XPath Function Reference

A collection of XPath functions are available in the BPEL Mapper's menu bar. These functions are based on the XPath 1.0 specification.

Each function has zero or more arguments. Each function returns a single result.

The menu bar contains the following drop-down menus: Operator, Boolean, String, Nodes, Number, Date & Time, and BPEL.

Operator

The Operator menu contains the following functions:

• Greater — Greater than.

• Greater or Equal

• Less — Less than.

• Less or Equal

• Addition

• Subtraction

• Multiplication

• Division — The operator returns the quotient for a given dividend and divisor.

• Remainder — The operator returns the remainder for a given dividend and divisor # Negative

• Negative

• Not Equal

• Equal

Boolean

The Boolean menu contains the following functions:

• Logical And — If both arguments are true, then the function returns true. If either argument is false, then the function returns false.

• Logical Or — If either argument is true, then the function returns true. If both arguments are false, then the function returns false.

• Logical Not — If the argument is false, then the function returns true. If the argument is true, then the function returns false.

• Language — Returns true or false depending on whether the language of the context node is the same as or is a sublanguage of the language specified in the argument.

• Logical False — Returns false.

• Logical True — Returns true.

• Boolean — Converts the argument to a boolean. For detailed information about the logic, see the XPath 1.0 specification.

String

The String menu contains the following functions:

• Contains — Uses the following logic: If the first argument string contains the second argument string, then the function returns true. Otherwise, the function returns false.

• Normalize Space — Returns the argument string with whitespace normalized by stripping leading and trailing whitespace and by replacing sequences of whitespace characters with a single space.

• String — Converts an object to a string.

• Starts With — Uses the following logic: If the first argument string starts with the second argument string, then the function returns true. Otherwise, the function returns false.

• String Length — Returns the number of characters in the string.

• Substring — Returns the substring of the first argument starting at the position specified in the second argument with the length specified in the third argument. The position of the first character is 1, the position of the second character is 2, and so on. The third argument is optional. If the third argument is not specified, then the function returns the substring starting at the position specified in the second argument and continuing to the end of the string.

• Substring Before — Returns the substring of the first argument string that precedes the first occurrence of the second argument string in the first argument string. If the first argument string does not contain the second argument string, then the function returns an empty string.

• Substring After — Returns the substring of the first argument string that follows the first occurrence of the second argument string in the first argument string. If the first argument string does not contain the second argument string, then the function returns an empty string.

• Translate — Returns the first argument string with occurrences of characters in the second argument string replaced by the character at the corresponding position in the third argument string.

• Concat — Returns the concatenation of the arguments.

• String Literal — Enables you to enter a string literal.

Nodes

The Nodes menu contains the following functions:

• Local Name — Returns the local part of the expanded name of the node in the argument node-set that is first in document order. (An expanded name consists of a local part and a namespace URI.)

• Name — Returns the qualified name that represents the expanded name of the node in the argument node-set that is first in document order. (An expanded name consists of a local part and a namespace URI.)

• Namespace URI — Returns the namespace URI of the expanded name of the node in the argument node-set that is first in document order. (An expanded name consists of a local part and a namespace URI.)

• Position — Returns the context position.

• Last — Returns the context size.

• Count — Returns the number of nodes in the argument node-set.

Number

The Number menu contains the following functions:

• Number — Converts the argument to a number. For detailed information about the logic, see the XPath 1.0 specification.

• Number Literal — Enables you to enter a number literal.

• Round — Returns the number that is closest to the argument and that is an integer.

• Sum — Returns the sum, for each node in the argument node-set, of the result of converting the string values of the node to a number.

• Floor — Returns the largest number that is not greater than the argument and that is an integer.

• Ceiling — Returns the smallest number that is not less than the argument and that is an integer.

Date & Time

The Date & Time menu contains the following functions:

• Current Date — Provides the current date.

• Current Time — Provides the current time.

• Current Date and Time — Provides the current date and time.

• Deadline — Provides the specified end time.

• Duration Literal — Enables you to enter a duration literal. Use the format specified in the XML Schema specification.

BPEL

The BPEL menu contains the following functions:

• Do XSL Transform — This is an XPath extension function defined in WS-BPEL specification. It can be used in a BPEL Assign activity to call an XSLT transformation.

• Get Variable Property — Provides the property of the variable.

• Wrap with Service Reference — This is a special case of Do XSL Transform function used to transform data into Service

• Do Marshal — Performs serialization of an object.

• Do UnMarshal — Performs deserialization of an object.

• GUID — Provides the GUID Name.

• Get BP ID — Gets the Business Process Identification.

• XML Literal — Enables you to enter an XML literal.