Giao diện

Câu hỏi thường gặp ​

File kết quả tải về nhưng dữ liệu không được render (vẫn thấy placeholder)? ​

  • Kiểm tra cú pháp placeholder trong template — phải đúng format Carbone: {d.fieldName}.
  • Tên field phải khớp chính xác với field name trong collection (phân biệt hoa thường).
  • Đảm bảo bản ghi có dữ liệu cho field tương ứng.

Hình ảnh không xuất hiện trong file kết quả? ​

  • Kiểm tra attachment field có chứa file hợp lệ (JPEG, PNG, GIF).
  • File hình ảnh phải accessible từ server (kiểm tra file storage).
  • Placeholder hình ảnh phải được đặt đúng vị trí trong template.

QR code không hiển thị? ​

  • Kiểm tra dữ liệu nguồn cho QR code không rỗng.
  • QR code được tạo dưới dạng hình ảnh — đảm bảo template có placeholder đúng.

Có thể xuất ra PDF thay vì DOCX? ​

Có — sử dụng tham số convertedToPDF: true trong request. Server sẽ chuyển đổi file kết quả sang PDF sau khi render.

Lưu ý

Chuyển đổi PDF cần LibreOffice cài đặt trên server. Nếu không có, tham số này sẽ bị bỏ qua.

Template áp dụng cho collection A có dùng được cho collection B không? ​

Không — mỗi template gắn với một collection cụ thể qua trường collectionName. Cần tạo template riêng cho mỗi collection.

Ai có thể upload/quản lý template? ​

Chỉ admin có quyền CRUD trên printingTemplates. User thường (member) chỉ có thể sử dụng (in) template đã được admin tạo.

Template in có hỗ trợ nhiều ngôn ngữ không? ​

Carbone hỗ trợ đa ngôn ngữ thông qua formatter. Tuy nhiên, mỗi template là một file riêng — nếu cần nhiều ngôn ngữ, tạo template riêng cho mỗi ngôn ngữ.