次の方法で共有


アダプターの登録

カスタム アダプターを開発している場合は、ソフトウェア開発キット (SDK) のサンプル ファイル アダプターに含まれているレジストリ ファイルのいずれかを変更して実行することで、BizTalk Server に登録できます。 または、アダプター レジストリ ウィザードを使用してレジストリ ファイルを作成することもできます。 このウィザードは、\Program Files (x86)\Microsoft BizTalk Server <VERSION>Utilities\AdapterRegistryWizard フォルダーにあります。

Von Bedeutung

  • 32 ビット コンピューターでは、アダプター登録ウィザードによって生成されたレジストリ (.reg) ファイルをコマンド プロンプトから実行する必要があります。
    • 64 ビット コンピューターでは、アダプター登録ウィザードによって生成されたレジストリ (.reg) ファイルは、32 ビットと 64 ビットの両方のコマンド プロンプトから実行する必要があります。

レジストリ エントリを作成したら、BizTalk Server 管理コンソールにアダプターを追加するか、Windows Management Instrumentation (WMI) メソッドを使用してプログラムでアダプターを追加できます。 このトピックでは、各レジストリ エントリについて説明し、カスタム アダプターの既存のレジストリ ファイルを変更する場所と方法について説明します。

アダプター レジストリ ウィザードの使用方法については、「アダプター レジストリ ウィザード」を参照してください。 SDK に含まれるサンプル レジストリ ファイルを変更する手順については、「 アダプター登録ファイル」を参照してください。

レジストリ キー

アダプターを展開するには、次のレジストリ エントリを作成する必要があります。

レジストリ キーの場所

[HKEY_CLASSES_ROOT\CLSID\{%uuid of custom transport%}\BizTalk]  
@="BizTalk"  
  

型名

アダプターの種類名は、BizTalk Server コンピューターのアダプターの種類を識別します。 このキーは、任意のアダプターに必要です。

"TransportType"="MyTransportAdapter"  
  

制約

アダプター制約は、アダプターの機能を定義します。

このキーは、すべてのアダプターに必要です。 作成するアダプターの種類によっては、制約のビットマスク値を変更できます。

"Constraints"=dword:00003C0b  

アダプターの機能を説明する値は、次の表に示す値の組み合わせにすることができます。

価値 16 進値 フラグ 説明
1 0x0001 eプロトコルサポートレシーブ アダプターは、受信操作をサポートします。
2 0x0002 eProtocolSupportsTransmit アダプターは送信操作をサポートします。
8 0x0008 eProtocolReceiveIsCreatable アダプターの受信ハンドラーは、インプロセスでホストされます。
128 0x0080 eProtocolSupportsRequestResponse アダプターは、要求/応答操作をサポートします。
256 0x0100 eProtocolSupportsSolicitResponse アダプターは、solicit-response 操作をサポートします。
1024 0x0400 アウトバウンドプロトコルにはコンテキスト初期化が必要です アダプターが送信ハンドラー構成に Adapter Framework ユーザー インターフェイスを使用することを示します。
2048 0x0800 eインバウンドプロトコルはコンテキストの初期化が必要です アダプターが受信ハンドラー構成に Adapter Framework ユーザー インターフェイスを使用することを示します。
4096 0x1000 eReceiveLocationRequiresContextInitialization(受信場所にはコンテキストの初期化が必要です) アダプターが受信場所の構成に Adapter Framework ユーザー インターフェイスを使用することを示します。
8192 0x2000 eTransmitLocationRequiresContextInitialization アダプターが送信ポート構成に Adapter Framework ユーザー インターフェイスを使用することを示します。
16384 0x4000 順序付け配達対応の電子サポート アダプターがメッセージの順序付き配信をサポートしていることを示します。
32768 0x8000 初期化トランスミッタサービス開始時 送信アダプターは、最初のメッセージを送信するときではなく、サービスが開始されたときに開始されます。
65536 0x10000 eSupport32BitOnly アダプターが 32 ビット ホストでのみ実行をサポートしていることを示します。

Namespace

各アダプターは、そのプロパティの名前空間を定義する必要があります。 BizTalk Server は、この名前空間の下のメッセージ コンテキストにアダプター固有のプロパティを格納します。 このプロパティは、すべてのアダプターに必要です。

"PropertyNameSpace"="namespace"  

別名

各アダプターには、BizTalk Server 内のアダプターの種類を一意に識別する一連のプレフィックスが含まれている場合があります。 これにより、動的送信ポートを介してメッセージを送信するときに、適切なトランスポートの種類を解決できます。 アダプターは、登録時にプレフィックスの一覧を指定する必要があります。

"AliasesXML"="<AdapterAliasList><AdapterAlias>sample://</AdapterAlias></AdapterAliasList>"  

