Dateiadapter (BizTalk Server-Beispiel)
Das Dateiadapterbeispiel ist in Microsoft Visual C# .NET geschrieben, um mit Microsoft BizTalk Server zu arbeiten. Es stellt Code zum Erstellen eines dynamischen oder eines statischen Adapters zur Verfügung. Im folgenden Verfahren wird jedoch nur der statische Adapter beschrieben. Ein statische Adapter ist ein Adapter mit einer statischen Schemasammlung ohne benutzerdefinierte Benutzeroberfläche. Ein dynamischer Adapter besitzt eine benutzerdefinierte Benutzeroberfläche und ggf. eine dynamische Schemasammlung. Statische und dynamische Adapter verwenden den Assistenten zum Hinzufügen eines Adapters, um ihre Schemas einem BizTalk-Projekt hinzuzufügen.
Hinweis
Das Dateiadapterbeispiel ist nicht identisch mit dem nativen FILE-Adapter, der im Lieferumfang von BizTalk Server enthalten ist. Wenn Sie daher den Transporttyp für die Verwendung in diesem Beispiel auswählen, wählen Sie Statisch anstatt FILE aus.
Der dynamische Adapter mit einer benutzerdefinierten Benutzeroberfläche und ggf. einer dynamischen Schemasammlung erfordert zusätzlichen Code auf der Adapterverwaltungsseite. Informationen zur Verwendung des dynamischen Schemasatzes finden Sie unter Konfiguration des dynamischen Design-Time Adapters.
Ziel des Beispiels
Der Beispieladapter kopiert Dateien aus einem Dateiordner, sendet als Nachrichten an BizTalk oder nimmt Nachrichten aus BizTalk Server und wird in einen Dateiordner abgelegt. Es stellt Code zum Erstellen eines dynamischen oder eines statischen Adapters zur Verfügung. Im folgenden Verfahren wird jedoch nur der statische Adapter beschrieben. Ein statische Adapter ist ein Adapter mit einer statischen Schemasammlung ohne benutzerdefinierte Benutzeroberfläche. Ein dynamischer Adapter besitzt eine benutzerdefinierte Benutzeroberfläche und ggf. eine dynamische Schemasammlung. Statische und dynamische Adapter verwenden den Assistenten zum Hinzufügen eines Adapters, um ihre Schemas einem BizTalk-Projekt hinzuzufügen.
Sie können den Beispieldateiadapter als Vorlage verwenden, anhand derer Sie weitere benutzerdefinierte Adapter erstellen.
Speicherort dieses Beispiels
<Beispielpfad>\AdaptersDevelopment\Dateiadapter
Hinweis
Der Standardspeicherort für <den Beispielpfad> ist %ProgramFiles%\Microsoft BizTalk Server\SDK\Samples, wenn BizTalk Server auf einem Computer installiert ist, auf dem eine 32-Bit-Version von Windows ausgeführt wird. Der Standardspeicherort für <Den Beispielpfad> ist %ProgramFiles(x86)%\Microsoft BizTalk Server\SDK\Samples, wenn BizTalk Server auf einem Computer installiert ist, auf dem eine 64-Bit-Version von Windows ausgeführt wird. Um die Werte zu bestimmen, die den Umgebungsvariablen %ProgramFiles% oder %ProgramFiles(x86)% zugeordnet sind, geben Sie echo %ProgramFiles% oder echo %ProgramFiles(x86)% an einer Eingabeaufforderung ein, und drücken Sie die EINGABETASTE. Wenn Sie dieses Beispiel auf einem 64-Bit-Betriebssystem ausführen, müssen Sie alle Verweise in einer der REG-Dateien von %ProgramFiles% in %ProgramFiles(x86)% ändern, bevor Sie die REG-Dateien ausführen.
In den folgenden Tabellen werden die Dateien in diesem Beispiel sowie deren Zweck beschrieben.
| Dateien in \File Adapter | BESCHREIBUNG |
|---|---|
| Dateien in \BizTalk Project | Enthält das Adaptertestprojekt, das zum Testen des Beispieladapters verwendet wird. |
| Dateien in \Design Time | Enthält das Entwurfszeit- und Verwaltungsprojekt (AdapterManagement.csproj). |
| Dateien in \Runtime | Enthält die Laufzeitprojekte für den Empfang der Dateikopie und die Übermittlung (DotNetFile.csproj). |
| DynamicAdapterManagement.reg | Registriert den dynamischen Beispieladapter. |
| Instance.xml | Beispieldatei für die Übergabe über den Dateiadapter. |
| StaticAdapterManagement.reg | Registriert den statischen Beispieladapter. |
| Dateien in \BizTalk Project\Adapter Harness | BESCHREIBUNG |
|---|---|
| AdapterHarness.odx, AdapterHarness.sln, AdapterHarnessProject.btproj | Stellt Projekt- und -Projektmappendateien sowie zugehörige Dateien für das BizTalk-Projekt zur Verfügung. |
| mySchema.xsd | Stellt das Schema Instance.xml zur Verfügung, das von der Testorchestrierung von der Empfangskomponente des Adapters erwartet wird, sowie das Schema von Instance.xml, das an die Sendekomponente des Adapters durch die Orchestrierung übergeben wird. |
| Dateien in \Design-Time\Adapter Management | BESCHREIBUNG |
|---|---|
| AdapterManagement.cs, AdapterManagement.csproj, AdapterManagement.sln | Projekt- und -Projektmappendateien sowie zugehörige Dateien für den Adapter zur Entwurfszeit. |
| AssemblyInfo.cs | Enthält Assemblyinformationen für dieses Beispiel. |
| CategorySchema2.xml | Wird nicht vom Beispieladapter verwendet. |
| CategorySchema.xml | Enthält die Dienstorganisationsstruktur für den statischen Adapter. |
| DotNetFileResource.resx | Enthält Ressourcen. |
| ReceiveHandler.xsd, ReceiveLocation.xsd | Enthält den empfangsseitigen Handler und benutzerdefinierte Endpunkteigenschaftenschemas. |
| service1.wsdl | Enthält Vorgangsdefinitionen für den Adapter. |
| TransmitHandler.xsd, TransmitLocation.xsd | Enthält den übertragungsseitigen Handler und benutzerdefinierte Endpunkteigenschaftenschemas. |
| Dateien in \Runtime | BESCHREIBUNG |
|---|---|
| DotNetFile.csproj, DotNetFile.sln, AssemblyInfo.cs, DotNetFileExceptions.cs, DotNetFileProperties.cs, DotNetFileReceiver.cs, DotNetFileReceiverEndPoint.cs, DotNetFileTransmitter.cs, DotNetFileTransmitterEndpoint.cs, DotNetFileAsyncTransmitterBatch.cs, BatchMessage.cs |
Dateien für die Sende- und Empfangsadapter für die Dateikopie zur Laufzeit. Sie können diese Dateien ändern und unter einem neuen Namen für benutzerdefinierte Komponenten speichern. DotNetFile.csproj und DotNetFile.sln sind die Projekt- und Projektmappendateien. AssemblyInfo.cs enthält Assemblyinformationen für dieses Beispiel. DotNetFileReceiver.cs liest die Dateien aus den Empfangsspeicherorten und übermittelt sie an BizTalk Server. DotNetFileExceptions.cs implementiert Code zum Verarbeiten von Ausnahmen während der Nachrichtenverarbeitung. DotNetFileProperties.cs enthält allgemeine Eigenschaften für Empfangs- und Sendevorgänge. BatchMessage.cs implementiert Batchmessaging. DotNetFileReceiverEndPoint.cs ist eine Klasse, die einem Empfangsspeicherort/URI entspricht. Sie steuert die Abfrage des angegebenen Ordners hinsichtlich neuer Nachrichten. DotNetFileTransmitter.cs ist eine Singleton-Klasse für den DotNetFile-Sendeadapter. Alle Nachrichten, die an verschiedene Sendeports dieses Adapters versandt werden, durchlaufen diese Klasse. DotNetFileTransmitterEndpoint.cs übernimmt die Übertragung der Nachrichten. |
| Dateien in \SDK\Samples\AdaptersDevelopment\BaseAdapter\v1.0.2 | BESCHREIBUNG |
|---|---|
| Adapter.cs, AdapterException.cs, AsyncTransmitter.cs, batch.cs, ConfigProperties.cs, ControlledTermination.cs, IManageEndpoints.cs, Receiver.cs, ReceiverEndpoint.cs | Stellt Klassen zur Verfügung, die den Basisadapter bilden. Sie können diese verwenden, um eigene Adapter zu erstellen. |
Verwenden dieses Beispiels
Verwenden Sie den Beispieldateiadapter als Vorlage, anhand derer Sie weitere benutzerdefinierte Adapter erstellen.
Erstellen dieses Beispiels
Wichtig
Wenn die BizTalk-Installation eine 64-Bit-Installation ist oder der Speicherort der Installation geändert wurde, müssen OutboundAssemblyPath, InboundAssemblyPath und AdapterMgmtAssemblyPath entsprechend geändert werden.
Mithilfe der folgenden Verfahren können Sie das Dateiadapterbeispiel erstellen und initialisieren.
So erstellen Sie einen starken Namenschlüssel für die DotNetFileAdapter-Projekte und das Basisadapterprojekt
Starten Sie die Visual Studio-Eingabeaufforderung.
Hinweis
Führen Sie die Eingabeaufforderung als Administrator aus.
Ändern Sie das aktuelle Verzeichnis in das < Verzeichnis Samples Path>\AdaptersDevelopment\BaseAdapter\v1.0.2.
Geben Sie an der Eingabeaufforderung sn –k BaseAdapter.snk ein, und drücken Sie dann die EINGABETASTE. Die SNK-Datei ist ggf. bereits vorhanden, weil andere Beispiele zuvor ausgeführt wurden. Wenn dies der Fall ist, können Sie direkt mit Schritt 4 fortfahren und diesen Schritt überspringen.
Ändern Sie das aktuelle Verzeichnis in das < Verzeichnis Samples Path>\AdaptersDevelopment\File Adapter\Runtime.
Geben Sie an der Eingabeaufforderung sn –k DotNetFileAdapter.snk ein, und drücken Sie dann die EINGABETASTE.
Geben Sie an der Eingabeaufforderung exit ein, und drücken Sie dann die EINGABETASTE, um das Eingabeaufforderungsfenster zu schließen.
So erstellen Sie das Laufzeitprojekt für den Empfänger
Klicken Sie auf Start, zeigen Sie auf Alle Programme, zeigen Sie auf Zubehör, und klicken Sie dann auf Windows Explorer.
Navigieren Sie zum < Verzeichnis Samples Path>"\AdaptersDevelopment\File Adapter\Runtime", und doppelklicken Sie dann auf DotNetFile.sln.
Um das Laufzeitprojekt Adapterempfänger neu zu erstellen, klicken Sie in Projektmappen-Explorer mit der rechten Maustaste auf DotNetFile, und klicken Sie dann auf Neu erstellen.
Klicken Sie im Menü Datei auf Beenden , um Visual Studio zu schließen.
So erstellen Sie das Entwurfszeitprojekt für den Adapter
Navigieren Sie in Windows Explorer zum < Verzeichnis Samples Path>"\AdaptersDevelopment\File Adapter\Design Time\Adapter Management", und doppelklicken Sie dann auf AdapterManagement.sln.
Klicken Sie in Projektmappen-Explorer mit der rechten Maustaste auf AdapterManagement, und klicken Sie dann auf Neu erstellen.
Klicken Sie im Menü Datei auf Beenden , um Visual Studio zu schließen.
So registrieren Sie den statischen Beispieladapter
Navigieren Sie in Windows Explorer zum < Verzeichnis Samples Path>"\AdaptersDevelopment\File Adapter".
Doppelklicken Sie zum Hinzufügen des Beispieladapters zur Registrierung auf StaticAdapterManagement.reg.
Hinweis
StaticAdapterManagement.reg enthält hartcodierte Pfade zu C:\Programme\Microsoft BizTalk Server\. Wenn Sie BizTalk Server nicht im Verzeichnis %ProgramFiles%\Microsoft BizTalk Server\ installiert haben, wenn Sie ihre BizTalk Server-Installation von BizTalk Server 2009 oder BizTalk Server 2006 R2 aktualisiert haben, oder wenn Sie installiert haben BizTalk Server auf einem Computer, auf dem eine 64-Bit-Version von Windows ausgeführt wird, müssen Sie die Datei StaticAdapterManagement.reg mit den entsprechenden Pfaden ändern. Standardmäßig wird BizTalk Server im Verzeichnis %ProgramFiles(x86)%\Microsoft BizTalk Server\ auf Computern installiert, auf denen eine 64-Bit-Version von Windows ausgeführt wird. Aktualisieren Sie die Pfade, die den Werten "InboundAssemblyPath", "OutboundAssemblyPath" und "AdapterMgmtAssemblyPath" zugeordnet sind, um auf den richtigen Speicherort der angegebenen Dateien zu verweisen.
Wichtig
Wenn Sie BizTalk auf einem 64-Bit-Computer installieren, ändern Sie alle Instanzen des registrierungseintrags HKEY_CLASSES_ROOT\CLSID\ in HKEY_CLASSES_ROOT\Wow6432Node\CLSID\ in der Registrierungsdatei StaticAdapterManagement.reg .
Klicken Sie im Dialogfeld Registrierungs-Editor auf Ja , um den Beispieladapter der Registrierung hinzuzufügen, und klicken Sie dann auf OK.
Klicken Sie zum Schließen von Windows Explorer im Menü Datei auf Schließen.
So installieren Sie den statischen Beispieladapter
Klicken Sie auf Start, wählen Sie Alle Programme, Microsoft BizTalk Server 20xx und dann BizTalk Server Verwaltung aus.
Klicken Sie in der BizTalk Server Verwaltungskonsole auf , um BizTalk Server Verwaltung zu erweitern, klicken Sie auf BizTalk-Gruppe, und klicken Sie auf Plattformeinstellungen.
Klicken Sie mit der rechten Maustaste auf Adapter, klicken Sie auf Neu, und klicken Sie dann auf Adapter.
Gehen Sie im Dialogfeld Adapter hinzufügen wie folgt vor.
Option Aufgabe Name Geben Sie Static ein. Adapter Wählen Sie in der Dropdownliste Static DotNetFile aus. Comment Geben Sie Sample Adapter ein. Klicken Sie auf OK.
Der statische Adapter wird nun in der Liste der Adapter im rechten Fenster der BizTalk-Verwaltungskonsole angezeigt.
So beenden Sie die Hostinstanz und starten diese neu
Klicken Sie auf Start, wählen Sie Alle Programme, Microsoft BizTalk Server 20xx und BizTalk Server Verwaltung aus.
Klicken Sie in der BizTalk Server Verwaltungskonsole auf , um BizTalk Server Verwaltung zu erweitern, klicken Sie auf BizTalk-Gruppe, erweitern Sie Plattformeinstellungen, und klicken Sie auf Hostinstanzen. Wählen Sie BizTalkServerApplication im rechten Bereich aus.
Klicken Sie im Ergebnisbereich mit der rechten Maustaste auf den Host instance (in der Regel der Computername), und klicken Sie dann auf Neu starten.
Ausführen dieses Beispiels
So führen Sie das Dateiadapterbeispiel aus
Klicken Sie auf Start, zeigen Sie auf Alle Programme, zeigen Sie auf Zubehör, und klicken Sie dann auf Windows Explorer.
Erstellen Sie die folgenden Ordner auf dem BizTalk Server Installationslaufwerk:
<drive>:\Temp
<drive>:\Temp\Send
<drive>:\Temp\Receive
Klicken Sie zum Schließen von Windows Explorer im Menü Datei auf Schließen.
Klicken Sie auf Start, zeigen Sie auf Alle Programme, zeigen Sie auf Microsoft BizTalk Server 20xx, und klicken Sie dann auf BizTalk Server Verwaltung.
Klicken Sie mit der rechten Maustaste auf den Knoten BizTalk Server Verwaltung, und wählen Sie Mit vorhandener Gruppe verbinden aus.
Führen Sie im Dialogfeld Verbindung mit vorhandener BizTalk Server Konfigurationsdatenbank herstellen die folgenden Schritte aus.
Hinweis
Die BizTalk-Verwaltungsdatenbank wird auch als BizTalk-Konfigurationsdatenbank bezeichnet.
Option Aufgabe SQL Server Geben Sie ein . (ein Punkt). Datenbank Wählen Sie den Namen der BizTalk-Verwaltungsdatenbank aus, die vom Konfigurations-Assistenten erstellt wurde. Der Standarddatenbankname, der vom Konfigurations-Assistenten verwendet wird, ist BizTalkMgmtDb. Klicken Sie auf OK.
Erweitern Sie den Knoten BizTalk-Gruppe[Servername] in der BizTalk Server-Verwaltungskonsole, erweitern Sie den Knoten Anwendungen, und erweitern Sie den Knoten BizTalk-Anwendung 1.
Klicken Sie mit der rechten Maustaste auf den Knoten Sendeports , und klicken Sie dann auf Neu, wählen Sie Static One-Way Send Port aus, und klicken Sie dann auf OK.
Wählen Sie im Dialogfeld Porteigenschaften senden die Option Allgemein aus, und führen Sie die folgenden Schritte aus.
Option Aufgabe Name Geben Sie AdapterSend ein. Transporttyp Wählen Sie in der Dropdownliste Statisch aus, und klicken Sie auf Konfigurieren.
– Geben Sie im Feld Verzeichnislaufwerk>:\Temp\Send ein<.
– Wählen Sie im Feld Dateimodusdie Option ErstellenNeu aus.
– Geben Sie im Feld Dateinameden Wert %MessageID%.xmlein.
– Klicken Sie auf OK.
– Das URI-Feld sollte drive>:\Temp\Send\%MessageID%.xmlanzeigen<.Sendepipeline Wählen Sie PassThruTransmit (Microsoft.BizTalk.DefaultPipelines.PassThruTransmit) aus, und klicken Sie dann auf OK. Klicken Sie unter dem Knoten BizTalk-Anwendung 1 auf Empfangsports, und wählen Sie Neuer/One-Way Empfangsport aus.
Wählen Sie im Dialogfeld Neuen Empfangsport erstellen im Feld Typ des Empfangsports angeben die Option Unidirektionale Empfangsport in der Dropdownliste aus, und klicken Sie dann auf OK.
Geben Sie im Dialogfeld Eigenschaften des Empfangsports im Feld Name den Namen AdapterReceive ein, und klicken Sie dann auf OK.
Klicken Sie unter dem Knoten BizTalk Application 1 mit der rechten Maustaste auf Empfangsspeicherorte, und wählen Sie Neuer/Unidirektionale Empfangsspeicherort aus.
Wählen Sie im Dialogfeld Empfangsport auswählen die Option AdapterReceive aus, und klicken Sie dann auf OK.
Gehen Sie im Dialogfeld Eigenschaften des Empfangsspeicherorts wie folgt vor.
Option Aufgabe Name Typ AdapterReceiveLocation Transporttyp Wählen Sie in der Dropdownliste Statisch aus, und klicken Sie auf Konfigurieren , um auf diese verbleibenden Eigenschaften zuzugreifen. URI – Klicken Sie auf die Schaltfläche mit den Auslassungspunkten (...).
– Geben Sie im Feld Anzahl von Dateien in Batchden Wert 20 ein.
– Geben Sie im Feld Verzeichnislaufwerk>:\Temp\Receive ein<.
– Stellen Sie sicher, dass die Eigenschaft Dateimaske auf *.xmlfestgelegt ist.
– Geben Sie im Feld Abfrageintervallden Wert 5 ein, und klicken Sie auf OK.
– Stellen Sie sicher, dass die URI-Bezeichnung laufwerk>:\Temp\Receive\*.xmlenthält<.Empfangshandler Wählen Sie in der Dropdownliste BizTalkServerAnwendung aus. Empfangspipeline Wählen Sie in der Dropdownliste XMLReceive aus. Klicken Sie auf OK.
Fahren Sie mit Dem Erstellen, Bereitstellen und Binden des Beispieladapters fort.
Erstellen, Bereitstellen und Binden des Beispieladapters
Bevor der Adapter online geschaltet wird, müssen Sie das Projekt erstellen, die Orchestrierung an die Ports binden und den Adapter eintragen.
So erstellen Sie eine Schlüsseldatei mit starkem Namen für den statischen Adapter
Starten Sie die Visual Studio-Eingabeaufforderung.
Ändern Sie an der Eingabeaufforderung das aktuelle Verzeichnis in das < Verzeichnis Samples Path>\AdaptersDevelopment\File Adapter\BizTalk Project\Adapter Harness.
Geben Sie an der Eingabeaufforderung sn –k AdapterHarness.snk ein, und drücken Sie dann ENTER.
Klicken Sie auf OK.
So erstellen Sie das Adaptertestprojekt
- Klicken Sie in Projektmappen-Explorer mit der rechten Maustaste auf AdapterHarnessProject, und klicken Sie dann auf Neu erstellen.
So stellen Sie das Adaptertestprojekt bereit
Klicken Sie in Projektmappen-Explorer, wenn das Projekt neu erstellt wurde, mit der rechten Maustaste auf AdapterHarnessProject, und klicken Sie dann auf Bereitstellen.
Wählen Sie in BizTalk Server Verwaltungskonsole das Projekt aus, das Sie bereitgestellt haben, und klicken Sie dann auf Aktualisieren.
So binden Sie die Orchestrierung an die Ports
Erweitern Sie in BizTalk Server Verwaltungskonsole unter der entsprechenden BizTalk Server Anwendung den Knoten Orchestrierungen.
Klicken Sie mit der rechten Maustaste auf AdapterHarness.AdapterHarnessType, und klicken Sie dann auf Binden.
Führen Sie im Dialogfeld Portbindungseigenschaften – AdapterHarness.AdapterHarnessType – Bindungskonfigurationen die folgenden Schritte aus.
Option Aufgabe AdapterFileReceivePort Wählen Sie in der Dropdownliste AdapterReceive aus. AdapterFileSendPort Wählen Sie in der Dropdownliste AdapterSend aus. Klicken Sie im linken Bereich auf Host.
Wählen Sie im Feld Host die Option BizTalkServerApplication aus der Dropdownliste aus, und klicken Sie dann auf OK.
Fahren Sie mit Verwalten des Beispieladapters fort.
Verwalten des Beispieladapters
Die Verwaltungsaufgaben für den Beispieladapter werden in der BizTalk-Verwaltungskonsole ausgeführt.
So verwalten Sie das Dateiadapterbeispiel
Klicken Sie auf Start, zeigen Sie auf Alle Programme, zeigen Sie auf Microsoft BizTalk Server 20xx, und klicken Sie dann auf BizTalk Server Verwaltung.
Klicken Sie im linken Bereich, um Anwendungen zu erweitern, klicken Sie, um BizTalk-Anwendung 1 zu erweitern, und klicken Sie auf Empfangsspeicherorte.
Stellen Sie sicher, dass adapterReceive status aktiviert ist.
Wenn die status nicht aktiviert ist, klicken Sie im rechten Bereich mit der rechten Maustaste auf AdapterReceive, und klicken Sie dann auf Aktivieren.
Klicken Sie im linken Bereich auf Orchestrierungen , und stellen Sie sicher, dass AdapterHarness.AdapterHarnessTypeEnlisted ist. Klicken Sie mit der rechten Maustaste auf AdapterHarness.AdapterHarnessType, und klicken Sie dann auf Enlist (wenn AdapterHarness.AdapterHarnessType bereits eingetragen ist, ist die Menüoption Enlist nicht verfügbar).
Klicken Sie mit der rechten Maustaste auf AdapterHarness.AdapterHarnessType, und wählen Sie Start aus. Die status dieser Orchestrierung sollte in Ausführen geändert werden.
Fahren Sie mit Testen des Beispieladapters fort.
Testen des Beispieladapters
Nach der Bereitstellung des Beispieladapters müssen Sie die Hostinstanz beenden und dann neu starten. Es ist wichtig, den Beispieladapter zu testen, bevor er in der Produktionsumgebung verwendet wird.
So beenden Sie die Hostinstanz und starten diese neu
Klicken Sie in der BizTalk Server Verwaltungskonsole auf BizTalk Server-Verwaltung, klicken Sie auf bizTalk-Gruppe, klicken Sie auf Plattformeinstellungen, und klicken Sie auf Hostinstanzen. Wählen Sie BizTalkServerApplication im rechten Bereich aus.
Klicken Sie mit der rechten Maustaste auf den Host instance (in der Regel auf den Computernamen), und klicken Sie dann auf Beenden.
Die status des Hosts instance in Beendet geändert.
Klicken Sie mit der rechten Maustaste auf den host instance, und klicken Sie dann auf Start.
Die status des Hosts instance in Ausführen geändert.
So testen Sie das Laufzeitmodul des statischen Adapters
Navigieren Sie in Windows Explorer zum < Verzeichnis Samples Path>\AdaptersDevelopment\File Adapter, und kopieren Sie die InstanceXML.xml Datei in Ihre Zwischenablage.
Navigieren Sie zu <laufwerk>:\Temp\Receive , und fügen Sie die Instance.xml Datei in den Ordner ein.
Wenn die Sende- und Empfangsadapter funktionieren, sollte die Datei vom <Ordner Laufwerk>:\Temp\Receive in den <Ordner laufwerk>:\Temp\Send verschoben werden.
So testen Sie die Beispielfunktionen des Assistenten zum Hinzufügen eines Adapters für den statischen Beispieladapter
Klicken Sie in Visual Studio in Projektmappen-Explorer mit der rechten Maustaste auf AdapterHarnessProject, zeigen Sie auf Hinzufügen, und klicken Sie dann auf Generierte Elemente hinzufügen.
Klicken Sie im Dialogfeld Generierte Elemente hinzufügen – AdapterHarnessProject auf Adaptermetadaten hinzufügen, und klicken Sie dann auf Öffnen.
Die Liste der registrierten Adapter wird angezeigt.
Wählen Sie Static DotNetFile aus, und klicken Sie dann auf Weiter.
Die vom Adapter bereitgestellte Dienstorganisation wird angezeigt.
Erweitern Sie Dienstorganisation, Gesundheitswesen, und klicken Sie dann auf Verwaltung.
Beachten Sie, dass die Berechtigung anders als die anderen Knoten angezeigt wird. Berechtigung ist ein Dienstknoten, den Sie auswählen können. Die anderen Knoten sind Organisationsknoten, die keinen bestimmten Dienst beschreiben.
Wählen Sie den Knoten Berechtigung aus , und klicken Sie dann auf Fertig stellen.
BizTalk importiert eine ODX- und eine XSD-Datei in das Projekt.
Sie können nun die aus dem Adapter importierten Schemas, PortTypes, Vorgänge und MessageTypes im Zeitplan für das BizTalk-Projekt verwenden.
Klassen oder Methoden, die in diesem Beispiel verwendet werden
Schnittstellen: "IBaseMessage", "IPropertyBag", "IBTTransportProxy"
Klassen (aus dem Basisadapter): "AsyncTransmitterEndpoint", "AsyncTransmitter", "BatchMessage", "ControlledTermination", "ReceiverEndpoint", "DotNetFileCommonProperties", "BatchOperationType"
Kommentare
Nach Abschluss des Beispieladapters können Sie den Beispieladapter so ändern, dass er einen benutzerdefinierten statischen oder dynamischen Adapter erstellt. Weitere Informationen finden Sie unter Adapter Design-Time Konfiguration.