Hitachi

uCosminexus Service Platform Reference Guide


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.

Figure 1‒29: Data Transformation (Mapping) Definition window

[Figure]

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.

Figure 1‒30: Source schema tree viewer, mapping viewer, and target schema tree viewer

[Figure]

Node

These are the schema logical names, elements, and attributes of XML schemas.

The icons displayed for nodes and their meanings are explained below.

  • Schema logical name ([Figure])

    Indicates a logical name for identifying an XML schema file.

  • Complex content ([Figure])

    Indicates a complex element that has a complex content.

  • Simple content ([Figure])

    Indicates a complex element that has both a simple element and simple content.

  • Attribute ([Figure])

    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 ([Figure]) and the other type is a non-mapping-target node adapter ([Figure]). 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.

Figure 1‒31: Palette (Data Transformation Definition window)

[Figure]

Group

Functions of the same type are gathered into a group. A group is preceded by a folder icon ([Figure]). 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.

Table 1‒8: Groups and tools on the palette (Data Transformation Definition window)

Icon

Display name

Explanation

[Figure]

Select node

Selects functions and mapping lines in the mapping viewer.

[Figure]

Marquee

Selects the functions and mapping lines contained inside the rectangular frame.

[Figure]

Mapping

Mapping lines for connecting nodes and functions.

[Figure]

Character string

Group made up of all string-related functions.

[Figure]

concat

String-concatenating function.

[Figure]

substr

Substring-acquiring function.

[Figure]

length

String-length-acquiring function.

[Figure]

contain

String-checking function.

[Figure]

trim

Node-trimming function.

[Figure]

Number

Group made up of all number-related functions.

[Figure]

format

Number format conversion function.

[Figure]

calc

Node operation function.

[Figure]

round

Node-rounding function.

[Figure]

sum

Node summing-up function.

[Figure]

bit

Group made up of all bit-related functions

[Figure]

not

NOT operation function

[Figure]

bitop

Logical operation function

[Figure]

shift

Shift operation function

[Figure]

node

Group made up of all node-related functions.

[Figure]

name

Node name-acquiring function.

[Figure]

count

Node count-acquiring function.

[Figure]

exist

Node-checking function.

[Figure]

Control

Group made up of all functions that control mapping.

[Figure]

loop

Node-looping function.

[Figure]

choose

Node-choosing function.

[Figure]

Other

Group made up of all functions that do not belong to any other group.

[Figure]

replace

Change value function.

[Figure]

radix

Radix conversion function

[Figure]

custom

Custom function.

[Figure]

const

Constant-setting function.

[Figure]

xpath

XPath function.