Skip to main content
Administrator Guide
Last Updated: 2023-06-23
Reference: Message Element Properties

Reference: Message Element Properties

Use the buttons at the top of
Message Builder
to add message elements to
write
,
log
, and
log-error
elements.
Not every message element has properties.

message-content

Property
XML Attribute Name
Description
Limit
limit
A limit on the number of characters the message can contain. The default value of zero indicates no character limit.

exception

Property
XML Attribute Name
Description
Escape Xml
escape-xml
Enables escaping of XML on exceptions in the
write
step.

xpath

Property
XML Attribute Name
Description
Namespaces
namespaces
Enables you to specify any namespace required by the XPath expression in the format
<prefix1> <namespace1> <prefix2> <namespace2>
.
XPath
xpath
The XPath expression used to extract a value from the incoming message.
XPath Version
xpath-version
Workday Studio supports XPath versions 1.0 and 2.0. The default value is 2 for assembly versions from Workday 12 onward and 1 for earlier versions.

xslt

Property
XML Attribute Name
Description
Allow Saxon Bytecode Generation
Specifies whether to allow Saxon bytecode generation. The default is
false
.
Reuse Strategy
Specifies the XSLT transformer reuse strategy:
  • default
    : if you specify the
    url
    property using the mctx URL protocol or an MVEL expression, the default behavior is
    no-reuse
    . Otherwise, it's
    transformer-pool
    .
    When you set
    transformer-factory
    to Saxon, the default behavior is
    templates
    .
  • no-reuse
    : Workday doesn't reuse transformer objects.
  • templates
    : Workday builds a Templates object, from which it creates fresh transformer objects. These transformers aren't reused.
  • transformer-pool
    : Workday uses a pool of transformers. Not recommended if the transformer object caches values.
Secure Processing
Specifies whether a transformer performs XSLT standard processing only. Set to
true
to impose limits on XML constructs. Example: ignore JavaScript or Java extension processing. Set to
false
to process XML according to the XML specifications.
Transformer Factory
The class name of the
TransformerFactory
that you want to use. The default is the JAXP factory. There are 3 other options:
  • net.sf.saxon.TransformerFactoryImpl
    for Saxon.
  • org.apache.xalan.processor.TransformerFactoryImpl
    for Xalan.
  • net.sf.joost.trax.TransformerFactoryImpl
    for Joost.
Url
The XSLT file location, either a relative path or an absolute URL. Supports MVEL expression templates.
You can load XSLT directly from the message content using the mctx (mediation context) URL protocol. Example: to load an XSLT file contained in an attachment, use
mctx:parts/1
.

xml-stream

Property
XML Attribute Name
Description
Namespaces
namespaces
Enables you to specify any namespace required by the XPath expression in the format
<prefix1> <namespace1> <prefix2> <namespace2>
.
XPath
xpath
The XPath expression to apply to the message when retrieving XML elements. Workday uses Streaming API for XML (StAX) processing. This library reads XML messages and translates them into events, rather than DOM. It doesn't perform any transformations itself.
The XPath expression is the same simplified XPath subset you use in the
xml-stream-splitter
strategy. Workday supports qualified or local element names and asterisks. It doesn't support the full XPath standard.
Examples:
  • /order/item, /ns:order/ns:order
  • //item, //ns:item, /ns:order/item
  • /*/*, //* /*/*
XPath Version
xpath-version
Workday Studio supports XPath versions 1.0 and 2.0. The default value is 2 for assembly versions from Workday 12 onward and 1 for earlier versions.
Limit
limit
Constrains the number of XML fragments to match based on the XPath expression. Useful mainly for performance reasons. If you know there's just 1 matching XML fragment, set the limit to
1
to prevent pull-parsing of the document after the result has been retrieved. The default value is
-1
, which means an unlimited result set.

regex-match

Property
XML Attribute Name
Description
Delimiter
delimiter
Specifies a string used to separate 2 or more occurrences. The default value is a single space.
Limit
limit
Specifies the number of occurrences to include in the result set. The default value is zero, which means all occurrences.
Regex
regex
Defines the matching expression.

static-file

Property
XML Attribute Name
Description
Character Encoding
character-encoding
Specifies the character encoding. The default value is
UTF-8
.
Input File
input-file
Specifies the file.

header

Property
XML Attribute Name
Description
Include Name
include-name
Specifies whether Studio inserts the header name.
Name
name
The header name.
Not Set Value
not-set-value
A string that's emitted if the header isn't found or is empty.