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

Reference: Validate Step Properties

Common Tab

Property
XML Attribute Name
Description
Step ID
id
The unique ID of the
validate
step within the assembly.
Input
input
Specifies where the
validate
step obtains data as input. 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, Studio selects the entire message.
  • variable
    : use a named variable from the
    MediationContext
    .
Schema
schema
The location of the schema file that the step uses to validate the message. If you specify a location instead of an MVEL template, Workday uses pooled validators.
Namespaces
namespaces
The namespaces used by your XPath expression in the format
prefix namespace prefix2 namespace2
. Overrides namespace mappings in the assembly.xml file.
Xpath
xpath
An XPath expression that selects elements for validation.
Failure Message
failure-message
A custom error message that overrides the default error message when a validation error occurs. Error messages display only when you set the
Filter
property to
false
.

Advanced Tab

Property
XML Attribute Name
Description
Description
description
A description of the
validate
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
validate
step executes.
Mode
mode
The type of validation performed. The options are:
  • schema
    : validates against a W3C XML schema.
  • dtd
    : validates against a Document Type Definition.
  • well-formed
    : verifies that the XML is well-formed.
DTD
dtd
The location of the DTD file that the step uses to validate the message.
Replace Message
replace-message
Indicates whether to use the custom error message set as the
Failure Message
property when validation fails.
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')}
.
Filter
filter
Specifies whether to interrupt mediation message processing when validation fails. The default value is
false
, meaning Studio passes validation errors to error-handlers defined within the component.
If set to
true
, Studio executes response steps for the component but discards the message and invokes no further steps. It doesn't raise an error.