Home
Reference Guide
This guide describes conceptual information about data design environment components when you want to use the data fabrication feature in HCL OneTest™ Server.
Schema design
A schema is a graphical data dictionary that contains metadata definitions of the structure of a document to generate test data. Schema provides visual cues for understanding the structure and complete definition of an object.
Functions and expressions
XML functions
XPATH functions
XPATH
The XPATH function queries the XML input.

Reference Guide
This guide describes conceptual information about data design environment components when you want to use the data fabrication feature in HCL OneTest™ Server.
- Files
  You add a file to a project to use it as input in the project. You can upload a file from your local file system to a project from the Files tab to generate test data. Alternatively, you can upload it when you define an action.
- Connections
  A connection defines the properties that are required to connect to an external resource. An action uses a connection to provide source data to a project or write data from a source to a target. Multiple actions can use the same connection. You can define both connections and actions at the project level.
- Schema design
  A schema is a graphical data dictionary that contains metadata definitions of the structure of a document to generate test data. Schema provides visual cues for understanding the structure and complete definition of an object.
  - Introduction to schema design
    Use the Schemas tab to define, modify, and view schemas. A schema describes the syntax, structure, and semantics of your data.
  - Type properties
    The properties of a type define the characteristics of the data objects of that type.
  - Item restrictions
    Item restrictions are an optional feature you can use to specify valid or invalid data objects for an item type. Item restrictions are grouped into three categories: Value, Character, and Range.
  - Components
  - Partitioning
  - Type inheritance
  - Schema analyzer
  - Distinguishable objects
  - Functions and expressions
    - Expressions and evaluations
    - Using functions
    - Syntax of a function
    - Function argument syntax
    - Functions that convert character-set encoding to the native code page
    - General functions
    - Bidirectional functions
    - Bit manipulation and testing functions
    - Conversion functions
    - Date/time functions
    - Error handling functions
    - External interface functions
    - Inspection functions
    - Logical functions
    - Lookup and reference functions
    - Math and statistics functions
    - Text functions
    - XML functions
      - VALIDATE
        The VALIDATE function validates the XML input by using the XMLLIB library.
      - VALIDATEEX
        The VALIDATEEX function validates the XML input, and logs the function processing in the directory where the map runs by using the XMLLIB library.
      - XVALIDATE
        The XVALIDATE function validates the XML input.
      - XPATH functions
        XPATH
        The XPATH function queries the XML input.
        XPATH used with XMLLIB
        The XPATH function that is used with XMLLIB queries the XML input.
      - XPATHEX
        The XPATHEX function queries the XML input by using the XMLLIB library, and logs function processing in the directory where the map runs.
      - XSLT functions
      - XSLTEX
        The XSLTEX function applies an XSLT transformation to the XML input, and logs the function processing in the directory where the map runs by using the XMLLIB library.
    - Custom functions
    - Date and time format strings
    - Number format strings
    - RUN function return codes
    - Character set codes for CPACKAGE, CSERIESTOTEXT, and CTEXT

XPATH

The XPATH function queries the XML input.

This function queries the XML input, which is provided as a text stream or URL, by using the specified XPATH expression and context, returning the result of the evaluation.

Syntax:: XPATH (single-text-expression, single-text-expression, single-text-expression)
Meaning:: XPATH (xml_url_or_xml_fragment, xpath_expression, context_expression)
Returns:: A single text item

Examples

XPATH( "current://ipo.in.xml", "/ipo:purchaseOrders/order/items/item[1]/shipDate", "ipo http://www.example.com/IPO" )
Returns the content of the shipDate element from the ipo.in.xml file.
XPATH( PACKAGE(source), "/ipo:purchaseOrders/order/items/item[1]/shipDate", "ipo http://www.example.com/IPO" )
Returns the content of the shipDate element from the input XML fragment.