创建或编辑协议

  • 项目

本主题介绍如何创建或编辑贸易合作伙伴协议。 贸易合作伙伴协议对贸易合作伙伴双方之间的关系做出规定，其中包括身份、合作伙伴接口流程 (PIP)、操作 URL、信号 URL、同步 URL 及相关协议。

贸易合作伙伴协议包括有关流程配置、本组织、合作伙伴及协议的设置。 所有这些设置都是协议所必需的。 您可以根据 RosettaNet PIP 或自定义架构创建流程配置，但是，您必须创建此配置。 还必须定义主组织和合作伙伴组织。 Microsoft BizTalk Accelerator for RosettaNet (BTARN) 不支持未知方之间的消息交换。

BTARN 基于所有这些设置处理和验证消息。 例如，对于 CIDX 消息，BTARN 仅根据 RosettaNet 实现框架 (RNIF) 版本 (1.1 进行验证，仅) 0A1 协议 (No 0A1 仅) ，属性 Is Single Action (仅单操作) 。 仅当将 RNIF 版本设置为“1.1”，将 0A1 协议设置为“No 0A1”，并将 Is Single Action 属性设置为 True时，才会验证 CIDX 消息。 BTARN 还会验证任何协议属性是否与进程配置文件设置一致。 例如，它将验证是否已将配置文件的 属性设置为 Standard “CIDX”，以及协议的 0A1 协议属性是否设置为“No 0A1”。

如果您在活动流程存在时更改协议，则可能产生无法预知的结果。 单击“ 应用 ”或“ 确定 ”接受协议属性更改后，将立即应用对协议属性所做的更改，但无法预测进程的哪个阶段正在运行。 更改协议后，当前流程中的任何新活动或任何新流程将使用已更改的协议属性。 但是，当您更改协议时，某个正在运行的流程可能已对正在处理的消息使用了先前的协议属性。

创建协议后，您必须将其激活，以便能够发送或接收与该协议相关联的消息。 您也可以停用协议，以防止发送或接收与协议相关联的消息。 要编辑某协议，您必须将其停用，然后在编辑后重新激活。

BTARN 将此信息保存在 BTARNCONFIG 数据库的 TPAConfig 表中。

贸易合作伙伴协议中的设置如下表所示，按选项卡排列。默认设置是最常用的值。 创建和编辑这些设置的过程在下表之后介绍。

选项卡 设置 使用情况
常规 名称 协议的唯一名称，如 Fabrikam_To_Contoso_3A2。

必填字段。
常规 进程配置 PIP 的标识符。

此数字将标识哪一流程配置与此协议相关联。

默认值为流程配置列表中的第一项。 下拉列表包括以前输入的所有流程配置。

必填字段。
常规 我的组织 本组织，可从下拉列表中选择。

必填字段。
常规 合作伙伴组织 合作伙伴组织，可从下拉列表中选择。

必填字段。
常规 说明 关于贸易合作伙伴协议的说明。
常规 RNIF 版本 BTARN 将用于协议通信的 RNIF 版本。

可以是 V01.10.00 或 V02.00.01 ， (默认) 。

对于 CIDX，必须为 V01.10.00 。
常规 主角色 本组织的角色。

可以是发起方角色或响应方角色。
常规 0A1 协议 发生故障时，BTARN 是否会 (0A1 PIP) 返回失败通知消息。

可以是 No 0A1 (默认) 或 0A1。

对于 CIDX，必须为 No 0A1 。
常规 使用情况 指明协议将使用的方案的类型。

可以是 测试 (默认) 或 生产。
常规

(应用程序适配器 区域) 		程序集名称 ApplicationAdapter 的文件名，可从文件系统中选择该文件名。

默认值为空字符串。
常规

(应用程序适配器区域) 		类名 BTARN 将从 ApplicationAdapter 使用的类的名称。

默认值为 <none>。
常规

(验证适配器区域) 		程序集名称 ValidationAdapter 的文件名，可从文件系统中选择该文件名。 默认值为空字符串。
常规

(验证适配器区域) 		类名 BTARN 将从 ValidationAdapter 使用的类的名称。

默认值为 <none>。
端口 操作 URL 本组织要将操作消息传送到的 URL。 例如，http://FabrikamServer/BTARNApp/RNIFReceive.aspx。

如果以下全部为真，则此字段为必需字段：

- “ 同步 进程配置”设置为 False。

- “ 是单个操作 ”进程配置设置为 True。

- 主角色 协议设置为 发起方。

如果满足以下条件，则这也是必填字段 (在这种情况下，) 也需要 “信号 URL” 字段：

- “ 同步 进程配置”设置为 False。

- “ 是单个操作 ”进程配置设置为 False。

- 必须在此字段中输入有效的 URI，该 URI 以“”或“<http://domain>”<https://domain>开头。
端口 信号 URL 本组织要将信号消息传送到的 URL。 例如，http://FabrikamServer/BTARNApp/RNIFReceive.aspx。

如果以下为真，则此字段为必需字段：

- “ 同步 进程配置”设置为 False。

- “ 是单个操作 ”进程配置设置为 True。

- 主角色 协议设置为 响应方。

如果满足以下条件，则这也是必填字段 (在这种情况下，) 还需要 “操作 URL” 字段：

- “ 同步 进程配置”设置为 False。

- “ 是单个操作 ”进程配置设置为 False。

必须在此字段中输入有效的 URI，该 URI 以“”<http://domain>或“”<https://domain>开头。
端口 同步 URL 本组织通过 HTTP 适配器建立连接时所使用的 URL。 例如，http://FabrikamServer/BTARNApp/RNIFReceive.aspx。

如果以下为真，则此字段为必需字段：

- “ 同步 进程配置”设置为 True。

