BizTalk-Adapter für die Konfiguration von Hostdateien

  • Artikel

Überblick

Der BizTalk-Adapter für Hostdateien ist ein Sende- und Empfangsadapter, mit dem BizTalk-Orchestrierungen mit Hostsystemen interagieren können. Insbesondere ermöglicht der Adapter Sende- und Empfangsvorgänge über TCP/IP- und APPC-Verbindungen zum Hosten von Dateien, die auf Mainframe- und IBM i-Plattformen ausgeführt werden. Basierend auf der Host Integration Server-Technologie verwendet der Adapter Metadatenassemblys der Datenzugriffsbibliothek zum Konfigurieren von Verbindungen und den Microsoft .NET Framework-Datenanbieter für Hostdateien zum Ausgeben von SQL-Befehlen und gespeicherten Prozeduren.

Der Adapter bietet zwei Standard Funktionen:

  • Für Sendevorgänge (sowohl One Way als auch Solicit Response) sendet der Adapter SQL-Befehle und Systembefehle an eine Hostdatei instance mit der Möglichkeit, eine Antwort anzufordern.

  • Für Empfangsvorgänge (nur unidirektionale Vorgänge) erstellt der Adapter einen SQL-Befehl, der Hostdateiobjekte abruft und zeilenweise Nachrichten erstellt, die dann an das BizTalk-Nachrichtensystem übermittelt werden.

    Darüber hinaus verwendet der BizTalk-Adapter für Hostdateien das standardmäßige BizTalk-Adapterablaufverfolgungstool als Problembehandlungsmechanismus.

Hinweis

Der BizTalk-Adapter für Hostdateien ist ein nicht transaktionaler Adapter. Dies bedeutet, dass eine Aktion, nachdem sie ausgeführt wurde, nicht rückgängig gemacht oder ein Rollback ausgeführt werden kann.

Erstellen einer Metadatenassembly

Nachdem Sie den Adapter installiert haben, können Sie eine Metadatenassembly erstellen, die Ihr Remotesystem beschreibt, um BizTalk Server.

Ein Teil des Prozesses zum Erstellen einer Hostdateianwendung in Visual Studio ist die Beschreibung des Layouts des Hostdateisystems. Dieser Prozess erstellt sowohl eine Metadatenassembly als auch ein Schema. Die Metadatenassembly ist eine programmgesteuerte Darstellung des Remotehostdateisystems, während das Schema eine XML-Darstellung des Hostdateisystems ist. Sie verwenden die Metadatenassembly, um das Hostdateisystem zu beschreiben, das BizTalk Server.

Weitere Informationen zum Erstellen einer Hostdateianwendung in Visual Studio finden Sie unter Erstellen einer Anwendung mit dem verwalteten Datenanbieter für Hostdateien.

Erstellen eines Sendeports

Melden Sie sich mit einem Konto an, das Mitglied der Gruppe BizTalk Server Administratoren ist.

  1. Erweitern Sie in BizTalk Server Verwaltungdie Option BizTalk-Gruppe, erweitern Sie Anwendungen, und wählen Sie dann Ihre Anwendung aus.

  2. Klicken Sie mit der rechten Maustaste auf Sendeports, wählen Sie Neu und dann Statischer unidirektionale Sendeport oder Anforderungsantwort-Sendeport aus.

  3. Legen Sie in den Sendeporteigenschaften den Transporttyp auf Hostdatei fest. Wählen Sie Konfigurieren aus, und geben Sie die folgenden Eigenschaften ein:

    Option Aufgabe
    Verbindungszeichenfolge Der Name eines Verbindungszeichenfolge, der zum Herstellen einer Verbindung mit der Hostdateidatenbank verwendet wird.

    Um eine neue oder vorhandene Verbindungszeichenfolge zu konfigurieren, klicken Sie auf die Auslassungspunkte (...). Dadurch wird der Datenquellen-Assistent gestartet. Um auf die Hilfe zuzugreifen, klicken Sie auf den Assistentenseiten auf Hilfe, oder öffnen Sie die Host Integration Server-Hilfe, und suchen Sie im Datenquellen-Assistenten (Hostdateien).
    Zielnamespace des Dokuments Der Zielnamespace, der in den XML-Dokumenten verwendet wird, die an den Host gesendet werden.
    Stammelementname der Antwort Der Name des Stammelements, das in den XML-Dokumenten verwendet wird, die vom Host empfangen werden. (Diese Eigenschaft kann für einen unidirektionale Port leer sein.)
    URI Einheitlicher Ressourcenbezeichner. Ein Name zum Identifizieren des Sendeportspeicherorts.

  4. Klicken Sie auf OK, um die Änderungen zu speichern.

  5. Wählen Sie für den Sendehandler den Host instance aus, um den Adapter auszuführen, und wählen Sie die Sendepipeline aus.

  6. Klicken Sie auf OK, um die Änderungen zu speichern.

  7. Klicken Sie unter Sendeports mit der rechten Maustaste auf Ihren neuen Sendeport, und wählen Sie Eintragen und dann Start aus.

Erstellen eines Empfangsports und standorts

