Installieren und Verwenden des Logik-App-Adapters auf BizTalk Server

BizTalk Server verwendet den Logic Apps-Adapter, um Nachrichten von einer Azure-Logik-App zu empfangen oder Nachrichten an eine Azure-Logik-App zu senden.

In Azure erstellen wir eine Logik-App. Diese Logik-App verwendet den BizTalk-Connector, um eine Verbindung mit einem Empfangsspeicherort herzustellen, den Sie auf Ihrem BizTalk Server erstellen. In diesem Thema wird vorausgesetzt, dass Sie mit Azure Logic Apps vertraut sind. Wenn Sie noch nicht mit Logik-Apps vertraut sind, empfehlen wir Ihnen, mehr darüber zu erfahren und sogar Ihre eigene Logik-App zu erstellen.

In diesem Thema werden die Schritte zum Empfangen einer Nachricht in BizTalk Server von einer Logik-App aufgeführt. Anders ausgedrückt: Die Logik-App sendet Nachrichten an eine BizTalk Server. Empfangsseitig werden Anwendungen in IIS verwendet, um die Kommunikation mit dem Azure-Dienst zu verarbeiten. Wenn BizTalk Server lokal ist, installieren Sie auch ein Datengateway auf der BizTalk Server und erstellen ein Gateway in Azure.

Wenn BizTalk Server auf einem virtuellen Azure-Computer (VM) installiert ist, können Sie die VM als HTTP-Endpunkt verfügbar machen (Sie erhalten eine URL), oder sie nicht als HTTP-Endpunkt verfügbar machen. Wenn Sie es verfügbar machen, müssen Sie das Gateway nicht verwenden. Sie können Ihre URL im BizTalk-Connector in Ihrer Logik-App eingeben. Wenn Sie den virtuellen Computer nicht verfügbar machen (keine URL), müssen Sie das Gateway verwenden. Diese Schritte werden in diesem Thema aufgeführt.

Außerdem erfahren Sie, wie Sie Nachrichten von BizTalk Server an eine Azure-Logik-App senden. Anders ausgedrückt: Die Logik-App empfängt Nachrichten von BizTalk Server. Die Sendeseite ist ziemlich einfach, wie Sie in diesem Thema sehen werden.

Verwenden Sie dieses Thema, um mithilfe des Logic Apps-Adapters einen Empfangsspeicherort und einen Sendeport zu erstellen. Sie können den LogicApp-Adapter in einem lokalen (mit Ihrer Domäne verknüpften) BizTalk Server oder auf einem virtuellen Azure-Computer verwenden, auf dem BizTalk Server ausgeführt wird.

Requirements (Anforderungen)

• Ein Azure-Abonnement, um sich beim Azure-Portal anzumelden und eine Logik-App zu erstellen.
• Optional. Um eine Testnachricht an Ihre Logik-App zu senden, installieren Sie ein HTTP-Testtool, z. B. Fiddler oder Postman. Wenn Sie eine andere Methode zum Senden einer Nachricht an eine Logik-App verwenden, müssen Sie diese Tools nicht verwenden.

Installieren des Logik-App-Adapters

BizTalk Server 2020 und höher

Ab BizTalk Server 2020 ist der Logik-App-Adapter in der BizTalk Server-Installation enthalten.

BizTalk Server 2016

1. Laden Sie auf Ihrem BizTalk Server den Logik-App-Adapter herunter, und installieren Sie sie:
   • Navigieren Sie zu Microsoft BizTalk Server Adapter für Logic Apps, und speichern Sie.
   • Öffnen Sie LogicAppAdapter.iso, und führen Sie die zu installierende Datei LogicApp Adapter.msi aus.
2. Wählen Sie die zu installierende LogicApp-Adapter.msi doppelt aus. Akzeptieren Sie den Lizenzvertrag, und installieren Sie.
3. Schließen Sie die Installation ab, und starten Sie die Hostinstanzen BizTalkServerApplication und BizTalkServerIsolatedHost neu.

Nach der Installation verfügen Sie über Folgendes:

• Der LogicApp-Adapter wird der BizTalk-Verwaltung hinzugefügt.

