RosettaNet 端口

Version 24.3.9111

RosettaNet 端口

RosettaNet 端口通过 RosettaNet 协议发送和接收消息。

概述

RosettaNet 连接在两个地方配置。RosettaNet 个人设置部分应该配置本地 RosettaNet 标识符和私钥证书。然后，每个 RosettaNet 端口应该配置有特定于单个交易伙伴的连接设置。当输入文件被 RosettaNet 端口处理时，会被打包并发送给指定的交易伙伴。

当通过知行之桥的 RosettaNet 端口接收到文件时，会尝试将该文件路由到特定的 RosettaNet 端口。应用程序使用 RosettaNet 消息中的 RosettaNet 标识符来确定哪个 RosettaNet 端口应该接收该文件。当文件被路由到 RosettaNet 端口时，该文件被放置在端口的接收目录中，或者被传递到工作流中的下一个连接的端口。

个人设置

在与单个 RosettaNet 端口建立连接之前，必须配置 RosettaNet 个人设置。

RosettaNet 个人设置

个人信息

用于标识本地配置文件的设置。

业务标识符 你的标识符。知行之桥发送的消息将在传出消息中包含该值，以识别发送者。传入消息必须寻址到此标识符。标识符区分大小写。
业务位置 描述接收传入消息的接收者的位置。该值不是地址，但可能是城市名称。

个人证书

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

私钥证书 用于解密传入消息和对发出消息的签名证书。此证书不得与任何外部人员共享。单击“创建证书”按钮，生成一个新的自签名证书，以便在 RosettaNet 交易中使用；还将生成具有相同文件名和 .cer 扩展名的相应公钥。
证书密码 访问私钥证书所需的密码。

应用程序 URL

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

接收 URL 知行之桥用来侦听传入 RosettaNet 消息的 URL。这个网址应该通知给所有交易伙伴。

特殊设置

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

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

端口配置

配置 RosettaNet 个人设置后，可以在工作流页面中创建 RosettaNet 端口，并为特定的交易伙伴进行配置。

设置

配置

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

端口 Id 端口的静态、唯一标识符。
端口类型 显示端口类型及其用途的描述。
端口描述 一个可选字段，用于提供端口及其在流中的角色的自由格式描述。
业务标识符 特定于目标交易伙伴的标识符。此值包含在发出消息的 RosettaNet 头部，还用于将传入的 RosettaNet 消息路由到适当的 RosettaNet 端口。
业务位置 待发消息接收方的位置。
交易伙伴 URL 交易伙伴的公共接口。

连接信息

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

RNIF 版本 生成 RosettaNet 消息时使用的协议版本。
加密类型 是否加密有效载荷，加密有效载荷和头，或者都不加密。
数据签名 是否对待发送的消息进行签名。
数据安全性 是否要求对传入的消息进行签名和加密。如果收到的消息没有所需的安全参数，将引发错误。
连接超时（秒） 端口在引发超时错误之前等待连接响应的时间。
测试标识符 控制前导码消息头中的GlobalUsageCode。选中此项以将代码设置为“测试”。如果未选中，则代码为“Production”。仅当 RNIF 版本 为 1.1 时才需要。

功能性ACK

与 RosettaNet 确认相关的设置。

自动发送 ACK 是否应自动发送 ACK 以响应传入的 RosettaNet 消息。
自动发送异常 是否应自动发送异常以响应失败的消息接收。
请求 ACK 是否应该响应传出的 RosettaNet 消息返回 ACK。
安全性 ACK 是否应包括验证消息完整性和接收者身份的签名块。
传输 ACK 是应该作为对传出 RosettaNet 消息的直接响应返回（同步），还是稍后作为单独连接的一部分返回（异步）。除非 RosettaNet 消息非常大，否则建议使用同步 ACK，在这种情况下，处理消息和传递同步 ACK 可能会增加连接超时持续时间。

交易伙伴证书

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

加密证书 发送消息时用于 RosettaNet 加密的公钥证书。此证书必须与交易伙伴的私钥证书配对，并且在共享 RosettaNet 配置详细信息时，交易伙伴应提供此公钥证书。
验证证书 接收消息时用于验证 RosettaNet 签名的公钥证书。该字段通常是不必要的；大多数 RosettaNet 方将使用相同的私有证书进行签名和解密，如果未指定此字段，应用程序将使用加密证书来验证签名。
TLS 服务器证书 用于验证 TLS／SSL 服务器身份的公钥证书。仅在交易伙伴的 RosettaNet 系统需要 HTTPS（而不是 HTTP）时才需要。如果交易伙伴不提供 SSL 服务器证书，此设置可以留空，以允许底层 OS／JVM 执行证书验证，或者将其设置为 “Any Certificate”，以无条件信任目标服务器的身份。

自动化

自动化设置

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

发送到达端口的文件是否会自动作为 RosettaNet 消息发送。
重试间隔 重试发送失败之前的时间。当服务器没有对发送尝试做出响应，或者对未收到文件的通信做出否定响应时，会触发重试。
最大重试次数 端口处理输入文件的最大次数。是否成功基于服务器相应和回执的验证（如需要回执）。如果设置为 0，那么端口将无限次尝试处理失败文件。
重发间隔 重新发送未收到 ACK 之前的等待时间。当服务器收到文件时，但在预期的时间范围内未提供异步 ACK，就会触发重发。
最大重发尝试次数（异步） 如果需要异步回执时，端口处理输入文件的最大次数。是否成功基于服务器在正确相应后异步回执是否在重发间隔内返回（如果服务器没有正确响应，那么最大重试次数会被使用）。如果设置为 0，那么端口将无限次尝试处理失败文件。

