There are two ways to map a merge field to a system field.
•If you correctly name the merge field as described in Automatically Mapped System Fields, then the mapping is done automatically when you open the RTF in the Data Mapping tool.
•If you created the merge field using your own name for it, you must perform the mapping in the Data Mapping tool.
See Locating the Data Mapping Tool for more information.
The following table provides examples of how to navigate to certain commonly-used system field values for Document Generator templates if your starting object is a custom object (project), such as Matter.
Navigation to Commonly-used System Fields
System field |
Navigation steps |
Resulting path |
Note: These examples are for a document template that is based on a custom object. |
||
Project Name |
1 name (ok) |
.name |
Project Number |
1 numberString (ok) |
.numberString |
Project's Default Category |
1 defaultCategory-> (traverse) 2 name (ok) |
.defaultCategory.name |
Contact-centric contact's last name |
1 contact-> (traverse) 2 name (ok) |
.contact.name |
Contact-centric contact's first name |
1 contact-> (traverse) 2 firstName (ok) |
.contact.firstName |
Contact-centric contact's default address |
Must have a separate merge field for each field in the address. Example navigation: 1 contact-> (traverse) 2 defaultAddress-> (traverse) 3 street (ok) |
Examples: •contact.defaultAddress.street •contact.defaultAddress.city •contact.defaultAddress.state •contact.defaultAddress.postalCode |
Main assignee's last name |
1 mainAssignee-> (traverse) 2 user-> (traverse) 3 contact-> (traverse) 4 name (ok) |
.mainAssignee.user.contact.name |
Main assignee's first name |
1 mainAssignee-> (traverse) 2 user-> (traverse) 3 contact-> (traverse) 4 firstName (ok) |
.mainAssignee.user.contact.firstName |
Main assignee's role |
1 mainAssignee-> (traverse) 2 type-> (traverse) 3 name (ok) |
.mainAssignee.type.name |
Current Phase |
1 currentPhaseType- > (traverse) 2 name (ok) |
.currentPhaseType.name |
A system field from the parent record of the project |
1 parent-> (traverse) 2 Then, navigate as described for the needed parent system field. |
Examples: •.parent.numberString •.parent.mainAssignee.user.contact.name |
Name of an assignee with a certain role |
Map a loop@ merge field to assigneeList->, as described in loop@ Merge Field Mapping. Or, map a filter@ merge field to assigneeList-> if you want the user to select the assignee. See filter@ Merge Field Mapping. |
|
A system or custom field from a child record of the project (or from an embedded object record) |
Map a filter@ merge field to childList->, as described in filter@ Merge Field Mapping. |