Skip to main content
CData 端口允许通过向 CData 推送数据或从 CData 拉取数据,将 CData 集成到数据流中。

核心功能

  • 通过 CData 驱动程序(ADO.NET 和 JDBC)支持 200 多种数据源
  • 用于数据操作的标准数据库操作(Select、Lookup、Upsert 和存储过程)
  • 通过缓存提升查询性能
  • 能够仅处理新的或更改的记录
  • 灵活的输出格式(例如 CSV 和 XML)
按照以下步骤将知行之桥连接到 CData。

安装 CData 驱动程序

连接到数据源之前,必须为相应数据源安装 ADO.NET 提供程序(.NET 版本)或 JDBC 驱动程序(跨平台版本)。
CData 端口中引用且需要许可的数据源应在知行之桥之外的计算机上完成许可。

ADO.NET

按照以下步骤下载并运行 ADO.NET 提供程序的 CData 安装程序:
  1. 在数据源列表中找到所需数据源。点击数据源磁贴以打开该数据源页面。
  2. 找到列出可用驱动程序类型的顶部工具栏,然后点击 ADO.NET 磁贴。
  3. 在打开的页面上点击 Download。
  4. 下载试用版(30 天完整功能)或完整提供程序(需要购买许可)。请联系知行之桥许可团队 edi@kasoftware.cn 安排提供程序许可。
  5. 运行下载的安装程序。
  6. 重启知行之桥服务器,使 CData 端口能够检测到新的提供程序。

JDBC

要让 CData 端口识别 JDBC 驱动程序,必须安装该驱动程序,并将其放置在托管知行之桥的 Java 服务器的 lib 文件夹中。
  1. 在数据源列表中找到所需数据源。点击数据源磁贴以打开该数据源页面。
  2. 找到列出可用驱动程序类型的顶部工具栏,然后点击 JDBC 磁贴。
  3. 在下一页点击 Download。
  4. 下载试用版(30 天完整功能)或完整驱动程序(需要购买许可)。选择最符合知行之桥安装环境的下载选项(Windows 使用 .exe,Linux 使用 .zip,Mac 使用 .dmg)。请联系知行之桥许可团队 edi@kasoftware.cn 安排驱动程序许可。
  5. 导航到驱动程序安装目录,并在 /lib/ 文件夹中找到驱动程序 .jar 文件和 .lic(许可证)文件。
  6. 将驱动程序 .jar 和 .lic 文件复制到托管知行之桥的 Java 服务器的 /lib/ 文件夹中。
  7. 重启知行之桥服务器,使 CData 端口能够检测到新的驱动程序。

建立连接

要允许知行之桥使用 CData 中的数据,必须在每个 CData 端口实例中输入连接凭据。CData 连接不能在多个 CData 端口之间重复使用。 按照以下步骤建立连接:
  1. 将 CData 端口拖入知行之桥流程并为其命名。
  2. 在设置选项卡的 Connection 部分,从下拉菜单中选择数据源。
  3. 身份验证步骤因所选数据源而异:
  • 如果出现连接字段,请在每个字段中输入所需信息,然后点击测试连接以确保知行之桥可以连接到 CData。如果发生错误,请检查所有字段并重试。
  • 如果出现连接按钮,请点击它以使用 OAuth 身份验证登录驱动程序。
  1. 点击保存更改。
高级选项卡上还有特定于数据源的身份验证和配置选项。本文档并未全部描述这些选项,但可以在我们网站的在线帮助文件页面找到数据源的详细信息。

选择一个操作

与 CData 建立连接后,必须选择 CData 端口将执行的操作。下表概述了每个操作及其在知行之桥工作流中的位置。

高级页面 (Advanced Tab)

高级选项卡上的许多设置都是从正在使用的数据源动态加载的,因此本文档中未介绍这些设置。可以在我们网站的在线帮助文件页面找到数据源的详细信息。 下面描述的选项适用于所有数据源。

消息

高级设置

高级设置 是依赖任意数据库驱动程序(例如 Database、CData 和 API 端口)连接到各种数据源的端口的通用设置。

其他设置

其他设置 适用于特定用例。

代理设置

自动化页面 (Automation Tab)

自动化设置

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

性能

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

通知选项卡

与配置通知相关的设置。 在执行服务等级协议 (SLA) 之前,需要设置电子邮件通知。默认情况下,知行之桥使用通知选项卡上的全局设置。要为此端口使用其他设置,请开启覆盖全局设置。 默认情况下,错误通知已启用,这意味着每当出现错误时都会发送电子邮件。要关闭错误通知,请取消选中启用复选框。 输入主题(必填),然后可选地输入以逗号分隔的收件人邮箱列表。

SLA 选项卡

与配置服务等级协议 (SLA) 相关的设置。 SLA 可配置期望流程中的端口发送或接收的数量,并设置期望满足该数量的时间范围。当 SLA 未满足时,知行之桥会发送电子邮件警告用户,并将 SLA 标记为_有风险_;这意味着如果 SLA 很快仍未满足,它将被标记为_已违反_。这让用户有机会介入并确定 SLA 未满足的原因,并采取适当措施。如果在风险时间段结束时仍未满足 SLA,则 SLA 会被标记为违反,并再次通知用户。 要定义 SLA,请开启预期数量,然后点击设置选项卡。 Empty SLA configuration
  • 如果端口具有单独的发送和接收操作,请使用单选按钮指定 SLA 所属的方向。
  • 在窗口的期待至少部分:
    • 设置期望处理的最小交易数量(交易量)
    • 使用每字段指定时间范围
    • 指定 SLA 何时生效。如果选择开始于,请完成日期和时间字段。
    • 勾选希望 SLA 生效的星期几。如有需要,使用下拉菜单选择每天。
  • 在窗口的**将状态设置为“有风险”**部分,指定何时应将 SLA 标记为存在风险。
    • 默认情况下,在 SLA 违反之前不会发送通知。要更改此设置,请选中发送“有风险”通知。
以下示例显示为预计周一至周五每天接收 1000 个文件的端口配置的 SLA。如果尚未收到 1000 个文件,则会在该时间段结束前 1 小时发送风险通知。 SLA Configuration Example
如有需要,可以关闭 SLA 警报。这在维护窗口期间非常有用。点击导航栏上的设置,然后导航到通知 > 通用通知。点击平板和铅笔图标进行编辑,并取消选中 SLA 警报设置。

宏

在文件命名策略中使用宏可以提高组织效率和对数据的上下文理解。通过将宏合并到文件名中,可以动态包含标识符、时间戳和消息头信息等相关信息,为每个文件提供有价值的上下文。这有助于确保文件名反映对组织重要的详细信息。 知行之桥支持这些宏,它们都使用以下语法:%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%