Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Corrected links that should have been relative instead of absolute.

...

Some mapping functions require the use of constant values for mapping elements. For this, you need to add the constant node to the Mapping Expression Area. Apart from these Mapping Functions, you can also use inbuilt mapper utility classes and global methods available in the Web Mapper to map the elements. Visit Mapper Utility page to know how to use utility classes.

Anchor
Math Function
Math Function
Using Math Function 

The Math mapping function enables you to map elements by performing simple mathematic operations. It comprises of various sub-functions, which are listed in the table below.  

...

You can use the required sub-function of Math mapping function to map elements. The process of using the Math function is the same for all its sub-functions.

Anchor
String Function
String Function
Using String Function 

The String mapping The String mapping function enables you to map elements by manipulating strings. It comprises of various sub-functions, which are listed in the table below.  

...

Anchor
Date
Date
Using Date Function

The Date mapping The Date mapping function enables you to map elements by generating dates in specific formats. It also returns the current date and the difference between two dates. It comprises of various sub-functions, which are listed in the table below.

...

Anchor
Aggregation
Aggregation
Using Aggregation Functions  

The Aggregation function The Aggregation function enables you to map elements by aggregating or counting the values of all nodes in an element. It comprises of various sub-functions, which are listed in the table below.

...

Anchor
Conditional
Conditional
Using Conditional Function 

The Conditional mapping The Conditional mapping function enables you to map elements by building conditional expressions. It comprises of various sub-functions, which are listed in the table below. 

...

 

Anchor
Axis
Axis
Using Axis Function

...

 The Axis function contains a list of advance XSL functions that are used to map elements only when the For Each function is applied on the Target node. It comprises of various sub-functions, which are listed in the table below. 

Mapping Function

Sub-Functions

Description

Example

Axis

 

 

 

 

 

 

 

 

 

 

 

File Path – XPath

This is a customized mapping function. 
This is an XML Lookup which returns the value of the element/attribute within the XML file whose path is specified. The File path and XPath must be specified in single quotes.

FilePath ['C:/correct_file.xml'] XPath {'/employees/employee/Name'}

Returns value of Name element from the file correct_file.xml.

Self

Returns the element which is the context node itself.

Self::Employee

Returns Employee which is the context node itself.

Child

Returns the element which is the child of the context node.

Child::Name

Returns Name which is a child of the context node.

Parent

Returns the element, which is the parent (if any) of the context node.

Parent::Name

Returns Name which is a parent of the context node.

Following-sibling

This axis contains all the following siblings of the context node. It returns the first occurrence of the element/attribute in the next sibling of the context node. If the context node is an attribute node or namespace node, then this axis is empty.

following-sibling: employee/Name

Returns the first occurrence of Name in the next employee node.

Ancestor

Returns the element which is the ancestor of the context node. This axis always includes the root node, unless the context node is the root node.

Ancestor::Name

Returns Name which is an ancestor of the context node.

Ancestor-or-self

This axis contains the context node and the ancestors of the context node. It always includes the root node. It returns the context node or ancestors of the context node.

ancestor-or-self::employees/@val

Returns context node or ancestors of context node.

Preceding-sibling

This axis contains all the preceding siblings of the context node. It returns the first occurrence of the element/attribute in the preceding sibling of the context node. If the context node is an attribute node or namespace node, then this axis is empty.

preceding-sibling: employee/Name

Returns the first occurrence of Name in the previous employee node.

Descendant

Returns the element which is the descendant of the context node. This axis does not contain attribute nodes.

descendant::Name

Returns Name, which is a descendant of the context node.

Descendant-or-self

This axis contains the context node and the descendants of the context node. It returns the context node or descendants of the context node.

descendant-or-self::employees/salary

Returns context node or descendants of context node.

Generate-id

Generates a unique id for the element/attribute specified by the XPath argument.

generate-id (employees/employee/Name)

Returns unique ID for Name element

Current

Removes all tags from the specified xml file and returns the data.

current()

Returns data of the xml file without tags.


You can use the required sub-function of Axis mapping function to map elements. The process of using the Axis function is the same for all its sub-functions.

Anchor
Boolean
Boolean
Using Boolean Function

...

The Boolean mapping function enables you to map elements by applying various logical operators in building Boolean expressions. It comprises of various sub-functions, which are listed in the table below.

Mapping Function

Sub-Functions

Description

Example

Boolean

 

 

 

 

 

 

 

Equal

Returns TRUE the first variable argument is equal to the second variable argument.

(5) = (5)returns true

Not Equal

Returns TRUE the first variable argument is not equal to the second variable argument.

(5) != (50)returns true

Greater Than

Returns TRUE the first variable argument is greater than the second variable argument.

(5)> (3)returns true

Less Than

Returns TRUE the first variable argument is less than the second variable argument.

(5) < (8)returns true

Greater than Equal

Returns TRUE the first variable argument is greater than or equal to the second variable argument.

(5)>= (5)returns true 
(5)>= (3)returns true

Less than Equal

Returns TRUE the first variable argument is less than or equal to the second variable argument.

(5) <= (8)returns true 
(5) <= (5)returns true

Or

Returns TRUE if either of the two variable arguments evaluate to TRUE otherwise FALSE. These variable arguments can only be of Boolean data type. Hence, their value can either be TRUE or FALSE only.

(True) Or (True) returns true 
(True) Or (False)returns true

And

Returns TRUE if both of the two variable arguments evaluate to TRUE otherwise FALSE. These variable arguments can only be of Boolean data type. Hence, their value can either be TRUE or FALSE only.

(True) And (True) returns true 
(True) And (False)returns false


 A Boolean sub-function is always used in conjunction with a Conditional function. 

Anchor
Context
Context
Using Context Functions

...

The Context mapping function enables you to map elements by setting or getting the value of process flow context variables.  It comprises of various sub-functions, which are listed in the table below.

Mapping Function

Sub-Functions

Description

Example

Context

Set-Context

This is a customized mapping function. 
Sets the value of the specified variable argument in the process flow context. This value can be string constant, numeric constant, XPath or output of limited set of mapping function, which can be used before set-context function. 
This function does not return a value. If mapped to a target element, it creates an empty tag of that target element in output XML.


set-context ('index', '123')

sets the value of index variable as 123 in the process flow.

 

Get-Context

This is a customized mapping function. 
Returns the value of the specified variable argument from process flow Context. This value can be string constant, numeric constant, XPath or output of a limited set of mapping function. If no value has been set, then the value specified in the second argument is returned.

get-context ('index', '100')

Returns the value of index variable from the process flow. If no value has been set for index, then 100 is returned. 

In get-context function you can also use any variable, which is not declared. In such case get-context creates a variable with the specified name and value, which can be further used with the selected target element. This can be done only in Textual Rule panel.

See Also

Utility Class in Web Mapper