Melden Sie sich mit einem Konto an, das Mitglied der Gruppe BizTalk Server-Administratoren ist.

  1. Erweitern Sie in BizTalk Server Verwaltungdie Option BizTalk-Gruppe, erweitern Sie Anwendungen, und wählen Sie dann Ihre Anwendung aus.

  2. Klicken Sie mit der rechten Maustaste auf Empfangsports, wählen Sie Neu und dann Statischer unidirektionale Empfangsport aus. Konfigurieren Sie Ihre Empfangsporteigenschaften, und wählen Sie OK aus, um Die Änderungen zu speichern.

  3. Klicken Sie mit der rechten Maustaste auf Empfangsorte, wählen Sie Neu und dann Unidirektionale Empfangsadresse aus. Wählen Sie den von Ihnen erstellten Empfangsport und dann OK aus.

  4. Legen Sie in den Eigenschaften des Empfangsspeicherorts den Transporttyp auf HostFiles fest. Wählen Sie Konfigurieren aus, und geben Sie die folgenden Eigenschaften ein:

    Option Aufgabe
    Verbindungszeichenfolge Geben Sie den Namen einer Verbindungszeichenfolge ein, die zum Herstellen einer Verbindung mit der Hostdatenbank verwendet wird.

    Um eine neue oder vorhandene Verbindungszeichenfolge zu konfigurieren, klicken Sie auf die Auslassungspunkte (...). Dadurch wird der Datenquellen-Assistent gestartet. Um auf die Hilfe zuzugreifen, klicken Sie auf den Assistentenbildschirmen auf Hilfe , oder öffnen Sie die Host Integration Server-Hilfe, und suchen Sie im Datenquellen-Assistenten (Hostdateien) nach.

    Wenn Sie einen Empfangsspeicherort oder Sendeport basierend auf dem BizTalk-Adapter für Hostdateien konfigurieren, sollte die Metadatendefinition als HIDX-Metadatendatei (Host Integration Designer XML) zum Codieren und Decodieren von Datensätzen erstellt werden. Anweisungen zum Erstellen einer HIDX-Datei finden Sie unter Erstellen einer Anwendung mit dem verwalteten Datenanbieter für Hostdateien.
    Stammelementname des Dokuments Der Name des Stammelements, das in den XML-Dokumenten verwendet wird, die vom Host empfangen werden.
    Zielnamespace des Dokuments Der Zielnamespace, der in den XML-Dokumenten verwendet wird, die vom Host empfangen werden.
    SQL-Befehl Der Select-Befehl, der einmal für jedes Abrufintervall ausgeführt wird.
    Update-Befehl Der Befehl, der nach jeder Zeile im Empfangsvorgang ausgeführt wird, wird verarbeitet. Dies kann entweder eine delete-Anweisung sein, die die Zeile aus der Tabelle im SQL-Befehl löscht, oder ein Updatebefehl, der eine oder mehrere Zeilen statisch ändert. Wenn diese Option angegeben ist, muss der SQL-Befehl eine Select-Anweisung sein und auf eine einzelne Tabelle zugreifen.

    Sie können zusätzliche Eigenschaften angeben, indem Sie auf die Schaltfläche mit den Auslassungspunkten (...) klicken. Dadurch wird das Dialogfeld Befehl ändern geöffnet, das drei Optionen enthält:

    - Nichts tun löscht die anderen beiden Optionen, wenn sie ausgewählt sind.
    - Löschen nach Lesevorgang löscht die Zeile, nachdem der Adapter sie gelesen hat.
    - Mit Update können Sie einen SQL-Befehl eingeben, der aktualisiert werden soll.
    URI Einheitlicher Ressourcenbezeichner. Ein Name, der den Speicherort des Empfangsports identifiziert.
    Abrufintervall Die Anzahl der Einheiten zwischen Abrufanforderungen. Zulässiger Bereich ist 1 bis 65535.
    Abrufmaßeinheit Die Maßeinheit (Sekunden, Minuten oder Stunden), die zwischen Abrufanforderungen verwendet wird. Der Standardwert ist Sekunden.

  5. Klicken Sie auf OK, um die Änderungen zu speichern.

  6. Wählen Sie für den Empfangshandler den Host instance aus. Der Empfangshandler muss auf diesem Host ausgeführt werden. Wählen Sie Ihre Empfangspipeline aus.

  7. Klicken Sie auf OK, um die Änderungen zu speichern.

  8. Klicken Sie unter Empfangsspeicherorte mit der rechten Maustaste auf den Empfangsspeicherort, und wählen Sie Aktivieren aus.

Erstellen eines Schemas

