🔁 Check trùng lặp

1. Giới thiệu

Khi nhiều kỹ thuật viên cùng thêm máy lên Google Sheet, dễ xảy ra trùng tên thiết bị hoặc trùng Service Tag (ví dụ nhập tay sai, hoặc Up Sheet hai lần). Nút 🔁 Check trùng lặp quét toàn bộ sheet, tìm các nhóm tên thiết bị trùng và Service Tag trùng, tạo ra một tab báo cáo ngay trên Google Sheet rồi tự mở trình duyệt tới đó — không phải tự lọc/so tay hàng trăm dòng.

Khi nào cần dùng:

• Nghi ngờ sheet có dòng trùng do nhập liệu nhiều người hoặc bấm Up Sheet nhầm nhiều lần.
• Muốn rà soát định kỳ chất lượng dữ liệu trên sheet.

Nút này không làm: không tự xoá hay sửa dữ liệu trùng — chỉ liệt kê ra để bạn tự quyết định xoá/sửa dòng nào trên sheet.

2. Trước khi bắt đầu

• Cần mạng Internet, việc quét có thể mất 30–60 giây nếu sheet nhiều dòng.
• Không cần chọn công ty/sheet nào trước — nút này quét theo toàn bộ cấu hình phía server (Apps Script), không phụ thuộc ô chọn sheet của nút 💾 Restore PC bên cạnh.

3. Các bước thực hiện

1. Ở tab 🖥️ Thiết bị, nhóm 🔁 Đồng bộ với Google Sheet, bấm 🔁 Check trùng lặp.
   Bạn sẽ thấy: thông báo "⏳ Đang quét toàn bộ sheet để tìm trùng lặp, vui lòng chờ..." kèm dòng nhỏ "(sheet nhiều dòng có thể mất 30-60 giây)" và có nút Hủy để dừng giữa chừng.
2. Chờ tool quét xong.
   Bạn sẽ thấy: hộp Check Value Devices báo đã tạo báo cáo trên Google Sheet, tab BaoCaoTrungLap, kèm số nhóm tên thiết bị trùng, số nhóm Service Tag trùng (đã bỏ qua các dòng dạng placeholder — các dòng chưa có dữ liệu thật, chỉ là ô trống/giữ chỗ), và dòng "Đang mở trình duyệt...".
3. Bấm OK.
   Bạn sẽ thấy: trình duyệt tự mở thẳng tới tab BaoCaoTrungLap trên sheet — đây là thao tác của Google Sheets, không phải cửa sổ của tool.
4. Trên sheet, xem danh sách từng nhóm máy bị trùng và tự quyết định xoá/sửa dòng nào.

4. Giải thích các mục trong cửa sổ

Nút này chạy thẳng, không mở cửa sổ con của tool:

Mục	Tác dụng	Ghi chú
Thông báo "Đang quét..."	Hiện trong lúc tool gọi Apps Script quét toàn sheet	Có nút Hủy để dừng giữa chừng
Hộp Check Value Devices	Báo kết quả: số nhóm tên trùng, số nhóm Service Tag trùng, đã bỏ qua dòng placeholder
Tab BaoCaoTrungLap trên Google Sheet	Nơi liệt kê chi tiết từng nhóm trùng	Được ghi trực tiếp vào sheet gốc, ai có quyền xem sheet cũng thấy

5. Kiểm tra kết quả

• Hộp Check Value Devices hiện số nhóm trùng cụ thể.
• Mở tab BaoCaoTrungLap trên Google Sheet (tự mở, hoặc tìm trong danh sách tab ở dưới sheet) để xem chi tiết.

6. Lỗi thường gặp và cách xử lý

Hiện tượng / thông báo	Nguyên nhân	Cách xử lý
Không kết nối được tới sheet. Kiểm tra lại kết nối mạng.	Mất mạng, hoặc Apps Script không phản hồi	Kiểm tra Internet, thử lại
Sheet báo lỗi: kèm nội dung	Apps Script phía sheet báo lỗi khi xử lý (sheet bị xoá, quyền truy cập bị thu hồi)	Đọc nội dung lỗi kèm theo, kiểm tra quyền truy cập Google Sheet, liên hệ người quản lý sheet
Phản hồi từ sheet không hợp lệ (không phải JSON mong đợi). Rất có thể Apps Script CHƯA được Deploy lại phiên bản mới (findDuplicates).	Sheet dùng bản Apps Script cũ, chưa có chức năng quét trùng lặp	Vào Apps Script Editor, Deploy > Manage deployments > sửa deployment hiện có > New version, thử lại (xem thêm nút 📄 Export .gs)
Không đọc được link báo cáo từ phản hồi: kèm nội dung	Apps Script trả JSON đúng dạng nhưng thiếu trường cần thiết (lệch phiên bản Apps Script)	Cập nhật Apps Script bằng bản .gs mới xuất từ nút 📄 Export .gs, Deploy lại
Bấm nút xong màn hình "đứng" vài chục giây không phản hồi	Sheet có rất nhiều dòng, việc quét toàn sheet cần thời gian	Chờ, hoặc bấm nút Hủy trên hộp "đang tải" nếu muốn dừng giữa chừng
Trình duyệt mở lên báo không có quyền xem tab BaoCaoTrungLap	Tài khoản Google đang đăng nhập trên máy không có quyền truy cập sheet đó	Đăng nhập đúng tài khoản Google có quyền xem/sửa sheet trước khi bấm nút
Báo cáo hiện số nhóm trùng nhưng mở sheet không thấy tab BaoCaoTrungLap đâu	Tab báo cáo bị ẩn, hoặc có nhiều tab nên cuộn danh sách tab không thấy	Cuộn danh sách tab ở dưới sheet, hoặc chuột phải vào danh sách tab để tìm tab bị ẩn
Báo 0 nhóm trùng dù biết chắc có trùng	Các dòng tưởng trùng thực ra bị coi là "placeholder" (dòng giữ chỗ, chưa có dữ liệu thật) nên bị bỏ qua	Kiểm tra lại dữ liệu các dòng đó có phải dòng thật hay chỉ là dòng mẫu/trống

7. Lưu ý an toàn

• Nút chỉ đọc và tạo báo cáo, không tự xoá hay sửa dòng trùng trên sheet — việc xoá/sửa do bạn tự làm sau khi xem báo cáo, cần cẩn thận không xoá nhầm dòng đúng.
• Tab báo cáo BaoCaoTrungLap được ghi trực tiếp vào sheet gốc — nếu sheet có nhiều người cùng xem, tab báo cáo sẽ hiện với tất cả, nên dọn/ẩn tab này sau khi xử lý xong nếu không muốn người khác thấy.