Difference between revisions of "Create an MS Word Print Template"
From LongJump Support Wiki
imported>Aeric |
imported>Aeric |
||
Line 7: | Line 7: | ||
===Adding Template Variables=== | ===Adding Template Variables=== | ||
===Inserting an Image Stored in an Object Record=== | |||
To insert an image into a Print Template, use the platform <tt>IMG</tt> tag in an HTML <tt>img</tt> element. | |||
;Format: | |||
:<tt><nowiki><img src="IMG</nowiki></tt><u><b>{$</b></u>''objectName''<u>.</u>''imageFieldName''<u><b>}</b></u><tt>"></tt> | |||
where: | |||
:* '''objectName -''' The name of the current object. (This variable is in {{Velocity}} format. The object name effectively creates a namespace, ensuring that there is no conflict with another variable that might have the same name.) | |||
:* '''imageFieldName -''' The name of the field in the current record that contains the image to display, joined to the object name by a "dot" (.). | |||
{{Important|The braces <u>{</u>...<u>}</u> and other underlined characters in this syntax are ''literals''. Type them in exactly as shown.}} | |||
;Result: | |||
:The URL for the image is inserted into the generated page. When viewed, the image is displayed. | |||
;Example: | |||
:<tt><nowiki><img src=”IMG{$Customer.logo_image}”></nowiki></tt> | |||
===Inserting a Chart=== | |||
To insert a chart into a Print Template, use the platform <tt>CHART</tt> tag in an HTML <tt>img</tt> element. | |||
;Format: | |||
:<tt><nowiki><img src="CHART</nowiki></tt><u><b>{$</b></u>''report_id''<u><b>}</b></u><tt>"></tt> | |||
:<tt><nowiki><img src="CHART</nowiki></tt><u><b>{$</b></u>''report_id'', <u>chart-title=</u>''Your Title'', ''field1''<u>=</u>''value'', ...<u><b>}</b></u><tt>"></tt> | |||
where: | |||
:* '''report_id -''' A required argument that gives the ID of the report that generates the chart. | |||
:* '''chart-title -''' An optional argument containing text for a chart title. | |||
:* '''field1 -''' An optional record field. Only records with a matching value will be included in the generated chart. Up to three fields and values can be specified in the comma-separated list. (More can be specified, but only the first three are used.) | |||
{{Important|The braces <u>{</u>...<u>}</u> and other underlined characters in this syntax are ''literals''. Type them in exactly as shown.}} | |||
;Result: | |||
:A URL for the generated chart is inserted into the generated page. When viewed, the chart image is displayed. | |||
'''Example #1 -''' Inserting a chart with no optional arguments: | |||
:<tt><nowiki><img src="CHART{c5cc43653b1b49db8142bc844735c209}"></nowiki></tt> | |||
'''Example #2 -''' Inserting a chart of Orders taken by the owner of the current record: | |||
:<tt><nowiki><img src="CHART{c5cc43653b1b49db8142bc844735c209, chart-title=Orders by $Order.owner.full_name, owner_id=$Order.owner.id}"></nowiki></tt> |
Revision as of 01:46, 17 February 2012
Creating the Template File
- On your local system, create a Word document
- Add boilerplate text and place-holder images.
- Insert template variables, record-specific images, and/or charts, as explained below.
- Save it in .docx format.
Adding Template Variables
Inserting an Image Stored in an Object Record
To insert an image into a Print Template, use the platform IMG tag in an HTML img element.
- Format
- <img src="IMG{$objectName.imageFieldName}">
where:
- objectName - The name of the current object. (This variable is in Template:Velocity format. The object name effectively creates a namespace, ensuring that there is no conflict with another variable that might have the same name.)
- imageFieldName - The name of the field in the current record that contains the image to display, joined to the object name by a "dot" (.).
- Result
- The URL for the image is inserted into the generated page. When viewed, the image is displayed.
- Example
- <img src=”IMG{$Customer.logo_image}”>
Inserting a Chart
To insert a chart into a Print Template, use the platform CHART tag in an HTML img element.
- Format
- <img src="CHART{$report_id}">
- <img src="CHART{$report_id, chart-title=Your Title, field1=value, ...}">
where:
- report_id - A required argument that gives the ID of the report that generates the chart.
- chart-title - An optional argument containing text for a chart title.
- field1 - An optional record field. Only records with a matching value will be included in the generated chart. Up to three fields and values can be specified in the comma-separated list. (More can be specified, but only the first three are used.)
- Result
- A URL for the generated chart is inserted into the generated page. When viewed, the chart image is displayed.
Example #1 - Inserting a chart with no optional arguments:
- <img src="CHART{c5cc43653b1b49db8142bc844735c209}">
Example #2 - Inserting a chart of Orders taken by the owner of the current record:
- <img src="CHART{c5cc43653b1b49db8142bc844735c209, chart-title=Orders by $Order.owner.full_name, owner_id=$Order.owner.id}">