Document Template Classes

From AgileApps Support Wiki
Revision as of 21:19, 5 April 2012 by imported>Aeric

This page is currently in progress...

About Print Template Classes

As far as a Print Template is concerned, a data object is simply a HashMap in the TemplateContext. By manipulating the HashMap(s) it contains, you change the data that the Print Template has available for processing.

  • Template reference: $objectName.fieldname
  • Retrieve a data object: TemplateContext.get(objectName)
  • Add or update a data object: TemplateContext.put(objectName)
  • Get a field from data object:
  • Add or update a field in a data object:

Configuring a Print Template to use a Specified Class and Method

--select the class, and the method to use

Methods that take following arguments are listed:

  • com.platform.api.TemplateContext - The container that the print template gets its data from.
  • String (objectName) - The name of the object the print template was invoked on.
  • String (recordID) - The ID of the record on which it was invoked.

__TBD: TemplateContext is in new javadocs, yes? objectName is passed in, yes? Does return value have to be void?__

Accessing Lookup Target Records

Data from lookup-target records is stored as a nested map. So to get data for the template variable $Order.customer.name:

  1. HashMap orderMap = TemplateContext.get("Order") gets the Order HashMap from the context.
  2. HashMap customerMap = orderMap.get("customer") gets the lookup-target record for the customer field.
  3. String name = customerMap.get("name") gets the customer's name.

Examples

Changing Field Data

<syntaxhighlight lang="java" enclose="div">

</syntaxhighlight>

Example: Adding a New Field

<syntaxhighlight lang="java" enclose="div">

</syntaxhighlight>

Example: Adding a New Object

<syntaxhighlight lang="java" enclose="div">

public void processTemplate(TemplateContext context, String objectName,String recordId)

HashMap<String, Object> map = new HashMap<String, Object>(); map.put("CompanyName", "Tulip"); map.put("Phone", "408-230-0987"); context.put("Company",map); </syntaxhighlight>