アダプターの登録ファイル

カスタム アダプター コードが正常にビルドされたら、BizTalk Serverに登録する必要があります。 これを行うには、レジストリを適切なアダプターの設定で更新します。 レジストリ ファイルは手動で記述できますが、正確かつ複雑な情報を入力する必要があるため、手動での記述はエラーを招く原因となります。 推奨される方法は、アダプターのレジストリ ウィザードを実行することです。 アダプターのレジストリ ウィザードには、最初からレジストリ ファイルを作成するのとまったく同じオプションが用意されており、ファイルでエラーが発生する可能性を減らすことができます。 アダプター レジストリ ウィザードの詳細については、「アダプター レジストリ ウィザード」を参照してください。

StaticAdapterManagement.reg ファイルと DynamicAdapterManagement.reg ファイルは、<drive>:\Program Files\Microsoft BizTalk Server\SDK\Samples\AdaptersDevelopment\File Adapter にあります。 これらのファイルのいずれかを実行すると (ダブルクリックするか、右クリックして [マージ] を選択できます)、サンプル ファイル アダプターがレジストリに登録され、アセンブリがグローバル アセンブリ キャッシュにインストールされます。 カスタム アダプターを登録するための最適な方法としては、アダプターのレジストリ ウィザードを使用して新しいレジストリ ファイルを作成することをお勧めします。 カスタムの静的アダプターがサンプル アダプターに似ている場合は、作成する代わりに既存のレジストリ ファイルを変更し、StaticAdapterManagement.reg ファイルの次のプロパティを開いて変更します。

• 制約

• InboundTypeName

• InboundAssemblyPath

• OutboundTypeName

• OutboundAssemblyPath

• AdapterMgmtTypeName

• AdapterMgmtAssemblyPath

• PropertyNameSpace

受信元アダプター、送信元アダプター、およびアダプター管理を実装する .NET 型を指定するには、次の 2 つの方法があります。

1. アダプターをフォルダーにインストールし、*TypeName と *AssemblyPath を指定します。*TypeName はクラスの type.FullName で、*AssemblyPath はアセンブリのパスとファイル名です。

2. グローバル アセンブリ キャッシュにアダプターをインストールし、*TypeName だけを指定します。*TypeName は、クラスの type.AssemblyQualifiedName です。 このオプションを選択することをお勧めします。

   すべてのアダプターには、GUID が指定されている次のレジストリ キーが必要です。

• Implemented Categories\{7F46FC3E-3C2C-405B-A47F-8D17942BA8F9}

• "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}"

  アダプター フレームワークに基づいたアダプターは、送信ハンドラー、受信ハンドラー、および場所のプロパティ ページでこれらの固有の GUID を使用する必要があります。 アダプターが送信専用アダプターの場合は、 OutboundProtocol_PageProvと TransmitLocation_PageProvGUID のみが必要であることに注意してください。 同様に、受信専用アダプターでは、 InboundProtocol_PageProv と ReceiveLocation_PageProv GUID のみが必要です。

  次のコードは、StaticAdapterManagement.reg ファイルのものですが、DynamicAdapterManagement.reg ファイルのコードもこれとほぼ同じです。 各レジストリ プロパティの詳細については、「 アダプターの登録」を参照してください。 レジストリ ファイルを変更した場合は、ファイルを保存してから実行します。

Windows Registry Editor Version 5.00  
[HKEY_CLASSES_ROOT\CLSID\{62018D08-281A-415b-A6D3-6172E3762867}]  
@="Static DotNetFile Adapter"  
"AppID"="{12A6EBAA-CF68-4B58-B36E-A5A19B22C04E}"  
  
[HKEY_CLASSES_ROOT\CLSID\{62018D08-281A-415b-A6D3-6172E3762867}\BizTalk]  
@="BizTalk"  
"TransportType"="Static DotNetFile"  
"Constraints"=dword:00003C0b  
  
"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}"  
  