構成プロパティ ページ

アダプターには、受信場所と送信ポートを構成するための構成プロパティ ページが必要です。 各アダプターは、それぞれのクラス ID を指定してプロパティ ページを登録します。

"InboundProtocol_PageProv"="{%CLSID for inbound protocol prop page%}"  
"OutboundProtocol_PageProv"="{%CLSID for outbound protocol prop page%}"  
"ReceiveLocation_PageProv"="{%CLSID for receive ___location prop page%}"  
"TransmitLocation_PageProv"="{%CLSID for transmit ___location prop page%}"  

アダプターがプロパティ ページの生成にアダプター フレームワークのユーザー インターフェイスを使用する場合は、レジストリ キーに次の値を指定する必要があります。

"InboundProtocol_PageProv"="{2DE93EE6-CB01-4007-93E9-C3D71689A281}"  
"OutboundProtocol_PageProv"="{2DE93EE6-CB01-4007-93E9-C3D71689A283}"  
"ReceiveLocation_PageProv"="{2DE93EE6-CB01-4007-93E9-C3D71689A280}"  
"TransmitLocation_PageProv"="{2DE93EE6-CB01-4007-93E9-C3D71689A282}"  

いずれかのエンドポイントが不要な場合 (アダプターが送受信のみ)、未使用のレジストリ キーをレジストリから削除できることに注意してください。

ランタイム コンポーネントの登録

アダプターは、クラス ID (COM と .NET の場合)、型名、およびアセンブリ パス (.NET の場合) を指定してランタイム コンポーネントを登録します。これは、ランタイム コンポーネントの受信と送信に使用します。

すべての OutboundEngineCLSID キーと InboundEngineCLSID キーは一意である必要があります。 データベース内の 1 行の 場合、OutboundEngineCLSIDInboundEngineCLSID は同じにすることができます。

"OutboundEngineCLSID"="{%CLSID of outbound transport%}"  
"InboundEngineCLSID"="{%CLSID of inbound transport%}"  
"InboundTypeName"="BizTalk.Samples.Adapters.MyReceiver"  
"OutboundTypeName"="BizTalk.Samples.Adapters.MyTransmitter"  
"InboundAssemblyPath"="C:\Program Files\MyTransport.dll"  
"OutboundAssemblyPath"="C:\Program Files\MyTransport.dll"  

アダプターのアセンブリをグローバル アセンブリ キャッシュにインストールし、レジストリ ファイルで参照できます。

SSO 構成ストアのアダプター プロパティの登録

アダプターは、デザイン時と実行時にプロパティを格納および取得できるように、そのプロパティを BizTalk Server SSO データベースに登録する必要があります。

ReceiveHandlerPropertiesXML  
ReceiveLocationPropertiesXML  
SendHandlerPropertiesXML  
SendLocationPropertiesXML  

これらの値には、アダプターに関連する対応するエンティティの許可されるプロパティの定義 (スキーマ) が含まれ、構成ストアに格納できます。 これらの定義は、プロパティ型を含むが値を含まないプロパティ バッグによって逆シリアル化される XML 文字列として保持されます。 プロパティ要素の空でない値は、プロパティがマスクされていることを意味します。 (マスクとは、書き込み専用であり、管理モードで呼び出されたときに Secure Store API によって返されないことを意味します。Secure Store API は、そのようなプロパティのVT_NULLを返します)。

HTTP アダプターは、 SendLocationPropertiesXML レジストリ キーを次の値で定義することで、HTTP 送信ポートのプロパティを登録します。

<CustomProps><Username vt="8"/><Password vt="8">Encrypted</Password><Certificate vt="8"/><RequestTimeout vt="3"/><MaxRedirects vt="3"/><ContentType vt="8"/><UseProxy vt="11"/><ProxyName vt="8"/><ProxyPort vt="3"/><ProxyUsername vt="8"/><ProxyPassword vt="8">Encrypted</ProxyPassword><UseHandlerSetting vt="11"/><AuthenticationScheme vt="8"/><UseSSO vt="11"/><AffiliateApplicationName vt="8"/></CustomProps>  

トランスポート プロバイダーとしてのコンポーネントの登録

アダプターは、レジストリの実装済みカテゴリ属性の下にトランスポート プロバイダーとして登録する必要があります。 この属性は、アダプターのコンシューマーにその特性を識別します。

[HKEY_CLASSES_ROOT\CLSID\{%uuid of custom transport%}\Implemented Categories]  
[HKEY_CLASSES_ROOT\CLSID\{%uuid of custom transport%}\Implemented Categories\{7F46FC3E-3C2C-405B-A47F-8D17942BA8F9}]  

こちらもご覧ください

アダプターの設計に関する問題