核心功能
- 通用数据库连接:支持主流数据库平台。
- 驱动程序支持:同时支持 ADO.NET 和 JDBC 驱动程序。
- 全面的事务管理:具备提交 (Commit) 和回滚 (Rollback) 功能。
- 标准数据库操作:提供查询 (Select)、查找 (Lookup)、更新/插入 (Upsert) 和存储过程 (Stored Procedure) 用于数据操作。
- 高级查询自定义:支持查询自定义和参数绑定。
建立数据库连接
在将 Database 端口添加到工作流之前,必须在本地计算机上配置与数据库的连接。Database 端口中引用且需要许可的数据源,应在知行之桥外部的计算机上完成许可授权。
ADO.NET
知行之桥的 .NET 版本主要使用 ADO.NET 驱动程序。为了让 ADO.NET 提供程序对知行之桥可见,它必须在 machine.config 文件中定义,并在全局程序集缓存 (GAC) 中注册。熟悉相关操作的用户可以手动完成此过程,但 知行软件建议在托管知行之桥的计算机上安装数据库客户端,因为数据库特定的安装向导会处理提供程序的定义和注册。JDBC
为了让 JDBC 驱动程序对知行之桥可见,它必须作为 Java 类路径的一部分包含在内。知行之桥包含 H2、MySQL、PostgreSQL 和 SQL Server 的驱动程序;如需将其他驱动程序添加到类路径,请参阅 Java Web servlet 的文档。除了默认选项之外,Database 端口还支持其他数据库的 JDBC 驱动程序。但是,自定义驱动程序可能需要覆盖端口发出的查询,以符合数据库预期的语法。可以使用 Input Mapping 或 Output Mapping 的 Write custom query 部分覆盖查询。
配置 Database 端口
配置数据库连接后,可以将 Database 端口添加到知行之桥工作流中。必须在 Database 端口的每个实例中输入数据库连接凭据。 按照以下步骤建立连接:- 将 Database 端口拖入知行之桥工作流,并为其命名。
- 在 Settings 选项卡的 Database Connection 部分,从列表中选择 Driver Name。Driver Class 会自动填充。
-
选择 Settings Format。
- 如果选择 Property List,请填写驱动程序特定的属性。这些属性因驱动程序而异。
- 如果选择 Connection String 或 DatabaseURL,请向数据库提供完整的连接字符串。
- 单击 Test Connection,确保知行之桥可以连接到 Database。如果发生错误,请检查所有字段并重试。
- 单击 Save Changes。
其他数据库连接
Database Connection 下拉菜单包含一个 Other 选项。选择 Other 时,会出现 Connection Type 选项,要求选择 ADO.NET 或 ODBC。- 如果选择 ADO.NET,请输入 Driver Class、Data Source、User 和 Password 详细信息。
- 如果选择 ODBC,请确保已按照以下说明创建系统 DSN,然后在 Data Source Name 中选择它。填写 Driver、User 和 Password 详细信息。
ODBC
通过 ODBC 驱动程序连接数据库需要数据源名称 (DSN)。可以使用 Microsoft ODBC 管理器创建 DSN。CData 必须为 ODBC 驱动程序使用系统 DSN 连接。创建 DSN 后,在端口的 Data Source Name 下拉列表中选择它。 Database 端口支持默认选项之外的其他数据库 ODBC 驱动程序。但是,自定义驱动程序可能需要覆盖端口发出的查询,以符合数据库预期的语法。有关更多信息,请参阅预处理和后处理查询。也可以在 Select 操作中使用 Write custom queries 选项。选择一个操作
与 Database 建立连接后,必须选择 Database 端口将执行的操作。下表概述了每个操作及其在知行之桥工作流中的位置。高级选项卡
高级选项卡上的许多设置都是从正在使用的数据源动态加载的,因此本文档中未介绍这些设置。可以在我们网站的在线帮助文件页面上找到数据源的详细信息。 下面描述的选项适用于所有数据源。消息
保存至 Sent 文件夹和Sent 文件夹方案设置已弃用,默认处于隐藏状态。只有先前已启用这些设置或将其配置为非默认值的端口才会显示它们。若要保留成功处理的文件副本,请在工作流中右键单击该端口,选择显示成功路径,然后将成功路径连接到File 端口。
高级设置
高级设置 是依赖任意数据库驱动程序(例如 Database、CData 和 API 端口)以连接到各种数据源的端口的通用设置。其它
其它设置 适用于特定用例。自动化选项卡
自动化设置
与端口自动处理文件相关的设置。性能
与分配给端口的资源相关的设置。通知选项卡
与配置通知相关的设置。 在执行服务等级协议 (SLA) 之前,需要设置电子邮件通知。默认情况下,知行之桥使用通知选项卡上的全局设置。要为此端口使用其他设置,请启用 覆盖全局设置。 默认情况下,错误通知已启用,这意味着每当发生错误时都会发送电子邮件。要关闭它们,请取消选中 启用 复选框。 输入 主题(必填),然后可选地输入以逗号分隔的 收件人 电子邮件列表。SLA 选项卡
与配置服务等级协议 (SLA) 相关的设置。 SLA 允许配置期望工作流中的端口发送或接收的数据量,并设置期望达到该数据量的时间范围。当 SLA 未满足时,知行之桥会发送电子邮件警告用户,并将 SLA 标记为 有风险,这意味着如果 SLA 很快仍未满足,则会被标记为 已违反。这使用户有机会介入并确定 SLA 未满足的原因,并采取适当措施。如果在风险时间段结束时仍未满足 SLA,SLA 会被标记为已违反,并再次通知用户。 要定义 SLA,请启用 预期数据量,然后单击 设置 选项卡。
- 如果端口具有单独的发送和接收操作,请使用单选按钮指定 SLA 适用的方向。
- 在窗口的 预计至少 部分:
- 设置期望处理的最小事务数(数量)
- 使用 每 字段指定时间范围
- 指定 SLA 应何时生效。如果选择 开始于,请填写日期和时间字段。
- 勾选希望 SLA 生效的星期几。如有需要,使用下拉菜单选择 每天。
- 在窗口的 将状态设置为“有风险” 部分,指定何时应将 SLA 标记为有风险。
- 默认情况下,只有违反 SLA 后才会发送通知。若要更改此设置,请选中 发送“有风险”通知。

