DVDAddin

Tiếng Việt

English

Tiếng Việt

English

Giao diện

Troubleshooting (Top 20 sự cố) ​

Tổng hợp 20 lỗi thường gặp + cách khắc phục chi tiết. Sắp xếp theo nhóm chức năng.

Cài đặt ​

#1 — "It was not possible to find a compatible framework version for .NET Desktop Runtime" ​

Nguyên nhân: .NET 8 Desktop Runtime chưa cài đúng bitness với Excel (không phải bitness của Windows).

Fix:

  1. Mở Settings → Apps → Installed apps.
  2. Tìm "Microsoft Windows Desktop Runtime - 8.0.x".
  3. Nếu chỉ có (x86) mà Excel là 64-bit → cài thêm x64, và ngược lại.
  4. Tải thủ công:

#2 — Tab DVD Addin / DVD Cons không hiển thị trên Ribbon ​

Nguyên nhân: Add-in chưa được Excel nạp (khoá OPEN bị xoá, hoặc Excel đã disable add-in sau một lần crash).

Fix:

  1. File → Options → Add-ins → Manage = Excel Add-ins → Go.
  2. Tích vào DVDAddin-AddIn64-packed.xll.
  3. Nếu không thấy trong danh sách → Browse → chọn:
    • 64-bit: C:\DVDAddin\DVDAddin-AddIn64-packed.xll
    • 32-bit: C:\DVDAddin\DVDAddin-AddIn-packed.xll
  4. Vẫn không được → File → Options → Add-ins → Manage = Disabled Items → Go → bỏ add-in ra khỏi danh sách bị vô hiệu hoá.

Cài đúng thì bạn thấy hai tab: DVD Addin và DVD Cons.

#3 — Cài bản mới xong mà lỗi cũ vẫn còn / vẫn là bản cũ ​

Nguyên nhân: Excel giữ file .xll trong bộ nhớ suốt phiên làm việc. Nếu còn bất kỳ cửa sổ Excel nào mở lúc cài, bản cũ vẫn nằm nguyên trong RAM (và bộ cài có thể không ghi đè được file).

Fix:

  1. Đóng TẤT CẢ cửa sổ Excel — kiểm tra tiến trình EXCEL.EXE trong Task Manager, kill nếu còn sót.
  2. Đóng cả Outlook (Outlook có thể mở Excel ngầm để xem file đính kèm).
  3. Chạy lại bộ cài.
  4. Mở Excel → DVD Addin → Tác giả → đối chiếu số phiên bản hiển thị với bản vừa cài.

Đây là nguyên nhân số một của tình huống "đã sửa rồi mà vẫn còn lỗi".

License ​

#4 — "No active license for this account" ​

Nguyên nhân: Tài khoản không có license nào còn hiệu lực — hết hạn, bị thu hồi, hoặc đơn hàng chưa được ghi nhận thanh toán.

Fix:

  • Mở DVD Addin → Bản quyền, đọc thẻ trạng thái ở đầu hộp thoại: gói đang dùng và hạn dùng nằm ở đó.
  • Hết hạn → Mua bản quyền để gia hạn.
  • Vừa chuyển khoản mà chưa nhận key → kiểm tra hộp thư (kể cả spam); nội dung chuyển khoản phải giữ đúng chuỗi do hộp thoại sinh ra, sửa nội dung là hệ thống không khớp được giao dịch.

#5 — "Invalid credentials" khi đăng nhập ​

Nguyên nhân: Sai email/mật khẩu, hoặc tài khoản bị khoá.

Fix:

  • Email gõ đúng, không thừa khoảng trắng (ô email nhận tối đa 200 ký tự).
  • Nếu bạn đã đổi mật khẩu sau lần đăng nhập đầu, dùng mật khẩu MỚI chứ không phải mật khẩu tạm trong email.
  • Quên mật khẩu → liên hệ nhóm Zalo hỗ trợ để admin reset.

#6 — Vừa kích hoạt xong nhưng lệnh vẫn báo cần license ​

Nguyên nhân: Ribbon còn giữ trạng thái license cũ của phiên Excel đang chạy.

