跳至主要内容
文档
文档
Administrator Guide
上次更新时间 ：2023-06-23
参考信息：消息元素属性

参考信息：消息元素属性

使用“Message Builder”
顶部的按钮，将消息元素添加到“write”
“log”
“log-error”
元素中。
并非每个消息元素都具有属性。

message-content

属性
XML 属性名称
描述
限制
limit
对消息中包含的字符数进行了限制。默认值为零，表示无字符数限制。

exception

属性
XML 属性名称
描述
转义 Xml
escape-xml
允许在
写入
 步骤中出现异常时转义 XML。

xpath

属性
XML 属性名称
描述
命名空间
namespaces
让您能够采用以下格式指定 XPath 表达式所需的任何命名空间
<prefix1> <namespace1> <prefix2> <namespace2>
。
XPath
xpath
用于从传入消息中提取值的 XPath 表达式。
XPath 版本
xpath-version
Workday Studio 支持 XPath 版本 1.0 和 2.0。对于 Workday 12 及更高版本的程序集，默认值为 2；对于较早版本，默认值为 1。

xslt

属性
XML 属性名称
描述
Allow Saxon Bytecode Generation
指定是否允许生成 Saxon 字节码。默认值为
false
。
重用策略
指定 XSLT 转换器重用策略：
  • 默认值
    ：如果您指定
    url
     属性（使用 mctx URL 协议或 MVEL 表达式），则默认行为为
    no-reuse
    。否则为
    transformer-pool
    。
    当您将
    Transformer-Factory
     设置为“Saxon”时，默认行为为
    templates
    。
  • no-reuse
    ：Workday 不会重复使用转换器对象。
  • templates
    ：Workday 会构建一个 Templates 对象，并据其新建转换器对象。这些转换器对象不会被重复使用。
  • transformer-pool
    ：Workday 使用 Transformer 池。如果转换器对象缓存了值，则不建议使用此项。
Secure Processing
指定转换器是否仅执行 XSLT 标准处理。若设置为“true”
，系统将对 XML 构造施加限制。示例：忽略 JavaScript 或 Java 扩展处理。若设置为“false”
，则可根据 XML 规范处理 XML。
Workday Transformer
的类名称
TransformerFactory
 您希望使用的类型默认值为 JAxP 工厂。您还有其他 3 个选项：
  • net.sf.saxon.TransformerFactoryImpl
     （对于 撒克语）
  • org.apache.xalan.processor.TransformerFactoryImpl
     适用于 Xalan。
  • net.sf.joost.trax.TransformerFactoryImpl
     对于 Joost。
URL
XSLT 文件位置（相对路径或绝对 URL）。支持 MVEL 表达式模板。
您可以使用 mctx（中介上下文）URL 协议直接从消息内容加载 XSLT。示例：要加载附件中包含的 XSLT 文件，请使用
mctx:parts/1
。

xml-stream

属性
XML 属性名称
描述
命名空间
namespaces
让您能够采用以下格式指定 XPath 表达式所需的任何命名空间
<prefix1> <namespace1> <prefix2> <namespace2>
。
XPath
xpath
检索 XML 元素时应用于消息的 XPath 表达式。Workday 使用 Streaming API for XML (StAX) 处理。此库会读取 XML 消息并将其转换为事件，而非 DOM。它本身不执行任何转换。
该 XPath 表达式与您在
xml-stream-splitter
 策略。Workday 支持限定的或本地化的元素名称和星号。不支持完整的 XPath 标准。
示例：
  • /order/item, /ns:order/ns:order
  • //item, //ns:item, /ns:order/item
  • /*/*, //* /*/*
XPath 版本
xpath-version
Workday Studio 支持 XPath 版本 1.0 和 2.0。对于 Workday 12 及更高版本的程序集，默认值为 2；对于较早版本，默认值为 1。
限制
limit
根据 XPath 表达式限制要匹配的 XML 片段的数量。主要出于性能原因有用。如果您知道只有 1 个匹配的 XML 片段，请将限制设置为
1
 以防止在检索结果后对文档进行拉取解析。默认值为
-1
，表示结果集不受限制。

regex-match

属性
XML 属性名称
描述
分隔符
delimiter
指定一个字符串，用于分隔 2 个或更多匹配项。默认值为一个空格。
限制
limit
指定要在结果集中包括的事件数。默认值为 0，表示可以包含所有实例。
正则表达式
regex
定义匹配表达式。

static-file

属性
XML 属性名称
描述
字符编码
character-encoding
指定字符编码。默认值为
UTF-8
。
输入文件
input-file
文件。

header

属性
XML 属性名称
描述
包括名称
include-name
指定 Studio 是否插入标头名称。
名称
name
表头名称。
未设置值
not-set-value
在标头未找到或为空时发出的字符串。