跳转到主要内容
RosettaNet 端口按照 RosettaNet Implementation Framework (RNIF) 标准发送和接收消息。

核心功能

  • 支持 RNIF 1.1 和 2.0,用于 B2B 文档交换
  • 支持按伙伴配置自动路由消息,并提供灵活的加密/签名选项
  • 基于证书的安全性,支持同步/异步确认处理

概述

RosettaNet 连接需要在两个位置配置。首先在 RosettaNet 个人设置页面中配置本地 RosettaNet 标识符和私有证书。然后为每个交易伙伴配置单独的 RosettaNet 端口及其连接设置。当 RosettaNet 端口处理输入文件时,该文件会被打包并发送给指定的交易伙伴。 当 知行之桥 通过 RosettaNet 接收到文件时,会尝试将该文件路由到特定的 RosettaNet 端口。应用程序使用 RosettaNet 消息中的 RosettaNet 标识符来确定哪个 RosettaNet 端口应接收该文件。当文件被路由到 RosettaNet 端口时,该文件会放入端口的交易选项卡,或传递给工作流中的下一个端口。

个人设置配置

必须先配置 RosettaNet 个人设置,才能与各个 RosettaNet 端口建立连接。单击导航栏上的个人设置,然后单击 RosettaNet 选项卡。

RosettaNet 个人设置选项卡

个人信息

用于标识本地个人设置的设置。

个人证书

与私有解密和签名证书相关的设置。

应用程序 URL

与从公共 Web 访问 知行之桥 相关的设置和显示值。

其他设置

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

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

端口配置

配置全局 RosettaNet 个人设置后,在工作流页面为每个交易伙伴创建并配置单独的 RosettaNet 端口。

设置选项卡

配置

_用于标识和连接到特定 RosettaNet 交易伙伴的设置。

连接信息

与指定交易伙伴的连接参数相关的设置。

确认

与 RosettaNet 确认相关的设置。

交易伙伴证书

与交易伙伴提供的公钥证书相关的设置。

高级选项卡

备用本地个人设置

覆盖此特定 RosettaNet 端口在个人设置页面上的配置。设置备用本地个人设置可让你为某些交易伙伴使用不同的本地证书和标识符。

TLS 客户端身份验证

与需要双向 TLS 身份验证时的客户端身份验证相关的设置。

HTTP 身份验证

与 HTTP 客户端身份验证相关的设置。

高级设置

_不属于前述类别的设置。

代理设置

这是一组用于识别连接所经代理并对其进行身份验证的设置。默认情况下,本节使用 安全设置 页面的 代理设置 部分中的全局设置。清除此复选框可为您的端口提供特定的设置。

设置描述
代理类型基于代理的防火墙使用的协议。
代理主机基于代理的防火墙的名称或 IP 地址。
代理端口基于代理的防火墙的 TCP 端口。
代理用户用于通过基于代理的防火墙进行身份验证的用户名。
代理密码用于对基于代理的防火墙进行身份验证的密码。
身份验证方案保留默认值 None 或选择以下身份验证方案之一:Basic、Digest、Proprietary 或 NTLM。

消息

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

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

日志

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

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

其他设置

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

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

自动化选项卡

自动化设置

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

性能

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

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

告警选项卡

SLA 选项卡

建立连接

配置新的 RosettaNet 端口时,交易伙伴必须提供部分所需的连接详细信息。这些详细信息至少应包括:
  • 业务标识符
  • 伙伴 URL
  • 伙伴证书

业务标识符

在 RosettaNet 交易中,交易伙伴由其业务标识符标识。发送传出请求时,业务标识符用于请求标头中以指示接收方。 若要建立 RosettaNet 自测,标识符应设置为与个人设置页面上的业务标识符相同的值。
此值区分大小写。

伙伴 URL

伙伴 URL 是交易伙伴接收 RosettaNet 传输的端点。传出的 RosettaNet 消息会发送到此目标端点,该端点对每个交易伙伴必须唯一。你可以使用 Web 浏览器测试伙伴 URL,以检查网络或连接问题。 若要建立 RosettaNet 自测,目标 URL 应与个人设置页面上的接收 URL 相同或几乎相同。你可以将个人设置页面中的域名替换为环回地址 localhost,以使 RosettaNet 交易保留在本地网络中。本地自测 URL 示例为 http://localhost:8001/pub/Receive.rsb。 如果未将域名替换为 localhost,RosettaNet 消息会路由到本地网络之外。你可以利用此方式检查网络配置设置,并确保消息可以通过任何防火墙到达 知行之桥。

伙伴证书

每个 RosettaNet 端口都必须为目标交易伙伴配置证书。交易伙伴会提供与其交换 RosettaNet 消息时进行加密和验证所需的证书。知行之桥 接受 X.509 公钥证书(扩展名为 .cer、.der 或 .pem 的文件)。 通常,交易伙伴会提供一个证书,应将其配置在加密证书字段中。 如果交易伙伴提供多个证书,应说明每个证书的用途。如果伙伴提供完整证书链(例如从商业证书颁发机构获取),则只需要配置叶证书(链中的最后一个证书)。

发送和接收文件

配置 RosettaNet 个人设置和特定伙伴的 RosettaNet 端口后,即可安全地发送和接收文件。

发送文件

在 RosettaNet 端口中,交易选项卡显示要发送给目标交易伙伴的文件。如果在自动化选项卡上启用了发送自动化,到达端口交易选项卡的文件会自动打包并发送。展开与已传输文件关联的行即可访问所有传输的日志文件。 在交易选项卡上,选择更多 > 创建测试文件以生成一组简单的测试文件并发送给交易伙伴。

重新发送和重试

当预期交易伙伴返回异步确认,但未能在重新发送间隔时长内(默认为 60 分钟)返回时,会触发 RosettaNet 重新发送。随后应用程序会尝试重新发送传输。应用程序会继续重新发送消息,直到收到确认为止或**最大次数(异步)**用尽。 当交易伙伴的 HTTP 响应表明服务器未收到传输时,会触发重试。这可能表示网络或连接问题,通常是暂时性的。应用程序每隔重试间隔分钟重试传输,直到传输被接收或最大次数用尽。

接收文件

在 RosettaNet 端口中,交易选项卡显示应用程序已接收并路由到该端口的文件(基于传入 RosettaNet 消息中存在的 RosettaNet 标识符)。展开每个文件行可显示该传输的可用日志列表。 这些文件可在端口的交易选项卡上查看。如果端口连接到工作流中的其他端口,文件会自动从 RosettaNet 端口的交易选项卡移动到工作流中下一个端口的交易选项卡。 RosettaNet 协议不允许主动从交易伙伴拉取文件:RosettaNet 端口只能被动等待交易伙伴发送文件。

配置 PIP

Partner Interface Processes (PIP) 是 RosettaNet 用于传输各种业务流程信息的逻辑 XML 文档。下面列出了常见 PIP:

宏

示例