Fix:

  • Đóng hộp thoại Bản quyền — ribbon tự cập nhật trong đa số trường hợp.
  • Nếu vẫn khoá → đóng hẳn Excel rồi mở lại.

#7 — Đang dùng bình thường thì báo hết hạn / mất license ​

Nguyên nhân thường gặp:

  • Offline quá lâu. Add-in giữ token phiên có hạn 7 ngày, cộng ~1 ngày đệm — tổng cộng khoảng 8 ngày dùng offline kể từ lần kiểm tra online cuối cùng.
  • Phiên bị kick. Tài khoản vừa đăng nhập ở máy khác; mỗi license chỉ có một phiên hoạt động tại một thời điểm.
  • Đồng hồ máy bị lùi lại. Add-in ghi lại mốc thời gian lớn nhất từng thấy; nếu đồng hồ hệ thống lùi quá 1 giờ so với mốc đó, phiên bị coi là không hợp lệ và cửa sổ đệm offline bị xoá luôn — chỉnh đồng hồ về đúng cũng không tự phục hồi, bắt buộc phải nối mạng đăng nhập lại một lần. Ngưỡng 1 giờ là để chừa chỗ cho NTP lệch nhẹ, đổi giờ mùa và máy ảo vừa resume.

Fix: bật đồng bộ giờ tự động của Windows (Settings → Time & language → Set time automatically), rồi nối mạng → mở Bản quyền → đăng nhập lại.

#8 — "Access denied" khi lưu trạng thái license ​

Nguyên nhân: File %LocalAppData%\DVDAddin\license.dat bị đặt read-only, hoặc cả thư mục bị chặn ghi (ACL, Controlled Folder Access của Windows Defender, thư mục cũ còn sót).

Fix:

  1. Mở %LocalAppData%\DVDAddin → bỏ thuộc tính Read-only của license.dat, hoặc xoá hẳn file (add-in tạo lại khi đăng nhập).
  2. Nếu lỗi vẫn còn → xoá cả thư mục %LocalAppData%\DVDAddin rồi đăng nhập lại.
  3. Kiểm tra Controlled Folder Access trong Windows Security có đang chặn Excel ghi vào thư mục đó không.

Add-in còn giữ một bản sao license trong registry HKCU nên bạn thường không mất phiên khi làm bước này.

Dịch thuật & AI ​

#9 — Gemini báo "chặn output (SAFETY / RECITATION)" ​

Nguyên nhân: Đó là finishReason do chính Gemini trả về, không phải lỗi của add-in.

Fix:

  • RECITATION — nội dung trùng tài liệu công khai (tiêu chuẩn, điều khoản hợp đồng). Chia nhỏ vùng dịch hoặc diễn đạt lại.
  • SAFETY — đổi sang Google hoặc ChatGPT.
  • MAX_TOKENS — vùng chọn quá lớn cho model; chia nhỏ hoặc chọn model có context window lớn hơn.

#10 — "API key" bị hỏi lại / lỗi 401 Unauthorized ​

Nguyên nhân: Chưa khai key cho đúng nhà cung cấp đang chọn, hoặc key sai/đã bị thu hồi.

Fix:

#11 — Gemini báo "quota exceeded" ​

Nguyên nhân: Vượt giới hạn free tier của Google AI Studio cho key của bạn.

Fix:

  • Đợi cửa sổ giới hạn reset.
  • Đổi Service sang Groq hoặc NVIDIA (free tier khác).
  • Giảm tải: vùng chọn được cắt thành lô 25 ô và chạy song song tối đa 10 lô — dịch từng đợt nhỏ sẽ ít chạm giới hạn phút hơn.

#12 — Lệnh dịch trả về lỗi dù mạng vẫn chạy ​

Fix:

  • Kiểm tra tường lửa/proxy công ty có chặn generativelanguage.googleapis.com, api.openai.com, api.groq.com hay không.
  • Thử với Google trước — dịch vụ này không cần API key, nếu Google chạy được thì vấn đề nằm ở key/nhà cung cấp chứ không phải mạng.

In & Xuất ​

#13 — In hàng loạt chạy rất lâu hoặc trông như treo Excel ​

