次の方法で共有

アグリーメントの作成と編集

  • [アーティクル]

ここでは、取引先アグリーメント (TPA) の作成方法または編集方法について説明します。 取引先アグリーメントは、2 つの取引先の間に、ID、PIP (Partner Interface Process)、アクション URL、シグナル URL、同期 URL、関連付けられたプロトコルなどのリレーションシップを構成します。

取引先アグリーメントには、プロセス構成、ホーム組織、パートナー、およびアグリーメントに関する設定が含まれています。 アグリーメントには、これらすべての設定が必要になります。 プロセス構成は RosettaNet PIP またはカスタム スキーマのいずれに基づいて作成できますが、その場合は構成を作成する必要があります。 また、ホーム organizationとパートナー organizationの両方を定義する必要があります。 Microsoft BizTalk Accelerator for RosettaNet (BTARN) では、不明な関係者間のメッセージ交換はサポートされていません。

BTARN は、これらすべての設定に基づいてメッセージを処理し、検証します。 たとえば、CIDX メッセージの場合、BTARN は RosettaNet Implementation Framework (RNIF) バージョン (1.1 のみ)、0A1 契約 (No 0A1 のみ)、および Is Single Action プロパティ (単一アクションのみ) に基づいて検証します。 CIDX メッセージは、RNIF バージョンを "1.1" に設定し、0A1 アグリーメントを "No 0A1" に設定し、 プロパティを にTrue設定したIs Single Action場合にのみ検証されます。 BTARN では、契約プロパティがプロセス構成プロファイル設定と一致することも検証されます。 たとえば、プロファイルの プロパティを Standard "CIDX" に設定していること、および契約の 0A1 契約プロパティが "No 0A1" に設定されていることを確認します。

プロセスがアクティブな状態でアグリーメントを変更すると、予測不可能な結果が生じることがあります。 契約プロパティの変更は、[ 適用 ] または [OK] を クリックして同意するとすぐに適用されますが、プロセスのどのステージが実行されているかを予測することはできません。 アグリーメントを変更した後は、現在のプロセスの新しいアクティビティや新しいプロセスはすべて、変更されたアグリーメント プロパティを使用します。 ただし、アグリーメントを変更するときに実行中であったプロセスは、処理中のメッセージには以前のアグリーメント プロパティを既に使用していた可能性があります。

アグリーメントを作成したら、アクティブ化して、そのアグリーメントに関連付けられたメッセージを送信または受信できるようにする必要があります。 アグリーメントに関連付けられたメッセージが送信または受信されないように、アグリーメントを非アクティブ化することもできます。 アグリーメントを編集するには、非アクティブ化して、編集後に再度アクティブ化します。

BTARN は、この情報を BTARNCONFIG データベースの TPAConfig テーブルに保存します。

取引先契約の設定は、次の表に示すようにタブで並べられます。既定の設定は、最も一般的に使用される値です。 これらの設定を作成して編集するための手順は、表の後に記載されています。

タブ 設定 使用法
全般 名前 Fabrikam_To_Contoso_3A2 など、アグリーメントの一意の名前。

必須フィールド。
全般 プロセス構成 PIP の識別子。

この番号によって、このアグリーメントに関連付けられたプロセス構成が識別されます。

既定値は、プロセス構成一覧の最初に表示される値です。 ドロップダウン リストには、以前入力されたすべてのプロセス構成が含まれます。

必須フィールド。
全般 自分の所属組織 ドロップダウン リストから選択されたホーム組織。

必須フィールド。
全般 パートナー organization ドロップダウン リストから選択された取引先組織。

必須フィールド。
全般 説明 取引先アグリーメントの説明。
全般 RNIF バージョン BTARN が契約通信に使用する RNIF のバージョン。

V01.10.00 または V02.00.01 (既定値) を指定できます。

CIDX の 場合は V01.10.00 である 必要があります。
全般 ホーム ロール ホーム組織のロール。

