Building Advanced Templates
Cogynt's Advanced Report Builder tool enables users to define custom .docx
export templates for a collection. The user builds the desired template as a .docx
file and uploads the template to Report Builder.
This guide covers the functionality tested and implemented in Cogynt. For more information regarding additional advanced features of the mapping library, refer to guigrpa's docx-template repository.
Building an Advanced (DOC) Report consists of two high level steps:
- Creating a
.docx
template file containing your desired formatting and output. - Uploading the
.docx
template to Workstation and creating an Advanced (DOC) Report.
Creating DOCX Templates
-
In an empty
.docx
file, set up your desired Word export template. This can include elements like:- Images
- Headers
- Footers
- Tables
- Static text elements (headings, subheadings, etc.)
-
Refer to any data in a collection that you wish to include in the export. This includes (but is not limited to):
- Collection information (name, description, tags, priority)
- Users on a collection
- Custom Fields on a collection
- Events on a collection
- Timestamps
For information about the specific syntax and options available to that you can output from a collection, refer to the Advanced Collection Mapping Guide.
- Save the
.docx
file. - Proceed to upload the docx template to Workstation and create an Advanced (DOC) Report.
Testing Templates
Users with Workstation: Report Builder: Edit and Workstation: Collections Export: Edit permissions are able to test the Advanced Collection Builder.
The process of creating Advanced Collection reports can take multiple iterations to get right. For convenience, you can test a .docx
template in Workstation without needing to create a saved template in Report Builder.
Assuming you have a .docx
file ready to test:
- Find the collection you wish to test the export on and ensure it is loaded onto an Object Details Viewer widget.
- Click the Export Data button on the collection.
- Select the Export to a DOCX template option.
- Attach the desired template and click Ok.
- The collection exports and saves to
.docx
if successful. If there is syntax error in your document, an error message appears.