This section describes two ways to use a Dynamic Transformation control. It contains the following topics:
Once you have created the Dynamic Transformation control, you can add a control instance to your business process and invoke its base methods from within your application.
To learn about adding an instance of the Dynamic Transformation control to your business process, see Create Control Nodes in Your Business Process.
The following methods are available:
Executes an XQuery and the arguments that it operates on based on message context.
Executes an XQuery that takes an XmlObject in and XmlObject out.
Executes an XSLT and the arguments that it operates on based on message context.
Executes MFL transformations from XML data to non-XML data.
The @jc:ddtf, @jc:xquery, @jc:xslt annotations control the behavior of these methods. Additional information is also available in the DynamicTransformation Interface.
This section describes how to add methods to the Dynamic Transformation control. It contains the following tasks:
In the following steps, you add a new method to the Dynamic Transformation control. After you add the method, you need to define the type of transformation and its parameters.
To Add a New Method to the Dynamic Transformation Control
A graphical representation of the control is displayed.
A transformation method is created.
In the following steps, you select the source and target types from the Source and Target panes of the Dynamic Transformation dialog box. Source types are the input data types for the data transformation—the data types that are transformed to the target data type.
To Define a Method for an XQuery Transformation
Note: To make the schema representations available in the Available Source Types and Available Target Types pane, the XSD and MFL files that contain these schemas must be imported into a Schemas project folder and the current application must have completed building. To learn more, see Creating Schema Projects.
The Dynamic Transformation dialog box is displayed.
To specify an XML, Non-XML, or Java primitives source type:
The element and its attributes are added to the Selected Source Types pane.
To specify a Java class source type:
Note: To learn more, see Using Java Classes in Transformations.
Note: Only one target type can be specified.
To specify an XML, Non-XML, or Java primitives target type:
The element and its attributes are added to the Selected Target Type pane.
To specify a Java class target type:
The element and its attributes are added to the Selected Target Type pane.
Note: To learn more, see Using Java Classes in Transformations.
The Dynamic Transformation dialog box should look similar to the following figure.
If a check box is selected, during run time, the parameters are validated against their schema types before the transformation is executed. To learn more, see Schema Validating During Run Time.
Note: The Schema Validate Parameters and Schema Validate Return check boxes are only enabled if all the parameters and the return type are typed XML or typed MFL types.
The transformation is created and the Dynamic Transformation dialog boxes closes. The new method is displayed in the control instance on the Data Palette.
Note: To learn about adding a control instance to your business process with the method you created, see Create Control Nodes in Your Business Process.
This completes the configuration of the method for the transformation. It links the transformation file with the selected method.
The @jc:ddtf and @jc:xquery annotations control the behavior of these methods. All of the attributes of these annotations are optional and have default values. For more information, see Dynamic Transformation Control Annotations.
The Dynamic Transformation dialog box is displayed.
Notes: The parameter name entered in the Name field must match the parameter name specified in the XSLT file.
The order of the parameters is not significant. The parameters of the XSLT are matched to the parameters of the transformation method by name.
Note: To learn about adding a control instance to your business process with the method you created, see Create Control Nodes in Your Business Process.
This completes the configuration of the method for the XSLT transformation. It links the XSLT file with the selected method in the transformation file. During run time, if the business process invokes this method, this XSLT is invoked.
The @jc:xslt tag controls the behavior of the Dynamic Transformation control. All of the attributes of the @jc:xslt tag are optional and have default values.
For more information on the @jc:xslt tag, see Dynamic Transformation Control Annotations.
Dynamic Transformation Control Annotations
Using Java Classes in Transformations
Create Control Nodes in Your Business Process
Dynamic Transformation Interface
![]() |
![]() |