- 主角色 协议设置为 发起方。

必须在此字段中输入有效的 URI，该 URI 以“”<http://domain>或“”<https://domain>开头。
协议 摘要方法 用于计算传入消息摘要的协议，以确保不可否认性。

从 BizTalk Server 2016 及更新版本开始，将自动包含 SHA2 支持。 选项包括： MD5、 SHA-1、 SHA-256 (默认) 、 SHA-384 和 SHA-512。

对于以前的BizTalk Server版本，选项包括 MD5 或 SHA-1 (默认) 。

即使用于加密消息的协议与协议的此选项卡上的 “编码 ”设置不匹配，BTARN 接收管道也会接收和解密消息。 因此，BTARN 接收在 RC2-40 或 3DES 中加密的消息。

所有传出签名消息的摘要为 SHA-1。
协议 将所有部分编码 系统是否对多部分消息的所有部分进行集中编码。

可以是 True 或 False (默认) 。

当时True，多部分消息的所有部分将使用 属性指示 Encoding 的方法一起编码。

当 为 时 False，系统将仅使用 属性指示 Encoding 的方法对附件进行编码。 (附件始终由发送管道使用 property 指示的方法 Encoding 进行编码。) 默认情况下，将此属性设置为 False时，BTARN 会将消息的其他部分 (RNIF 2.01 中的四个部分编码，RNIF 1.1 中的三个部分) 采用带引号打印的格式。
协议 编码 如果“编码所有部件”框 True) ，则用于对所有部件 (编码的协议;如果) “编码所有部件”框False，则为附件 (。

可以是 8 位、base 64 (默认) 或带引号打印。
协议 加密算法 用于对传入或传出消息进行加密的算法。

从 BizTalk Server 2016 及更新版本开始，将自动包含 AES 支持。 选项包括 RC2-40、 3DES、 AES128 (默认) 、 AES192 和 AES256。

对于以前的BizTalk Server版本，选项包括 RC2-40 (默认) 或 3DES。

只有在相应的进程配置中将 属性设置为 Is Persistent Confidentiality RequiredPayload 或 Payload Container 时，加密算法才会生效。
协议 加密方向 系统将加密传入消息或传出消息，或者对二者都加密。

可以是 入站、 出站或 入站/出站 (默认) 。

只有在相应的进程配置中将 属性设置为 Is Persistent Confidentiality RequiredPayload 或 Payload Container 时，加密方向设置才会生效。
自定义属性 名称 自定义属性的名称。

您可以为每份协议设置自定义属性。 如果您新建了自定义专用流程，那么您可以在处理不同协议时使用这些自定义属性。

可以使用 RuntimeConfig.GetTPACustomConfigValue BTARN SDK 中的 方法从 BTARN 配置中检索自定义属性。

属性 Name 必须唯一且不为空。

您可以输入以下自定义值：

- AAR。 这是“要求接受确认”自定义属性。 此属性仅适用于 RNIF 1.1。 将此设置为 false (不区分大小写) 仅需要回执确认，而不需要接受确认。 如果 AAR 设置为 false 以外的任何内容，则响应方公共进程必须发送接受确认，发起方公共进程需要接受确认。 如果将“AAR”设置为“false”，则确认收到后公用流程即完成。

- HPCC。 这是本组织合作伙伴分类代码。 此属性仅适用于 RNIF 1.1。 使用此属性可以在传出消息的服务头中将本组织合作伙伴的 GlobalPartnerClassificationCode 元素设置为“值”列中的条目。 此值将覆盖本组织配置中的本组织分类属性。 当本组织可以具有多个分类时，可使用此自定义属性。

- PPCC。 这是合作伙伴配置文件分类代码。 此属性仅适用于 RNIF 1.1。 使用此属性可以在传出消息的服务头中将合作伙伴的 GlobalPartnerClassificationCode 元素设置为“值”列中的条目。 此值将覆盖合作伙伴配置中的合作伙伴分类属性。 当合作伙伴可以具有多个分类时，可使用此自定义属性。
自定义属性 值 自定义属性的值。

创建贸易合作伙伴协议

  1. 单击“开始”，指向“所有程序”，指向“Microsoft BizTalk Accelerator for RosettaNet”，然后单击“BizTalk Accelerator for RosettaNet”“管理控制台”。

  2. 在 BTARN 管理控制台中，展开BizTalk Accelerator for RosettaNet。

  3. 右键单击“ 协议”，指向“ 新建”，然后单击“ 协议”。

  4. 在“新建协议属性”对话框中的“ 常规”、“ 端口”、“ 协议”和“ 自定义属性” 选项卡上，输入设置的值。 有关这些设置的信息，请参阅上表。

  5. 单击 “确定” 。

    注意

    只有激活协议之后，BTARN 才接受与该协议有关的消息。

  6. 右键单击右窗格中的协议名称，然后单击“ 激活”。

注意

如果已激活协议，则可以在右窗格中右键单击协议的名称，然后单击“ 停用 ”以防止发送或接收与协议关联的任何消息。

编辑贸易合作伙伴协议

  1. 单击“开始”，指向“所有程序”，指向“Microsoft BizTalk Accelerator for RosettaNet”，然后单击“BizTalk Accelerator for RosettaNet”“管理控制台”。

  2. 在 BTARN 管理控制台中，展开BizTalk Accelerator for RosettaNet，然后单击“协议”节点。

  3. 右键单击要编辑的协议，然后单击“ 属性”。

  4. 在 <协议名称> “属性”对话框中的“ 常规 ”和“ 联系人属性” 选项卡上，根据需要更改设置。 有关这些设置的信息，请参阅上表。

  5. 单击“确定”。

另请参阅

管理配置、证书、数据库和安全性
管理 BTARN 配置