环回
使用 Loopback 实用工具可以自动生成环回协议，它是本组织到合作伙伴协议的镜像副本。 这使你能够在单个计算机上执行本组织到合作伙伴以及合作伙伴到本组织的消息交换。 此实用工具可以用于带有 0A1 消息的方案，也可以用于不带 0A1 消息的方案。 你可以为操作-消息（非 0A1）协议或 0A1 协议创建环回协议。
使用该实用工具还可以登记或取消登记发件人角色的本组织。 使用 实用工具启用家庭组织时，它会创建两个发送端口“ <主页>”。异步和 <主页>。同步，组织使用该同步来与其合作伙伴通信。
在 SDK 中的位置
<驱动>\ Program Files (x86) \Microsoft BizTalk <version> Accelerator for RosettaNet\SDK\
正在运行环回
运行 Loopback
打开命令提示符。
移动到 <drive>\ Program Files (x86) \Microsoft BizTalk <version> Accelerator for RosettaNet\SDK\。
在命令提示符下，键入 Loopback，键入所需的相应开关，然后按 Enter。
Loopback 的语法
下面给出了用于启动此命令行实用工具的语法：
Loopback [/enable|/disable <home_organization>] [/mirror|/unmirror <agreement_name>] [/NoF <0A1_agreement>]
语法说明
下表描述了 Loopback 实用工具使用的语法的各个部分。
| 语法 | 说明 |
|---|---|
| enable | 为发件人角色登记home_organization>中指定的<组织。 它创建两个发送端口： <主页>。异步和 <主页>。同步，合作伙伴使用该同步来与主组织通信。 |
| disable | 取消登记发件人角色的本组织。 |
| home_organization | 要登记或取消登记的发件人角色的合作伙伴。 |
| mirror | 基于 agreement_name> 中指定的<协议创建环回协议。 |
| unmirror | 根据agreement_name>中指定的<协议删除环回协议。 |
| agreement_name | 在环回方案中要镜像或取消镜像的协议。 |
| NoF | 将 Loopback 实用工具镜像的操作消息协议的 0A1 协议属性设置为 <0A1_agreement>。 /NoF 开关只能添加到同样包含 /镜像 开关的 Loopback 命令。 |
| 0A1_agreement | agreement_name 的镜像协议使用的 0A1 协议。 此协议是通过镜像响应方 0A1 协议而生成的。 |
注解
Loopback 实用工具在创建环回协议时切换角色。 如果某组织在原始协议中是本组织，则该实用工具会使其成为环回协议中的合作伙伴组织。 同样，如果某组织在原始协议中是合作伙伴组织，则该实用工具会使其成为环回协议中的本组织。 该实用工具还会切换本组织角色的属性设置。 如果在原始协议中本组织角色属性是发起方，则该实用工具会将其更改为响应方，反之亦然。 而所有其他属性保持不变。
Loopback 实用工具将环回协议的名称命名为与原始协议相同，只是在前面加上“loopback:”。 为避免混淆，请不要将协议命名为以“loopback”开头。
如果针对已经生成环回协议的协议运行该实用工具，则该实用工具将取消镜像现有的环回协议，然后创建新的环回协议。
需要 Loopback 实用工具，因为无法在 BTARN 管理控制台中创建镜像协议。 不能在 BTARN 管理控制台中创建一个协议，该协议的主组织、合作伙伴组织和主角色属性被反转，并且所有其他字段都与现有协议的字段相同。 同样，BTARN 不支持直接在控制台中更改环回协议。 如果尝试在控制台中打开环回协议，你将收到一条错误消息。 如果必须更改环回协议，请先更改起始协议，然后对该协议再次运行 Loopback 实用工具，以重新生成该环回协议。
重要
该环回方案不支持签名协议。 在此方案中，签名消息将失败验证，因为BizTalk Server只允许使用签名证书配置一方。 本组织和合作伙伴组织不能使用相同的签名证书。 这是与使用签名证书唯一标识一方相关的BizTalk Server限制。 因此，两个 BizTalk 参与方不能共享相同的证书。
有关环回实现的详细信息，请参阅 环回教程。
将 Loopback 与 0A1 协议一起使用
你可以配置一个生成 0A1（失败通知）消息的环回方案。 为此，必须为本组织创建以下协议：请求操作-消息协议、发起方 0A1 协议和响应方 0A1 协议。 然后必须对这些协议运行 Loopback 实用工具以为合作伙伴组织创建以下协议：请求操作-消息协议、发起方 0A1 协议和响应方 0A1 协议。 这是必需的，因为无法使用 BTARN 管理控制台来创建这些协议。
完整的一组协议必须包括用于以下消息的协议。 例如，如果操作消息是 3A4，则应包括以下协议：
Home_to_Partner_3A4（操作消息）协议。 该协议启动从 HOME 组织到 PARTNER 组织的操作消息 PIP。
Home_to_Partner_Initiator_0A1 协议。 该协议启动从 HOME 组织到 PARTNER 组织的 PIP 0A1。
Home_to_Partner_Responder_0A1 协议。 该协议接收从 PARTNER 组织到 HOME 组织的 PIP 0A1。
Loopback:Home_to_Partner_3A4（响应消息）协议。 该协议接收从 HOME 组织到 PARTNER 组织的 PIP 3A4。
Loopback:Home_to_Partner_Responder_0A1 协议。 该协议启动从 PARTNER 组织到 HOME 组织的 PIP 0A1。
Loopback:Home_to_Partner_Initiator_0A1。 该协议接收从 HOME 组织到 PARTNER 组织的 PIP 0A1。
创建 0A1 消息的环回协议
若要创建一组完整的协议，必须使用 Loopback 实用工具来创建合作伙伴的操作-消息协议和 0A1 协议。 下面的表给出了生成合作伙伴环回协议所需的 Loopback 操作。 本主题在下面的表中使用 3A4 消息作为示例。
| 步骤 | HOME 协议 |
|---|---|
| 14 | Home_to_Partner_3A4 本组织：HOME 合作伙伴组织：PARTNER 本组织角色：发起方 0A1 协议：Home_to_Partner_Initiator_0A1 说明：启动从 HOME 到 PARTNER 的 PIP 3A4 的协议 |
| 2 | Home_to_Partner_Initiator_0A1 本方：Home 合作伙伴：Partner 角色：发起方 说明：启动从 HOME 到 PARTNER 的 PIP 0A1 的协议 |
| 3 | Home_to_Partner_Responder_0A1 本方：Home 合作伙伴：Partner 角色：响应方 说明：接收从 PARTNER 到 HOME 的 PIP 0A1 的协议 |
| 步骤 | PARTNER 协议（使用 Loopback.exe 镜像的协议） |
|---|---|
| 7 | Loopback:Home_to_Partner_3A4 本方：Partner 合作伙伴：Home 角色：响应方 0A1 协议：Loopback:Home_to_Partner_Responder_0A1 说明：接收从 HOME 到 PARTNER 的 PIP 3A4 的协议 创建它的 Loopback 命令：Loopback /mirror Home_to_Partner_3A4 /NoF Loopback:Home_to_Partner_Responder_0A1 |
| 5 | Loopback:Home_to_Partner_Responder_0A1 本方：Partner 合作伙伴：Home 角色：发起方 说明：启动从 PARTNER 到 HOME 的 PIP 0A1 的协议 创建它的 Loopback 命令：Loopback /mirror Home_to_Partner_Responder_0A1 |
| 6 | Loopback:Home_to_Partner_Initiator_0A1 本方：Partner 合作伙伴：Home 角色：响应方 说明：接收从 HOME 到 PARTNER 的 PIP 0A1 的协议 创建它的 Loopback 命令：Loopback /mirror Home_to_Partner_Initiator_0A1 |
在以下过程中需运行这些表中的 Loopback 命令。
为使用 0A1 消息的环回方案创建协议
在 BTARN 管理控制台中，为家庭组织发送的请求操作消息创建协议。
创建一个用于由本组织发送的发起方 0A1 消息的协议，并执行以下操作：
使用此选项 要执行此操作 我的组织 设为本组织。 合作伙伴组织 设为合作伙伴。 主角色 将 设置为 PIP 失败通知器 (发起方) 。 使用 BTARN 管理控制台，为要发送到主组织的响应方 0A1 消息创建协议，并执行以下操作：
使用此选项 要执行此操作 我的组织 设为本组织。 合作伙伴组织 设为合作伙伴。 主角色 设置为 故障报告管理员 (响应方) 。 使用 BTARN 管理控制台，将主组织的请求操作消息 协议的 0A1 协议属性设置为主组织的发起方 0A1 协议的名称。
使用 Loopback 实用工具创建用于由合作伙伴组织发送的发起方 0A1 消息的协议。 为此，需要镜像本组织的响应方 0A1 协议。 这将创建名为 loopback：<0A1 协议名称>的新 0A1 协议。 属性
My organization设置为伙伴，Partner organization属性设置为主组织，属性Home role为 PIP Failure Notifier (发起方) 。使用 Loopback 实用工具创建用于合作伙伴组织的响应方 0A1 消息的协议。 为此，需要镜像本组织的 0A1 发起方协议。 这将创建名为 loopback：<0A1 协议名称>的新 0A1 协议。 属性
My organization设置为合作伙伴，Partner organization属性设置为主组织，属性Home role为 故障报告管理员 (响应方) 。使用 Loopback 实用工具创建用于合作伙伴组织的响应操作消息的协议。 在此命令中，还必须将 0A1 协议属性设置为合作伙伴的响应方 0A1 协议。 为此，可以镜像主组织的请求操作消息协议，并将 /NoF 开关与合作伙伴的响应方 0A1 协议的名称一起使用。 这将创建名为 Loopback：<agreement name 的新响应操作消息协议>。 属性
My organization设置为合作伙伴，0A1 协议属性设置为合作伙伴的响应方 0A1 协议。