How to Add Custom Fields to DevExpress Reports
Overview
In this tutorial, the process for adding Custom Fields to Certificate Reports (Certificate, Certificate Reissue, Statement of Attainment, Unaccredited Certificate), Letters of Offer, and Training Plans using the Internal Reference ID is explained. This ensures the reports are accurate, personalised, and display all relevant information for each student.
Before adding Custom Fields into the editor, ensure they are already created and available in the SMS. For a comprehensive guide on how to add Custom Fields in the SMS, please refer to this tutorial: How to Use Custom Fields.
Step Tutorial
1. Take note of the Internal Reference IDs of the Custom Fields to be added to the report. These can be found by navigating to Administration → Templates → Custom Fields → Custom Fields. For this example, three Custom Fields will be added, with reference IDs CF0001, CF0002, and CF0003, respectively.
2. Go to the Template Editor by navigating to Administration → Templates → Documents. Locate the specific template to be edited, then, under the Actions column, click Edit Report. A new tab will open where the template can be edited.
3. In the editor, drag a text field—this is where the reference IDs will be added.
4. Select the text field, then, under the Text box on the right, enter an opening curly brace ({), followed by the Internal Reference ID, and then a closing curly brace (}). For example: {CF0001}.
5. Repeat the process for all Custom Fields to be included in the report. For this example, the process will be completed three times to reflect all required fields.
6. Once satisfied with the added fields, click the hamburger icon in the upper-left corner of the editor, then select Save.
7. The edited document can now be issued to a student to confirm that the changes are reflected. For example, if a Certificate template was edited, issue a Certificate to a student; if a Statement of Attainment (SOA) was edited, issue an SOA.
These are the steps on how to add custom fields to devexpress reports.
Congratulations on completing this tutorial. We hope this has been helpful to you and your organisation. For any questions or concerns regarding this function, please reach out to the contact support via email.