"InboundEngineCLSID"="{3D4B599E-2202-4bbb-9FC6-7ACA3906E5DE}"  
"InboundTypeName"="Microsoft.BizTalk.SDKSamples.Adapters.DotNetFileReceiver""InboundAssemblyPath"="C:\\Program Files\\Microsoft BizTalk Server <version>\\SDK\\Samples\\AdaptersDevelopment\\File Adapter\\Runtime\\bin\\Debug\\Microsoft.BizTalk.SDKSamples.Adapters.DotNetFile.Runtime.dll"  
"OutboundEngineCLSID"="{024DB758-AAF9-415e-A121-4AC245DD49EC}"  
"OutboundTypeName"="Microsoft.BizTalk.SDKSamples.Adapters.DotNetFileTransmitter""OutboundAssemblyPath"="C:\\Program Files\\Microsoft BizTalk Server <version>\SDK\\Samples\\AdaptersDevelopment\\File Adapter\\Runtime\\bin\\Debug\\Microsoft.BizTalk.SDKSamples.Adapters.DotNetFile.Runtime.dll""AdapterMgmtTypeName"="Microsoft.BizTalk.SDKSamples.Adapters.Designtime.StaticAdapterManagement""AdapterMgmtAssemblyPath"="C:\\Program Files\\Microsoft BizTalk Server <version>\SDK\\Samples\\AdaptersDevelopment\\File Adapter\\Design Time\\Adapter Management\\bin\\Debug\\Microsoft.BizTalk.SDKSamples.Adapters.DotNetFile.Designtime.dll""PropertyNameSpace"="http://schemas.microsoft.com/BizTalk/2003/SDK_Samples/Messaging/Transports/dotnetfile-properties"  
"AliasesXML"="<AdapterAliasList><AdapterAlias>DotNetFILE://</AdapterAlias></AdapterAliasList>"  
"ReceiveHandlerPropertiesXML"="<CustomProps><AdapterConfig vt=\"8\"/></CustomProps>"  
"SendHandlerPropertiesXML"="<CustomProps><AdapterConfig vt=\"8\"/></CustomProps>"  
"ReceiveLocationPropertiesXML"="<CustomProps><AdapterConfig vt=\"8\"/></CustomProps>"  
"SendLocationPropertiesXML"="<CustomProps><AdapterConfig vt=\"8\"/></CustomProps>"  
[HKEY_CLASSES_ROOT\CLSID\{62018D08-281A-415b-A6D3-6172E3762867}\Implemented Categories]  
[HKEY_CLASSES_ROOT\CLSID\{62018D08-281A-415b-A6D3-6172E3762867}\Implemented Categories\{7F46FC3E-3C2C-405B-A47F-8D17942BA8F9}]  

サンプルの静的アダプターを登録するには

1. 次の手順を使用して、SDK のファイル アダプター サンプルを実行します。 詳細については、「ファイル アダプター (BizTalk Server サンプル)」を参照してください。

2. [スタート] ボタンをクリックし、[すべてのプログラム] をポイントし、[アクセサリ] をポイントして、[Windows エクスプローラー] をクリックします。

3. BizTalk Serverのインストール ドライブに<drive>移動し、:\Program Files\Microsoft BizTalk Server\SDK\Samples\AdaptersUsage\File Adapter に移動します。

4. サンプル アダプターをレジストリに追加するには、[ StaticAdapterManagement.reg] をダブルクリックします。(動的ファイル アダプターをレジストリに追加する場合は、代わりに DynamicAdapterManagement.reg を実行し、必要に応じてそのファイルを他のすべての場所で使用します)。

   Note

   BizTalk Serverがコンピューターのドライブ C にインストールされていない場合は、StaticAdapterManagement.reg ファイルを適切なインストール パスで変更する必要があります。 ファイルで C: を検索し、正しいインストール ドライブに置き換えます。

5. [ レジストリ エディター ] ダイアログ ボックスで、[ はい ] をクリックしてサンプル アダプターをレジストリに追加し、[ OK] を クリックしてダイアログ ボックスを閉じ、情報がレジストリに追加されたことを確認します。

6. Windows エクスプローラーを閉じるには、[ファイル] メニューの [閉じる] をクリックします。

   サンプルの静的アダプターが BizTalk Server に登録されました。