次の方法で共有

ループバック

  • [アーティクル]

home-to-partner アグリーメントのミラー コピーであるループバック アグリーメントが自動的に生成されるようにするには、ループバック ユーティリティを使用します。 このユーティリティを使用すると、1 台のコンピューターで home-to-partner と partner-to-home のメッセージ交換を実行できます。 このユーティリティは、0A1 メッセージの有無にかかわらず使用できます。 ループバック アグリーメントは、アクション メッセージ (非 0A1) アグリーメントと 0A1 アグリーメントのどちらに対しても作成できます。

このユーティリティは、ホーム組織を送信者のロールに登録したり、登録を解除したりするためにも使用できます。 ユーティリティを使用してホーム organizationを有効にすると、ホームという 2 つの送信ポート<>が作成されます。Async と <Home>。organizationがパートナーとの通信に使用する同期。

SDK でのパス

<ドライブ>\ Program Files (x86)\Microsoft BizTalk <version> Accelerator for RosettaNet\SDK\

ループバックの実行

ループバックを実行するには

  1. コマンド プロンプトを開きます。

  2. Drive>\ Program Files (x86)\Microsoft BizTalk <version> Accelerator for RosettaNet\SDK\ に<移動します。

  3. コマンド プロンプトで「 ループバック」と入力し、必要なスイッチと適切なスイッチを入力し、Enter キーを押します。

ループバックの構文

次に、このコマンドライン ユーティリティを起動するために使用する構文を示します。

Loopback [/enable|/disable <home_organization>] [/mirror|/unmirror <agreement_name>] [/NoF <0A1_agreement>]

構文の説明

次の表で、ループバック ユーティリティが使用する構文の各要素について説明します。

構文 説明
enable 送信者ロールのhome_organizationで<指定されたorganization>を登録します。 ホーム>という 2 つの送信ポートが<作成されます。Async と <Home>。パートナーがホーム organizationとの通信に使用する同期。
disable 送信者ロールとしてのホーム組織の登録を解除します。
home_organization 送信者ロールとして登録する (または登録解除する) 組織。
mirror agreement_nameで<指定された契約に基づいてループバック アグリーメントを>作成します。
unmirror agreement_nameで<指定された契約に基づいてループバック 契約を>削除します。
agreement_name ループバック シナリオでミラー化または非ミラー化するアグリーメント。
NoF ループバック ユーティリティによってミラー化されたアクション メッセージ アグリーメントの 0A1 アグリーメント プロパティを0A1_agreement>に<設定します。 /NoF スイッチは、/ミラー スイッチも含むループバック コマンドにのみ追加できます。
0A1_agreement agreement_name のミラー アグリーメントによって使用される 0A1 アグリーメント。 このアグリーメントは、応答側 0A1 アグリーメントをミラー化することによって生成されます。

注釈

ループバック ユーティリティは、ループバック アグリーメントの作成におけるロールを切り替えます。 ループバック ユーティリティを実行すると、元のアグリーメントのホーム組織は、ループバック アグリーメントでは取引先組織になります。 同様に、元のアグリーメントの取引先組織は、ループバック アグリーメントではホーム組織になります。 ループバック ユーティリティは、ホーム ロール プロパティの設定も切り替えます。 このユーティリティを実行すると、元のアグリーメントで開始側だったホーム ロール プロパティは応答側になり、応答側だったホーム ロール プロパティは開始側になります。 その他のプロパティはどれも変化しません。

ループバック ユーティリティでは、ループバック アグリーメントに元のアグリーメントと同じ名前が付けられ、先頭に "loopback:" が追加されます。 混乱を防ぐため、"loopback" で始まる名前をアグリーメントに付けないでください。

ループバック アグリーメントを既に生成してあるアグリーメントに対してこのユーティリティを実行すると、既存のループバック アグリーメントが非ミラー化され、新しいループバック アグリーメントが作成されます。

BTARN 管理コンソールでミラー化された契約を作成できないため、ループバック ユーティリティが必要です。 BTARN 管理コンソールで、ホーム organization、パートナー organization、およびホーム ロールのプロパティが元に戻され、その他のすべてのフィールドが既存の契約のフィールドと同じである契約を作成することはできません。 同様に、BTARN では、コンソールでループバック アグリーメントを直接変更することはできません。 ループバック アグリーメントをコンソールで開こうとすると、エラーが返されます。 ループバック アグリーメントを変更する必要がある場合は、元のアグリーメントを変更してから、元のアグリーメントに対してループバック ユーティリティを再び実行し、ループバック アグリーメントを再生成します。

重要

