Aam Digital enables you to generate custom PDF files tailored to specific requirements or formats. The “File Generation” feature let's you upload templates (Word documents) with placeholders to generate a PDF from them.
You can use normal office files (e.g., .docx, .xlsx, .pptx or their open alternatives .odt, .ods, .odp) as templates. With such templates, you can, for example, craft personalized contracts for each beneficiary without the need to create documents manually, copy and pasting names and other details. You can save a template in the system and reuse it for other beneficiaries, significantly reducing the time spent on paperwork.
Through this guide, we will demonstrate how to generate a PDF file:
1. Placeholders in your template
Your template must include placeholders that the system can use to pull in and replace with actual data.
These placeholders must match the “Field ID” of the field in the data structure of the record in Aam Digital. You can find this in the form editor of the admin user interface (Edit data structure -> Detail view) when you edit a specific field to display its details.
We are working on a user interface that will help you generate placeholders more easily.
For example, I want the name of a child in my template. To find the “Field ID,” follow these steps:
-
Navigate to Children from the main menu> Edit Data structure> Detail view
-
Click on the required field >“Edit Field”
-
Copy the text in “Field ID”
Use this field ID in the template of your choice. The field ID, which is a placeholder, will be replaced with actual data when the file is generated.
A placeholder in the document must be inside curly braces { }, and the ID is prefixed with “d.” (as in “d” for data record). For example, the text {d.name} is replaced with the value in the “Name” field of the respective record.
2. Upload your template:
Now that you have the required data that needs to be pulled, we will upload this template into Aam Digital.
-
Open the Admin Overview from the main menu
-
Select "Configure Export Templates > Add New"
-
You can upload your template in the field "Template file"
-
... and select the applicable entity with which the template will be linked. (i.e., for which kinds of records you are able to generate files with this template)
-
Then click "Save"
3. Generate File from Template
In our example, we selected Child as our entity type for which this template is designed.
-
Navigate to Children from the main menu
-
Click on a child record whose document you want to create
-
Click on the three-dot menu in the top-right-hand corner
-
Click on “Generate File”
-
In the field “Template”, select the template created in the previous step
- Click on “Generate File”
The customized document will be created, with placeholders replaced by the actual data.