Skip to end of metadata
Go to start of metadata

Introduction

Custom values are hard-coded values that can be mapped to a target field in either mapping mode or script mode.

Mapping to a Target Field

Custom values can be added using a visual interface for any target fields that do not already have a mapping. From either mapping mode or script mode, hover over the target field, then click the plus icon  to open an actions menu. From the menu, select Add Custom Value:

A custom entry field will open where you can enter a hard-coded value:

After a custom field is created, to edit the custom value, simply click on the field to bring it back to edit mode. Then edit the custom value accordingly.

NOTE: If a field is flagged as invalid after adding a custom value, it may contain characters that are causing the underlying script to be invalid. In this situation, you can open the target field script directly, as covered next, where you can use the validation information to edit the script.

For fields that already have a mapping, you must enter the value directly in a script on the target field. To add a new script on a target field, in either mapping mode or script mode, hover over the target field and click the plus icon  in the upper right to open a menu of actions. From the menu select Add Script:

This opens the editable script area on the target field in script mode, where you can enter the custom value along with any other script logic:

For a larger script area to work within, click the popout icon  in the upper right of the target field, which opens the full script editor. Once within the full script editor, click the return icon  to come back to this screen.

Removing a Mapping

You can remove target field mappings one at a time, or all at once for all field mappings contained within a node or all invalid field mappings contained within a node.

Remove a Single Field Mapping

To remove a single custom value mapping from a target field, or unmap the field, hover over the custom value within the target field and click the trash icon :

If the custom value is used in combination with any other script logic, you must edit the script to remove the custom value mapping, or clear the contents of the target field script to remove the entire mapping. To open the script for editing, click the script icon  on the target field. Then manually clear the contents of the target field script to remove the mapping.

Remove Multiple Field Mappings

To remove all target field mappings contained within a node, from either mapping mode or script mode, hover over a node name and click the actions menu icon  to open the actions menu. From the menu, select Clear mappings beneath this node:

This will delete all mappings on fields contained within the node, as well as all mappings on fields contained within sub-nodes of that node. Upon selecting this option, a message will ask you to confirm that you want to delete mappings. Note that using this option on a root node will remove all mappings from the transformation.

To remove only invalid target field mappings contained within a node, from either mapping mode or script mode, hover over a node name and click the actions menu icon  to open the actions menu. From the menu, select Clear invalid mappings only:

This will delete all invalid mappings on fields contained within the node, as well as all invalid mappings on fields contained within sub-nodes of that node. For more information about invalid mappings, see Transformation Mapping Validity.

On This Page

Last updated:  Mar 03, 2020

  • No labels