バインド ファイルを使用した既存の構成の更新
バインド ファイルの情報により既存の構成情報が置き換えられます。 バインド ファイルのアイテムの名前が既存の構成のアイテムの名前と一致する場合は、バインド ファイルをインポートすると、バインド ファイルのアイテムで既存の構成のアイテムが更新されます。
既存のアイテムをバインド ファイルのアイテムで更新するときは、一定のルールに従います。 このトピックでは、既存の構成のアイテムをバインド ファイルのアイテムで更新する際に従うルールについて説明します。
ここでは、バインド ファイルがインポートされたときに、このファイルに有効な値が指定されていることを前提としています。バインド ファイルに無効な値が含まれているシナリオは想定していません。
バインド ファイルで構成を更新するときに BizTalk Server が従うルール
BizTalk Server では、既存のアイテムをバインド ファイルの一致するアイテムで更新するときに一定のルールに従います。 一般に、次のルールが適用されます。
BizTalk Server のユーザー インターフェイス (BizTalk Server 管理コンソールまたは BizTalk エクスプローラー) を使用したアイテムの構成時に表示されるテキスト ボックスとチェック ボックスには、特定の値を設定するか、空白にする必要があります。 バインド ファイルのアイテムに指定した値に応じて、更新される項目のユーザー インターフェイスの値が設定されます。
BizTalk Server のユーザー インターフェイスを使用したアイテムの構成時に表示されるドロップダウン ボックスには、特定の値を設定するか、"なし" に設定する必要があります。 バインド ファイルのアイテムに指定した値に応じて、更新される項目のユーザー インターフェイスの値が設定されます。
BizTalk Server のユーザー インターフェイスを使用したアイテムの構成時に表示されるデータ グリッド ビューは、バインド ファイルの対応する項目の一覧で更新されます。 データ グリッド ビューの一覧がポートまたは受信場所に関連付けられていない限り、データ グリッド ビューに関連付けた一覧は、常にバインド ファイルの一覧で上書きされます。 この場合、バインド ファイルの一覧は既存のデータ グリッド ビューの一覧と結合されます。
バインド ファイルのアイテムは、主キーの値によって識別されます。 アイテムの主キーに関連付けられた値は、ユーザー インターフェイスで Null に設定することはできないので、バインド ファイルのすべてのアイテムには主キーの値が設定されている必要があります。 バインド ファイルのアイテムの主キーに関連付けられた値が、既存の構成のアイテムの主キーに関連付けられた値と一致する場合は、これらのアイテムは同一である (一致している) と見なされます。 バインド ファイルのアイテムと既存のアイテムが同一の場合、以下の表に示すように、既存のアイテムがバインド ファイルのアイテムで更新されます。 バインド ファイルのアイテムが一意の主キーの値を持つ場合は、バインド ファイルのインポート時に BizTalk Server 構成に新しいアイテムが作成されます。
次の表では、バインド ファイルのインポートによって、既存の構成のアイテムを一致するアイテムで更新する場合に予測される動作について説明します。
| アーティファクトの種類 | プロパティ | 指定したプロパティが出現する可能性のある回数 | ユーザー インターフェイスのフィールド | バインド ファイルから一致するアイテムをインポートした影響 |
|---|---|---|---|---|
| Party | 名前 | 最小発生数: 1 最大発生数: 1 |
テキスト ボックス | Primary key (プライマリ キー) |
| エイリアス | 最小発生数: 0 最大発生数: * |
データ グリッド | エイリアスの一覧はバインド ファイルのエイリアスの一覧で上書きされます。 | |
| 送信ポート | 最小発生数: 0 最大発生数: * |
データ グリッド | このパーティのポートの既存の一覧は、バインド ファイルのこのパーティのポートの一覧と結合されます。 | |
| 証明書の "一般名" および "拇印" | 最小発生数: 0 最大発生数: 1 (プロパティごと) |
テキスト ボックス | これらの値はバインド ファイルに指定された値で上書きされます。 これらの値がバインド ファイルに存在しない場合は、null に設定します。 | |
| 説明 | 最小発生数: 1 最大発生数: 1 |
テキスト ボックス | この値は、バインド ファイルで指定された値で上書きします。 | |
| Host | 最小発生数: 0 最大発生数: 1 |
ドロップダウン | この値はバインド ファイルに指定された値で上書きされます。 この値がバインド ファイルに存在しない場合は、Null に設定します。 | |
| "受信ポート" および "送信ポート" | 最小発生数: 0 最大発生数: * |
ドロップダウン | 論理ポートを既存の物理ポートにバインドします。 物理ポートは次の場所に存在する可能性があります。 - グループ内。 - アプリケーションで。 - バインド ファイル内。 必要に応じて、ポートを [なし] に設定します。 None に設定すると、論理ポートはどのリソースにもバインドされません。 |
|
| "追跡" プロパティのチェック ボックス | 最小発生数: 1 最大発生数: 1 (プロパティごと) |
チェック ボックス | これらの値は、バインド ファイルで指定された値で上書きします。 | |
| 送信ポート グループ | 名前 | 最小発生数: 1 最大発生数: 1 |
テキスト ボックス | Primary key (プライマリ キー) |
| 送信ポート | 最小発生数: 0 最大発生数: * |
データ グリッド | この送信ポート グループの既存のポートの一覧を、バインド ファイルで指定されたこの送信ポート グループのポートの一覧とマージします。 | |
| フィルター | 最小発生数: 0 最大発生数: * |
データ グリッド | この送信ポート グループのフィルターの既存の一覧は、バインド ファイルに指定されたこの送信ポート グループのフィルターの一覧で上書きされます。 | |
| 送信ポート | 名前 | 最小発生数: 1 最大発生数: 1 |
テキスト ボックス | Primary key (プライマリ キー) |
| [トランスポート] - [種類] | 最小発生数: 1 最大発生数: 1 |
ドロップダウン | この値をバインド ファイルで指定された値で上書きします。 | |
| [トランスポート] - [送信ハンドラー] | 最小発生数: 1 最大発生数: 1 |
ドロップダウン | この値をバインド ファイルで指定された値で上書きします。 | |
| [送信パイプライン] | 最小発生数: 1 最大発生数: 1 |
ドロップダウン | この値をバインド ファイルで指定された値で上書きします。 | |
| "再試行の回数"、"再試行間隔"、"優先度" | 最小発生数: 1 最大発生数: 1 (各プロパティにつき) |
スクロール ボックス | これらの値は、バインド ファイルで指定された値で上書きします。 | |
| [順次配送] | 最小発生数: 1 最大発生数: 1 |
チェック ボックス | この値をバインド ファイルで指定された値で上書きします。 | |
| 失敗したメッセージをルーティングする | 最小発生数: 1 最大発生数: 1 |
チェック ボックス | この値をバインド ファイルで指定された値で上書きします。 | |
| サービス時間帯を有効にする | 最小発生数: 1 最大発生数: 1 |
チェック ボックス | この値をバインド ファイルで指定された値で上書きします。 | |
| サービス時間帯の "開始時刻" および "停止時刻" | 最小発生数: 1 最大発生数: 1 |
スクロール ボックス | これらの値は、バインド ファイルで指定された値で上書きします。 | |
| Maps | 最小発生数: 0 最大発生数: * |
データ グリッド | この送信ポートのマップの既存の一覧は、バインド ファイルに指定されたこの送信ポートのマップの一覧で上書きされます。 | |
| フィルター | 最小発生数: 0 最大発生数: * |
データ グリッド | この送信ポートのフィルターの既存の一覧は、バインド ファイルに指定されたこの送信ポートのフィルターの一覧で上書きされます。 | |
| [証明書の共通名] | 最小発生数: 1 最大発生数: 1 |
テキスト ボックス | この値をバインド ファイルで指定された値で上書きします。 | |
| 証明書の拇印 | 最小発生数: 1 最大発生数: 1 |
テキスト ボックス | この値をバインド ファイルで指定された値で上書きします。 | |
| 追跡 | 最小発生数: 0 最大発生数: 1 |
チェック ボックス | この値をバインド ファイルで指定された値で上書きします。 | |
| バックアップ トランスポートの "種類" | 最小発生数: 0 最大発生数: 1 |
ドロップダウン | この値をバインド ファイルで指定された値で上書きします。 | |
| バックアップ トランスポートの URI | 最小発生数: 1 最大発生数: 1 |
テキスト ボックス | この値をバインド ファイルで指定された値で上書きします。 バックアップ トランスポートの "種類" プロパティが設定されている場合にのみ有効です。 | |
| バックアップ トランスポートの "送信ハンドラー" | 最小発生数: 1 最大発生数: 1 |
ドロップダウン | この値をバインド ファイルで指定された値で上書きします。 バックアップ トランスポートの "種類" プロパティが設定されている場合にのみ有効です。 | |
| バックアップ トランスポートの "再試行の回数" | 最小発生数: 1 最大発生数: 1 |
スクロール ボックス | この値をバインド ファイルで指定された値で上書きします。 バックアップ トランスポートの "種類" プロパティが設定されている場合にのみ有効です。 | |
| バックアップ トランスポートの "再試行間隔" | 最小発生数: 1 最大発生数: 1 |
スクロール ボックス | この値をバインド ファイルで指定された値で上書きします。 バックアップ トランスポートの "種類" プロパティが設定されている場合にのみ有効です。 | |
| バックアップ トランスポートの "サービス時間帯を有効にする" | 最小発生数: 1 最大発生数: 1 |
チェック ボックス | この値をバインド ファイルで指定された値で上書きします。 バックアップ トランスポートの "種類" プロパティが設定されている場合にのみ有効です。 | |
| バックアップ トランスポートのサービス時間帯の "開始時刻" と "停止時刻" | 最小発生数: 1 最大発生数: 1 |
スクロール ボックス | これらの値は、バインド ファイルで指定された値で上書きします。 バックアップ トランスポートの "種類" プロパティが設定されていて、"サービス時間帯を有効にする" プロパティの値が設定されている場合にのみ有効です。 | |
| 受信ポート | 名前 | 最小発生数: 1 最大発生数: 1 |
テキスト ボックス | Primary key (プライマリ キー) |
| 認証の設定 (オプション ボタン) | 最小発生数: 1 最大発生数: 1 |
ラジオ ボタン | この値をバインド ファイルで指定された値で上書きします。 | |
| 失敗したメッセージをルーティングする | 最小発生数: 1 最大発生数: 1 |
チェック ボックス | この値をバインド ファイルで指定された値で上書きします。 | |
| 説明 | 最小発生数: 1 最大発生数: 1 |
テキスト ボックス | この値をバインド ファイルで指定された値で上書きします。 | |
| 受信場所 | 最小発生数: 0 最大発生数: * |
データ グリッド | この受信ポートの受信場所の既存の一覧は、バインド ファイルに指定されたこの受信ポートの受信場所の一覧で上書きされます。 バインド ファイルのすべての受信場所がグループ内に既に存在する場合、インポートは失敗します。 | |
| Maps | 最小発生数: 0 最大発生数: * |
データ グリッド | この受信ポートのマップの既存の一覧は、バインド ファイルに指定されたこの受信ポートのマップの一覧で上書きされます。 | |
| "追跡" - "メッセージ本文の追跡" および "メッセージ プロパティの追跡" | 最小発生数: 1 最大発生数: 1 (各チェック ボックスにつき) |
チェック ボックス | これらの値は、バインド ファイルで指定された値で上書きします。 | |
| 受信場所 | 名前 | 最小発生数: 1 最大発生数: 1 |
テキスト ボックス | 主キー |
| トランスポートの種類 | 最小発生数: 1 最大発生数: 1 |
ドロップダウン | この値をバインド ファイルで指定された値で上書きします。 | |
| 受信ハンドラー | 最小発生数: 1 最大発生数: 1 |
ドロップダウン | この値をバインド ファイルで指定された値で上書きします。 | |
| パイプライン | 最小発生数: 1 最大発生数: 1 |
ドロップダウン | この値をバインド ファイルで指定された値で上書きします。 | |
| 説明 | 最小発生数: 1 最大発生数: 1 |
テキスト ボックス | この値をバインド ファイルで指定された値で上書きします。 | |
| スケジュールの [開始日] および [停止日] チェック ボックスとドロップダウン ボックス | 最小発生数: 1 最大発生数: 1 |
チェック ボックスおよびドロップダウン ボックス | これらの値は、バインド ファイルで指定された値で上書きします。 チェック ボックスの値がオンになっていない場合でも、日付の値はインポートされます。 | |
| [サービス時間帯を有効にする] チェック ボックス | 最小発生数: 1 最大発生数: 1 |
チェック ボックス | この値をバインド ファイルで指定された値で上書きします。 | |
| サービス時間帯の "開始時刻" および "停止時刻" | 最小発生数: 1 最大発生数: 1 |
スクロール ボックス | これらの値は、バインド ファイルで指定された値で上書きします。 [サービス時間帯を有効にする] の値が設定されている場合にのみ有効です。 | |
| [スキーマ] | 説明 | 最小発生数: 1 最大発生数: 1 |
テキスト ボックス | この値をバインド ファイルで指定された値で上書きします。 |
| "追跡" - "常にすべてのプロパティを追跡する" | 最小発生数: 1 最大発生数: 1 |
チェック ボックス | この値をバインド ファイルで指定された値で上書きします。 | |
| "追跡" - "すべてのメッセージ プロパティを選択する" | 最小発生数: 1 最大発生数: 1 |
チェック ボックス | この値をバインド ファイルで指定された値で上書きします。 このチェック ボックスの値がオンの場合、オンにすることができるすべてのメッセージ プロパティもオンになります。 | |
| "追跡" - 個別のプロパティ | 最小発生数: 0 最大発生数: * |
チェック ボックス | このスキーマの追跡対象のプロパティの既存の一覧は、バインド ファイルに指定されたこのスキーマの追跡対象のプロパティの一覧で上書きされます。 既存のスキーマにはない追跡対象のプロパティを参照するバインド ファイルをインポートすると、エラーが生成されます。 |
|
| Map | 説明 | 最小発生数: 1 最大発生数: 1 |
テキスト ボックス | この値をバインド ファイルで指定された値で上書きします。 |
| パイプライン | 説明 | 最小発生数: 1 最大発生数: 1 |
テキスト ボックス | この値をバインド ファイルで指定された値で上書きします。 |
| イベントの追跡 | 最小発生数: 1 最大発生数: 1 (各チェック ボックスにつき) |
チェック ボックス | これらの値は、バインド ファイルで指定された値で上書きします。 | |
| メッセージ本文の追跡 | 最小発生数: 1 最大発生数: 1 (各チェック ボックスにつき) |
チェック ボックス | これらの値は、バインド ファイルで指定された値で上書きします。 | |
| ポリシー | 適用不可。 ポリシーはバインド ファイルにエクスポートできません。 | 適用なし | 適用なし | 適用なし |
| ロール リンク | 適用不可。 ロール リンクはバインド ファイルにエクスポートできません。 | 適用なし | 適用なし | 適用なし |
既存のアイテムをバインド ファイルの一致するアイテムで更新するときのバインド解除動作
バインド ファイル アイテムは通常、他のアイテムを参照するように構成されます。たとえば、受信ポートは通常、受信場所を参照するように構成されます。 このシナリオでは、受信ポートが親アイテムで、受信場所が子アイテムです。 受信ポートは、受信場所と受信場所を参照するように 明示的に 構成され、受信ポートを 暗黙的に 参照します。 バインド ファイルに不完全に構成された親アイテムが存在する場合 (受信場所を指定して構成されていない受信ポートなど)、既存の構成の状態と関係なくバインド ファイルがインポートされると、アイテムは不完全に構成されます。 たとえば、受信場所 myRL で構成された既存の受信ポート myRP があり、バインド ファイル内の同じ受信ポート myRP が受信場所 myRL で構成 されていない 場合、バインド ファイル エントリが優先されます。 この例では、バインド ファイルをインポートした後、受信ポート myRP は受信場所で構成されないため、myRP から実質的に myRL を バインド解除 できます。
この規則は、明示的な参照を行うアイテムをインポートするときにのみ適用されます。暗黙的な参照を行うアイテムをインポートするときには適用されません。 したがって、他の 10 のアイテムを暗黙的に参照する (それらのアイテムから明示的に参照される) マップをインポートした場合、暗黙的に参照されるアイテムからマップがバインド解除されるおそれはありません。