• Der Sendehandler wird erstellt und verwendet den BizTalkServerApplication-Host.

• Der Empfangshandler wird als WCF-Dienst erstellt und verwendet den BizTalkServerIsolatedHost-Host.

• Der LogicApp Adapter Ordner wird im BizTalk-Installationsverzeichnis erstellt und umfasst zwei Dienste: Management und ReceiveService.

  Die Verwaltung wird vom BizTalk-Connector in einer Logik-App verwendet, um über das Datengateway eine Verbindung mit BizTalk Server herzustellen. Mit diesem Verwaltungsdienst können BizTalk Server Nachrichten von einer Azure-Logik-App über das Datengateway empfangen. Dieser Dienst wird nur auf der Empfangsseite von BizTalk verwendet. Sie wird nicht von der Sendeseite verwendet.

  Der ReceiveService wird vom BizTalk-Connector in einer Logik-App verwendet, wenn Sie den Empfangsspeicherort eingeben. Der ReceiveService ist für das Senden der Nachrichten aus der Logik-App verantwortlich. Dieser Dienst wird nur auf der Empfangsseite von BizTalk verwendet. Sie wird nicht von der Sendeseite verwendet.

Empfangen von Nachrichten von einer Logik-App

Es sind einige Schritte erforderlich, damit BizTalk Server Nachrichten von einer Logik-App empfangen können. Im folgenden Abschnitt werden die erforderlichen Schritte beschrieben. Es ist möglich, dass sich die Benutzeroberfläche in Azure ändert, sodass einige der Schritte möglicherweise nicht genau wie aufgeführt sind.

Voraussetzungen

• Wenn BizTalk Server lokal ist, installieren und konfigurieren Sie das lokale Datengateway für Logic Apps. Erstellen Sie dann in Azure die Datengatewayressource, um eine Verbindung mit Ihrem BizTalk Server herzustellen.
• Wenn BizTalk Server auf einer Azure-VM installiert ist und der virtuelle Computer nicht als HTTP-Endpunkt verfügbar gemacht wird, installieren und konfigurieren Sie das lokale Datengateway für Logic Apps. Erstellen Sie dann in Azure die Datengatewayressource, um eine Verbindung mit Ihrem BizTalk Server herzustellen.
• Wenn BizTalk Server auf einer Azure-VM installiert ist und die VM als HTTP-Endpunkt verfügbar gemacht wird, wird das Gateway nicht benötigt oder verwendet.

Verwenden des NullAdapters und des Logik-App-Adapters zusammen – nur BizTalk Server 2016

Wenn Sie den Logik-App-Adapter und den NullAdapter installieren, wird möglicherweise der folgende Fehler angezeigt:

Another adapter with the same OutboundEngineCLSID value already exists

Die GUID der Adapter-Klasse ist für Logic App Adapter und NullAdapter identisch. Wenn beide Adapter benötigt werden, haben Sie folgende Möglichkeiten:

1. Laden Sie den Quellcode von NullAdapter auf GitHub herunter.
2. Aktualisieren Sie die GUID in der NullSendAdapter.cs-Klasse .
3. Aktualisieren Sie den Wert outboundEngineCLSID in der Datei NullAdapter.reg .
4. Erstellen sie den NullAdapter, und stellen Sie es bereit.

Schritt 1: Erstellen der IIS-Anwendungen

Die IIS-Anwendungen verwenden die Dienste Management und ReceiveService.

Sie können die IIS-Anwendungen mithilfe eines neuen Anwendungspools oder eines vorhandenen Anwendungspools ausführen. Die Identität des AppPools erfordert die Mitgliedschaft in den gleichen Gruppen wie das Konto, das die BizTalk-Dienste ausführt, z. B. die Gruppen BizTalk-Anwendungsbenutzer und BizTalk Isolated Host Users.

Tipp

Wenn Sie einen neuen Anwendungspool erstellen, behalten Sie die .NET CLR-Standardversion und die verwaltete Pipeline bei. Denken Sie daran, eine Identität (Erweiterte Einstellungen) auszuwählen, die in den gleichen BizTalk-Gruppen wie Ihr BizTalk-Dienstkonto mitglied ist.

Erstellen der IIS-Verwaltungsanwendung

