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
...
Declaring a Custom Method
- Ensure that the source and target schemas destination layouts are loaded and all their elements are listed under their respective nodes.
- Enter
Click the
Global tab displayed in the Mapping Graph Area. All tabs of the Global tab are displayed. Click the Custom Methods tab.
- Click the Add New Method (
) button to add a Custom Method. A row is inserted with the listed columns.
- Alias
- Class (PKG)
- Method
- # Parameters
- The value 'java' is automatically displayed in the Alias column. This is a read-only field.
- Click Alias field and then press Enter or Tab key to activate the Class (PKG) field.
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 (PKG) field field and press Enter or Tab key to activate the Method field.
- Enter the name of the custom method in the Method column and press Enter or press Tab key to activate the #ParameterParams field.
Enter the number of arguments taken by Method in the #ParameterParams column. A custom method can take any number of arguments. However, if you enter a value greater than 4, then a warning message appears.
Click OK to close the message- Click Save. This saves the custom method and displays it under Custom 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
...
destination element.
...
- Ensure that the source and
...
- destination layouts are loaded and all their elements are listed under their respective nodes.
...
- Select a destination element and click Mapping Expression tab from Mapping Functional panel.
Double-click the required custom method under Custom
...
node in the Parameters Panel. The selected method node is displayed in the Mapping
...
Expression 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.
...
Create a link from the output of the custom method node to the input of the target element.
...
Double-click the source element to define the custom method and map it to destination element.
- This maps the custom method to the target element.
Save the mapping activity and exit the
...
Web Mapper.