Welcome > Workflow > Variables > Create process variables > Create an XML expression variable

Create an XML expression variable

  1. On the Type list, select XML expression. (Default: String)
  2. Optional. To use the variable for process initialization, select Initialization.
  3. In the XPath expression text field, enter the XML string, such as //Customer, or the path to an XML document, such as \\<machinename>\HardDiskC\Program Files\TotalAgility\AWAudit.txt.
  4. To specify the source to use in the XML document variable, select the Source XML.
    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.

  5. On the Return data type list, select the return type of the XML expression which can use any of the following formats: Bool (default), Byte, Currency, Date, Decimal, Double, Float, Long, Short, String, Text or XML.
  6. To specify the XML document schema location, select one of the following options:

    • None (default): Does not use an XML schema.

    • Location variable: Select a process or server variable in the Location variable field.

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

  7. Enter the Namespace bindings, such as xmlns:a=http://example.org/CustomerExample.
    Note The namespace binding is used to avoid element name conflicts.
  8. 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.

  9. Click Save.