File di registrazione dell’adapter
Dopo aver compilato correttamente il codice dell'adattatore personalizzato, è necessario registrarlo con BizTalk Server. Per eseguire questa operazione, aggiornare il Registro di sistema con le impostazioni dell'adapter appropriate. È possibile creare manualmente un file del Registro di sistema, ma questa operazione è soggetta a errori a causa della precisione e della complessità delle informazioni che è necessario immettere. È quindi consigliabile eseguire la Creazione guidata Registro di sistema adapter. Questa procedura offre le stesse opzioni utilizzate durante la creazione manuale di un nuovo file del Registro di sistema e consente di ridurre il rischio di introdurre errori nel file. Per altre informazioni sulla Procedura guidata Registro adattatori, vedere Configurazione guidata registro adapter.
Il file StaticAdapterManagement.reg e il file DynamicAdapterManagement.reg si trovano nell'unità<>:\Programmi\Microsoft BizTalk Server\SDK\Samples\AdaptersDevelopment\File Adapter. Quando si esegue uno di questi file (è possibile fare doppio clic su di esso o fare clic con il pulsante destro del mouse su di esso e selezionare Merge), registra l'adattatore di file di esempio con il Registro di sistema e installa l'assembly nella global assembly cache. La migliore soluzione per registrare l'adapter personalizzato consiste nel creare un nuovo file del Registro di sistema tramite la Creazione guidata Registro di sistema adapter. Se l'adapter statico personalizzato è simile all'adapter di esempio e si sceglie invece di modificare il file del Registro di sistema esistente, aprire e modificare le proprietà seguenti nel file StaticAdapterManagement.reg:
Vincoli
InboundTypeName
InboundAssemblyPath
OutboundTypeName
OutboundAssemblyPath
AdapterMgmtTypeName
AdapterMgmtAssemblyPath
PropertyNameSpace
Nota
Per OutboundAssemblyPath e AdapterMgmtAssemblyPath è consigliabile non includere il percorso locale nel valore della proprietà, perché la configurazione potrebbe interrompere quando installata in posizioni server diverse. È preferibile utilizzare un nome sicuro e installarlo nella Global Assembly Cache.
Per specificare il tipo .NET che implementa il ricevitore, il trasmettitore e la gestione dell'adapter, è possibile procedere in uno dei seguenti modi:
Installare l'adapter in una cartella e specificare *TypeName e *AssemblyPath, dove *TypeName corrisponde al tipo e nome completo della classe e *AssemblyPath corrisponde al percorso e nome file dell'assembly.
Installare l'adapter nella Global Assembly Cache e specificare solo *TypeName, dove *TypeName corrisponde al type.AssemblyQualifiedName della classe. È consigliabile selezionare questa opzione.
Tutti gli adapter devono disporre delle seguenti chiavi del Registro di sistema con il GUID specificato:
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}"
Gli adapter basati sul framework degli adapter devono utilizzare questi GUID specifici per il gestore di trasmissione e ricezione e per le pagine delle proprietà degli indirizzi di trasmissione e ricezione. Si noti che se un adattatore è un adattatore di sola trasmissione, è sufficiente OutboundProtocol_PageProv eTransmitLocation_PageProvGUID. Analogamente, una scheda di sola ricezione richiede semplicemente i GUID InboundProtocol_PageProv e ReceiveLocation_PageProv .
Il codice seguente deriva dal file StaticAdapterManagement.reg ed è quasi identico al codice del file DynamicAdapterManagement.reg. Per altre informazioni su ognuna delle proprietà del Registro di sistema, vedere Registrazione di un adapter. Dopo aver apportato le modifiche al file del Registro di sistema, salvare il file ed eseguirlo.
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}]
Per registrare l'adapter statico di esempio
Completare la procedura seguente per eseguire l'adapter per file di esempio nell'SDK. Per altre informazioni, vedere Adattatore file (BizTalk Server esempio).
Fare clic sul pulsante Start, scegliere Tutti i programmi, Accessori, quindi fare clic su Esplora risorse.
Passare all'unità di installazione per BizTalk Server e quindi passare a <
drive>:\Programmi\MicrosoftBizTalk Server\SDK\Samples\AdaptersUsage\File Adapter.Per aggiungere l'adattatore di esempio al Registro di sistema, fare doppio clic su StaticAdapterManagement.reg. Se si vuole aggiungere l'adattatore di file dinamico al Registro di sistema, eseguire dynamicAdapterManagement.reg e usare invece tale file ovunque.
Nota
Se BizTalk Server non è installato nell'unità C del computer, è necessario modificare il file StaticAdapterManagement.reg con il percorso di installazione appropriato. Cercare il file per C: e sostituirlo con l'unità di installazione corretta.
Nella finestra di dialogo Editor registro fare clic su Sì per aggiungere l'adattatore di esempio al Registro di sistema e quindi fare clic su OK per chiudere la finestra di dialogo, verificando che le informazioni siano state aggiunte al Registro di sistema.
Per chiudere Esplora risorse, scegliere Chiudi dal menu File.
L'adattatore statico di esempio è ora registrato con BizTalk Server.