Use the Transformation Sequence editor to define the source and target order items and the relationship between them for each step of the transformation.
When modeling transformation sequences, see the following topics:
The following fields are common to multiple tabs in the Transformation Sequence editor:
Field | Use |
---|---|
Description | Edit the display name of the transformation sequence. |
Namespace | Select an existing namespace or enter a unique namespace in which to include the transformation sequence. |
Creating New Transformation Sequences
Use the Properties tab to define the order items that are used for the transformation sequence.
Note:
See "Transformation Sequence Editor" for information about fields that appear on multiple Transformation Sequence editor tabs.Field | Use |
---|---|
Output Order Item | Click Select to select an order item specification for the order items to result from the transformation. |
Input Order Item | Click Select to select an order item specification for the order items to be transformed. |
Use the Dependencies tab to configure the transformation stages in the transformation sequence.
When modeling transformation stages, refer to the following topics:
Transformation Sequence Editor Dependencies Tab Transformation Model Subtab
Transformation Sequence Editor Dependencies Tab Stage Detail Subtab
Transformation Sequence Editor Dependencies Order Item Context Subtab
Transformation Sequence Editor Dependencies Tab Related Order Items Selector Subtab
Transformation Sequence Editor Dependencies Tab Relationship Type Details Subtab
Transformation Sequence Editor Dependencies Tab Stage Condition Subtab
Note:
See "Transformation Sequence Editor" for information about fields that appear on multiple Transformation Sequence editor tabs.Field | Use |
---|---|
Tree area | The tree area contains the transformation sequence and each of the transformation stages. Do any of the following:
|
Transformation Sequence Editor
Use the Transformation Sequence subtab of the Dependencies tab to define the name of the transformation sequence and to determine whether the stages run in parallel or sequentially. This subtab is visible when you have a transformation sequence selected in the tree area.
Field | Use |
---|---|
Name | Enter the name of the transformation sequence. |
Sequential Execution | Select this option to allow custom sequencing of the transformation stages. See "Configuring Non-Sequential Stage Transitions" for more information about using this option. |
Use the Stage Detail subtab of the Dependencies tab to configure details of the transformation stage. This subtab is visible when you have a transformation stage selected in the tree area.
Field | Use |
---|---|
Name | Enter the name of the transformation stage. |
Allow Overrides | Select this option to set a value that indicates that the results of previous transformation stages may be overridden.
Note: This option should not be selected for the first transformation stage in the transformation sequence. |
This subtab is visible when you have a transformation stage selected in the tree area. Use the Order Item Context subtab of the Dependencies tab to configure details of the transformation stage.
Field | Use |
---|---|
Reuse Previous Stage Context | Select this option to indicate that the current transformation stage should not recalculate the order item context but should use the order item context of the previous stage.
Note: This option should not be selected for the first transformation stage in the transformation sequence. |
Order Item Context | Do one of the following:
|
This subtab is visible when you have a transformation stage selected in the tree area. Use the Related Order Items Selector subtab of the Dependencies tab to configure details of the order items to which the transformation stage applies. This subtab is visible when you have a transformation stage selected in the tree area.
Field | Use |
---|---|
Related Order Item | Do one of the following:
|
This subtab is visible when you have a transformation stage selected in the tree area. Use the Relationship Type Details subtab of the Dependencies tab to configure details of the Java classes that implement the transformation stage. This subtab is visible when you have a transformation stage selected in the tree area.
Field | Use |
---|---|
Relationship Types | This table shows a list of the relationships that are available to the transformation stage.
Do any of the following:
|
Relationship Type | Click Select to select a relationship type to be implemented by the transformation stage. |
Implementation | Do one of the following:
|
Use the Stage Condition subtab of the Dependencies tab to configure how OSM determines whether the stage should be run. This subtab is visible when you have a transformation stage selected in the tree area.
Field | Use |
---|---|
XQuery | The XQuery tab enables you to configure XQuery-based rules to determine whether the transformation stage will run. See "About Creating XQuery Expressions with Design Studio" for more information about entering information into XQuery controls. See "About Stage Condition XQuery Expressions" for more information about this XQuery field. |
Instances | Define a Data Instance behavior to obtain data that is not included in the order data and to make that data available to the XQuery expression. Click Add to add a Data Instance behavior. Select the Data Instance behavior, and click Properties to configure the Data Instance behavior.
See "Defining Data Instance Behavior Properties" for more information. |
Information | Describe the intended use of the XQuery expression. For example, you might describe the functionality of a complex expression or provide instructions on its use. |