📄 Export .gs

1. Giới thiệu

Mỗi công ty/khách hàng dùng một Google Sheet riêng để lưu danh sách máy, tên người giữ, key Windows... Sheet đó cần có một đoạn mã "Apps Script" đứng sau để nhận dữ liệu từ các nút khác của tool (⬆ Up Sheet, 💾 Restore PC, 🔁 Check trùng lặp...). Khi tool có thêm công ty mới, mã Apps Script cũ phải được viết lại cho khớp. Nút 📄 Export .gs tự viết ra một file .gs đầy đủ, để bạn chỉ cần copy-dán một lần, không phải tự ghép tay từng hàm.

Khi nào cần dùng:

• Vừa thêm một công ty mới vào danh sách, cần cập nhật lại mã Apps Script của sheet khách cho khớp.
• Sheet của khách báo lỗi "Apps Script CHƯA được Deploy lại phiên bản mới" ở các nút khác.

Nút này không làm: không tự dán hay Deploy mã lên Google — bạn phải tự làm ba bước còn lại (copy, dán đè, Deploy bản mới) trên trình duyệt.

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

• Tool đã có file cấu hình cạnh exe (mặc định có sẵn khi mở tool bình thường) — thiếu file này nút sẽ bị khoá.
• Đã có ít nhất một công ty trong danh sách ở nhóm phía trên (ô Công ty: + nút ＋ Thêm) — danh sách rỗng thì nút báo và dừng.
• Muốn áp dụng thật lên một sheet: mở sẵn trình duyệt, đăng nhập đúng tài khoản Google có quyền sửa Apps Script của sheet đó.

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

1. Ở tab 🖥️ Thiết bị, nhóm 🖥 Khởi tạo PC - chạy thẳng, bấm 📄 Export .gs.
   Bạn sẽ thấy: tool ghi thẳng file AppsScript_Full.gs ngay cạnh file thanhd.exe (ghi đè bản cũ nếu có), rồi hiện hộp thoại Export .gs.
2. Đọc hộp thoại — nó nhắc ba bước tiếp theo: ① Copy toàn bộ nội dung file. ② Mở Apps Script Editor của sheet, dán đè hết. ③ Deploy > Manage deployments > sửa deployment đang dùng > New version.
3. Bấm Yes/Có để tool tự mở file bằng Notepad.
   Bạn sẽ thấy: Notepad mở file AppsScript_Full.gs vừa ghi.
4. Trong Notepad, bấm Ctrl+A để chọn hết, Ctrl+C để copy toàn bộ nội dung.
5. Mở Google Sheet cần cập nhật trên trình duyệt → menu Extensions / Tiện ích mở rộng → Apps Script để mở trình soạn mã.
6. Trong khung soạn mã, bấm Ctrl+A chọn hết mã cũ, xoá, rồi dán (Ctrl+V) nội dung vừa copy từ Notepad. Lưu lại (Ctrl+S hoặc biểu tượng đĩa mềm).
7. Vẫn trong Apps Script Editor, bấm Deploy → Manage deployments → bấm biểu tượng bút chì ở deployment đang dùng (không tạo deployment mới, giữ đúng URL cũ) → ở ô Version chọn New version → bấm Deploy.
   Bạn sẽ thấy: các nút khác của tool (Up Sheet, Restore PC, Check trùng lặp...) từ lúc này gọi đúng mã mới.

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

Mục	Tác dụng	Ghi chú
Nút 📄 Export .gs	Ghi thẳng file AppsScript_Full.gs cạnh file thanhd.exe, không hỏi gì trước	Ghi đè bản cũ cùng tên mỗi lần bấm
Hộp thoại Export .gs (Yes/No)	Hiện đường dẫn file vừa ghi, kèm 3 bước hướng dẫn	Bấm Yes/Có để tool tự mở Notepad; bấm No/Không chỉ đóng hộp — file vẫn đã được ghi
Bước dán vào Apps Script Editor	Nằm trên trình duyệt Google, ngoài phạm vi tool	Giao diện Google có thể thay đổi theo thời gian, không thuộc tool
Bước Deploy > Manage deployments > New version	Áp dụng mã mới cho các lần gọi sau	Không tạo deployment mới để giữ đúng URL cũ đang dùng

5. Kiểm tra kết quả

• File AppsScript_Full.gs xuất hiện cạnh thanhd.exe (hoặc trên Desktop nếu bị chặn ghi, xem mục 6).
• Sau khi dán và Deploy xong, bấm thử một nút dùng Apps Script (ví dụ 🔎 Kiểm tra kết nối) để xác nhận sheet phản hồi đúng, không còn báo "chưa Deploy lại phiên bản mới".

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ý
Danh sách công ty đang trống, không có gì để xuất. / Thêm công ty rồi thử lại.	Chưa thêm công ty nào ở hàng Công ty: phía trên	Bấm ＋ Thêm, thêm ít nhất 1 mục rồi bấm lại
Nhật ký: [!] Không ghi được cạnh tool (...) nên đã lưu ra Desktop: ...	Thư mục chứa exe bị khoá ghi (USB chỉ đọc, Program Files cần quyền admin)	Mở file trên Desktop, hoặc copy cả tool ra thư mục ghi được rồi làm lại
Không thể tạo file: <đường dẫn>	Cả nơi cạnh tool và Desktop đều không ghi được (ổ đầy, quyền bị chặn hẳn)	Kiểm tra dung lượng ổ C, chạy tool bằng quyền Administrator rồi thử lại
Dòng đầu file .gs ghi thiếu file mẫu, chỉ xuất được các hàm setup riêng lẻ	Thiếu file mẫu cạnh tool — hay gặp khi chạy thẳng mã nguồn, chưa build thành file chạy	Dùng đúng bản thanhd.exe đã build, không chạy trực tiếp mã nguồn
Dán xong, các nút khác (Restore PC, Check trùng lặp) báo "Rất có thể Apps Script CHƯA được Deploy lại phiên bản mới"	Quên bước Deploy > Manage deployments > New version sau khi dán mã mới (chỉ mới Lưu code)	Vào lại Apps Script Editor, Deploy > Manage deployments, chọn New version, Deploy lại
Apps Script Editor báo lỗi cú pháp (dòng đỏ) khi lưu	Copy thiếu dòng đầu/cuối, hoặc dán nối vào mã cũ chứ không xoá sạch trước	Chọn hết mã cũ (Ctrl+A), xoá hẳn, rồi dán lại từ đầu file mới
Mã Apps Script cũ đang chạy tốt biến mất sau khi dán	Không sao lưu mã cũ trước khi dán đè — Google không có undo xuyên phiên	Trước khi dán, vào File > Make a copy, hoặc copy nội dung cũ ra một file text riêng
Không mở được Notepad để copy nội dung file	Máy thiếu/đã gỡ Notepad mặc định	Mở file AppsScript_Full.gs bằng tay bằng trình soạn thảo khác

7. Lưu ý an toàn

• Nội dung Google Sheet và link Apps Script Web App là dữ liệu nội bộ của khách (chứa key Windows, tên người giữ máy) — không chia sẻ công khai.
• File .gs ghi đè bản cũ cùng tên mỗi lần bấm nút, không hỏi lại — cần giữ bản cũ thì đổi tên/copy ra nơi khác trước khi bấm lần sau.
• Trước khi dán đè Apps Script Editor của một sheet đang chạy thật, luôn sao lưu mã cũ (File > Make a copy) — dán đè không hoàn tác được.
• Dán xong phải Deploy bản mới (New version); chỉ Lưu code là chưa đủ.