Câu hỏi thường gặp (FAQ) — File Previewer Office

Sử dụng

Xem trước file có chính xác 100% không?

Hầu hết nội dung hiển thị chính xác, bao gồm:

• Heading, bảng, hình ảnh trong Word
• Dữ liệu bảng, sheet tabs trong Excel
• Slide layout, hình ảnh trong PowerPoint

Tuy nhiên, một số tính năng phức tạp có thể hiển thị khác biệt:

• Font đặc biệt (chưa cài trên Microsoft server)
• Macro (không thực thi được trong viewer)
• Animation trong PowerPoint (chỉ hiển thị slide tĩnh)
• Biểu đồ phức tạp trong Excel

Có thể chỉnh sửa file trực tiếp không?

Không. Plugin chỉ hỗ trợ xem trước (preview). Để chỉnh sửa, user cần:

1. Nhấn nút Download tải file gốc
2. Mở bằng ứng dụng Office trên máy
3. Chỉnh sửa và upload lại

Preview có hoạt động với file trên local storage không?

Chỉ nếu URL file truy cập được từ internet. Microsoft Office Online Viewer cần đọc file qua HTTP(S). Nếu server Digiforce nằm trong mạng nội bộ (không có public URL), preview sẽ không hoạt động.

Giải pháp:

1. Chuyển sang cloud storage (S3, OSS) với public access
2. Expose server ra internet qua reverse proxy hoặc tunnel
3. Sử dụng self-hosted viewer (OnlyOffice, LibreOffice Online)

Có hỗ trợ file PDF không?

Plugin này không xử lý PDF. PDF thường đã có viewer tích hợp trong trình duyệt. Plugin chỉ tập trung vào file Office (Word, Excel, PowerPoint, OpenDocument).

File lớn (>10MB) có preview được không?

Có thể, nhưng:

• Thời gian tải lâu hơn (Microsoft cần download file)
• Microsoft Office Online Viewer có giới hạn kích thước (khoảng 10-50MB tùy loại file)
• File Excel quá nhiều sheet/dữ liệu có thể timeout

Có cần kết nối internet không?

Có. Plugin dựa vào dịch vụ Microsoft Office Online Viewer (view.officeapps.live.com). Nếu server hoặc client không có kết nối internet, preview sẽ không hoạt động.

Bảo mật

File có được gửi qua Microsoft servers không?

Có. Microsoft Office Online Viewer tải file từ URL được cung cấp, xử lý và render. Điều này có nghĩa:

• File nội dung nhạy cảm sẽ đi qua Microsoft servers
• Microsoft có thể cache file tạm thời

Khuyến nghị cho file nhạy cảm:

1. Sử dụng self-hosted viewer (OnlyOffice Server)
2. Hoặc không sử dụng preview — chỉ cho phép download

Có thể dùng viewer khác thay Microsoft?

Hiện tại plugin mặc định dùng Microsoft Office Online Viewer. Để dùng viewer khác (ví dụ: OnlyOffice), cần:

1. Tùy chỉnh plugin hoặc tạo plugin mới
2. Thay đổi URL template từ view.officeapps.live.com sang viewer riêng
3. Self-host viewer: OnlyOffice Document Server hoặc LibreOffice Online

Lỗi thường gặp

File không hiển thị (iframe trắng)?

Kiểm tra theo thứ tự:

1. File có URL public không? Mở URL file trong trình duyệt ẩn danh (incognito) — nếu cần đăng nhập, Microsoft không thể đọc
2. Kết nối internet — server và client cần truy cập được view.officeapps.live.com
3. MIME type đúng không? Kiểm tra file có mimetype hoặc extension thuộc danh sách hỗ trợ
4. HTTPS? Microsoft Office Online Viewer yêu cầu URL file là HTTPS (hoặc HTTP)
5. File bị corrupt? Thử mở file bằng ứng dụng Office trên máy

Preview hiển thị lỗi "Sorry, this document can't be opened"?

Microsoft Office Online Viewer không thể đọc file. Nguyên nhân:

• File URL không truy cập được từ internet
• File bị corrupt hoặc protected bằng password
• File quá lớn
• Định dạng không được hỗ trợ

Click vào file nhưng không mở modal?

Plugin chỉ xử lý file Office. Kiểm tra:

• File có extension thuộc danh sách hỗ trợ (.docx, .xlsx, .pptx, .doc, .xls, .ppt, .odt)
• Hoặc MIME type thuộc danh sách MIME type Office
• Plugin đã được kích hoạt (kiểm tra Plugin Manager)

Preview tải rất chậm?

• File lớn cần thời gian để Microsoft download và render
• Kiểm tra tốc độ kết nối giữa storage backend và Microsoft servers
• Thử giảm kích thước file (ví dụ: nén ảnh trong Word/PowerPoint)

Vấn đề khác

So sánh với self-hosted viewer?

Tiêu chí	Microsoft Online Viewer	Self-hosted (OnlyOffice)
Cài đặt	Không cần	Cần cài server riêng
Chi phí	Miễn phí	Cần license hoặc Community Edition
Bảo mật	File đi qua Microsoft	File ở nội bộ
Chất lượng render	Rất tốt	Tốt
Offline	Không	Có
Chỉnh sửa	Không	Có (tùy version)

Plugin có ảnh hưởng đến hiệu năng không?

Rất ít. Plugin:

• Server-side: Rỗng (không xử lý gì)
• Client-side: Chỉ đăng ký file type handler (nhẹ)
• Nặng nhất: iframe load Microsoft viewer (phụ thuộc Microsoft, không ảnh hưởng Digiforce)