Validate 端口

Version 23.4.8843


Validate 端口


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

概述

Validate 端口可配置一条或多条规则,来决定输入的 XML 文件 或消息头是否被视为有效。有效的 XML 或消息头输入将会成功地通过端口,未通过验证的 XML 文件或消息头将会抛出错误且不能在工作流中传输。添加一个验证步骤帮助防止出错。

验证规则配置有一个 Xpath,一个运算符以及一个目标值。对于每个配置的规则,端口将会对比输入 XML 中的值与目标值,来确定是否将其视为有效,更多详情请查阅验证规则部分。

端口配置

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

设置

端口配置

  • 端口 Id 端口的静态、唯一标识符。
  • 端口类型 显示端口类型及其用途的描述。
  • 端口描述 一个可选字段,用于提供端口及其在流中的角色的自由格式描述。
  • 示例文件(可选)表示正在验证的 XML 结构的文件。 如果上传示例文件,规则编辑器会显示文档的树形表示形式,以便可以轻松找到所需的 XPath。

验证

使用 验证 部分添加和配置规则和规则组。 如果输入 XML 和消息标头符合所有配置的规则,则它们被视为有效。 有关定义规则的说明,请参阅验证规则

高级设置

  • 延迟处理 放置在输入文件夹中的文件的处理延迟的时间量(以秒为单位)。 这是一个遗留设置。 最佳实践是使用 File 端口 来管理本地文件系统,而不是此设置。

消息

消息设置 确定端口如何搜索消息并在处理后管理它们。 可以将邮件保存到你的 已发送 文件夹,或者可以根据 已发送 文件夹方案将它们保存,如下所述。

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

日志

  • 日志级别 端口生成的日志的详细程度。 当端口请求支持时,请将其设置为 调试
  • 日志子文件夹方案 指端口根据选定的时间间隔对日志文件夹中的文件进行分组。 例如,Weekly 选项表示端口每周创建一个新子文件夹并将该周的所有日志存储在该文件夹中。 空白设置告诉端口将所有日志直接保存在 Logs 文件夹中。 对于处理大量事务的端口,使用子文件夹有助于保持日志井井有条并提高性能。
  • 保留消息副本 选中此项可使已处理文件的日志条目包含文件本身的副本。 如果禁用此功能,端口可能无法从 输入输出 选项卡下载文件的副本。

特殊设置

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

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

自动化

自动化设置

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

  • 发送 是否自动处理到达端口的消息。

性能

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

  • 最大线程数 从线程池中消耗用于处理此端口上的文件的最大工作线程数。 如果设置,这将覆盖 设置 > 自动化 页面上的默认设置。
  • 最大文件数 分配给端口的每个线程发送的最大文件数。 如果设置,这将覆盖 设置 > 自动化 页面上的默认设置。

通知

与配置警报和服务等级协议 (SLA) 相关的设置。

端口邮件设置

在执行 SLA 之前,需要设置电子邮件警报以获取通知。 单击 配置通知 将打开一个新的浏览器窗口,转到 系统设置,可以在其中设置系统范围的警报。 有关详细信息,请参阅通知

服务等级协议 (SLA) 配置

SLA 能够配置期望工作流中的端口发送或接收的数量,并设置期望满足该数量的时间范围。 知行之桥在不满足 SLA 时发送电子邮件警告用户,并将 SLA 标记为 有风险,这意味着如果很快不满足 SLA,则会将其标记为 已违反。 这使用户有机会介入并确定未满足 SLA 的原因,并采取适当的措施。 如果在风险时间段结束时仍未满足 SLA,则将 SLA 标记为违反,并再次通知用户。

要定义 SLA,请单击 添加预期数量条件

  • 如果端口具有单独的发送和接收操作,请使用单选按钮指定 SLA 所属的方向。
  • 期待至少 设置为期望处理的最小交易数量(交易量),然后使用 字段指定时间范围。
  • 默认情况下,SLA 每天都有效。 要更改此设置,请取消选中每日,然后选中想要的一周中的几天的框。
  • 使用 将状态设置为“有风险” 来指示何时应将 SLA 标记为存在风险。
  • 默认情况下,在违反 SLA 之前不会发送通知。 要更改此设置,请选中 发送“有风险”通知

以下示例显示为预计周一至周五每天接收 1000 个文件的端口配置的 SLA。 如果尚未收到 1000 个文件,则会在该时间段结束前 1 小时发送风险通知。

验证规则

可以通过定义单个规则和/或规则组来构建复杂的验证。 为了便于阅读,请单击栏右侧的扩展器图标 扩展 展开 规则 部分。

要添加验证规则,请单击“添加规则”或“添加组”。

当构建规则时,请使用下拉菜单进行选择并选择的运营商。 可以从以下选项中进行选择:

  • 输入XML
    • 值:正在评估的 XPath 处的值
    • 数据类型:值的数据类型(字符串、数字、日期时间)
    • 出现次数:XPath在文档中出现的次数
  • 消息头
    • 值: 正在评估的消息头的值
    • 值类型:值的数据类型(字符串、数字、日期时间)

当为规则选择 XPath 时,如果上传了示例文件,编辑器会显示文档的树形表示形式,以便可以轻松找到所需的 XPath,如下图所示。

可以对规则和组重新排序。 单击手柄 手柄 并将对象拖动到新位置。

仅当满足所有验证规则(或规则组)时,输入 XML 才被视为有效。 如果在输入 XML 中找不到规则中配置的 XPath,则验证自动失败。 换句话说,如果端口无法读取规则的 XPath 值,则输入文件不会通过该规则。