Die URL dieser IIS-Anwendung wird vom BizTalk-Connector (in Ihrer Logik-App) verwendet, um das Datengateway auf Ihrem BizTalk Server zu verwenden.

BizTalk Server 2020 und höher

1. Konfigurieren Sie die REST-APIs mithilfe des BizTalk-Konfigurations-Assistenten. Hilfe bei der Konfiguration finden Sie im Konfigurationshandbuch. Weitere Informationen zu den REST-APIs finden Sie in der BizTalk-REST-API-Referenz.
2. Öffnen Sie einen Webbrowser, und navigieren Sie zu http://localhost/BizTalkManagementService/Schemas. Entweder wird eine Liste von Schemas angezeigt, oder Sie werden aufgefordert, zu öffnen/zu speichern schemas.json. Das tatsächliche Ergebnis hängt von Ihrem Webbrowser ab. Wenn keines dieser Fehler auftritt, überprüfen Sie ihre REST-API-Konfiguration.

BizTalk Server 2016

1. Öffnen Sie den Internetinformationsdienste-Manager (Internet Information Services (IIS) Manager).

2. Klicken Sie mit der rechten Maustaste auf Standardwebsite, und klicken Sie dann auf Anwendung hinzufügen. In dieser neuen Anwendung:

   1. Geben Sie den Alias (Name) für Ihre Anwendung ein, z. B. IISLogicApp.
   2. Wählen Sie den Anwendungspool aus.
   3. Legen Sie den physischen Pfad auf fest C:\Program Files (x86)\Microsoft BizTalk Server 2016\LogicApp Adapter\Management.
   4. Testeinstellungen , um zu bestätigen, dass die Anwendungspoolidentität die Authentifizierungs- und Autorisierungstests bestanden hat.

3. Klicken Sie zum Speichern der Änderungen auf OK .

4. Öffnen Sie einen Webbrowser, und wechseln Sie zu http://localhost/YourApplicationAlias/schemas?api-version=2016-10-26, z. B http://localhost/IISLogicApp/Schemas?api-version=2016-10-26. . Entweder wird eine Liste von Schemas angezeigt, oder Sie werden aufgefordert, zu öffnen/zu speichern schemas.json. Das tatsächliche Ergebnis hängt von Ihrem Webbrowser ab. Wenn dies nicht der Fall ist, fehlt Ihrer AppPool-Identität möglicherweise die Mitgliedschaft in den BizTalk-Gruppen.

Erstellen der IIS-Anwendung BizTalk ReceiveService

Die URL dieser IIS-Anwendung wird vom BizTalk-Connector (in Ihrer Logik-App) verwendet, wenn Sie den Empfangsspeicherort auswählen.

1. Öffnen Sie den Internetinformationsdienste-Manager (Internet Information Services (IIS) Manager).

2. Klicken Sie mit der rechten Maustaste auf Standardwebsite, und klicken Sie dann auf Anwendung hinzufügen. In dieser neuen Anwendung:

   1. Geben Sie den Alias (Name) für Ihre Anwendung ein, z. B. ReceiveWCFService.

   2. Wählen Sie den gleichen Anwendungspool wie die vorherige IIS-Anwendung aus.

   3. Legen Sie den physischen Pfad auf Folgendes fest:

      • BizTalk Server 2020: C:\Program Files (x86)\Microsoft BizTalk Server\LogicApp Adapter\ReceiveService.
      • BizTalk Server 2016: C:\Program Files (x86)\Microsoft BizTalk Server 2016\LogicApp Adapter\ReceiveService.

   4. Testeinstellungen , um zu bestätigen, dass die Anwendungspoolidentität die Authentifizierungs- und Autorisierungstests bestanden hat.

3. Klicken Sie zum Speichern der Änderungen auf OK .

Schritt 2: Erstellen einer Logik-App

1. Erstellen Sie im Azure-Portal eine neue Logik-App.

2. Fügen Sie den Trigger Beim Empfang einer HTTP-Anforderung hinzu.

3. Fügen Sie die Aktion BizTalk Server – Nachricht aus JSON vorbereiten hinzu.

