| # Hướng dẫn áp dụng Fix Excel Download - CẬP NHẬT 2026 |
|
|
| ## Vấn đề |
| File Excel chỉ tải được 1 lần, lần 2+ thất bại vì `URL.revokeObjectURL()` được gọi sau 60s. |
|
|
| ## 🎯 GIẢI PHÁP HOÀN HẢO - Fix v2.0 |
|
|
| ### Cách 1: Auto Loader (TỰ ĐỘNG) - KHÔNG CẦN LÀM GÌ CẢ |
| - `auto-excel-fix-loader.js` tự động tải `vai-excel-fix-v2.js` khi trang mở |
| - Script đã được tích hợp sẵn trong index.html |
| - Chỉ cần mở lại trang là được áp dụng tự động ✅ |
|
|
| ### Cách 2: Bookmarklet - KHÔNG CẦN CHỈNH SỬA CODE |
| Tạo bookmark mới với URL: |
| ```javascript |
| javascript:(function(){var s=document.createElement('script');s.src='/vai-excel-fix-v2.js?v='+Date.now();s.onload=function(){alert('✅ Excel Fix v2.0 đã tải!\nBạn có thể tải Excel bao nhiêu lần tùy thích!');};document.head.appendChild(s);})(); |
| ``` |
|
|
| ### Cách 3: Thêm script tag vào index.html (TỰ ĐỘNG) |
| Thêm đoạn sau vào trước thẻ `</body>`: |
| ```html |
| <!-- V.AI STUDIO Excel Multi-Download Fix v2.0 --> |
| <script src="vai-excel-fix-v2.js?v=2026"></script> |
| ``` |
|
|
| ## Test |
| 1. Mở Space V.AISTUDIO |
| 2. Tạo báo giá (lập báo giá) → Click 💾 Excel → tải ✅ |
| 3. Click 💾 Excel NGAY → tải tiếp tục ✅ |
| 4. Click nhiều lần nữa → luôn tải được ✅ |
| 5. Quay lại → tạo đơn hàng mới → GH Excel → tải ✅ |
|
|
| ## File đã chuẩn |
| - ✅ `vai-excel-fix-v2.js` - Script fix chính (mới nhất) |
| - ✅ `auto-excel-fix-loader.js` - Tự động tải fix |
| - ✅ `vai-quote-excel-order-fix-v1050.js` - Backup (nếu v2 không tải được) |
|
|
| ## Điều kiện áp dụng |
| - Cần có thư viện ExcelJS (đã có trong index.html): |
| ```html |
| <script src="https://cdn.jsdelivr.net/npm/exceljs@4.4.0/dist/exceljs.min.js"></script> |
| ``` |
|
|
| ## Changelog v2.0 |
| - Thay đổi cách quản lý blob URL: registry toàn cục |
| - Patch URL.revokeObjectURL: không revoke khi chưa unload |
| - Hỗ trợ cả Quote modal và Order modal |
| - Toast thông báo khi xuất thành công/thất bại |
|
|
| --- |
| *Cập nhật: 14-07-2026 - ML Intern - Fix Excel multi-download hoàn hảo* |
