跳转到主要内容
Script 端口提供了执行 知行之桥 内置端口中不可用的函数或操作的能力。

核心功能

  • 使用 ArcScript 或 Python 实现自定义业务逻辑
  • 访问完整的消息上下文,包括消息标头和文件内容
  • 集成外部库和系统命令 (Python)
  • 支持复杂的数据转换和业务规则处理

概述

Script 端口使用强大的 ArcScript 脚本语言来完成各种自定义行为。每当文档被放入端口的事务选项卡时,端口中配置的脚本就会运行。脚本可以读取和修改输入文档,也可以让输入文档仅触发端口中配置的外部函数。Script 端口也可以通过自动化选项卡上的接收自动化按计划运行。 以下是可配置 Script 端口执行的一些任务:
  • 使用自定义 SQL 查询返回的数据替换输入文档中的值
  • 调用自定义 Web 服务以触发专用工作流
  • 通过 sysExecute 操作运行外部脚本或可执行文件
为 Script 端口确定合适的任务后,请阅读脚本文档,了解如何使用 ArcScript 调用各种操作。

端口配置

本节包含所有可配置的端口属性。

Script 选项卡

与编写和测试脚本相关的选项。

操作

设置选项卡

配置

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

高级设置

高级选项卡

消息

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

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

日志

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

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

其他设置

杂项

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

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

自动化选项卡

自动化设置

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

性能

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

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

警报选项卡

SLA 选项卡

事务选项卡

此选项卡列出了与端口关联的所有消息。使用搜索栏查找特定消息,或单击漏斗图标应用过滤器。您可以按时间、消息方向和/或状态进行过滤。 此选项卡上的选项会因端口的操作类型而异:
  • 如果端口是触发器,请使用接收按钮启动工作流。
  • 如果端口是转换或终结,请使用上传文件按钮将文件上传到工作流。

使用 arc:push 关键字

arc:push 关键字通常用于 Script 端口,以将项目传递到脚本的输出 Feed。此外,当从“插入选项”菜单中选择 Output 属性时,如果脚本中尚未包含 arc:push 关键字,知行之桥 会自动注入该关键字,以确保脚本正常运行。以下是三个常见用例。 1 创建并输出文件:
2 将输入文件作为输出传递:
3 向 Script 端口日志文件写入条目:

宏

示例