4. Optional: Wählen Sie Über lokales Datengateway verbinden aus, und geben Sie Folgendes ein:

   Eigenschaft	BESCHREIBUNG
   BizTalk Server URL	Geben Sie den vollqualifizierten Domänennamen (FQDN) der Anwendungs-URL der BizTalk-Verwaltung in IIS ein. Geben Sie z. B. http://BizTalkServerName.corp.contoso.com/IISLogicApp/ ein
   Authentifizierungstyp	Wählen Sie Windows aus.
   Username	Geben Sie die Identität des IIS-Anwendungspools ein.
   Kennwort	Geben Sie das Kennwort des IIS-Anwendungspools ein.
   Gateway	Wählen Sie das von Ihnen erstellte Gateway aus.

   Tipp

   Denken Sie daran, dass das Datengateway nur erforderlich ist, wenn:

   • Sie verwenden eine lokale BizTalk Server
   • Sie verwenden einen BizTalk Server virtuellen Azure-Computer, und der virtuelle Computer wird NICHT als HTTP-Endpunkt (keine URL) verfügbar gemacht.

5. Klicken Sie auf Erstellen.

6. Konfigurieren Sie die Aktion. Wählen Sie unter Text die HTTP-Textausgabe aus. Wählen Sie unter Schema das Schema aus, das Sie verwenden möchten.

   Hinweis

   In diesem Schritt wird davon ausgegangen, dass Sie mit Schemas in BizTalk vertraut sind und wissen, welches Schema Sie benötigen. Wenn Sie nicht sicher sind, stellen Sie das Beispiel helloWorld SDK bereit, aktualisieren Sie die Artefakte, um den Logik-App-Adapter zu verwenden, und verwenden Sie dessen Schema und die Beispielmeldung.

7. Fügen Sie einen neuen Schritt hinzu, und wählen Sie die Aktion BizTalk Server – Nachricht senden aus. Wählen Sie unter Empfangsspeicherort die URL aus der Dropdownliste aus, oder geben Sie den vollqualifizierten Domänennamen (FQDN) der URL der Iis-Anwendung "ReceiveService" ein. Geben Sie z. B. http://BizTalkServerName.corp.contoso.com/ReceiveWCFService/Service1.svc ein

   Tipp

   Wenn Sie den Empfangsspeicherort erstellen, wird diese genaue URL auch in den Transporteigenschaften des Empfangsspeicherorts als öffentliche Adresse (Registerkarte Allgemein) eingegeben.

   Wählen Sie unter Text die Textausgabe aus der vorherigen BizTalk Server Aktion aus.

8. Speichern Sie die Änderungen.

Wenn Sie speichern, erstellt der HTTP-Anforderungstrigger automatisch eine URL. Kopieren Sie diese URL. Sie benötigen sie in Schritt 4: Senden einer Nachricht (in diesem Artikel).

Schritt 3: Erstellen eines Empfangsports und eines Empfangsspeicherorts

Hinweis

Anstatt Eigene Empfangsports und Empfangsspeicherorte zu erstellen, können Sie das Beispiel helloWorld SDK bereitstellen. Aktualisieren Sie die Artefakte, um den Logic Apps-Adapter zu verwenden.

In diesem Abschnitt werden die Schritte zum Erstellen eigener Artefakte aufgeführt.

1. Erweitern Sie BizTalk Server Verwaltung BizTalk Server,BizTalk-Gruppe, Anwendungen, und erweitern Sie dann die Anwendung, die Sie als Empfangsspeicherort ausführen möchten. Erweitern Sie beispielsweise BizTalk-Anwendung 1.

2. Wählen Sie mit der rechten Maustaste Empfangsports, Neu und Unidirektionale Empfangsport aus.

