You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 10 Next »

Data Mapping is a very common task in the integration business. The Designer offers you a powerful tool to define data mappings directly by drawing object flows between the properties of the related classes.

You can create a mapping diagram by creating a mapping operation on a class. The mapping diagram is based on the data model contained in the Implementation folder. It defines mappings between the data structures defined in this data model. You cannot change the data model in the mapping diagram, all attributes are read-only.

Refer to Modeling Data Structures for more details on how to create a class operation.

Adding a Mapping Diagram

From the quick actions of a class, select to add an mapping operation.

Enter a name for the operation and click Save.

Restrictions on Element Names

A BPMN model name must be unique within one service.

In addition, the following name restrictions apply to all service panel elements:

Element names...

  • ... must not be empty.
  • ... must not contain spaces. Exception: Spaces are allowed in operation names.
  • ... must not start with numbers.
  • ... must not end with a period (.).
  • ... must not contain one of the following characters: <, >, :, ", /, \, |, ?, *
  • Furthermore, the following strings must not be used as element names: CON, PRN, AUX, NUL, COM1, COM2, COM3, COM4, COM5, COM6, COM7, COM8, COM9, LPT1, LPT2, LPT3, LPT4, LPT5, LPT6, LPT7, LPT8, LPT9.

Alternatively, you can open the context menu of the class and select the option Add Operation.

The dialog Add Operation opens.

Select Mapping Diagram from the drop-down list, enter a name for the operation and click Save.

The new operation has been added to the class. It opens automatically in a new Designer tab, and you can directly start modeling your activity.

Go to Working with the Activity Editor for detailed information.

Once the mapping operation has been created, you can use the quick actions and the context menu to manage it.

You can:

  • add a parameter
    • in
    • out
    • return
  • open the implementation of the mapping diagram
  • change the implementation from mapping diagram to action script or activity diagram
  • cut the mapping operation
  • copy the mapping operation
  • paste the mapping operation (available if Copy or Cut option have been used before)
  • rename the mapping operation
  • delete the mapping operation

Refer to Implementation and Modeling Data Structures for more information on your options here.

Refer to Modeling Data Structures for more information on how to create classes and operations.

Mapping Editor Overview

When you create a new mapping diagram, it is automatically opened in the Mapping Editor:

Use the various functionalities of the Mapping Editor to create your mapping diagram:

NameDescription
1 Mapping Editor
The mapping editor is where you draw your data mappings.
Go to page Working with the Mapping Editor for detailed information about the features of the editor.
2 Elements Toolbar
The elements toolbar contains all elements that you can create in the mapping editor.
Go to page Working with the Mapping Editor for further details about the usage of the toolbar.
3 Model Toolbar

The model toolbar of the mapping editor offers the following:

IconDescription
Click on this icon to highlight the operation in the Service panel.
Go to page Service Panel for further information about this panel.
Click on this icon to reload the mapping diagram.
4 Designer Panels

In the mapping editor, the following panels assist you during modeling:

  • Service Panel: In the Service panel you can access your libraries and your data model.
    Go to Working With Libraries for detailed information.
  • Attributes Panel: Use the Attributes panel to change the settings of the data model elements.
  • Validation Panel: The Validation panel supports you during modelling by displaying notes for invalid actions in your models or forms. It also gives advice on how to fix the errors.
    Go to Validating a Service
    for detailed information.
  • Search Panel: Use the Search panel to find elements in the mapping editor.
    Go to Searching in the Designer for detailed information.

On this Page:

Simple_Data_Mapping_Example

Click the icon to download a simple example model that shows how to implement simple mappings in Scheer PAS Designer.

Go to chapter Mapping Data Structures in the PAS Designer Developer Guide for more mapping examples.

  • No labels