1.2.4 Data Transformation Definition Window
You can define data transformation by using the mapping definition editor.
For the operation method, see 1.13 Operations in the Data transformation definition Window.
- Organization of this subsection
(1) Source schema tree viewer, mapping viewer, and target schema tree viewer
Map nodes in the source schema tree viewer to nodes in the target schema tree viewer. In the mapping viewer, you can deploy functions selected from the palette, and connect node adapters and functions with mapping lines.
The items in the source schema tree viewer, the mapping viewer, and the target schema tree viewer are shown in the following figure and explained below.
- Node
-
These are the schema logical names, elements, and attributes of XML schemas.
The icons displayed for nodes and their meanings are explained below.
-
Indicates a logical name for identifying an XML schema file.
-
Indicates a complex element that has a complex content.
-
Indicates a complex element that has both a simple element and simple content.
-
Indicates the attribute of an element.
The value inside the square brackets ([ ]) following the node indicates the occurrence count of the node. The occurrence count is displayed in the following format:
- [minimum-occurrence-count:maximum-occurrence-count]
-
If there is no upper limit for the maximum occurrence count, an asterisk (*) is displayed.
If both the minimum occurrence count and the maximum occurrence count are 1, no occurrence count is displayed.
You can copy a path to the clipboard by selecting and right-clicking the path and then clicking Copy Element Path in the context menu. In the case of N-to-one transformation, the path including $schema-logical-name (business-process-variable-name) is copied.
-
- Node-mapping line
-
A line that indicates mapping between a node and a node adapter.
- Node adapter
-
Node adapters are displayed for all nodes. Map the source node adapters to target node adapters by connecting those using mapping lines. There are two types of node adapters. One type is a mapping-target node adapter () and the other type is a non-mapping-target node adapter (). For details about the mapping targets and non-mapping targets, see the description of mapping conditions in the manual Service Platform Basic Development Guide.
Note that you cannot scroll node adapters with the scroll bar displayed in the mapping viewer. You can move the scroll bar displayed in the transformation destination schema tree viewer scroll to scroll the node adapters.
(2) Palette
From the tools on the palette, select the functions to be deployed in the mapping viewer. Also select mapping lines to connect node adapters and functions.
The items on the palette are shown in the following figure and explained below.
- Group
-
Functions of the same type are gathered into a group. A group is preceded by a folder icon (). Clicking a group hides the tool list under the group. When the tool list is hidden, a list of tools is displayed.
- Tool
-
A tool can be a function or a mapping line, for example. You can deploy the functions that you have selected in the mapping viewer, or map node adapters and functions with mapping lines.
The following table lists the groups and tools on the palette.
Icon |
Display name |
Explanation |
---|---|---|
Select node |
Selects functions and mapping lines in the mapping viewer. |
|
Marquee |
Selects the functions and mapping lines contained inside the rectangular frame. |
|
Mapping |
Mapping lines for connecting nodes and functions. |
|
Character string |
Group made up of all string-related functions. |
|
concat |
String-concatenating function. |
|
substr |
Substring-acquiring function. |
|
length |
String-length-acquiring function. |
|
contain |
String-checking function. |
|
trim |
Node-trimming function. |
|
Number |
Group made up of all number-related functions. |
|
format |
Number format conversion function. |
|
calc |
Node operation function. |
|
round |
Node-rounding function. |
|
sum |
Node summing-up function. |
|
bit |
Group made up of all bit-related functions |
|
not |
NOT operation function |
|
bitop |
Logical operation function |
|
shift |
Shift operation function |
|
node |
Group made up of all node-related functions. |
|
name |
Node name-acquiring function. |
|
count |
Node count-acquiring function. |
|
exist |
Node-checking function. |
|
Control |
Group made up of all functions that control mapping. |
|
loop |
Node-looping function. |
|
choose |
Node-choosing function. |
|
Other |
Group made up of all functions that do not belong to any other group. |
|
replace |
Change value function. |
|
radix |
Radix conversion function |
|
custom |
Custom function. |
|
const |
Constant-setting function. |
|
xpath |
XPath function. |