uCosminexus Service Platform, Basic Development Guide
(1) Defining new data transformation
To define new data transformation:
Note that the procedure for defining data transformation varies according to the method displaying the Data Transformation Definition screen.
(a) Method for displaying from data transformation activity of the Adapter Definition screen or Business Process Definition screen
- Open the Data Transformation Definition screen from the Service Adapter Definition screen or from a data transformation activity in the Business Process Definition screen.
The Data Transformation Definition screen opens, and then the Root Element Chooseion dialog box opens.
For details about the Data Transformation Definition screen and the Root Element Chooseion dialog box, see the manual Cosminexus Service Platform Reference.
- Choose the root elements of all schema logical names.
The OK button becomes enabled.
- Click OK.
The schemas of the selected root elements are displayed in a tree in the transformation-source schema tree viewer and the transformation-destination schema tree viewer.
- Execute mapping.
For details about mapping, see 6.4 Mapping.
- In the Data Transformation Definition screen, right-click an appropriate location in the transformation-source schema tree viewer, mapping viewer, or transformation-destination schema tree viewer, and choose Validation.
Validation is executed.
- Note
- If you click Cancel in step 3, an error message appears. Click OK in the dialog box displaying the error message to reopen the Choose root element dialog box.
(b) To display from the Eclipse menu
- In the Eclipse menu, choose File, New and Others.
The dialog box for choosing the wizard appears.
- Choose HCSCTE mapping definitions and Mapping definition file and then click Next.
The New mapping definition file dialog box appears.
- Enter the directory for saving the Mapping Definition file and the file name and then click Next.
- Choose the transformation-source and destination schemas and then click End.
The Data Transformation Definition screen appears and then the Choose root element dialog box appears. For details about the Data Transformation Definition screen and the Choose root element dialog box, see Cosminexus Service Platform Reference.
- Choose root elements of all schema logical names.
You can now click OK.
- Click OK.
The tree of the schema of the selected root element appears in the transformation-source and destination schema tree viewers.
- Map.
For details about mapping, see 6.4 Mapping.
- Right click the applicable location in the Data Transformation Definition screen and then choose Create data transformation definition.
The dialog box for specifying the directory for saving the data transformation definition and the file name appears.
- Specify the directory for saving the data transformation definition and the file name and then click Save.
Validation is executed and the data transformation definition is saved.
- Note
- If Cancel is clicked in Step 6., an error message appears. Click OK in the dialog box displaying the error message to reopen the Choose root element dialog box.
(2) Editing already defined data transformation
To edit already defined data transformation:
- Open the Data Transformation Definition screen from the Service Adapter Definition screen or from a data transformation activity in the Business Process Definition screen.
The Data Transformation Definition screen for already defined data transformation opens.
For details about the Data Transformation Definition screen, see the manual Cosminexus Service Platform Reference.
- Change the root element as needed.
For details about how to change the root element, see 6.3.1(3) Changing the Root Element.
- Edit the mapping.
For details about mapping, see 6.4 Mapping.
- In the Data Transformation Definition screen, right-click an appropriate location in the transformation-source schema tree viewer, mapping viewer, or transformation-destination schema tree viewer, and choose Validation.
Validation is executed.
After you have displayed schemas in a tree view by selecting a root element, you can change the root element. The procedure for changing the root element is described below. Note that the method to change the root element varies according to the display method of the Data Transformation Definition screen.
(a) If the Data Transformation Definition screen is displayed from the data transformation activity of the Adapter Definition screen or Business Process Definition screen
- Right-click a schema logical name in the transformation-source schema tree viewer or the transformation-destination schema tree viewer, and choose Choose Root Element.
The Root Element Chooseion dialog box opens.
- Change the root element of the schema logical name.
- Click OK.
The schemas of the changed root element are displayed as a tree in the transformation-source schema tree viewer and the transformation-destination schema tree viewer.
If you executed mapping with the root element prior to the change, a message box opens, informing you that the content edited prior to the change will be discarded. To discard the content edited prior to the change and display the schemas of the newly selected root element, click OK.
(b) If the Data Transformation Definition screen is displayed from the Eclipse menu
- Right click the schema logical name of the transformation-source and destination schema tree viewers and choose Choose root element.
Setting transformation-source and destination schema files dialog box appears.
- Choose the transformation-source and destination schemas.
In the Setting transformation-source and destination schema files dialog box, the file specified previously is set. To retain the file specified previously, do not reset the file.
- Click OK.
The Choose root element dialog box appears.
- Change the root element of the schema logical name.
- Click OK.
The transformation-source and destination schema tree viewers display trees of the changed root element schemas.
If the status before change was mapped, a dialog box appears stating that contents edited before change are destroyed. To destroy contents edited before change and to open the tree of the new selected root element schema, click OK.
All Rights Reserved. Copyright (C) 2015, Hitachi, Ltd.