共用方式為

配接器登錄檔案

  • 發行項

成功建置自訂配接器程式碼之後，必須將它註冊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

注意

針對 OutboundAssemblyPath 和 AdapterMgmtAssemblyPath ，建議您不要在屬性值中包含本機路徑，因為組態可能會在安裝在不同的伺服器位置時中斷。 更好的選擇是使用強式名稱，並將它安裝在全域組件快取中。

有兩個選擇可指定實作配接器接收器、配接器傳輸器和配接器管理的 .NET 類型：

  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 中的 FILE 配接器範例。 如需詳細資訊，請參閱檔案配接器 (BizTalk Server 範例) 。

  2. 按一下 [開始]，指向 [所有程式]，指向 [ 配件]，然後按一下 [ Windows 檔案總管]。

  3. 流覽至 BizTalk Server 的安裝磁片磁碟機，然後流覽至 <drive> ：\Program Files\MicrosoftBizTalk Server\SDK\Samples\AdaptersUsage\File Adapter。

  4. 若要將範例配接器新增至登錄，請按兩下 StaticAdapterManagement.reg。 (如果您想要將動態檔案配接器新增至登錄，請改為執行 DynamicAdapterManagement.reg ，並視情況使用該檔案。)

    注意

    如果您的電腦 C 磁片磁碟機上未安裝BizTalk Server，您必須使用適當的安裝路徑修改 StaticAdapterManagement.reg 檔案。 搜尋檔案中的 C： ，並將它取代為正確的安裝磁片磁碟機。

  5. 在 [ 登錄編輯器] 對話方塊中，按一下 [ 是 ] 將範例配接器新增至登錄，然後按一下 [ 確定 ] 以關閉對話方塊，確認資訊已新增至登錄。

  6. 若要關閉 Windows 檔案總管，請在 [ 檔案 ] 功能表上，按一下 [ 關閉]。

    範例靜態配接器現在已向 BizTalk Server 註冊。