本主题介绍如何创建或编辑贸易合作伙伴协议。 贸易伙伴协议配置两个贸易伙伴之间的关系，包括他们的身份、合作伙伴接口流程 (PIP)、行动、信号和同步网址，以及关联的协议。
贸易合作伙伴协议包括流程配置、家庭组织、合作伙伴和协议的设置。 协议需要所有这些设置。 可以基于 RosettaNet PIP 或自定义架构创建进程配置，但必须创建配置。 还必须定义家庭组织和合作伙伴组织。 Microsoft BizTalk Accelerator for RosettaNet （BTARN） 不支持未知方之间的消息交换。
BTARN 基于所有这些设置处理和验证消息。 例如，对于 CIDX 消息，BTARN 基于 RosettaNet 实现框架（RNIF）版本（仅 1.1）、0A1 协议（不包括非 0A1）和 Is Single Action 属性（仅限单动作）进行验证。 仅当将 RNIF 版本设置为“1.1”时，CIDX 消息才会验证，0A1 协议设置为“No 0A1”，并将 Is Single Action 属性设置为 True。 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。如果满足以下条件，则为必填字段： - Is Synchronous进程配置设置 False。- Is Single Action 过程配置设置是 True。- 主角色 协议设置为 发起者。 如果满足以下条件，则此字段也是必填字段（在这种情况下，还需要 信号 URL 字段）： - “Is Synchronous”进程配置设置为 False。- 是否为单个操作流程配置设置 False。- 必须在此字段中输入有效的 URI，该 URI 以“”< http://___domain>或“”<https://___domain>开头。 |
| 端口 | 信号 URL | 主组织将发送信号消息的 URL。 例如，http://FabrikamServer/BTARNApp/RNIFReceive.aspx。如果满足以下条件，则为必填字段： - Is Synchronous进程配置设置为 False。- “是否单一动作” 是进程配置设置的选项。 True- 主角色 协议设置为 响应者。 如果满足以下条件，则此字段也是必填字段（在这种情况下，还需要操作 URL字段）： Is Synchronous 进程配置设置是 False。- 为单动作进程配置设置为 False。必须在此字段中输入有效的 URI，该 URI 以“”< http://___domain>或“”<https://___domain>开头。 |
| 端口 | 同步 URL | 主组织用于通过 HTTP 适配器建立连接的 URL。 例如，http://FabrikamServer/BTARNApp/RNIFReceive.aspx。如果满足以下条件，则为必填字段： - 是否同步进程配置设置是 True。- 主角色 协议设置为 发起者。 必须在此字段中输入有效的 URI，该 URI 以“”< http://___domain>或“”<https://___domain>开头。 |
| 协议 | Digest 方法 | 用于计算传入消息摘要以用于不可否认目的的协议。 从 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属性指示的方法对附件进行编码。 （附件始终由发送管道使用属性指示 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。 仅当在相应的进程配置中将属性设置为 Payload 或 Payload Container 时， Is Persistent Confidentiality Required加密算法才会生效。 |
| 协议 | 加密方向 | 系统是加密传入消息还是传出消息，还是同时加密这两者。 可以是 入站、 出站或 入站/出站 （默认值）。 仅当在相应的进程配置中将属性设置为 Payload 或 Payload Container 时， Is Persistent Confidentiality Required加密方向设置才会生效。 |
| 自定义属性 | 名称 | 自定义属性的名称。 可以基于每个协议设置自定义属性。 如果创建新的自定义专用进程，则可以使用这些自定义属性来处理不同的协议。 可以使用 RuntimeConfig.GetTPACustomConfigValue BTARN SDK 中的方法从 BTARN 配置中检索自定义属性。该 Name 属性必须是唯一的，而不是空的。可以输入以下自定义值： - AAR。 这是接受确认必需自定义属性。 这仅适用于 RNIF 1.1。 将此设置为 false （不区分大小写）仅要求接收确认，而不是接受确认。 如果 AAR 设置为非 false 的任何值，则响应方公共进程必须发送接受确认通知，并且发起方公共进程将期望收到接受确认通知。 如果 AAR 设置为 false，则公共流程将在收到确认后完成。 - HPCC。 这是家庭合作伙伴分类代码。 这仅适用于 RNIF 1.1。 这样，您可以将传出消息的服务标头中本地合作伙伴的 GlobalPartnerClassificationCode 元素设置为 Value 列中的条目。 此值会覆盖家庭组织配置中的家庭组织分类属性。 当主组织可以有多个分类时，请使用此自定义属性。 - PPCC。 这是伙伴档案分类代码。 这仅适用于 RNIF 1.1。 这样，便可以将传出消息的服务标头中的合作伙伴的 GlobalPartnerClassificationCode 元素设置为 Value 列中的条目。 此值替代合作伙伴配置中的合作伙伴分类属性。 当合作伙伴可以有多个分类时，请使用此自定义属性。 |
| 自定义属性 | 价值 | 自定义属性的值。 |
创建贸易合作伙伴协议
单击“ 开始”，指向 “所有程序”，指向 MicrosoftBizTalk Accelerator for RosettaNet，然后单击“ BizTalk Accelerator for RosettaNet管理控制台”。
在 BTARN 管理控制台中，展开 BizTalk Accelerator for RosettaNet。
右键单击 “协议”，指向“ 新建”，然后单击“ 协议”。
在“新建协议属性”对话框中的“ 常规”、“ 端口”、“ 协议”和“ 自定义属性 ”选项卡上，输入设置的值。 有关这些设置的信息，请参阅上表。
单击 “确定” 。
注释
在激活协议之前，BTARN 将不接受与协议相关的消息。
右键单击右窗格中协议的名称，然后单击“ 激活”。
注释
如果已激活协议，可以在右窗格中右键单击协议的名称，然后单击“ 停用 ”以防止发送或接收与协议关联的任何消息。
编辑贸易合作伙伴协议
单击“ 开始”，指向 “所有程序”，指向 MicrosoftBizTalk Accelerator for RosettaNet，然后单击“ BizTalk Accelerator for RosettaNet管理控制台”。
在 BTARN 管理控制台中，展开 BizTalk Accelerator for RosettaNet，然后单击 “协议” 节点。
右键单击要编辑的协议，然后单击“ 属性”。
在 <协议名称> “属性”对话框中的“ 常规 ”和“ 联系人属性 ”选项卡上，根据需要更改设置。 有关这些设置的信息，请参阅上表。
单击 “确定” 。