動的デザイン時アダプター構成
静的デザイン時アダプター構成とアダプター メタデータの追加ウィザードの標準の既定 UI では、インポートする BizTalk プロジェクトのアダプターのサービスを表示するための柔軟性が足りない場合があります。 代わりに、動的デザイン時構成を使用できます。この構成では、カスタマイズした UI をウィザードに提供し、アダプターのサービスを表示および選択できます。 BizTalk アダプター フレームワークには、アダプターに必要なスキーマのインポートやカスタム UI の表示に使用できる一連の API が用意されています。
このセクションでは、カスタム アダプターの動的デザイン時構成機能を実装する方法について説明します。 どのように変更するかは、アダプターが通信するアプリケーションの要件、およびアダプターが実装するロジックに基づいて決定します。 これらの手順について詳しく説明したり、追加の背景を提供したりするBizTalk Serverヘルプのセクションへのリンクは、利用可能な場合に提供されます。 また、サンプル ファイルのアダプター ドキュメント内で、関連する例が記載されている部分を参照することもできます。
動的な開発プロセスのガイドライン
以下に、動的デザイン時機能をアダプターに組み込む場合の推奨事項を示します。 開発中は、これらの手順をすべて実行したり、厳密なシーケンスで実行したりする必要がない場合があります。
アダプター構成要件、および設定する必要がある構成パラメーターの一覧を作成します。 すべての受信場所と送信ポートでグローバルに使用するパラメーターは、ハンドラー スキーマ構成ファイルで指定します。 特定のポートまたは特定の場所で使用するパラメーターは、送信ポート構成ファイルと受信場所構成ファイルでそれぞれ構成します。
アダプターのプロパティ ページを新しい構成パラメーターに対応するように変更します。 この手順の詳細については、「 アダプター構成スキーマ」を参照してください。
アダプター メタデータの追加ウィザード用のカスタム ユーザー インターフェイス (UI) を作成し、スキーマを選択してプロジェクトに追加します。 ここに記載されているすべての推奨事項の中で、動的アダプターが静的アダプターと異なるのはこの点だけです。 この手順の詳細については、「 動的アダプター DisplayUI メソッド 」および 「Microsoft.BizTalk.Adapter.Framework.IDynamicAdapterConfig.DisplayUI クラス」を参照してください。
スキーマが Web サービス記述言語 (WSDL) ファイルとして返されるようにサンプル コードを修正します。 この手順の詳細については、「 静的アダプター IStaticAdapterConfig インターフェイス」を参照してください。
既存の WSDL ファイルを変更するか、新しい WSDL ファイルを作成します。 この手順の詳細については、「 アダプター WSDL ファイル」を参照してください。
サンプル コードを変更して、WSDL ファイルに含まれていないアダプターによって必要とされている追加の XSD ファイルを返します。 この手順の詳細については、「 アダプター GetSchema メソッド」を参照してください。
アダプターのレジストリ キーを変更して、アダプターのレジストリ ファイルを実行します。 この手順の詳細については、「 アダプター登録ファイル」を参照してください。
静的アダプターを BizTalk Server にインストールします。 この手順の詳細については、「アダプターをBizTalk Serverにインストールする」を参照してください。
アダプターのプロパティ ページに対して行われた変更をテストします。 アダプターを再ビルドして、アダプター メタデータの追加ウィザードに表示される UI をテストします。 この手順の詳細については、「アダプター プロジェクトのビルドとテスト」を参照してください。