This section describes how to edit date formatter. The subsections are updating, removing and reordering its data mappings.
To edit a data formatter includes updating Mapping source or target of a data mapping, removing and reordering data mappings. These tasks are all based on the Data Mapping editor, so the first step is to launch the Data Mapping editor.
Procedure
Select the transition or state which has the data mapping and click 'edit' button beside the Mapping name.
If you switch 'Simple Mapping' to 'Mapping flow', this data Mapping would be removed.
This section describes how to modify the mapping source or target of an existing data mapping.
1 In the pop-up Data Mapping editor, select the data mapping from the table on the bottom.
Note Once a mapping is selected, you could see the mapping source and the target displayed and highlighted on the top panels and proceed to edit them if required, including updating data mapping and removing data mapping.
2 Re-select the new mapping source or target or both that you want to update.
3 Click Update.
Use CTRL+Z to undo the previous operation, or CTRL+Y to redo it.
4 Click OK.
The data formatter is saved into the Transaction file and can be viewed in the Format tab of the Transaction editor.
This section describes how to remove data mappings from the formatter.
1 Do one of the following:
▪ To remove one data mapping, select the data mapping in the table at the bottom of the Data Mapping window, and then click Unbind.
▪ To remove all the data mappings that are defined for the data formatter, click Unbind All. In this case, the data formatter still exists and will be called to format data, but it will do nothing.
Use CTRL+Z to undo the previous operation, or CTRL+Y to redo it.
2 Click OK.
The data formatter is saved into the Transaction file, and can be viewed in the Format tab of the Transaction editor.
This section describes how to define the execution sequence of data mappings.
You can define several mappings associated to either an Output Mapping or an Input Mapping. These mappings will be sequentially executed at runtime according to the list order of mappings on the mapping table. In order to change the order of execution of already defined mappings, the Mapping Editor provides drag and drop capabilities.
1 Click the data mapping or Condition you want to relocate from the mapping table.
2 Drag it to the new position in the mappings list. The black line stands for two situations.
▪ If the line vertically parallels with the upper-level element, it is in the same level as the upper-level element. In this case, the mapping would be in the same level as mapElseIf and executed no matter whether mapElseIf would happen or not.
▪ If the line vertically parallels with the lower-level element, it is in the same level as the lower-level element. In this case, the mapping would be under mapElseIf and executed only if mapElseIf would happen.
There are some rules when reordering data mapping:
▪ You need to make sure data mappings at the same level have different Mapping targets.
▪ You need to follow the restrictions on valid Condition group.
▪ In Conditional mappings, when the data mapping or nested Conditions are hidden, they would be moved with the Condition.
▪ Data mappings in RefFormatter cannot be edited or reordered.
Use CTRL+Z to undo the previous operation, or CTRL+Y to redo it.
3 Click OK.
The data formatter is saved into the Transaction file and can be viewed in the Format tab of the Transaction editor.
