跳转到主要内容
Validate 端口执行 XML 或消息头验证的步骤,以便在之后的工作流中捕获无效的 XML 文件或消息头。

核心功能

  • 使用可配置的规则和条件进行 XML 及消息头验证
  • 基于 XPath 的 XML 内容验证,支持通过示例文件创建规则
  • 针对字符串、数字和日期时间(DateTime)值的数据类型验证
  • 支持基于分组的规则管理,具备复杂的逻辑条件(与/或)

概述

Validate 端口可配置一条或多条规则,来决定输入的 XML 文件或消息头是否被视为有效。有效的 XML 或消息头输入将会成功地通过端口,未通过验证的 XML 文件或消息头将会抛出错误且不能在工作流中传输。添加一个验证步骤帮助防止出错。 验证规则配置有一个 XPath、一个运算符以及一个目标值。对于每个配置的规则,端口将会对比输入 XML 中的值与目标值,来确定是否将其视为有效,更多详情请查阅规则选项卡。

端口配置

本部分包括所有可配置的端口属性。

规则选项卡

添加和配置规则和规则组。输入 XML 和消息头如果符合所有配置的规则,则被视为有效。 您可以通过定义单个规则和/或规则组来构建复杂的验证。要添加验证规则,请点击 Add Rule 或 Add Group。 构建规则时,使用下拉菜单进行选择并选择运算符。您可以从以下选项中进行选择:
  • 输入XML
    • 值:正在评估的 XPath 处的值
    • 数据类型:值的数据类型(字符串、数字、日期时间)
    • 出现次数:XPath 在文档中出现的次数
  • 消息头
    • 值:正在评估的消息头的值
    • 值类型:值的数据类型(字符串、数字、日期时间)
选择规则的 XPath 时,如果您已上传样本文件,编辑器会显示文档的树形表示,以便您轻松找到所需的 XPath,如下图所示。 您可以重新排列规则和组。点击手柄 handle 并将对象拖到新位置。 仅当所有验证规则(或规则组)都满足时,输入 XML 才被视为有效。如果在输入 XML 中找不到规则中配置的 XPath,验证将自动失败。换句话说,如果端口无法读取规则 XPath 的值,输入文件将不会通过该规则。

设置选项卡

端口设置

设置描述
端口 Id端口的静态、唯一标识符。
端口类型显示端口类型及其用途的描述。
端口描述一个可选字段,用于提供端口及其在流中的角色的自由格式描述。

高级设置选项卡

消息

消息设置确定端口如何搜索消息并在处理后管理它们。

设置描述
保存到已发送文件夹选中此项可将端口处理的文件复制到该端口的“已发送”文件夹中。
已发送文件夹方案端口根据选定的时间间隔对 已发送 文件夹中的文件进行分组。例如,Weekly 选项指示端口每周创建一个新的子文件夹,并将本周发送的所有文件存储在该文件夹中。空白设置告诉端口将所有文件直接保存在 已发送 文件夹中。对于处理许多事务的端口,使用子文件夹可以帮助保持文件有序并提高性能。

日志

用于管理日志创建和存储的设置。

设置描述
日志级别指定要记录在端口日志目录中的信息类型:
  • None - 不创建任何日志。
  • Error - 仅当端口遇到错误时才创建日志。
  • Warning - 仅当端口发出警告时才创建日志。
  • Info - 记录工作流的一般信息,包括任何错误和警告(如果适用)。
  • Debug - 记录成功和失败工作流的详细调试信息。
  • Trace - 记录成功和失败工作流的详细跟踪信息。
请注意:Debug 和 Trace 级别的日志可能会记录敏感信息,包括消息内容和 SSL 证书。尽管连接属性(例如密码)被屏蔽了,但在与您的组织外部共享它们之前,请查看此级别的日志以避免泄漏敏感信息。
日志文件夹结构指示端口根据选定的时间间隔将日志文件夹中的文件分组。例如,Weekly 选项指示端口每周创建一个新的子文件夹,并将该周的所有日志存储在该文件夹中。空白设置告诉端口将所有日志直接保存在日志文件夹中。对于处理许多事务的端口,使用子文件夹有助于保持日志的有序性并提高性能。
保留消息副本指示端口在日志目录中保存最新消息副本的切换。请注意,端口每个子文件夹只保留一个消息,并且端口在再次运行时会覆盖以前保存的消息。

其他设置

杂项设置

特殊设置适用于特定用例。

设置描述
其他设置允许在以分号分隔的列表中配置隐藏的端口设置,例如 setting1=value1;setting2=value2。正常的端口用例和功能不需要使用这些设置。

自动化选项卡

与端口自动处理文件相关的设置。

性能

与端口资源分配相关的设置。

设置描述
最大工作线程数此端口上处理文件时从线程池中消耗的最大工作线程数。如果设置,则会覆盖 高级设置 页面的 性能设置 部分的默认设置。
最大文件数分配给端口的每个线程发送的最大文件数。如果设置,则会覆盖 高级设置 页面的 性能设置 部分的默认设置。

告警选项卡

SLA 选项卡