Function Argument Mapping Wizard for XPath 2.0
Using the Function Argument Mapping wizard you can map the variable of the source to the argument of a mapper function.
Functions Section
The Functions section is similar to the Function Argument Mapping wizard for XPath 1.0. It displays the view-only name of the function you are working with and the editable entity path to the item, whose properties and attributes you want to map to the function arguments.
Input Section
The Input section in the Function Argument Mapping wizard for XPath 2.0 is a combination of the Input section of the Function Argument Mapping wizard for XPath 1.0 and XPath Function Builder. For XPath 2.0, there is no separate XPath Function Builder but it has been merged in the Function Argument Mapping wizard. However, the Function Argument Mapping wizard still performs the same functions and in the same way with only the user interface changes.
In the Input section, on the left side, there are three tabs: Data Source, Functions, Constants.
The Data Source tab is similar to the Scope Variables panel in the Function Argument Mapping wizard for XPath 1.0. It lists the properties and attributes available to the function, as well as global variables defined in the project.
The Functions and the Constants tab are the same tabs which are available in the XPath Formula Builder for XPath 1.0. However, the Functions tab now contains the XPath 2.0 mapper functions. Some of these new functions were provided by TIBCO in XPath 1.0, which are now part of the XPath 2.0 function library. See The XPath Formula Builder Reference for more details on these tabs.
On the right side, similar to the Function panel in the Function Argument Mapping wizard for XPath 1.0 the XSLT template is present which specify how the Data Source would be transformed to provide the expected input. There is a toolbar which consists of the tools show the edit tab and auto-fix the errors.
| Icon | Tool | Desctiption |
|---|---|---|
|
Remove Mapping | Removes the selected mapping from the selected attribute. |
|
Show Check and Repair | Displays mapper check and repair window similar to XPath 1.0. It verifies the XSLT template you have created in the Function panel against the expected input. A list of errors and warnings appear and you can choose which items you wish to fix.
TIBCO BusinessEvents attempts to fix simple problems such as adding missing items that are expected and typecasting errors. |
|
Fix Typecasting Error | Fixes the typecasting error in XPath 2.0 where explicit casting is not done. For BusinessEvents, if the XPath expression elements cannot be implicitly cast, an error will be displayed. For instance, if the XPath expression is $price > 1000, and $price is defined as a String, then an explicit cast must be done (the XPath 1.0 mapper does this casting implicitly). |
|
Show/Hide Edit Tab | Toggles the XPath expression editor for building complex XPath statement for the selected input argument. See
XPath Formula Builder for XPath 2.0.
This builder functions in the same way in which XPath Function Builder was working in XPath 1.0. See XPath Formula Builder for more details. |
XPath Formula Builder For XPath 2.0
XPath 2.0 mapper do not have a separate window for XPath Formula Builder. The expression editor is now part of the Function Argument Mapping wizard and can be shown by the Show/Hide Edit Tab button.
Click the Show/Hide Edit Tab icon to display or hide the XPath Statement and XSLT Source tabs where you can build the complex XPath expression. You can use the data scope variables, mapper functions and constants from the respective tab on the left. In XPath 2.0, the behavior of the formula builder remains the same as XPath 1.0. See XPath Formula Builder for more details on its functioning in XPath 1.0.
