uCosminexus Service Platform, Basic Development Guide

[Contents][Glossary][Index][Back][Next]

5.6.6 Data Transformation Activity

This activity defines data transformation processing.

You can define the details of data transformation activities in the Data Transformation Activity dialog box.

You can also use the Data Transformation Definition screen to create definition information for data transformation methods (as a data transformation definition file).

Organization of this subsection
(1) Definition procedure
(2) Processing when a system exception occurs in an activity
(3) Notes on definition

(1) Definition procedure

To define a data transformation activity:

  1. Deploy a data transformation activity on the canvas.
    For details about how to deploy activities, see 5.4.1 Deploying Activities.
  2. Use one of the following methods to open the Data Transformation Activity dialog box:
    • Double-click a data transformation activity on the canvas (only if the Launch Mapping Definition Editor menu is inactive).
    • Select and right-click a data transformation activity on the canvas, and then select Setting.
    The Data Transformation Activity dialog box appears.
  3. Enter the necessary information in the Data Transformation Activity dialog box.
    For details about the display and input contents of the Data Transformation Activity dialog box, see 1.4.11 Data Transformation Activity Dialog in the manual uCosminexus Service Platform Reference Guide.
    To edit the contents of the variables specified in Source Variables and Destination Variable, click Edit. The List Of Variables And Correlation Sets dialog box appears. In this dialog box, you can edit the contents of the variable. In Source Variables and Destination Variable, you cannot specify a variable of the message type (any). Instead, specify a variable of the message type (XML or non-XML). For details about the List Of Variables And Correlation Sets dialog box, see 1.4.1 List Of Variables And Correlation Sets Dialog in the manual uCosminexus Service Platform Reference Guide.
  4. Click OK in the Data Transformation Activity dialog box.
    The Data Transformation Activity dialog box closes.
  5. Double-click a data transformation activity on the canvas, or right-click it and then select Launch Mapping Definition Editor.
    The data transformation definition screen opens.
    If the message format was changed, a dialog box appears to confirm whether to apply the change in the message format. For details, see 6.3.2 Procedure for defining changed message formats.
  6. In the Data Transformation Definition screen, create a data transformation definition file.
    For details about how to create a data transformation definition file, see 6.3 Defining Data Transformation.
    For details about the Data Transformation Definition screen, see 1.2.5 Data Transformation Definition Window in the manual uCosminexus Service Platform Reference Guide.
    Note that the created data transformation definition file is saved in a temporary directory until the business process is saved. When the business process is saved, the data transformation definition file is stored in the repository.

Note
The data transformation definition file specified in DataTransDefnFile in the Data Transformation Activity dialog box is saved in the repository. Then, you can change only the part specifications for variables and message formats in the information for the variables specified in Source Variables and Destination Variable. If you want to change any information other than part specifications for variables and message formats, click Delete File.
In this case, even if you click Delete File, the data transformation definition file is not deleted from the repository. The data transformation definition file is deleted from the repository when the business process is saved.

(2) Processing when a system exception occurs in an activity

A system exception that occurs in an activity can be transformed into a general fault before being output. For details, see 4.7 General fault for converting system exceptions to faults in the manual Service Platform Overview.

(3) Notes on definition