A custom method is used to call a function from a custom Java class in a package. It is declared and used globally for all target destination elements.
To use a custom method in a mapping activity, you need to map it to a target destination element. This will successfully execute the custom method when you execute the mapping activity in the process flow.
Prerequisites
...
- Ensure that the source and target schemas are loaded and all their elements are listed under their respective nodes.
Click the Add Parameters icon and select Custom Methods to display Create Custom Method window.
- To add a Custom Method, enter the details in the fields.
- Class
- Method
- Params
- Enter the fully qualified name of the Java class in the Class field and press Tab key to activate the Method field.
- Enter the name of the custom method in the Method column and press Tab key to activate the Params field.
Enter the number of arguments taken by Method in the Params column. A custom method can take any number of arguments.
- Click Save. This saves the custom method and displays it under Methods in node in the Parameters Panel.
To remove a custom method, select the custom method and click the Remove.
Map Custom Method to Destination Element
Once you have created a custom method, you can map it to a target element. To map:
- Ensure that the source and target schemas are loaded and all their elements are listed under their respective nodes.
- Select a destination element. This displays the selected target element node in the Mapping Graph Area.
Double-click the required custom method under Custom Methods in the Parameters Panel. The selected method node is displayed in the Mapping Graph Area.
If the custom method is defined with more than 4 parameters, then double-clicking the custom method will display the warning message. Once you click OK, you need to define the mapping using Textual Rules.
- Click two source elements. The selected source nodes are displayed in the Mapping Graph Area.
- Create a link from the output of the first source element to the first input of the custom method node.
- Create a link from the output of the second source element to the second input of the custom method node.
Create a link from the output of the custom method node to the input of the target element.
- Click the Apply Mapping (
) button. This maps the custom method to the target element.
Save the mapping activity and exit the Data Mapper.
You can view and validate the generated mapping XSL, view the target XML and, view and validate mapping output, before saving the mapping activity.