3. Geben Sie in den Eigenschaften Des Empfangsports Folgendes ein:

   Option	Aufgabe
   Name	Geben Sie einen Namen für den Empfangsport ein. Geben Sie beispielsweise LAReceivePort ein.
   Authentifizierung	Optionen: Keine Authentifizierung: Standard. Deaktiviert die Authentifizierung. Löschen von Nachrichten, wenn die Authentifizierung fehlschlägt: Aktiviert die Authentifizierung, aber das Löschen nicht authentifizierter Nachrichten. Nachrichten beibehalten, wenn die Authentifizierung fehlschlägt: Klicken Sie auf diese Option, um die Authentifizierung zu aktivieren und nicht authentifizierte Nachrichten beizubehalten.
   Routing für fehlerhafte Nachrichten aktivieren	Leitet jede Nachricht, die bei der Verarbeitung fehlschlägt, an eine abonnierende Anwendung weiter (z. B. an einen anderen Empfangsport oder einen Orchestrierungszeitplan). Deaktivieren Sie diese Option, um fehlerhafte Nachrichten angehalten und eine negative Bestätigung (NACK) zu generieren. In der Standardeinstellung ist dieses Kontrollkästchen deaktiviert. Weitere Informationen finden Sie unter Aktivieren des Routings für fehlerhafte Nachrichten für einen Empfangsport.

4. Wählen Sie Empfangsspeicherorte und dann Neu aus.

5. Geben Sie einen Namen für den Empfangsspeicherort ein. Geben Sie beispielsweise LAReceiveLoc ein.

6. Wählen Sie unter Typ die Option LogicApp aus der Liste aus, und wählen Sie die Schaltfläche Konfigurieren aus.

7. Konfigurieren Sie auf der Registerkarte Allgemein die Endpunktadresse für Ihre Logik-App:

   Option	Aufgabe
   Adresse (URI)	Erforderlich. Geben Sie die IIS-Anwendungs-URL für BizTalk ReceiveService (/YourIISApp2Name/Service1.svc) ein. Geben Sie z. B. /ReceiveWCFService/Service1.svc ein
   Öffentliche Adresse	Erforderlich. Geben Sie http://<your fully qualified machine name>/YourIISApp2Name/Service1.svc ein. Geben Sie z. B. http://btsProd.northamerica.corp.contoso.com/ReceiveWCFService/Service1.svc ein Diese genaue URL wird auch in Ihrer Logik-App am Empfangsspeicherort aufgeführt.

8. Optional: Konfigurieren Sie auf der Registerkarte Bindung alle Timeout- und Codierungseigenschaften der zugrunde liegenden WCF-WebHttp Bindung. Diese Eigenschaften sind bei großen Nachrichten hilfreich.

   Option	Aufgabe
   Offenes Timeout	Geben Sie das Zeitintervall ein, das es dauern soll, bis der Vorgang zum Öffnen des Kanals abgeschlossen ist. Dieser Wert sollte größer oder gleich System.TimeSpan.Zero sein. Standardwert: 00:01:00 Maximaler Wert: 23:59:59
   Timeout senden	Geben Sie das Zeitintervall ein, das bis zum Abschluss des Sendevorgangs dauern soll. Dieser Wert sollte größer oder gleich System.TimeSpan.Zero sein. Wenn Sie einen Anforderung-Antwort-Empfangsport verwenden, gibt dieser Wert eine Zeitspanne an, in der die gesamte Interaktion abgeschlossen werden kann, auch wenn der Client eine große Nachricht zurückgibt. Standardwert: 00:01:00 Maximalwert: 23:59:59
   Schließen-Timeout	Geben Sie das Zeitintervall ein, das bis zum Abschluss des Vorgangs zum Schließen des Kanals dauern soll. Dieser Wert sollte größer oder gleich System.TimeSpan.Zero sein. Standardwert: 00:01:00 Maximalwert: 23:59:59
   Maximalgröße empfangener Nachrichten (Byte)	Geben Sie die maximale Größe (in Bytes) für eine Nachricht einschließlich Headern ein, die über die Verbindung empfangen werden soll. Die Größe der Nachrichten ist an die Menge des Arbeitsspeichers gebunden, der für jede Nachricht zugewiesen ist. Sie können diese Eigenschaft verwenden, um das Risiko für Denial-of-Service-Angriffe (DoS-Angriffe) einzuschränken. Standardwert: 65536 Maximalwert: 2147483647
   Maximale Anzahl gleichzeitiger Aufrufe	Geben Sie die Anzahl gleichzeitiger Aufrufe eines einzelnen Diensts instance ein. Aufrufe, die diese Grenze überschreiten, werden in die Warteschlange eingereiht. Das Festlegen dieses Werts auf 0 (null) ist identisch mit dem Festlegen des Werts auf Int32.MaxValue. Standardwert: 200.

