ContextQMD
Back to Nocobase

Configuration

docs/docs/en/template-print/configuration.md

2.0.513.3 KB
Original Source

Configuration Instructions

Activating Template Printing

Template printing currently supports detail blocks and table blocks. Below are the configuration methods for these two types of blocks.

Detail Blocks

  1. Open the Detail Block:
  • Navigate to the detail block in the application where you need to use the template printing feature.
  1. Access the Configuration Operation Menu:
  • Click the "Configuration Operation" menu at the top of the interface.
  1. Select "Template Printing":
  • Click the "Template Printing" option in the dropdown menu to activate the plugin.

Configuring Templates

  1. Access the Template Configuration Page:
  • In the configuration menu of the "Template Printing" button, select the "Template Configuration" option.

  1. Add a New Template:
  • Click the "Add Template" button to enter the template addition page.

  1. Fill in Template Information:
  • In the template form, fill in the template name and select the template type (Word, Excel, PowerPoint).
  • Upload the corresponding template file (supports .docx, .xlsx, .pptx formats).

  1. Edit and Save the Template:
  • Go to the "Field List" page, copy fields, and fill them into the template.

  • Template printing now supports attachment fields and handwritten signature fields, and the Field List will automatically generate the corresponding template expressions.
  • If you want to render images in the template, it is recommended to always copy the variable directly from the Field List instead of writing :attachment() or :signature() expressions manually.
  • After filling in the details, click the "Save" button to complete the template addition.
  1. Template Management:
  • Click the "Use" button on the right side of the template list to activate the template.
  • Click the "Edit" button to modify the template name or replace the template file.
  • Click the "Download" button to download the configured template file.
  • Click the "Delete" button to remove unnecessary templates. The system will prompt for confirmation to avoid accidental deletion.

Table Blocks

The usage of table blocks is basically the same as detail blocks, with the following differences:

  1. Support for Multiple Record Printing: You need to first select the records to print by checking them. You can print up to 100 records at once.

  1. Template Isolation Management: Templates for table blocks and detail blocks are not interchangeable — because the data structures are different (one is an object, the other is an array).