開始側ロールまたは応答側ロールを指定できます。
全般 [0A1 アグリーメント] エラーが発生したときに BTARN からエラー通知メッセージ (0A1 PIP) が返されるかどうか。

No 0A1 (既定値) または 0A1 を指定できます。

CIDX の 場合は No 0A1 にする必要があります。
全般 使用方法 アグリーメントが使用するシナリオの種類を示します。

Test (既定値 ) または Production を指定できます。
全般

(アプリケーション アダプター 領域)		 アセンブリ名 ファイル システムから選択できる ApplicationAdapter のファイル名。

既定値は空の文字列です。
全般

(アプリケーション アダプター領域)		 クラス名 ApplicationAdapter から BTARN が使用するクラスの名前。

既定値は none です<>。
全般

(検証アダプター領域)		 アセンブリ名 ファイル システムから選択できる ValidationAdapter のファイル名。 既定値は空の文字列です。
全般

(検証アダプター領域)		 クラス名 BTARN が ValidationAdapter から使用するクラスの名前。

既定値は none です<>。
ポート アクション URL ホーム組織がアクション メッセージを送信する先の URL。 たとえば、「 http://FabrikamServer/BTARNApp/RNIFReceive.aspx 」のように入力します。

このフィールドは、次の項目がすべて該当する場合に必須です。

- 同期 プロセス構成の設定は です False。

- Is Single Action process-configuration 設定は です True。

- ホーム ロール アグリーメントの設定は イニシエーターです。

これは、次の条件に該当する場合も必須フィールドです (その場合は、[ シグナル URL ] フィールドも必須です)。

- 同期 プロセス構成の設定は です False。

- Is Single Action process-configuration 設定は です False。

- このフィールドには、"" または "<>http://domain><https://domain" で始まる有効な URI を入力する必要があります。
ポート [シグナル URL] ホーム組織がシグナル メッセージを送信する先の URL。 たとえば、「 http://FabrikamServer/BTARNApp/RNIFReceive.aspx 」のように入力します。

このフィールドは、次の項目が該当する場合に必須です。

- 同期 プロセス構成の設定は です False。

- Is Single Action process-configuration 設定は です True。

- ホーム ロール アグリーメントの設定は レスポンダーです。

これは、次に該当する場合も必須フィールドです (その場合は、[ アクション URL ] フィールドも必須です)。

- 同期 プロセス構成の設定は です False。

- Is Single Action process-configuration 設定は です False。

このフィールドには、"" または "<>http://domain><https://domain" で始まる有効な URI を入力する必要があります。
ポート [同期 URL] ホーム組織が HTTP アダプターを介して接続を確立するために使用する URL。 たとえば、「 http://FabrikamServer/BTARNApp/RNIFReceive.aspx 」のように入力します。

このフィールドは、次の項目が該当する場合に必須です。

- 同期 プロセス構成の設定は です True。

- ホーム ロール アグリーメントの設定は イニシエーターです。

このフィールドには、"" または "<>http://domain><https://domain" で始まる有効な URI を入力する必要があります。
プロトコル [ダイジェストの作成方法] 否認不可を目的として、着信メッセージのダイジェストの計算に使用されるプロトコル。

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 の 4 つの部分、RNIF 1.1 の 3 つの部分) を引用符で囲まれた印刷可能な形式でエンコードします。
プロトコル [エンコード] すべてのパーツをエンコードするために使用されるプロトコル ([ すべてのパーツをエンコード する] ボックスが Trueの場合) または添付ファイル ([ すべてのパーツをエンコード する] ボックスが の False場合)。

8 ビット、ベース 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 に設定した場合にのみ有効です。
カスタム プロパティ 名前 カスタム プロパティの名前です。

カスタム プロパティはアグリーメント単位で設定します。 新しいカスタム プライベート プロセスを作成する場合、これらのカスタム プロパティをさまざまなアグリーメントの処理に使用できます。

