Adapterregistrierungsdatei
Nachdem der benutzerdefinierte Adaptercode erfolgreich erstellt wurde, muss er bei BizTalk Server registriert werden. Dazu aktualisieren Sie die Registrierung mit den entsprechenden Adaptereinstellungen. Sie können eine Registrierungsdatei zwar manuell erstellen, aufgrund der erforderlichen Genauigkeit und der Komplexität der einzugebenden Informationen treten hierbei jedoch leicht Fehler auf. Sinnvoller ist es, den Adapterregistrierungs-Assistenten auszuführen. Mit dem Adapterregistrierungs-Assistenten verfügen Sie über die gleichen Optionen wie beim Neuerstellen einer Registrierungsdatei, wobei die Wahrscheinlichkeit von Fehlern in der Datei jedoch verringert wird. Weitere Informationen zum Adapterregistrierungs-Assistenten finden Sie unter Adapterregistrierungs-Assistent.
Die Dateien StaticAdapterManagement.reg und DynamicAdapterManagement.reg befinden sich unter <laufwerk>:\Programme\Microsoft BizTalk Server\SDK\Samples\AdaptersDevelopment\File Adapter. Wenn Sie eine dieser Dateien ausführen (Sie können darauf doppelklicken oder mit der rechten Maustaste darauf klicken und Zusammenführen auswählen), registriert sie den Beispieldateiadapter bei der Registrierung und installiert die Assembly im globalen Assemblycache. Wenn Sie Ihren benutzerdefinierten Adapter registrieren möchten, ist es am sinnvollsten, mit dem Adapterregistrierungs-Assistenten eine neue Registrierungsdatei zu erstellen. Wenn Ihr benutzerdefinierter statischer Adapter dem Beispieladapter ähnlich ist und Sie eher die vorhandene Registrierungsdatei ändern möchten, öffnen Sie die Datei StaticAdapterManagement.reg, und bearbeiten Sie die folgenden Eigenschaften:
Einschränkungen
InboundTypeName
InboundAssemblyPath
OutboundTypeName
OutboundAssemblyPath
AdapterMgmtTypeName
AdapterMgmtAssemblyPath
PropertyNameSpace
Hinweis
Für OutboundAssemblyPath und AdapterMgmtAssemblyPath wird empfohlen, den lokalen Pfad nicht in den Eigenschaftswert einzufügen, da die Konfiguration bei der Installation an verschiedenen Serverspeicherorten unterbrochen werden kann. Es empfiehlt sich, stattdessen einen starken Namen zu verwenden und den Adapter im globalen Assemblycache zu installieren.
Zur Angabe des .NET-Typs, der den Adapterempfänger, den Adaptersender und die Adapterverwaltung implementiert, stehen Ihnen zwei Optionen zur Verfügung.
Installieren Sie den Adapter in einem Ordner, und geben Sie *TypeName sowie *AssemblyPath an. Bei *TypeName handelt es sich um type.FullName der Klasse, und *AssemblyPath ist der Pfad und Dateiname der Assembly.
Installieren Sie den Adapter im globalen Assemblycache, und geben Sie lediglich *TypeName an. Bei *TypeName handelt es sich hierbei um type.AssemblyQualifiedName der Klasse. Dies ist die empfohlene Option.
Alle Adapter müssen die folgenden Registrierungsschlüssel mit der angegebenen GUID aufweisen:
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}"
Adapter, die auf dem Adapterframework beruhen, müssen diese spezifischen GUIDs für Sende- und Empfangshandler sowie für Eigenschaftenseiten des Empfangsspeicherorts verwenden. Beachten Sie, dass ein Adapter, wenn es sich um einen rein sendenden Adapter handelt, nur die OutboundProtocol_PageProvund TransmitLocation_PageProvGUIDs benötigt. Ebenso erfordert ein nur empfangener Adapter lediglich die InboundProtocol_PageProv und ReceiveLocation_PageProv GUIDs.
Der folgende Code stammt aus der Datei StaticAdapterManagement.reg. Der Code für die Datei DynamicAdapterManagment.reg ist beinahe identisch. Weitere Informationen zu den einzelnen Registrierungseigenschaften finden Sie unter Registrieren eines Adapters. Nachdem Sie die Änderungen an der Registrierungsdatei vorgenommen haben, speichern Sie die Datei, und führen Sie sie aus.
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}]
So registrieren Sie den statischen Beispieladapter
Führen Sie die Schritte zum Ausführen des Dateiadapterbeispiels im SDK aus. Weitere Informationen finden Sie unter Dateiadapter (BizTalk Server Beispiel).
Klicken Sie auf Start, zeigen Sie auf Alle Programme, zeigen Sie auf Zubehör, und klicken Sie dann auf Windows Explorer.
Navigieren Sie zum Installationslaufwerk für BizTalk Server, und navigieren Sie dann zu <
drive>:\Programme\MicrosoftBizTalk Server\SDK\Samples\AdaptersUsage\File Adapter.Doppelklicken Sie zum Hinzufügen des Beispieladapters zur Registrierung auf StaticAdapterManagement.reg. (Wenn Sie den dynamischen Dateiadapter zur Registrierung hinzufügen möchten, führen Sie stattdessen DynamicAdapterManagement.reg aus, und verwenden Sie diese Datei bei Bedarf überall sonst.)
Hinweis
Wenn BizTalk Server nicht auf Laufwerk C ihres Computers installiert ist, müssen Sie die Datei StaticAdapterManagement.reg mit dem entsprechenden Installationspfad ändern. Suchen Sie in der Datei nach C: , und ersetzen Sie sie durch das richtige Installationslaufwerk.
Klicken Sie im Dialogfeld Registrierungs-Editor auf Ja , um den Beispieladapter zur Registrierung hinzuzufügen, und klicken Sie dann auf OK , um das Dialogfeld zu schließen und zu überprüfen, ob die Informationen zur Registrierung hinzugefügt wurden.
Klicken Sie zum Schließen von Windows Explorer im Menü Datei auf Schließen.
Der statische Beispieladapter ist jetzt bei BizTalk Server registriert.
Feedback
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unter https://aka.ms/ContentUserFeedback.
Feedback senden und anzeigen für