Nguyên nhân: Mỗi vòng lặp add-in ghi số vào driver cell rồi để Excel tính lại toàn sheet — hàng trăm vòng thì mất vài phút là bình thường. Chậm bất thường thì thường do VBA của workbook.

Fix:

  • Nếu workbook có Worksheet_Change, thêm Application.EnableEvents = False ở đầu handler, hoặc tách biểu mẫu sang workbook không VBA.
  • Không gõ vào ô nào trong lúc lệnh đang chạy — Excel sẽ từ chối thao tác COM của add-in.
  • Lưu workbook trước khi chạy loạt lớn: driver cell bị ghi đè giá trị thật trong lúc chạy.

#14 — Trộn sang Word ra file trống / không thay chỗ trống ​

Nguyên nhân: Placeholder không khớp tiêu đề cột.

Fix:

  • Placeholder viết dạng [TenCot] (ngoặc vuông) và trùng CHÍNH XÁC tiêu đề cột, kể cả dấu tiếng Việt và khoảng trắng:
    ✗ [Hang muc]   → tiêu đề cột là "HangMuc" → KHÔNG khớp
✗ [ HangMuc ]  → thừa khoảng trắng → KHÔNG khớp
✓ [HangMuc]    → đúng
  • Vùng dữ liệu phải BAO GỒM dòng tiêu đề.
  • Placeholder nằm trong header / footer / text box của file mẫu có thể không được thay — đưa chúng vào phần thân văn bản.
  • Cột chọn làm tên file phải có giá trị duy nhất, nếu không các file đầu ra ghi đè lên nhau.

#15 — PDF xuất ra thừa trang trắng ​

Nguyên nhân: Ngắt trang tự chèn, hoặc vùng ảnh dvdPic trống vẫn được in.

Fix: trong khung Tùy chọn của In hàng loạt:

  • Tắt tự chèn ngắt trang tại vùng ký nếu biểu mẫu đã vừa trang.
  • Bật hai tuỳ chọn bỏ qua vùng / trang in có công thức dvdPic nhưng không có hình.

#16 — Gửi Email không chạy / bị đánh dấu spam ​

Nguyên nhân: Lệnh gửi thư qua Outlook trên máy, không gửi trực tiếp qua máy chủ thư.

Fix:

  • Máy phải cài Microsoft Outlook và đã cấu hình sẵn tài khoản.
  • Luôn bấm Preview cho vòng đầu tiên để xem thư mở ra trong Outlook trước khi bấm Gửi — thư đã gửi thì không thu hồi được.
  • Tránh gửi hàng trăm thư có subject và body giống hệt nhau; hệ thống lọc thư của bên nhận sẽ đánh dấu spam.
  • Đường dẫn đính kèm phải tồn tại trên máy; nhiều đường dẫn trong một ô thì mỗi dòng một đường dẫn (Alt+Enter).

DVD Cons (Xây dựng) ​

#17 — Vẽ tiến độ nhưng ngày bị sai ​

Fix:

  • Start / Finish phải là Date format, không phải Text.
  • Predecessors ghi theo Activity ID + kiểu quan hệ (MHC1060FS, MHC1090SS, MHC1150FF).
  • Duration là số nguyên ngày.
  • Bật Tự động tính; bật thêm Tự động vẽ nếu muốn biểu đồ tự cập nhật.
  • Kiểm tra lịch làm việc và ngày nghỉ lễ trong Cài đặt và sheet Input của file mẫu.
  • Không bấm lệnh khi con trỏ đang nhấp nháy trong ô (chế độ sửa nội dung).

#18 — Cắt thép cho ra tỷ lệ phế cao ​

Fix:

  • Kiểm tra mạch cắt (kerf) khai theo đường kính/mác thép — mặc định 4 mm.
  • Cột Cho phép nối (Yes/No) trong sheet 02_NhuCauCat: để No với thanh dài gần bằng cây 11,7 m thì luôn sinh đầu thừa lớn.
  • Khai thép tồn kho để thuật toán tận dụng cây dở.
  • Cửa sổ Xem trước cắt thép cho phép bấm Đóng để huỷ hoàn toàn — không sheet nào bị ghi, cứ thử nhiều phương án.
  • Sau khi Áp dụng, sheet kết quả bị ghi đè và Ctrl+Z không khôi phục được.

