Giao diện

Cài đặt và sử dụng ​

Cài đặt ​

Plugin @digiforce-nc/plugin-action-template-print có cả client và server. Kích hoạt qua Plugin Manager.

Khi install, plugin tự động:

  • Tạo collection printingTemplates trong database.
  • Thêm quyền templatePrint vào admin và member role strategies.
  • Tạo thư mục storage/print-templates/ để lưu file template.

Upload template ​

Bước 1: Tạo template DOCX/XLSX ​

Tạo file Word (.docx) hoặc Excel (.xlsx) chứa placeholder theo cú pháp Carbone:

  • {d.customerName} — field đơn giản
  • {d.items[i].productName} — loop qua mảng
  • {d.total:formatN(2)} — format số

Bước 2: Upload lên hệ thống ​

  1. Vào Settings → Printing Templates (hoặc dùng API printingTemplates:upload).
  2. Chọn collection mà template áp dụng.
  3. Đặt tên template và upload file.

Bước 3: Thêm nút Template Print ​

  1. Mở Schema Editor trên block Detail hoặc Table row.
  2. Vào Configure actions → chọn Template Print.
  3. Chọn template từ danh sách.
  4. Lưu schema.

Sử dụng ​

  1. Mở detail view hoặc click row action Template Print.
  2. Chọn template (nếu có nhiều template cho collection).
  3. Server lấy dữ liệu bản ghi, render vào template qua Carbone engine.
  4. Trình duyệt tải file kết quả (DOCX hoặc XLSX).

Các loại template hỗ trợ ​

Định dạngInputOutput
DOCXFile Word templateFile Word đã render dữ liệu
XLSXFile Excel templateFile Excel đã render dữ liệu

Mẹo

Template DOCX phù hợp cho hóa đơn, hợp đồng, báo cáo dạng văn bản. Template XLSX phù hợp cho bảng tổng hợp, phiếu kho, báo cáo dạng bảng.