Transform
The Transform task is used to manipulate the data available in a mediation flow so that the expected input, output, or fault message can be created.
Transform tasks can be placed on input, output, or fault paths. For more information, see Transform Tasks.
General Tab
Use the General tab to specify a name and description for the task. This tab is useful for providing documentation for tasks in your mediation flows.
Field | Description |
---|---|
Name | Assign a name to the task, to identify the task in the mediation flow. This name appears in the tooltip that opens when you hover the cursor over the task icon in the mediation flow. |
Description | Describe the task briefly. This description appears in the tooltip that opens when you hover the cursor over the task icon in the mediation flow. |
Contribute Output to Mediation Exchange |
When not selected, this option signifies that the output of the Transform task should change the message data. When this option is selected, the message data is left unchanged, and the output of this task is added as another data item within the mediation exchange. The data contributed by this task is available to subsequent mediation tasks along the same path. If you select Use External Stylesheet on this tab, the Contribute Output to Mediation Exchange option is automatically selected and cannot be cleared. |
Use External Stylesheet | Select to use an external stylesheet for data transformation. This enables you specify the transformation mapping in your workspace, outside the mediation flow. |
Input and Output Style |
Appears only if you select Use External Stylesheet. Specify how the XML appears:
|
Stylesheet Reference Type |
Appears only if you select Use External Stylesheet. Select the type of reference for the Transform task:
|
Static Style Sheet Reference | Appears if you select a static stylesheet reference type. Click Browse to select a single (static) stylesheet that is in your workspace. |
Dynamic Stylesheet Folder | Appears if you selected a dynamic stylesheet reference type. Chose a value available in the drop-down list. At run-time, one of the style sheets in the list are used dynamically, based on the input to the mediation task. |
Input Tab
Use the Input tab to map data from the mediation exchange into the expected message schema.
Field | Description |
---|---|
xmlString | Specify an XML document serialized as a string. |
xmlBinary | Specify an XML document serialized in Base64Binary format. |
xmlTree | Specify an XML document. |
stylesheetURI | Specify the schema URI, so that ActiveMatrix can locate it at run time and use it for the transformation. |
parameter |
A stylesheet can expect zero, one or more parameter(s) for its execution at runtime:
|
Output Tab
The Output tab shows a tree representation of the Transform task output. Depending on the input style chosen, the output can be:
xmlString
— XML document serialized as stringxmlBinary
— XML document serialized in Base64Binary formatxmlTree
— XML document