Create a variable of XML Expression Type

  1. Open the process in which to create a variable of XML Expression type.
  2. On the Modeling bar, click Variables.

    The Variables page appears.

  3. On the Type list, select XML Expression.
  4. Enter a Name and ID for the variable.
  5. Click Configure.

    The XML Expression Variable page appears.

  6. To specify the source to use in the XML document variable, consume the variable in the Source XML box.
    Note
    • For a synchronous process map with an XML expression variable whose source is mapped with a server variable, at runtime, updating the XML expression variable does not update the server source variable.

    • When editing server XML expression variables, the process and case variables are not visible on the Variables list.

  7. In the Expression Text box, enter the XML string, such as //Customer, or the path to an XML document, such as \\<machinename>\HardDiskC\Program Files\TotalAgility\AWAudit.txt.
  8. On the Expression Type list, select XPath.
    Note XPath is the default setting.
  9. On the Return Type of Extracted Data list, select the return type of the XML expression which can use any of the following formats:
    • Boolean

    • Byte

    • Currency

    • Date

    • Decimal

    • Double

    • Float

    • Long

    • Short

    • String

    • Text - returns the contents of all nodes without the XML tags

    • XML - returns the contents of all nodes including the XML tags

  10. Optionally, enter Namespace Bindings, such as "xmlns:a=http://example.org/CustomerExample".
    Note The namespace binding is used to avoid element name conflicts.
  11. To specify the XML Document Schema location, select one of the following options:
    • None: Does not use an XML schema.

    • Location Variable: Consume a variable in the Location Variable box.

    • Location: Enter a static value for the XML schema location in the Location box, such as, c:\xml node\schemas.

  12. Click OK.

    Note the following:

    • If an input parameter returns an XML variable, the contents of the variable are returned as follows:

      • If the variable stores a path, the content of the XML document appears.

      • If the variable stores an XML String, the actual XML value appears.

    • If an input parameter returns an XML expression, the expression is evaluated and the actual value appears.

    • If an output or initialization parameter is an XML variable or expression, the actual XML appears. If the user updates the value of the parameter the XML document is updated.

    • Variable value validation of XML expressions is completed the same way as that of a simple process variable of the same type. For example, XML expressions of return type Short can be used in process maps as if they were simple short variables.