9. Optional: Konfigurieren Sie auf der Registerkarte Sicherheit alle Sicherheitseigenschaften. Zu Entwicklungszwecken können Sie Keine auswählen:

   Option	Aufgabe
   Sicherheitsmodus	Optionen: None: Nachrichten werden bei der Übertragung nicht gesichert. Transport: Während des HTTPS-Transports ist die Sicherheit gewährleistet. Die SOAP-Nachrichten werden bei der Verwendung von HTTPS gesichert. Um diesen Modus zu verwenden, müssen Sie SSL (Secure Sockets Layer) in Internet Information Services (IIS) einrichten. TransportCredentialOnly: Standard.
   Transport von Clientanmeldeinformationstypen	Wählen Sie den Anmeldeinformationstyp aus, wenn Sie die Clientauthentifizierung verwenden. Optionen: None: Auf Transportebene erfolgt keine Authentifizierung. Basic: Verwendet die Standardauthentifizierung, um Benutzernamen und Kennwörter in Nur-Text über das Netzwerk zu senden. Sie müssen Domänen- oder lokale Benutzerkonten erstellen, die den Anmeldeinformationen entsprechen. Digest: Verwendet Digest-Authentifizierung, um Kennwörter als Hashwert über das Netzwerk zu senden. Nur für Domänen mit Domänencontrollern verfügbar, die die Windows Server-Betriebssystemauthentifizierung ausführen. Sie müssen Domänen- oder lokale Benutzerkonten erstellen, die den Anmeldeinformationen entsprechen. Ntlm: Standard. Clients senden die Anmeldeinformationen ohne Kennwort an diesen Empfangsspeicherort. Sie müssen Domänen- oder lokale Benutzerkonten erstellen, die den Anmeldeinformationen entsprechen. Windows: Die integrierte Windows-Authentifizierung verhandelt Kerberos oder NTLM und bevorzugt Kerberos, wenn eine Domäne vorhanden ist. Für die Verwendung von Kerberos ist es wichtig, dass der Client den Dienst mit einem Dienstprinzipalnamen (Service Principal Name, SPN) identifiziert. Sie müssen Domänen- oder lokale Benutzerkonten erstellen, die den Anmeldeinformationen entsprechen. Zertifikat: Verwendet ein Clientzertifikat. Die Zertifizierungsstellenzertifikatkette für die X.509-Clientzertifikate muss im Zertifikatspeicher vertrauenswürdiger Stammzertifizierungsstellen dieses Computers installiert sein, damit sich die Clients an diesem Empfangsspeicherort authentifizieren können. InheritedFromHost
   Verwenden des einmaligen Anmeldens

10. Optional: Verwenden Sie auf der Registerkarte Nachrichten die Eigenschaft Ausgehende HTTP-Header, um benutzerdefinierte Header hinzuzufügen, und verwenden Sie die zusätzlichen Eigenschaften, um Fehler zu beheben:

    Option	Aufgabe
    Ausgehende HTTP-Header	Geben Sie alle HTTP-Header ein, die für die Antwortnachricht gestempelt werden sollen.
    Speicherort bei Fehler deaktivieren	Deaktiviert den Empfangsspeicherort, wenn die eingehende Verarbeitung aufgrund eines Fehlers der Empfangspipeline oder eines Routingfehlers fehlschlägt. Der Standardwert ist deaktiviert.
    Anforderungsnachricht bei Fehler anhalten	Hält die Anforderungsnachricht an, wenn die eingehende Verarbeitung aufgrund eines Fehlers der Empfangspipeline oder eines Routingfehlers fehlschlägt. Der Standardwert ist deaktiviert.
    Ausnahmedetails in Fehlermeldung einbeziehen	Wenn ein Fehler auftritt, gibt alle SOAP-Fehler zurück, um das Debuggen zu unterstützen. Der Standardwert ist deaktiviert.

Die Verwaltung von Empfangsspeicherorten beschreibt die zusätzlichen Eigenschaften.

Schritt 4: Senden einer Nachricht