如有必要,可以关闭 SLA 通知。这在维护窗口期间非常有用。单击导航栏上的 Settings,然后导航到 Alerts > General Alerts。单击平板和铅笔图标进行编辑,并取消选中 SLA Alerts 设置。
宏
在文件命名策略中使用宏可以提高组织效率和对数据的上下文理解。通过将宏合并到文件名中,可以动态包含标识符、时间戳和消息头信息等相关信息,为每个文件提供有价值的上下文。这有助于确保文件名反映对组织重要的详细信息。 知行之桥支持这些宏,它们都使用以下语法:%Macro%。
示例
某些宏(例如 %Ext% 和 %ShortDate%)不需要参数,但其他宏需要。所有带参数的宏都使用以下语法:%Macro:argument%
以下是一些带参数宏的示例:
- %Header:headername%:其中
headername是消息上消息头的名称。 - %Header:mycustomheader% 替换为输入消息上设置的
mycustomheader消息头的值。 - %Header:ponum% 替换为输入消息上设置的
ponum消息头的值。 - %RegexFilename:pattern%:其中
pattern是正则表达式模式。例如,%RegexFilename:^([\w][A-Za-z]+)%会匹配并替换为文件名中的第一个单词,且不区分大小写(test_file.xml替换为test)。 - %Vault:vaultitem%:其中
vaultitem是保管库中项目的名称。例如,%Vault:companyname%替换为保管库中存储的companyname项的值。 - %DateFormat:format%:其中
format是可接受的日期格式(详见示例日期格式)。例如,%DateFormat:yyyy-MM-dd-HH-mm-ss-fff%替换为文件上的日期和时间戳。
- 在一个文件名中组合多个宏:
%DateFormat:yyyy-MM-dd-HH-mm-ss-fff%%EXT% - 包含宏之外的文本:
MyFile_%DateFormat:yyyy-MM-dd-HH-mm-ss-fff% - 在宏中包含文本:
%DateFormat:'DateProcessed-'yyyy-MM-dd_'TimeProcessed-'HH-mm-ss%