Groovy is a java-compliant scripting language used to customize the processing of objects and fields in Gateway. Use Groovy expressions to manipulate objects and fields in:
- Field mapping templates
- File Parsers
- File Generators
This example shows how to add a new field mapping template containing Groovy code.
Prerequisites
You have configured Primavera Gateway with P6 and Sample deployments.
Procedure
To create a new field mapping template with Groovy code for a Resource business object in P6:
- In the sidebar, select Configuration.
- Select the Field Mapping Templates tab.
- From the Select Business Object list, select Resource, and then select Add....
- In the General step:
- Enter a Template Name, Groovy Field Mapping for Resource.
- Select Template Type as Groovy.
- Select Provider 1 as Sample.
- Select Provider 2 as P6.
- Select Object 1 as Resource.
- Select Object 2 as Resource.
- In the left pane of the Mappings step, the source fields are in the Sample provider, and the target fields are in the Gateway:
- Select the Direction as Provider 1 (Sample) to Gateway.
- Select Employee Name from the Source Fields list.
- Select Name from the Target Fields list.
- In the Groovy Expression text box, enter the following code:
if (containsField("EmployeeName")){{Name} = [EmployeeName].toUpperCase();}} - Select Validate Expression to ensure the syntax is valid.
- In the right pane of the Mappings step, the source fields are in the Gateway and the target fields are in the P6 provider:
- Select the Direction as Gateway to Provider 2 (P6).
- Select Name from the Source Fields list.
- Select Name from the Target Fields list.
- In the Summary step, review all selections and select Save.
The Groovy Field Mapping for Resource template will now be available in the Field Mappings tab of the Project Data page for the Resource object.
Tips
- You can also edit a field-mapping template and select Save in any step to exit the wizard.