1. Öffnen Sie Fiddler oder Postman (oder was auch immer Sie bevorzugen).

2. Fügen Sie die URL des Anforderungstriggers aus Ihrer Logik-App ein. Sie haben diese URL in Schritt 3 kopiert.

3. Wählen Sie POST als HTTP-Verb aus, und legen Sie den Header Content-type auf fest application/json. Fügen Sie den folgenden JSON-Code in den Textkörper ein:

   {"hello":"world"}
   

4. Da dies ein unidirektionaler Aufruf von BizTalk ist, sollte das Ergebnis ein HTTP 202 sein. Wenn Sie das Beispiel für das HelloWorld SDK verwenden, wechseln Sie zu Ihrem BizTalk-Server. Möglicherweise befindet sich in Ihrem Sendeordner eine Datei.

Senden von Nachrichten an eine Logik-App

Schritt 1: Erstellen einer Logik-App

1. Erstellen Sie im Azure-Portal eine neue Logik-App.

2. Hinzufügen des Triggers Beim Empfang einer HTTP-Anforderung

3. Fügen Sie die aktion Office 365 Outlook – Senden einer E-Mail hinzu. Geben Sie unter An Adresse Ihre Office 365 Adresse ein. Geben Sie als Betreff ein Sending from BizTalk. Wählen Sie unter Text die Ausgabe Text aus dem Trigger Wenn eine HTTP-Anforderung empfangen wird aus.

4. Ihre Logik-App ähnelt dem folgenden Beispiel:

   

5. Kopieren Sie die HTTP POST-URL, die automatisch erstellt wird, wenn Sie die Logik-App speichern. Sie benötigen diese URL im nächsten Schritt. Möglicherweise müssen Sie die Logik-App schließen und erneut öffnen, um die URL anzuzeigen.

Schritt 2: Erstellen eines Sendeports

Damit BizTalk Server Nachrichten an eine Logik-App senden kann, muss die Logik-App über einen manuellen Trigger verfügen, z. B. Manuell – Wenn eine HTTP-Anforderung empfangen wird.

1. Erweitern Sie BizTalk Server Verwaltung BizTalk Server,BizTalk-Gruppe, Anwendungen, und erweitern Sie dann die Anwendung, die Sie ausführen möchten, um den Sendeport auszuführen. Erweitern Sie beispielsweise BizTalk-Anwendung 1.

2. Wählen Sie mit der rechten Maustaste Ports senden, Neu und statischen unidirektionalen Sendeport aus.

3. Geben Sie einen Namen für den Sendeport ein. Geben Sie beispielsweise LASendPort ein.

4. Wählen Sie unter Typdie Option LogicApp aus der Liste aus, und wählen Sie die Schaltfläche Konfigurieren aus.

5. Konfigurieren Sie auf der Registerkarte Allgemein den Rückruf-URI Ihres Logik-App-Triggers. Hierfür gibt es zwei Möglichkeiten:

   Option 1 : Fügen Sie die HTTP POST-URL, die Sie im vorherigen Schritt kopiert haben, in die Eigenschaft Trigger (Rückruf-URI) ein. Sie können den URI auch mit den folgenden Schritten kopieren:

   1. Öffnen Sie im Azure-Portal Ihre Logik-App im Logik-Apps-Designer (Bearbeitungsmodus).

   2. Wählen Sie beim Empfang einer HTTP-Anforderung Karte aus, und kopieren Sie die URL.

   3. Fügen Sie diese URL an Ihrem Sendeport in die Eigenschaft Trigger (Rückruf-URI) ein.

      Tipp

      Sie können auch Ihre Verwaltungs-APIs verwenden, um diesen URI abzurufen.

      Option 2 : Wenn Sie den Rückruf-URI für Ihren Trigger nicht kennen, wählen Sie Konfigurieren und Anmelden bei Azure aus. Verwenden Sie dann die Dropdownlisten, um Ihr Abonnement, Ihre Ressourcengruppe, Ihre Logik-App und Ihren Trigger auszuwählen.