性能

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

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

通知

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

端口邮件设置

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

服务等级协议 (SLA) 配置

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

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

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

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

高级设置

首选个人设置

覆盖此特定 RosettaNet 端口的个人设置页面中的 RosettaNet 配置。设置备用本地配置文件允许对某些交易伙伴使用不同的本地证书和标识符。

业务标识符 你的位置。将覆盖个人设置部分中的业务标识符。
业务位置 你的标识符。将覆盖个人设置部分中的业务位置。
私钥证书 用来解密传入消息和发出消息签名的证书。将覆盖个人设置部分中的私有证书。
证书密码 访问本地私钥证书所需的密码。

TLS 客户端身份验证

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

使用“个人设置” 是否使用在个人设置页面中配置的相同私钥证书作为客户端身份验证的 TLS 证书。
私钥证书 在 TLS 客户端身份验证期间提供的私有证书。仅适用于不使用个人设置页面中相同私有证书的情况。
证书密码 访问 TLS 客户端证书所需的密码。

HTTP 身份验证

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

使用 HTTP 身份验证 是否启用客户端 HTTP 身份验证。
HTTP 认证类型 是否以加密格式（摘要）还是以纯文本格式（基本）提供 HTTP 身份验证凭据。只有当连接是 HTTPS 连接（而不是 HTTP）时，才应该使用基本认证。
用户名 用于 HTTP 客户端身份验证的用户名。
密码用于 HTTP 客户端身份验证的密码。

代理配置

这些是一组设置，用于识别和验证代理，RosettaNet 连接应通过该代理进行路由。默认情况下，此部分使用设置页面上的全局设置。清除该复选框可提供特定于端口的设置。

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

自定义头部

一组任意的包含在发出消息中的自定义头部。

高级设置

设置不包括在以前的类别中。

延迟处理 放置在输入文件夹中的文件的处理延迟的时间量（以秒为单位）。这是一个遗留设置。最佳实践是使用 File 端口来管理本地文件系统，而不是此设置。
RNIF 调试模式 RosettaNet 接收方是否应返回与管道仪表流程验证或发送方认证相关的通信错误。必须在传输的两端启用此设置，才能返回异常。
签名算法 对传出消息进行签名时使用的算法。
启用 TLS 建立传出连接时支持的 TLS／SSL 协议列表。强烈建议仅使用 TLS 协议。一些旧的操作系统不支持 TLS 1.2。
请求安全传输 选中此项以在转发消息时要求安全。

消息

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

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

日志

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

特殊设置

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

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

建立连接

贸易伙伴必须提供配置新的 RosettaNet 端口时所需的一些连接详细信息。这些详细信息至少应包括：

业务标识符
交易伙伴 URL
交易伙伴证书

业务标识符

贸易伙伴通过 RosettaNet 交易中的业务标识符来识别。发送传出请求时，请求消息头中会使用业务标识符来指示收件人。

要建立 RosettaNet 自测试，标识符应设置为与 Profiles 页面上的 Business Identifier 相同的值。

注意：该值区分大小写。

交易伙伴 URL

合作伙伴 URL 是贸易伙伴接收 RosettaNet 传输的接口。传出的 RosettaNet 消息被发送到此目标接口，这对于每个贸易伙伴来说都是唯一的。可以使用 Web 浏览器测试合作伙伴 URL，以检查网络或连接问题。

要建立 RosettaNet 自测试，目标 URL 应与 Profiles 页面上的 接收 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

交易伙伴接口流程（PIPs）是 RosettaNet 用来传输各种业务流程信息的逻辑 XML 文档。以下是常见管道点的列表：

3A1	Request Quote	请求报价
3A2	Request Price and Availability	请求价格和可用性
3A3	Request Shopping Cart Transfer	请求购物车转移
3A4	Request Purchase Order	请求采购订单
3A5	Query Order Status	查询订单状态
3A6	Distribute Order Status	分发订单状态
3A7	Notify of Purchase Order Update	采购订单更新通知
3A8	Request Purchase Order Change	请求采购订单更改
3A9	Request Purchase Order Cancellation	请求取消采购订单
3A10	Notify of Quote Acknowledgement	报价确认通知
3A13	Notify of Purchase Order Information	采购订单信息通知
3A14	Distribute Planned Order	分发计划订单
3B1	Distribute Transportation Projection	分布式运输计划
3B2	Notify of Advance Shipment	提前装运通知
3B3	Distribute Shipment Status	分发装运状态
3B4	Query Shipment Status	查询装运状态
3B5	Request Shipment Change	请求装运更改
3B6	Notify of Shipments Tendered	招标装运通知
3B11	Notify of Shipping Order	发货通知
3B12	Request Shipping Order	请求发货单
3B13	Notify of Shipping Order Confirmation	发货订单确认通知
3B14	Request Shipping Order Cancellation	请求取消发货订单
3B18	Notify of Shipment Documentation	装运文件通知
3C1	Return Product	返料
3C2	Request Financing Approval	请求融资批准
3C3	Notify of Invoice	发票通知
3C4	Notify of Invoice Reject	发票拒绝通知
3C5	Notify of Billing Statement	账单通知
3C6	Notify of Remittance Advice	汇款通知
3C7	Notify of Self-Billing Invoice	自开发票的通知