#19 — Kết nối Server: bấm lệnh mà không thấy gì / không đồng bộ được ​

Nguyên nhân & fix:

  • Cửa sổ không mở — license hết hạn hoặc chưa đăng nhập. Lệnh không hiện thông báo lỗi, chỉ đơn giản là không mở.
  • Host chưa đặt Mật khẩu Admin — add-in cảnh báo "Host phải đặt Pass Admin!" và không chạy server.
  • Nhận được dữ liệu nhưng đọc không ra — Mật khẩu Dữ liệu dùng để mã hoá gói tin, mọi máy trong phiên phải nhập giống hệt nhau.
  • Không kết nối được LAN — các máy phải cùng lớp mạng và cổng (mặc định 8888) phải được mở trên tường lửa Windows của máy host.
  • Đóng cửa sổ không ngắt phiên — muốn thoát hẳn phải dùng lệnh Ngắt kết nối.

Workbook & Performance ​

#20 — Workbook chậm sau khi cài DVDAddin ​

Nguyên nhân: Hàm volatile tính lại mỗi lần Excel recalc: dvdAutoHide, dvdMCLookup, dvdMVLookup, dvdSumVisible, dvdUniqueV. Bốn hàm gọi mạng (dvdTranslate, dvdStock, DVDFx, dvdAIExplain) còn nặng hơn nữa khi kéo cho nhiều dòng.

Fix:

  • Giới hạn số ô dùng hàm volatile; nhiều trường hợp thay được bằng dvdXlookup hoặc SUBTOTAL.
  • Chốt số liệu xong thì convert sang giá trị tĩnh (Ctrl+C → Paste Special → Values).
  • Chuyển Excel sang Manual calculation khi đang chỉnh bảng lớn.

Diagnostic checklist ​

Khi gặp lỗi không rõ nguyên nhân:

  1. Đóng hẳn Excel (kiểm tra EXCEL.EXE trong Task Manager) → mở lại → thử lại lệnh. Rất nhiều lỗi "lạ" chỉ là add-in cũ còn nằm trong bộ nhớ.
  2. Cập nhật lên bản mới nhất — DVD Addin → Menu Thông tin → Cập nhật.
  3. Restart Windows — reset trạng thái COM.
  4. Kiểm tra dữ liệu tại chỗ:
    • %LocalAppData%\DVDAddin\license.dat — trạng thái license.
    • HKCU\Software\DVD\DVDAddin\ — toàn bộ thiết lập (Preferences, API Keys, Model, Service, GanttSettings…).
    • C:\DVDAddin\Template\ — 6 file mẫu; thiếu thư mục này thì các lệnh mở mẫu sẽ báo lỗi kèm danh sách đường dẫn đã tìm.
  5. Xem log (nếu người hỗ trợ yêu cầu):
    • %TEMP%\DVDAddin\ — log của watchdog và một số lệnh.
    • %TEMP%\dvdaddin-chat.log — DVD Chat.
    • %TEMP%\DVDAddin_Sync_Log.txt — Kết nối Server.
    • %LocalAppData%\CrashDumps\EXCEL.EXE.*.dmp — dump khi Excel crash.
  6. Loại trừ xung đột add-in: File → Options → Add-ins → bỏ tick từng add-in khác, test lại với riêng DVDAddin.
  7. Thử trên máy khác để tách bạch lỗi sản phẩm và lỗi cấu hình máy.

Báo bug ​

Gửi qua nhóm Zalo hỗ trợ (zalo.me/g/yqzwvk121) hoặc GitHub Issue (github.com/dangdvd/DVDAddin/issues), kèm:

  • Số phiên bản add-in — mở DVD Addin → Tác giả và chụp màn hình (cửa sổ hiện cả phiên bản lẫn loại license).
  • Phiên bản Excel (32/64-bit) + Windows.
  • Mô tả lỗi + các bước tái hiện.
  • Log files nếu có.
  • Screenshot với lỗi giao diện.

Liên quan ​

Released under DVDAddin License.

Copyright © 2026 Đặng Văn Đằng — dvdpm.net