このループバック シナリオでは、署名付きアグリーメントはサポートされません。 このシナリオでは、署名付きメッセージは検証に失敗します。BizTalk Serverでは署名証明書を使用して 1 人のパーティのみを構成できるためです。 ホーム組織と取引先組織が同じ署名証明書を使用することはできません。 これは、署名証明書を使用してパーティを一意に識別することに関連するBizTalk Serverの制限です。 そのため、2 つの BizTalk パーティが同じ証明書を共有することはできません。

ループバック実装の詳細については、「 ループバック チュートリアル」を参照してください。

ループバックと 0A1 アグリーメントの使用

0A1 (障害通知) メッセージを生成するようにループバック シナリオを設定できます。 これを行うには、要求アクション メッセージ アグリーメント、開始側 0A1 アグリーメント、および応答側 0A1 アグリーメントをホーム組織用に作成する必要があります。 次に、これらの各アグリーメントに対してループバック ユーティリティを実行し、応答アクション メッセージ アグリーメント、開始側 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 メッセージ向けのループバック アグリーメントの作成

アグリーメント一式を作成するには、ループバック ユーティリティを使用して、取引先に関するアクション メッセージ アグリーメントと 0A1 アグリーメントを作成する必要があります。 次の表に、取引先のループバック アグリーメントを生成するために必要なループバック操作を示します。 説明しやすいように、このトピックの表では 3A4 メッセージを使用します。

手順 HOME アグリーメント
1, 4 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 /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 /mirror Home_to_Partner_Responder_0A1
6 Loopback:Home_to_Partner_Initiator_0A1

ホーム : Partner

取引先 : Home

ロール : 応答側

説明: HOME から PARTNER への PIP 0A1 を受信するためのアグリーメント

作成に使用するループバック コマンド: Loopback /mirror Home_to_Partner_Initiator_0A1

これらの表に示したループバック コマンドは、次の手順の一部として実行します。

0A1 メッセージを使用してループバック シナリオのアグリーメントを作成するには

  1. BTARN 管理コンソールで、ホーム organizationから送信される要求アクション メッセージの契約を作成します。

  2. ホーム組織によって送信される開始側 0A1 メッセージのアグリーメントを作成し、次の操作を行います。

    プロパティ 目的
    マイ organization ホーム組織に設定します。
    パートナー organization 取引先に設定します。
    ホーム ロール PIP Failure Notifier (イニシエーター) に設定します。

  3. BTARN 管理コンソールを使用して、ホーム organizationに送信するレスポンダー 0A1 メッセージの契約を作成し、次の操作を行います。

    プロパティ 目的
    マイ organization ホーム組織に設定します。
    パートナー organization 取引先に設定します。
    ホーム ロール [失敗レポート管理者 (レスポンダー)] に設定します。

  4. BTARN 管理コンソールを使用して、ホーム organizationの要求アクション メッセージ契約の 0A1 契約プロパティを、ホーム organizationのイニシエーター 0A1 契約の名前に設定します。

  5. ループバック ユーティリティを使用して、取引先組織によって送信される開始側 0A1 メッセージのアグリーメントを作成します。 これを行うには、ホーム組織の応答側 0A1 アグリーメントをミラー化します。 これにより、 ループバック:<0A1 契約名を持つ新しい 0A1 契約が作成されます>。 プロパティはMy organizationパートナーに設定され、Partner organizationプロパティはホーム organizationに設定されHome role、プロパティは PIP Failure Notifier (イニシエーター) です。

  6. ループバック ユーティリティを使用して、取引先組織の応答側 0A1 メッセージのアグリーメントを作成します。 これを行うには、ホーム組織の開始側 0A1 アグリーメントをミラー化します。 これにより、 ループバック:<0A1 契約名を持つ新しい 0A1 契約が作成されます>。 プロパティはMy organizationパートナーに設定され、Partner organizationプロパティはホーム organizationに設定されHome role、プロパティは Failure Report Administrator (Responder) です。

  7. ループバック ユーティリティを使用して、取引先組織の応答アクション メッセージのアグリーメントを作成します。 同じコマンドで、[0A1 アグリーメント] プロパティを取引先の応答側 0A1 アグリーメントに設定する必要があります。 これを行うには、ホーム organizationの要求アクション メッセージ契約をミラーリングし、パートナーのレスポンダー 0A1 契約の名前で /NoF スイッチを使用します。 これにより、 ループバック:<契約名を持つ新しい応答アクション メッセージ アグリーメントが作成されます>。 プロパティは My organization パートナーに設定され、0A1 契約プロパティはパートナーのレスポンダー 0A1 契約に設定されます。

参照

ユーティリティ
ループバックのチュートリアル