Skip to main content
Documentation
Documentation
Administrator Guide
Last Updated: 2023-06-23
Reference: Xmldiff Step Properties

Reference: Xmldiff Step Properties

Common Tab

Property
XML Attribute Name
Description
Step ID
id
Specifies the unique ID of the
xmldiff
 step within the assembly.
First Input
first-input
Specifies the first data input source for the
xmldiff
 step. There are 5 possible values:
  • message
    : the entire message, including
    rootpart
     and attachments.
  • soapbody
    : the content of the SOAP body from the
    rootpart
     of the message. Only applicable when the input contains a SOAP message.
  • attachment
    : a MIME attachment within the message. Specify the attachment index.
  • rootpart
    : the content of the
    rootpart
     of a MIME message. If the message isn't MIME, Workday selects the entire message.
  • variable
    : use a named variable from the
    MediationContext
    .
Second Input
second-input
Specifies the second data input source for the
xmldiff
 step. There are 5 possible values:
  • message
    : the entire message, including
    rootpart
     and attachments.
  • soapbody
    : the content of the SOAP body from the
    rootpart
     of the message. Only applicable when the input contains a SOAP message.
  • attachment
    : a MIME attachment within the message. Specify the attachment index.
  • rootpart
    : the content of the
    rootpart
     of a MIME message. If the message isn't MIME, Workday selects the entire message.
  • variable
    : use a named variable from the
    MediationContext
    .
Output
output
Specifies where the
xmldiff
 step directs the output. There are 5 possible values:
  • message
    : the entire message, including
    rootpart
     and attachments. This value creates a new message, effectively removing any attachments.
  • soapbody
    : the content of the SOAP body from the
    rootpart
     of the message.
  • attachment
    : a MIME attachment within the message. Specify the attachment index.
  • rootpart
    : the content of the
    rootpart
     of a MIME message. If the message isn't MIME, Workday selects the entire message. This value preserves any attachments on the original message.
  • variable
    : save the output as a named variable in the
    MediationContext
    .
Copy To Output
copy-to-output
Specifies whether the
xmldiff
 step copies the output to the mediation message or a variable.
If set to
true
, the
xmldiff
 step copies the output to the mediation message.
If set to
false
, the
xmldiff
 step copies the output to a variable.
Ignore Attributes
ignore-attributes
Specifies whether the
xmldiff
 step ignores attributes when comparing 2 XML documents.
Namespaces
namespaces
Namespace override definitions for XPath expressions implemented by the
xmldiff
 step.

Advanced Tab

Property
XML Attribute Name
Description
Description
description
A description of the
xmldiff
 step that displays in the consolidated log. You can use this feature to describe the step's function and the data on which it is operating.
Execute When
execute-when
A condition that determines whether the
xmldiff
 step executes.
XPath Version
xpath-version
Specifies whether to use XPath version 1.0 or 2.0. Enter the value 1 for assembly versions through Workday 11, and 2 for assembly versions Workday 12 onwards. Workday ignores this property if the
stream-xpath
 value is set to
true
.
You can enable Workday to set the version dynamically using an MVEL template that inserts a system property value. Example:
@{props.get('the_version')}
.

Definitions Tab

Property
XML Attribute Name
Description
Name
name
Specifies the name of the
sub-diff
 to use when looking up results of the
xmldiff
 step.
Ignore Deletions
ignore-deletions
Specifies whether the
xmldiff
 step ignores deletions in the output.
Different Nodes Only
result-document-different-nodes-only
Specifies which nodes display in the output document for the
xmldiff
 step.
If set to
true
, only top-level nodes display in the output document.
If set to
false
, all child nodes display in the output document.
Result Document Inclusion
result-document-inclusion
Specifies whether the
xmldiff
 step records differences between nodes in the output document. There are 3 possible values:
  • Always
    : the selected node and its children always display in the result document.
  • Different
    : the selected node and its children only display in the result document if differences are found.
  • Never
    : the selected node and its children never display in the result document.
XPath
xpath
The XPath expression implemented by the
xmldiff
 step to find nodes in your input document.

Matcher XPath Tab

On the
Matcher XPath
 tab, you can add XPath expressions that locate nonsequential matching nodes in your input documents.