Prev | Next |
Creating a Template Fragment
A Template Fragment can return data from either an SQL Query or Model Scripts. The process of defining the content of a Template Fragment depends on which type of data you want your Template Fragment to return; the choices being:
- Normal Document Template model data - the Template Fragment operates in the same way as a normal template
- Template Selector - to define a template that calls in other Template Fragments depending on the element type being reported on
- Custom SQL - to refer to the data returned by a custom SQL Query
- Custom Scripts - to refer to data returned from a Model Script
- Document Script - to identify a Model Script to be used by your Template Fragment; the script must return either an empty string or a string that contains raw RTF
- Custom XML Script - to create a query to report values from an XML file produced by a previously-generated script, such as the data from a simulation; the query operates on static data that is not being continually or automatically updated
In all cases the process is very similar to creating a normal document template.
Access
Use one of the methods outlined here to open the 'New Document Template' dialog.
Ribbon |
Publish > Tools > Document Templates > New Template icon |
Keyboard Shortcuts |
> Templates : New |
Other |
In the Resources window, expand the 'Document Generation' folder, then:
|
Create a new Template Fragment
Step |
Action |
See also |
---|---|---|
1 |
Using one of the methods above, display the 'New Document Template' dialog. |
Document Templates |
2 |
In the 'New Template' field, type the name for the Template Fragment. |
|
3 |
In the 'Template Type' field, click on the drop-down arrow and select the 'Fragments' option. |
|
4 |
In the 'Copy Template' field, click on the drop down arrow and select either:
|
|
5 |
In the 'Template Group' field either:
The Template Group determines the location of the Template Fragment in the Resources window. |
Resources |
6 |
Click on the . The Document Template Designer displays in the Diagram View. |
Design Custom Document Templates |
7 |
Define the contents of your Template Fragment; the actual steps you follow depend on the data source you want the Template Fragment to operate on:
|
How to Define a Document Script Fragment How to Define a Custom XML Script Fragment Design Custom Document Templates Custom SQL Fragments Custom Script Fragments Define a Template Selector |
8 |
Once you have created the Template Fragment, you incorporate it into a normal template (or into an existing Template Fragment, if you prefer). |
Adding Fragments to a Document Template |
Notes
Learn more