6. Optional: Konfigurieren Sie auf der Registerkarte Bindung alle Timeout- und Codierungseigenschaften der zugrunde liegenden WCF-WebHttp Bindung. Diese Eigenschaften sind hilfreich beim Umgang mit großen Nachrichten.

   Option	Aufgabe
   Offenes Timeout	Geben Sie das Zeitintervall ein, das es dauern soll, bis der Vorgang zum Öffnen des Kanals abgeschlossen ist. Dieser Wert sollte größer oder gleich System.TimeSpan.Zero sein. Standardwert: 00:01:00 Maximalwert: 23:59:59
   Timeout senden	Geben Sie das Zeitintervall ein, das bis zum Abschluss des Sendevorgangs dauern soll. Dieser Wert sollte größer oder gleich System.TimeSpan.Zero sein. Wenn Sie einen Anforderung-Antwort-Empfangsport verwenden, gibt dieser Wert eine Zeitspanne an, in der die gesamte Interaktion abgeschlossen werden kann, auch wenn der Client eine große Nachricht zurückgibt. Standardwert: 00:01:00 Maximalwert: 23:59:59
   Schließen-Timeout	Geben Sie das Zeitintervall ein, das bis zum Abschluss des Vorgangs zum Schließen des Kanals dauern soll. Dieser Wert sollte größer oder gleich System.TimeSpan.Zero sein. Standardwert: 00:01:00 Maximalwert: 23:59:59
   Maximalgröße empfangener Nachrichten (Byte)	Geben Sie die maximale Größe (in Bytes) für eine Nachricht einschließlich Headern ein, die über die Verbindung empfangen werden soll. Die Größe der Nachrichten ist an die Menge des Arbeitsspeichers gebunden, der für jede Nachricht zugewiesen ist. Sie können diese Eigenschaft verwenden, um das Risiko für Denial-of-Service-Angriffe (DoS-Angriffe) einzuschränken. Der Logik-appa-Adapter nutzt die WebHttpBinding-Klasse im gepufferten Übertragungsmodus, um mit einem Endpunkt zu kommunizieren. Im gepufferten Transportmodus entspricht die Eigenschaft WebHttpBinding.MaxBufferSize immer dem Wert dieser Eigenschaft. Standardwert: 65536 Maximalwert: 2147483647

7. Optional: Verwenden Sie auf der Registerkarte Nachrichten die Eigenschaft Ausgehende HTTP-Header, um benutzerdefinierte Header für die ausgehende Nachricht hinzuzufügen.

8. Wählen Sie OK, um Ihre Konfiguration zu speichern.

Das Verwalten von Sendeports und Sendeportgruppen beschreibt die zusätzlichen Sendeporteigenschaften.

Schritt 3: Senden von Nachrichten

Sie können einen Empfangsport und einen Empfangsspeicherort mithilfe des Dateiadapters erstellen. Stellen Sie sicher, dass Ihre Logik-App aktiviert ist.

1. Erstellen eines Empfangsports, z. B . FileSendPort,

2. Erstellen Sie einen Empfangsspeicherort, und legen Sie die Eigenschaften wie folgt fest:

   Eigenschaft	Beispieleingabe
   Empfangsordner	C:\temp\In\
   Dateimaske	*.txt
   Pipeline	PassThruReceive

3. Legen Sie im von Ihnen erstellten Sendeport den Filter auf fest:

   Eigenschaft	Operator	Wert
   BTS.ReceivePortName	==	FileSendPort

4. Erstellen Sie eine Textdatei (FileName.txt) mit dem folgenden Text. Verwenden Sie diese Textdatei als Beispielmeldung:

   <Data>
     <DataID>DataID_0</DataID>
     <DataDetails>DataDetails_0</DataDetails>
   </Data>
   

5. Kopieren Sie Ihre Beispielnachricht (FileName.txt) in den Empfangsordner. Der Sendeport sendet die .txt-Datei mithilfe des eingegebenen URI an die Logik-App. Ihre Logik-App empfängt die Dateien. Wenn Sie den Office 365 Outlook-Connector verwendet haben, sollte Ihre An-E-Mail-Adresse die E-Mail mit der Beispielnachricht erhalten.

Nächste

Was sind Logik-Apps?

Erstellen einer Logik-App

Verwenden von Adaptern in BizTalk Server