アダプターのデザイン時構成
アダプターには、実行時コンポーネントとデザイン時コンポーネントの両方が含まれます。 実行時コンポーネントを表示することはできません。 BizTalk Serverメッセージの送信、受信、処理は透過的に行われます。
アダプターのデザイン時コンポーネントは、管理ユーザー インターフェイスで表示できます。 デザイン時コンポーネントは、使用可能なプロパティの表示、管理入力の受け付け、およびアダプターを構成するための入力の検証を行います。 デザイン時コンポーネントでは、アダプターのプロパティを適切に構成して、実行時機能でメッセージを正しく交換できるようにすることが重要です。
ここでは、アダプターのデザイン時コンポーネントについてのみ説明します。 したがって、アダプターの構成を表示して設定する方法を中心に説明します。 アダプターを構成するには、次の 2 つの方法があります。
プロパティ ブラウザー 送受信ポート、または送受信ハンドラーのアダプター プロパティは、BizTalk Server管理コンソールを使用して[プロパティ] メニューを使用して構成されます。 これらのアイテムの構成時に、プロパティ ブラウザーを使用してアダプター (トランスポート) を選択し、そのプロパティを構成します。 適用できるプロパティは、スキーマをとおしてセット名と共に表示されます。 たとえば、送信ハンドラーであれば、プロパティは TransmitHandler.xsd ファイルに格納され、受信場所であれば、プロパティは ReceiveLocation.xsd ファイルに格納されます。 アダプターは IAdapterConfig インターフェイスを実装し、適切なスキーマを見つけて読み込み、プロパティ ブラウザーで特定のプロパティを公開します。 IAdapterConfigValidation インターフェイスを使用して、これらのエントリを検証し、構成データを保存する前に値を最終的に変更します。
アダプター メタデータの追加ウィザード : アプリケーション アダプターとデータベース アダプターの場合は、Visual Studio の BizTalk プロジェクトでアダプターが必要とするメッセージの種類とポートの種類を記述するサポート スキーマをインポートすることが必要になる場合があります。 それ以外に、アダプターで提供されるサービスの使用が必要になることもあります。 アダプター メタデータの追加ウィザードでは、アダプターがサポートするサービスを表示して、関連するメッセージの種類やポートの種類をプロジェクトにインポートできます。 このプロセスは"メタデータの収集" と呼ばれます。アダプター開発者は、これらのサービスを記述する XML ファイルを作成し、IStaticAdapterConfig インターフェイスまたは IDynamicAdapterConfig インターフェイスを使用してデザイン時にウィザードに公開します。その結果は次のとおりです。
静的アダプター 。ウィザードは、アダプターのサービスの表示に使用する標準の既定階層ツリー構造を提供します。 静的アダプターとは、ウィザードで提供される標準ツリー ユーザー インターフェイス (UI) を使用するアダプターのことです。 選択したサービスを BizTalk プロジェクトに追加できるようにするには、 IStaticAdapterConfig.GetServiceOrganization メソッドと GetServiceDescription メソッドを使用します。 これは、アダプター開発者にとって最も簡単な構成オプションですが、表示書式の厳密さはありません。
動的アダプター 。ウィザードで提供される基本的なサービス選択の UI にニーズを満たすほどの柔軟性がない場合は、ウィザードで動的に表示されるカスタム UI を作成できます。 IDynamicAdapterConfig.DisplayUI メソッドを使用して、BizTalk プロジェクトに追加するサービスの選択を許可するカスタム UI を表示します。
ここでは、静的な方法または動的な方法のいずれかでデザイン時構成を処理するための 2 組のガイドラインを提供します。
Microsoft BizTalk Server ソフトウェア開発キット (SDK) には、独自のアダプターデザイン時構成ソリューションを作成およびカスタマイズするためのテンプレートとして使用できるサンプル ファイル アダプターが含まれています。 サンプル ファイル アダプターに関する注意とリファレンスが、デザイン時構成に関する各トピックで提供されており、独自のカスタム アダプター構成の要件を変更するのに役立ちます。 これらのガイドラインについての理解を深めるため、SDK に用意されているサンプル ファイル アダプターをインストールし、ビルドして実行することをお勧めします。 詳細については、「ファイル アダプター (BizTalk Server サンプル)」を参照してください。