Verwenden Sie den Assistenten zum Generieren von Hostdateischemas, um die XSD-Schemas für den BizTalk-Adapter für Hostdateien zu erstellen. Nachdem Sie das Schema erstellt haben, können Sie die Konfiguration auf der BizTalk Server seite fortsetzen.

  1. Öffnen Sie Ihr BizTalk Server Visual Studio-Projekt.

  2. Klicken Sie mit der rechten Maustaste auf das Projekt, wählen Sie Hinzufügen, dann Generierte Elemente hinzufügen und dann Adaptermetadaten hinzufügen aus.

  3. Wählen Sie im Assistenten zum Hinzufügen von Adaptern auf der Seite Adapter auswählen die Option Hostdatei und dann Weiter aus.

  4. Führen Sie im Assistenten zum Erstellen des Hostdateiadapterschemas Folgendes aus:

    1. Navigieren Sie unter Datenbankinformationen zu einer vorhandenen Verbindungszeichenfolge, oder erstellen Sie eine neue.

      Dies kann der Anfangskatalog, die Paketsammlung (TCP-Adresse und Port) oder (APPC Local LU, Remote-LU und Modus), (Benutzername und Kennwort) oder (integrierte Sicherheit) sein. Die maximale Länge beträgt 1024.

    2. Definieren Sie unter Schemainformationen den Standardnamespace, die Stammelemente und den Porttyp, die Sie im Schema verwenden möchten.

      Wenn Sie Port empfangen auswählen, wird nur der Name eines Anforderungsdokumentstammelements benötigt. Wenn Sie Port senden auswählen, sind die Namen des Stammelements für Anforderungs- und Antwortdokument erforderlich.

    3. Wählen Sie unter Anweisungstypinformationen den Typ des Datenbankbefehls aus, der ausgegeben werden soll.

      Wenn Sie auf der vorherigen Seite Sendeports ausgewählt haben, können Sie ein Updategramm, eine gespeicherte Prozedur oder eine SELECT-Anweisung ausstellen. Wenn Sie Empfangsports ausgewählt haben, ist dieser Schritt nicht erforderlich.

    4. Geben Sie unter Anweisungsinformationen die Details zur Hostdatei ein. Geben Sie je nach den Informationen, die Sie zuvor auf früheren Seiten eingegeben haben, die folgenden Eigenschaften ein. Wenn Sie Sendeport ausgewählt haben:

      • Updategram senden Wenn Sie einen Sendeport und Updategramme verwenden möchten, können Sie hier den Vorgang updategram sowie die Tabelle und spalten auswählen, die im Updategram vorhanden sein werden.

      • Systembefehl senden Wenn Sie einen Sendeport verwenden und eine gespeicherte Prozedur ausstellen, können Sie eine gespeicherte Prozedur aus dem Katalog der aktuellen Verbindung auswählen. Sie müssen nicht werte für alle Parameter auf dieser Seite eingeben.

      • Select-Anweisung senden Wenn Sie sich für die Verwendung eines Sendeports mit einer SQL Select-Anweisung entschieden haben, können Sie die Anweisung hier auswählen oder navigieren.

      Wenn Sie Den Port empfangen ausgewählt haben:

      • Select-Anweisung empfangen Wenn Sie sich für die Verwendung eines Empfangsports mit einer SQL-Anweisung entschieden haben, können Sie die Anweisung hier auswählen oder navigieren.

      • Updategram senden Wenn Sie einen Sendeport und Updategramme verwenden möchten, können Sie hier den Vorgang updategram sowie die Tabelle und spalten auswählen, die im Updategram vorhanden sein werden.

      • Gespeicherte Prozedur senden Wenn Sie einen Sendeport verwenden und eine gespeicherte Prozedur ausstellen, können Sie eine gespeicherte Prozedur aus dem Katalog der aktuellen Verbindung auswählen. Sie müssen nicht werte für alle Parameter auf dieser Seite eingeben.

      • Select-Anweisung senden Wenn Sie sich für die Verwendung eines Sendeports mit einer SQL Select-Anweisung entschieden haben, können Sie die Anweisung hier auswählen oder navigieren.

  5. Wählen Sie Fertig stellen aus, wenn sie abgeschlossen sind.

Erstellen einer BizTalk-Anwendung

Nachdem Sie das Schema erstellt haben, können Sie Ihre BizTalk-Anwendung codieren. Ihre Anwendung verwendet die Metadatenassembly, die Sie in Visual Studio erstellt haben, zusätzlich zum Schema und den Ports, die Sie erstellt haben.

  1. Erstellen Sie ein BizTalk-Projekt in Visual Studio.

  2. Verwenden Sie das von Ihnen erstellte Schema, um das Hostdateisystem für die BizTalk-Anwendung zu beschreiben.

  3. Verwenden Sie den von Ihnen erstellten Sendeport, um Daten an das Hostdateisystem zu senden.

  4. Verwenden Sie bei Bedarf den empfangenen Port und den Speicherort, den Sie erstellt haben.

  5. Fügen Sie nach Bedarf zusätzliche Orchestrierungen, Komponenten oder Code hinzu.

  6. Testen Sie Ihre Anwendung.

  7. Erstellen Sie nach Abschluss des Tests ihrer Anwendung ein .msi Paket, um Ihre Anwendung auf einen Staging- oder Liveserver zu verschieben. Wenn Sie ein BizTalk Server .msi-Paket erstellen, müssen Sie unbedingt die Metadatenassembly der Hostdatei einschließen, die Sie erstellt haben.

Weitere Informationen

Verwalteter Datenanbieter für Hostdateien