次の方法で共有

契約の作成または編集

このトピックでは、取引先契約を作成または編集する方法について説明します。 取引先契約は、2 つの取引先 (ID を含む) 間の関係を構成します。パートナー インターフェイス プロセス (PIP);アクション、シグナル、および同期 URL。および関連するプロトコル。

取引先契約には、プロセス構成、ホーム組織、パートナー、契約の設定が含まれます。 契約には、これらすべての設定が必要です。 RosettaNet PIP またはカスタム スキーマに基づいてプロセス構成を作成できますが、構成を作成する必要があります。 また、ホーム組織とパートナー組織の両方を定義する必要があります。 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" に設定し、 Is Single Action プロパティを Trueした場合にのみ検証します。 また、BTARN は、契約プロパティがプロセス構成プロファイル設定と一致することも検証します。 たとえば、プロファイルの Standard プロパティを "CIDX" に設定していること、および契約の 0A1 契約プロパティが "No 0A1" に設定されていることを確認します。

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

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

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でなければなりません。
全般 使用方法 契約で使用されるシナリオの種類を示します。

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

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

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

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

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

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

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

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

次の条件がすべて満たされている場合、これは必須フィールドです。

- [ 同期 プロセス構成] 設定が False。

- [単一アクションの プロセス構成] 設定が True。

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

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

- 「Is Synchronous」 プロセス構成設定は False です。

- 単一実行のプロセス設定はFalse。

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

次の条件に該当する場合、これは必須フィールドです。

- 同期しているかプロセス構成設定はFalseです。

- 単一アクションのプロセス構成設定 が True。

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

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

- Is Synchronous のプロセス設定は False です。

- 単一アクションのプロセス構成設定は 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 Required プロパティを Payload または Payload Container に設定した場合にのみ有効になります。
プロトコル 暗号化の方向 システムが受信メッセージと送信メッセージのどちらを暗号化するか、またはその両方を暗号化するか。

受信、送信、または受信/送信 (既定値) を指定できます。

暗号化方向の設定は、対応するプロセス構成で Is Persistent Confidentiality Required プロパティを Payload または Payload Container に設定した場合にのみ有効になります。
カスタム プロパティ 名前 カスタム プロパティの名前。

契約ごとにカスタム プロパティを設定できます。 新しいカスタム プライベート プロセスを作成する場合は、これらのカスタム プロパティを使用してさまざまな契約を処理できます。

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

Name プロパティは一意であり、空である必要はありません。

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

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

- HPCC。 これはホーム パートナー分類コードです。 これは RNIF 1.1 にのみ適用されます。 これにより、送信メッセージのサービス ヘッダーのホーム パートナーの GlobalPartnerClassificationCode 要素を [値] 列のエントリに設定できます。 この値は、ホーム組織構成のホーム組織分類プロパティをオーバーライドします。 ホーム組織で複数の分類を行うことができる場合は、このカスタム プロパティを使用します。

- PPCC。 これはパートナー プロファイル分類コードです。 これは RNIF 1.1 にのみ適用されます。 これにより、送信メッセージのサービス ヘッダーのパートナーの GlobalPartnerClassificationCode 要素を [値] 列のエントリに設定できます。 この値は、パートナー構成のパートナー分類プロパティをオーバーライドします。 パートナーが複数の分類を持つ場合は、このカスタム プロパティを使用します。
カスタム プロパティ 価値 カスタム プロパティの値。

取引先契約を作成する

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

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

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

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

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

    注

    BTARN は、契約を有効にするまで、契約に関連するメッセージを受け入れません。

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

注

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

取引先契約を編集する

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

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

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

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

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

こちらもご覧ください

構成、証明書、データベース、およびセキュリティを管理する
BTARN 構成の管理