BTARN SDK の RuntimeConfig.GetTPACustomConfigValue メソッドを使用して、BTARN 構成からカスタム プロパティを取得できます。

プロパティは Name 一意であり、空ではない必要があります。

次のカスタム値を入力できます。

- AAR。 Acceptance Acknowledgment Required (要承認確認) カスタム プロパティ。 RNIF 1.1 にのみ適用されます。 受け入れ確認ではなく、受信確認のみを要求するには、 false (大文字 と小文字は区別されません) に設定します。 AAR が false 以外に設定されている場合、レスポンダーパブリックプロセスは受け入れ確認を送信する必要があり、イニシエーターパブリックプロセスは受け入れ確認を想定します。 [AAR] を false に設定した場合、パブリック プロセスが完了するのは受信確認の後です。

- HPCC。 Home Partner Classification Code (ホーム パートナー分類コード)。 RNIF 1.1 にのみ適用されます。 この値によって、送信メッセージの Service Header に含まれるホーム パートナーの GlobalPartnerClassificationCode 要素を、[値] 列のエントリに設定できます。 この値は、ホーム組織の構成において、ホーム組織の分類プロパティをオーバーライドします。 ホーム組織で複数の分類を持つことができる場合に、このカスタム プロパティを使用します。

- PPCC。 Partner Profile Classification Code (パートナー プロファイル分類コード)。 RNIF 1.1 にのみ適用されます。 この値によって、送信メッセージの Service Header に含まれるパートナーの GlobalPartnerClassificationCode 要素を、[Value] 列のエントリに設定できます。 この値は、パートナー構成において、パートナーの分類プロパティをオーバーライドします。 パートナーが複数の分類を持つ場合は、このカスタム プロパティを使用します。
カスタム プロパティ Value カスタム プロパティの値。

取引先アグリーメントの作成

  1. [スタート] ボタンをクリックし、[すべてのプログラム] をポイントし、[MicrosoftBizTalk Accelerator for RosettaNet] をポイントして、[BizTalk Accelerator for RosettaNet管理コンソール] をクリックします。

  2. BTARN 管理コンソールで、[BizTalk Accelerator for RosettaNet] を展開します。

  3. [契約] を右クリックし、[新規] をポイントして、[契約] をクリックします。

  4. [新しい契約のプロパティ] ダイアログ ボックスの [ 全般]、[ ポート]、[ プロトコル]、[ カスタム プロパティ ] タブで、設定の値を入力します。 これらの設定の詳細については、上の表を参照してください。

  5. [OK] をクリックします。

    注意

    BTARN は、アグリーメントがアクティブ化されるまで、アグリーメントに関連するメッセージを受け入れません。

  6. 右側のウィンドウで契約の名前を右クリックし、[ アクティブ化] をクリックします。

Note

契約を既にアクティブ化している場合は、右側のウィンドウで契約の名前を右クリックし、[ 非アクティブ化 ] をクリックして、契約に関連付けられているメッセージが送受信されないようにすることができます。

取引先契約を編集する

  1. [スタート] ボタンをクリックし、[すべてのプログラム] をポイントし、[MicrosoftBizTalk Accelerator for RosettaNet] をポイントして、[BizTalk Accelerator for RosettaNet管理コンソール] をクリックします。

  2. BTARN 管理コンソールで、[BizTalk Accelerator for RosettaNet] を展開し、[契約] ノードをクリックします。

  3. 編集する契約を右クリックし、[ プロパティ] をクリックします。

  4. [契約名>の<プロパティ] ダイアログ ボックスの [全般] タブと [連絡先プロパティ] タブで、必要に応じて設定を変更します。 これらの設定の詳細については、上の表を参照してください。

  5. [OK] をクリックします。

参照

構成、証明書、データベース、セキュリティの管理
BTARN 構成の管理