AgileApps Support Wiki Pre Release

Document Templates

From AgileApps Support Wiki
Revision as of 21:23, 19 July 2011 by imported>Aeric (→‎How it Works)

Designer > Presentation > Print Templates

Print templates are powerful tools, allowing you to set up documents that pull information from a specific object and merge into an HTML or JSP page. Print templates are loaded into the platform and can be used to set up standard proposals, queries, contracts, invoices, etc., and generate PDF documents unique to specific records - any document that you can dream up.

Examples

  • Create an Expense Report to be used in expense management application
  • Print an Employee Benefit Form

Notepad.png

Note: Print templates are created outside of the platform, using an HTML editor. Once created, they can be downloaded, edited, and uploaded again.

How it Works

The Print Templates feature lets you generate graphical mail-merge-style PDF documents using variables and HTML. You can use these templates to create prefilled forms, invoices, contracts, and other types of documents using data stored in your application. The platform uses the Apache Velocity templating engine to create powerful dynamic documents.

Learn more: http://velocity.apache.org
  • Before you add a print template, you first create an HTML document (on your local file system) or JSP Page (in the platform) that includes all of the text, images, logic, etc. that you want to include in your template.
    Learn more: HTML Resources
  • While creating this document, you should make note of the fields you want to add to the document.
  • Use the Template Variable Tool to get the field names you need to customize the HTML file.

Some features to consider when building print templates:

  • CSS styles can be embedded into the HTML file, giving you a high degree of control of the final output of the file.
  • Images can be placed into your document server and accessed by the template via Web access.
  • Using the Velocity scripting language, you can build logic directly into the template to change the content based on specific customer parameters.

Add a Print Template

Add a Print Template

Edit a Print Template

  1. Click Designer > Data > Objects > {object} > Print Templates
  2. Click the Download link on the template you want to copy to your local system.
  3. Make changes to the template.
  4. If you need additional variable names, click the [New Template] button to access the Template Variable Tool:
    TemplateVariableTool.jpg
  5. If the New Template window is open, click [Cancel] to close it and go back to the Templates (record list) view.
  6. Click the Replace link on the template to upload the modified template.

Warn.png

Warning: Be sure to click the right link. The existing template page will be replaced by the new one.

Use the Template

  1. Open an object record.
  2. Click the [Print] button to create an HTML page using the Print Template.
  3. Copy content from the resulting HTML page, print it, or save the page to your local system.

See Also

Sample print templates are available for use and customization.

[[Category:Template:Features]]