Mapping

Figure 1: Mapping Example Mappings are Modeling Blocks inside Workflows that are typically used to create or transform parameters. They offer the opportunity to directly model copying or simple calculations between given Input and Output Parameters. The possibilities of Formula Modeling will help to create complex mapping instructions.

Table of Contents Create a Mapping Add Formulas Supported Mapping Operations See Also

Create a Mapping

Figure 2: Prototype Service

There are two ways to create a Mapping:

• Drag the Mapping symbol out of the icon bar into the Workflow and add Input Parameters and Output Parameters.
• Alternatively it can be created from a Prototype Service. Therefor insert a Prototype Service into the Workflow and add Input Parameters and Output Parameters (cf. fig. 2). Then open the context menu of the Prototype Service and choose Convert into Mapping. After that, the Prototype Service will be replaced by a Mapping.

Add Formulas

A new mapping formula can be added with the plus symbol and then be modeled by using Formula Modeling. To sort the assignments open the context menu of the Mapping and choose Sort Assignements. Invalid formulas will be reported as Issues. For a compact view hide the formulas by choosing Show/hide Formulas.

Supported Mapping Operations

• Simple assignment: Assignments can be done either directly between Input and Output Parameters or by accessing their Member Variables. The user can define the way the source parameters will be assigned to the target parameters:
  • Deep clone (default) (:=): Source parameters and their Member Variables are cloned.
  • Shallow clone (~=): Source parameters are cloned, their (complex) Member Variables are referenced.
• Access to lists: If lists are involved in the assignments, the user can either access single list elements or the complete list. The single list elements are referenced by square brackets and an index value.
• NULL assignment (null): An output parameter can be set to NULL.
• Simple calculations: Combine several values with one of the following arithmetic operators:
  • Summation (+)
  • Subtraction (-)
  • Multiplication (*)
  • Division (÷)
• Boolean calculations: Combine several values with one of the following Boolean operators:
  • Equals (=)
  • Not equals (≠)
  • ≥, >, ≤, <
  • AND
  • OR
  • NOT (!)
• Functions: A set of static functions amplifies the possible calculations between several values (see Formula Modeling).
  • String-based operations
  • List-based operations
  • Type-based operations
  • XPath
  • etc.
• Instance Services: Some Data Types supply Instance Services with a simple output type (e.g. String or Boolean). They can be called from out of a source parameter.

See Also

• Formula Modeling
• Modeling Blocks
• Data Model