Difference between revisions of "Create a PowerPoint Document Template"
From AgileApps Support Wiki
imported>Aeric |
Wikieditor (talk | contribs) |
||
(16 intermediate revisions by one other user not shown) | |||
Line 1: | Line 1: | ||
A PowerPoint file can also be used as a document template. | |||
:''Learn more:'' [[Document Templates]] | |||
__TOC__ | |||
==Creating the Template File== | |||
#On your local system, create a PowerPoint presentation. | #On your local system, create a PowerPoint presentation. | ||
# Add boilerplate text and fixed graphics. | # Add boilerplate text and fixed graphics. | ||
Line 5: | Line 8: | ||
# Insert template variables, record-specific images, and/or charts, as explained below. | # Insert template variables, record-specific images, and/or charts, as explained below. | ||
# Saved it in <tt>.pptx</tt> format. | # Saved it in <tt>.pptx</tt> format. | ||
{{Note| | {{Note| | ||
:* The <tt>.pptx</tt> file is stored in an XML format the platform can work with. | |||
:* A <tt>.ppt</tt> file is in a binary (numeric) format that won't work. | |||
:* The <tt>.pptx</tt> format does not support Related record variables. | |||
:* The AgileApps document template feature does not support the documents generated through Microsoft cloud www.office.com}} | |||
==Working with Template Variables== | |||
===Inserting Template Variables=== | ===Inserting Template Variables=== | ||
# Begin to [[Add a | # Begin to [[Add a Document Template]] or '''[Edit]''' an existing template.<br>The [[Template Variable Tool]] appears. | ||
#:[[File:TemplateVariableTool.jpg]] | |||
#: | |||
# Select the '''Category''' of fields to choose from.<br>(Fields in the current object or [[Related Objects]], User fields, or Company fields) | # Select the '''Category''' of fields to choose from.<br>(Fields in the current object or [[Related Objects]], User fields, or Company fields) | ||
# Under '''Fields''', scroll down the list to find fields in the current record or in a [[Lookup]] target record. | # Under '''Fields''', scroll down the list to find fields in the current record or in a [[Lookup]] target record. | ||
Line 14: | Line 25: | ||
# Copy the variable name to the clipboard. | # Copy the variable name to the clipboard. | ||
# In the template file, paste the variable name you copied. | # In the template file, paste the variable name you copied. | ||
===Testing Boolean Values=== | |||
{{:Common:Testing Boolean Values in Velocity}} | |||
===Convert Currency Variables to Numbers=== | |||
{{:Common:Convert Variables to Numbers}} | |||
==Inserting an Image Stored in an Object Record== | |||
To insert an image: | |||
# Select a placeholder image to replace. | |||
# Right click on the image. Choose '''Size and Position...''' | |||
# Click the '''Alt Text''' tab | |||
# In the '''Alternative Text''' area, type in a platform <tt>IMG</tt> tag | |||
{{:IMG Tag}} | |||
;Example: | |||
:<tt><nowiki>IMG{$Customer.logo_image}</nowiki></tt> | |||
<!-- | |||
===Inserting a Chart=== | |||
To insert a chart: | |||
# Select a placeholder image to replace. | |||
# Right click on the image. Choose '''Size and Position...''' | |||
# Click the '''Alt Text''' tab | |||
# In the '''Alternative Text''' area, type in a platform <tt>CHART</tt> tag | |||
{{:CHART Tag}} | |||
'''Example #1 -''' A chart with no optional arguments: | |||
:<tt><nowiki>CHART{c5cc43653b1b49db8142bc844735c209}</nowiki></tt> | |||
'''Example #2 -''' A chart of Orders taken by the owner of the current record: | |||
:<tt><nowiki>CHART{c5cc43653b1b49db8142bc844735c209, chart-title=Orders by $Order.owner.full_name, owner_id=$Order.owner.id}</nowiki></tt> | |||
--> | |||
<noinclude> | |||
[[Category:Presentation | 5]] | |||
[[Category:Tutorials]] | |||
</noinclude> |
Latest revision as of 07:05, 17 February 2022
A PowerPoint file can also be used as a document template.
- Learn more: Document Templates
Creating the Template File
- On your local system, create a PowerPoint presentation.
- Add boilerplate text and fixed graphics.
- Add placeholder images for any record images or charts you plan to add. Size them appropriately.
- Insert template variables, record-specific images, and/or charts, as explained below.
- Saved it in .pptx format.
Note:
- The .pptx file is stored in an XML format the platform can work with.
- A .ppt file is in a binary (numeric) format that won't work.
- The .pptx format does not support Related record variables.
- The AgileApps document template feature does not support the documents generated through Microsoft cloud www.office.com
Working with Template Variables
Inserting Template Variables
- Begin to Add a Document Template or [Edit] an existing template.
The Template Variable Tool appears. - Select the Category of fields to choose from.
(Fields in the current object or Related Objects, User fields, or Company fields) - Under Fields, scroll down the list to find fields in the current record or in a Lookup target record.
- Select the field to add.
The variable name appears. - Copy the variable name to the clipboard.
- In the template file, paste the variable name you copied.
Testing Boolean Values
Boolean values are seen in Velocity as strings with the value "Yes" or "No". So a test of a boolean field looks something like this:
- #if ($BooleanField == "Yes"), or
- #if ($BooleanField == "No")
Or, similarly,
- #if ($BooleanField != "Yes"
- #if ($BooleanField != "No")
Convert Currency Variables to Numbers
When you want to do calculations on a currency field in Velocity, you need to create a number from the currency strings delivered by the platform. That string has the form $24.95. The following code converts it to a number that can be used in calculations:
- <syntaxhighlight lang="html4strict" enclose="div">
- set($n = 0.00)
- set($s = $YourObject.currency_field.substring(2) )
- set($n = $n.parseDouble($s)
</syntaxhighlight> where:
- $n = 0.00 creates an instance of the double-precision float class (Double)
- $YourObject.currency_field.substring(2) removes the first two characters from the currency string. (The $ sign and the space that follows it.)
- parseDouble($s) converts the resulting string into a double-precision float--a number that can be used in calculations.
Inserting an Image Stored in an Object Record
To insert an image:
- Select a placeholder image to replace.
- Right click on the image. Choose Size and Position...
- Click the Alt Text tab
- In the Alternative Text area, type in a platform IMG tag
- IMG Tag
- IMG{$objectName.imageFieldName}
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" (.).
- Result
- The URL for the image is inserted into the generated page. When viewed, the image is displayed.
- Example
- IMG{$Customer.logo_image}