Herstellen einer Verbindung mit Azure Logic Apps von BizTalk Server
Um Nachrichten zwischen BizTalk Server und einem Logik-App-Workflow in Azure auszutauschen, können Sie den Adapter in BizTalk Server für Azure Logic Apps verwenden. In diesem Leitfaden wird gezeigt, wie Eine Nachricht in BizTalk Server von einem Logik-App-Workflow empfangen wird. Der Workflow kann Nachrichten an BizTalk Server senden. Das empfangende Ende verwendet IIS-Anwendungen (Internet Information Services), um die Kommunikation mit einem Azure-Dienst zu verarbeiten.
Wenn BizTalk Server lokal ist und Ihrer Domäne beigetreten ist, müssen Sie das lokale Datengateway auf BizTalk Server installieren und eine lokale Datengatewayressource in Azure erstellen. Wenn BizTalk Server jedoch auf einem virtuellen Azure-Computer installiert ist, können Sie auswählen, ob der virtuelle Computer als HTTP-Endpunkt verfügbar gemacht werden soll, der über eine URL verfügt, die Sie aufrufen können.
Wenn Sie die HTTP-Endpunktoption auswählen, müssen Sie das Gateway nicht verwenden. Stattdessen erstellen Sie einen Logik-App-Workflow, fügen die gewünschte BizTalkServer- Connectoraktion hinzu, und geben Sie die HTTP-Endpunkt-URL an, die von den Verbindungsinformationen der Aktion benötigt wird. Wenn Sie jedoch die lokale Option auswählen, müssen Sie das Datengateway einrichten und verwenden, das weiter unten in diesem Handbuch beschrieben wird.
In diesem Leitfaden wird auch gezeigt, wie Nachrichten von BizTalk Server an einen Logik-App-Workflow gesendet werden. Auf eine andere Weise kann Ihr Logik-App-Workflow Nachrichten von BizTalk Server empfangen.
In diesem Handbuch wird gezeigt, wie Sie einen Empfangsspeicherort und einen Sendeport mithilfe des Azure Logic Apps-Adapters erstellen. Sie können diesen Adapter mit einem lokalen BizTalk Server oder einem virtuellen Azure-Computer mit BizTalk Server verwenden.
Voraussetzungen
Ein Azure-Konto und -Abonnement, damit Sie sich beim Azure-Portal anmelden und eine Logik-App-Ressource und einen Workflow erstellen können. Wenn Sie kein Abonnement haben, sich für ein kostenloses Azure-Kontoregistrieren.
BizTalk Server-Anforderungen basierend auf dem Speicherort, an dem der Server installiert ist:
Lokaler Computer mit BizTalk Server: Installieren und Einrichten des lokalen Datengateways für Azure Logic Apps. Erstellen Sie dann im Azure-Portal die Datengatewayressource, die mit dem BizTalk-Serverconnector in Ihrem Logik-App-Workflow verwendet werden soll.
Virtueller Azure-Computer mit BizTalk Server:
Wenn der virtuelle Computer nicht als HTTP-Endpunkt verfügbar gemacht wird, installieren und einrichten Sie das lokalen Datengateway für Azure Logic Apps. Erstellen Sie dann im Azure-Portal die Datengatewayressource, die mit dem BizTalk Server-Connector in Ihrem Logik-App-Workflow verwendet werden soll.
Wenn der virtuelle Computer als HTTP-Endpunkt verfügbar gemacht wird, müssen Sie weder die Datengatewayinstallation verwenden noch die Datengatewayressource erstellen.
Einige Kenntnisse mit Azure Logic Apps. Wenn Sie mit Logik-Apps noch nicht vertraut sind, lesen Sie Was ist Azure Logic Apps? und erstellen sie einen Beispielworkflow für die Verbrauchslogik-App in mehrinstanzenfähigen Azure Logic Apps.
Wenn Ihr Workflow optional mit einem Trigger beginnt, der HTTP-Anforderungen empfangen kann, z. B. einen Request Trigger, können Sie eine Testnachricht senden, die den Logik-App-Workflow auslöst. Verwenden Sie zum Senden dieser Nachricht ein Tool, mit dem HTTP-Anforderungen an die Endpunkt-URL gesendet werden können, die für den Trigger in Ihrem Workflow generiert wurde. Die folgende Liste enthält einige Beispieltools:
- Visual Studio Code mit einer Erweiterung von Visual Studio Marketplace
- PowerShell Invoke-RestMethod-
- Microsoft Edge – Netzwerkkonsolentool
- Bruno
- Curl-
Vorsicht
Für Szenarien, in denen Sie vertrauliche Daten haben, z. B. Anmeldeinformationen, Geheime Schlüssel, Zugriffstoken, API-Schlüssel und andere ähnliche Informationen, stellen Sie sicher, dass Sie ein Tool verwenden, das Ihre Daten mit den erforderlichen Sicherheitsfeatures schützt, offline oder lokal funktioniert, Ihre Daten nicht mit der Cloud synchronisiert und nicht erfordert, dass Sie sich bei einem Onlinekonto anmelden. Auf diese Weise reduzieren Sie das Risiko, vertrauliche Daten der Öffentlichkeit offen zu stellen.
Installieren des Azure Logic Apps-Adapters
BizTalk Server 2020 und höher
Ab BizTalk Server 2020 ist der Azure Logic Apps-Adapter in der BizTalk Server-Installation enthalten.
BizTalk Server 2016
Laden Sie auf Ihrem BizTalk Server den Azure Logic Apps-Adapter herunter, und installieren Sie sie:
Wechseln Sie zu Microsoft BizTalk Server Adapter for Logic Apps, und wählen Sie Downloadaus.
Öffnen Sie zum Installieren die LogicAppAdapter.iso-Datei, und führen Sie die LogicApp Adapter.msi Datei aus.
Akzeptieren Sie den Lizenzvertrag, und wählen Sie Installierenaus.
Starten Sie nach Abschluss der Installation die BizTalkServerApplication neu, und BizTalkServerIsolatedHost Hostinstanzen.
Nach Abschluss der Installation haben Sie die folgenden Zustände:
Der Azure Logic Apps-Adapter wird der BizTalk Administration hinzugefügt.
Der Sendehandler wird erstellt und verwendet die BizTalkServerApplication Hostinstanz.
Der Empfangshandler wird als Windows Communication Foundation-Dienst erstellt und verwendet die BizTalkServerIsolatedHost Hostinstanz.
Der ordner LogicApp Adapter wird im BizTalk-Installationsverzeichnis erstellt und umfasst zwei Dienste: Management und ReceiveService.
Verwaltung: Wird vom BizTalk-Connector in einem Logik-App-Workflow verwendet, um mithilfe des Datengateways eine Verbindung mit BizTalk Server herzustellen. Dieser Verwaltungsdienst ermöglicht Es BizTalk Server, Nachrichten von einem Logik-App-Workflow mithilfe des Datengateways zu empfangen. Dieser Dienst wird nur auf der Empfangsseite von BizTalk und nicht auf der Sendeseite verwendet.
ReceiveService-: Wird vom BizTalk-Connector in einem Logik-App-Workflow mit dem Empfangsspeicherort verwendet. Dieser Dienst ist für das Senden von Nachrichten aus dem Logik-App-Workflow verantwortlich. Dieser Dienst wird nur auf der Empfangsseite von BizTalk und nicht auf der Sendeseite verwendet.
Empfangen von Nachrichten aus einem Workflow
In diesem Abschnitt werden die zusätzlichen Schritte aufgeführt, die für den Empfang von Nachrichten von einem Logik-App-Workflow erforderlich sind. Da sich das Azure-Portal ändern kann, entsprechen einige Schritte möglicherweise nicht genau den aufgeführten Schritten.
BizTalk Server 2016 only: NullAdapter and Azure Logic Apps adapter
Wenn Sie den Azure Logic Apps-Adapter und den NullAdapter installieren, wird möglicherweise der folgende Fehler angezeigt:
Ein anderer Adapter mit demselben Wert "OutboundEngineCLSID" ist bereits
Die GUID der Adapterklasse ist für den Azure Logic Apps-Adapter und NullAdapter identisch. Wenn Sie beide Adapter benötigen, führen Sie die folgenden Schritte aus:
Laden Sie den Quellcode NullAdapter auf GitHubherunter.
Aktualisieren Sie in der NullSendAdapter.cs Klasse die GUID.
Aktualisieren Sie in der datei NullAdapter.reg den wert OutboundEngineCLSID.
Erstellen und Bereitstellen des NullAdapters.
Schritt 1: Erstellen der IIS-Anwendungen
Die IIS-Anwendungen verwenden die Servcies Management und ReceiveService-. Sie können die IIS-Anwendungen mit einem neuen oder vorhandenen Anwendungspool ausführen. Die Identität des AppPool erfordert die Mitgliedschaft in den gleichen Gruppen wie das Konto, das die BizTalk-Dienste ausführt, z. B. die BizTalk-Anwendungsbenutzer und BizTalk Isolated Host Users-Gruppen.
Trinkgeld
Wenn Sie einen neuen Anwendungspool erstellen, achten Sie darauf, die .NET CLR-Standardversion und die verwaltete Pipeline beizubehalten. Denken Sie daran, eine Identität (erweiterte Einstellungen) auszuwählen, die über Mitgliedschaften zu den gleichen BizTalk-Gruppen verfügt wie Ihr BizTalk-Dienstkonto.
Erstellen der IIS-Verwaltungsanwendung
Der BizTalkServer Connector in Ihrem Logik-App-Workflow verwendet die URL für diese IIS-Anwendung, um eine Verbindung über das Datengateway auf Ihrem BizTalk Server herzustellen.
BizTalk Server 2020 und höher
Konfigurieren Sie die REST-APIs mithilfe des BizTalk-Konfigurations-Assistenten.
Weitere Informationen finden Sie im Konfigurationshandbuch.
Weitere Informationen zu den REST-APIs finden Sie in der BizTalk REST API Reference.
Wechseln Sie in einem Webbrowser zu
http://localhost/BizTalkManagementService/Schemas
.Basierend auf Ihrem Webbrowser wird entweder die Schemaliste angezeigt, oder Sie erhalten eine Aufforderung zum Öffnen und Speichern einer schemas.json Datei. Wenn keines der Fall ist, überprüfen Sie die REST-API-Konfiguration.
BizTalk Server 2016
Öffnen Sie den Internetinformationsdienste-Manager (IIS).
Wählen Sie im Kontextmenü Standardwebsite-Anwendung hinzufügenaus.
In dieser neuen Anwendung:
Geben Sie den Alias (Name) für Ihre Anwendung ein, z. B. IISLogicApp-.
Wählen Sie den Anwendungspool aus.
Legen Sie den physischen Pfad auf
C:\Program Files (x86)\Microsoft BizTalk Server 2016\LogicApp Adapter\Management
fest.Testen Sie die Einstellungen, um zu bestätigen, dass die Anwendungspoolidentität die -Authentifizierungs- und Autorisierungstests bestanden hat.
Wählen Sie OK aus, um Ihre Änderungen zu speichern.
Wechseln Sie in einem Webbrowser zu
http://localhost/YourApplicationAlias/schemas?api-version=2016-10-26
, z. B.:http://localhost/IISLogicApp/Schemas?api-version=2016-10-26
.Basierend auf Ihrem Webbrowser wird entweder die Schemaliste angezeigt, oder Sie erhalten eine Aufforderung zum Öffnen und Speichern einer schemas.json Datei. Wenn keines der Fall ist, fehlt ihre AppPool-Identität möglicherweise der Mitgliedschaft in den BizTalk-Gruppen.
Erstellen der IIS-Anwendung BizTalk ReceiveService
Der BizTalkServer Connector in Ihrem Logik-App-Workflow verwendet die URL für diese IIS-Anwendung für den von Ihnen angegebenen Empfangsspeicherort.
Öffnen Sie den Internetinformationsdienste-Manager (IIS).
Öffnen Sie das Kontextmenü der Standardwebsite, und wählen Sie Anwendung hinzufügenaus.
Führen Sie in dieser neuen Anwendung die folgenden Schritte aus:
Geben Sie den Alias (Name) für Ihre Anwendung ein, z. B. ReceiveWCFService-.
Wählen Sie den gleichen Anwendungspool wie die vorherige IIS-Anwendung aus.
Legen Sie basierend auf der Version 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
- BizTalk Server 2020:
Testen Sie die Einstellungen, um zu bestätigen, dass die Anwendungspoolidentität die -Authentifizierungs- und Autorisierungstests bestanden hat.
Wählen Sie OK aus, um Ihre Änderungen zu speichern.
Schritt 2: Erstellen eines Logik-App-Workflows
Erstellen Sie im Azure-Portaleine neue Logik-App-Ressource und einen leeren Workflow.
Basierend auf dem von Ihnen erstellten Workflow die folgenden generischen Schritte ausführen, um den Request Trigger namens Wenn eine HTTP-Anforderung zu Ihrem Workflow empfangen wird.
Führen Sie diese allgemeinen Schritte aus, um die BizTalkServer Aktion namens Nachricht aus JSON- dem Workflow vorzubereiten.
Geben Sie im Verbindungsbereich der Aktion die folgenden Informationen an:
Eigentum Beschreibung Verbinden über das lokale Datengateway Wählen Sie aus, ob Sie das lokale Datengateway verwenden. Das Gateway ist nur in den folgenden Szenarien erforderlich:
– Sie verwenden einen lokalen BizTalk Server.
– Sie verwenden einen BizTalk Server auf einem virtuellen Azure-Computer, der virtuelle Computer wird jedoch nicht als HTTP-Endpunkt verfügbar gemacht.Verbindungsname Geben Sie einen Anzeigenamen für die Verbindung ein. BizTalk Server-URL Geben Sie den vollqualifizierten Domänennamen (FQDN) der BizTalk-Verwaltung in der IIS-Anwendungs-URL ein. Geben Sie z. B. http://BizTalkServerName.corp.contoso.com/IISLogicApp/
ein.Authentifizierungstyp Wählen Sie Windowsaus. Benutzername Geben Sie die Identität des IIS-Anwendungspools ein. Kennwort Geben Sie das Kennwort des IIS-Anwendungspools ein. Gateway- - Abonnement-: Wählen Sie das Azure-Abonnement aus, das der Gatewayressource zugeordnet ist, die Sie im Azure-Portal erstellt haben.
- Gateway-: Wählen Sie die Gatewayressource aus, die Sie im Azure-Portal erstellt haben.Wählen Sie Neuenerstellen aus.
Geben Sie nach dem Anzeigen des Aktionsinformationsbereichs die erforderlichen Details ein, z. B.:
Eigentum Beschreibung Body- Wählen Sie die HTTP-Textkörperausgabe aus. Schema- Wählen Sie das Schema aus, das Sie verwenden möchten. Anmerkung
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 HelloWorld SDK-Beispiel bereit, aktualisieren Sie die Artefakte auf die Verwendung des Azure Logic Apps-Adapters, und verwenden Sie das Schema und die Beispielmeldung.
Führen Sie diese allgemeinen Schritte aus, um die BizTalkServer Aktion mit dem Namen Senden von Nachrichten ihrem Workflow hinzuzufügen.
Eigentum Beschreibung Empfangsstandort Wählen Sie in der Liste die URL aus, oder geben Sie den vollqualifizierten Domänennamen (FQDN) für die IIS-Anwendungs-URL des ReceiveService ein. Geben Sie z. B. http://BizTalkServerName.corp.contoso.com/ReceiveWCFService/Service1.svc
ein.
Wenn Sie den Empfangsspeicherort erstellen, geben Sie diese genaue URL auch auf der Registerkarte Allgemein als öffentliche Adresse in den Transporteigenschaften für den Empfangsort ein.Body- Wählen Sie die Textkörperausgabe aus der vorherigen BizTalk Server-Aktion aus. Speichern Sie Ihren Workflow. Wählen Sie auf der Designersymbolleiste Speichernaus.
Dieser Schritt erstellt automatisch eine Endpunkt-URL, die im Trigger Anforderung angezeigt wird. Sie können HTTP-Anforderungen an diese URL senden, die auslösen oder dazu führen, dass der Workflow ausgeführt wird.
Kopieren sie die Endpunkt-URL, und speichern Sie sie. Sie benötigen diese Informationen für Schritt 4: Senden einer Nachricht.
Schritt 3: Erstellen eines Empfangsports und eines Empfangsstandorts
In diesem Abschnitt wird beschrieben, wie Sie eigene Artefakte erstellen.
Trinkgeld
Anstatt eigene Empfangsports und Empfangsspeicherorte zu erstellen, können Sie das HelloWorld SDK-Beispiel bereitstellen und dann die Artefakte so aktualisieren, dass der Azure Logic Apps-Adapter verwendet wird.
Erweitern Sie in der BizTalk Server-Verwaltung Folgendes:
BizTalk Server Administration>BizTalk Group>Anwendungen
Erweitern Sie die Anwendung, die für die Ausführung des Empfangsspeicherorts verwendet werden soll. Erweitern Sie z. B. BizTalk-Anwendung – Empfangen.
Wählen Sie im Kontextmenü Empfangen von PortsNeueaus, und wählen Sie Unidirektionale Empfangsport-aus.
Geben Sie in den Eigenschaften Empfangen von Port die folgenden Informationen ein:
Eigentum Beschreibung Name Geben Sie einen Namen für den Empfangsport ein. Geben Sie z. B. LAReceivePortein. Authentifizierung
- Keine Authentifizierung (Standard): Authentifizierung deaktivieren.
- Nachrichten ablegen, wenn die Authentifizierungfehlschlägt: Authentifizierung aktivieren, aber nicht authentifizierte Nachrichten fallen.
- Nachrichten beibehalten, wenn die Authentifizierungfehlschlägt: Authentifizierung aktivieren und nicht authentifizierte Nachrichten beibehalten.Aktivieren des Routings für fehlgeschlagene Nachrichten Leiten Sie alle Nachrichten weiter, bei denen die Verarbeitung an eine abonnierende Anwendung fehlschlägt, z. B. einen anderen Empfangsport- oder Orchestrierungszeitplan. Deaktivieren Sie diese Option, um fehlgeschlagene Nachrichten anzusetzen und eine negative Bestätigung (NACK) zu generieren. Standardmäßig ist die Option deaktiviert.
Weitere Informationen finden Sie unter Aktivieren des Routings für fehlgeschlagene Nachrichten für einen Empfangsport.Wählen Sie Empfangsspeicherorteaus, und wählen Sie Neueaus.
Geben Sie einen Namen für den Empfangsspeicherort ein. Geben Sie z. B. LAReceiveLocein.
Wählen Sie für Typ-LogicApp-aus, und wählen Sie dann Konfigurierenaus.
Richten Sie auf der Registerkarte Allgemeine die Endpunktadresse für Ihren Logik-App-Workflow ein:
Eigentum Beschreibung Adresse (URI) Erforderlich. Geben Sie die IIS-Anwendungs-URL von BizTalk ReceiveService wie folgt ein:
Format:/{your-IIS-app2-name}/Service1.svc
Beispiel:/ReceiveWCFService/Service1.svc
.öffentliche Adresse Erforderlich. Geben Sie die folgende URL wie folgt ein:
Format:http://{fully-qualified-machine-name}/{your-IIS-App2-name}/Service1.svc
.
Beispiel:http://btsProd.northamerica.corp.contoso.com/ReceiveWCFService/Service1.svc
Diese genaue URL wird auch in Ihrer Logik-App am Empfangsspeicherort aufgeführt.Optional. Konfigurieren Sie auf der Registerkarte Bindung alle Timeout- und Codierungseigenschaften der zugrunde liegenden WCF-WebHttp Bindung. Die folgenden Eigenschaften sind beim Behandeln großer Nachrichten hilfreich:
Eigentum Beschreibung Timeout- Geben Sie das für den Kanalöffnungsvorgang erwartete Zeitintervall ein. Dieser Wert ist größer oder gleich System.TimeSpan.Zero.
- Standardwert: 00:01:00
- Maximalwert: 23:59:59Timeout- senden Geben Sie das für den Sendevorgang erwartete Zeitintervall ein. Dieser Wert ist größer oder gleich System.TimeSpan.Zero. Wenn Sie einen Anforderungsantwort-Empfangsport verwenden, gibt dieser Wert eine Zeitspanne für die gesamte Interaktion an, auch wenn der Client eine große Nachricht zurückgibt.
- Standardwert: 00:01:00
- Maximalwert: 23:59:59Timeout- schließen Geben Sie das für den Abschlussvorgang des Kanals erwartete Zeitintervall ein. Dieser Wert ist größer oder gleich System.TimeSpan.Zero.
- Standardwert: 00:01:00
- Maximalwert: 23:59:59Maximale Empfangene Nachrichtengröße (Bytes) Geben Sie die maximale Größe in Byte für eine Nachricht ein, einschließlich Kopfzeilen, die an der Leitung empfangen werden sollen. Die Nachrichtengröße ist an die Für jede Nachricht zugewiesene Arbeitsspeichermenge gebunden. Sie können diese Eigenschaft verwenden, um die Gefährdung von Denial-of-Service-Angriffen (DoS) zu begrenzen.
- Standardwert: 65536
- Maximalwert: 2147483647Maximale Anzahl gleichzeitiger Anrufe Geben Sie die Anzahl gleichzeitiger Aufrufe für eine einzelne Dienstinstanz ein. Anrufe, die den Grenzwert überschreiten, werden in die Warteschlange gestellt. Das Festlegen dieses Werts auf 0 entspricht dem Festlegen des Werts auf Int32.MaxValue.
Standardwert: 200Optional. Konfigurieren Sie auf der Registerkarte Sicherheit alle Sicherheitseigenschaften. Für Entwicklungszwecke können Sie Keineauswählen:
Eigentum Beschreibung Sicherheitsmodus - Keine: Nachrichten werden während der Übertragung nicht gesichert.
- Transport: Sicherheit wird mithilfe des HTTPS-Transports bereitgestellt. Die SOAP-Nachrichten werden mit HTTPS gesichert. Um diesen Modus zu verwenden, müssen Sie secure Sockets Layer (SSL) in IIS einrichten.
- TransportCredentialOnly: Standard.Transport-Clientanmeldeinformationstypen Wählen Sie den Anmeldeinformationstyp aus, wenn Sie die Clientauthentifizierung verwenden.
- Keine: Es erfolgt keine Authentifizierung auf Transportebene.
- Basic-: Verwenden Sie die Standardauthentifizierung, um Benutzernamen und Kennwörter im Nur-Text-Format über das Netzwerk zu senden. Sie müssen die Domäne oder lokale Benutzerkonten erstellen, die den Anmeldeinformationen entsprechen.
- Digest-: Verwenden Sie die Digestauthentifizierung, um Kennwörter als Hashwert über das Netzwerk zu senden. Nur für Domänen mit Domänencontrollern verfügbar, auf denen die Windows Server-Betriebssystemauthentifizierung ausgeführt wird. Sie müssen die Domäne oder lokale Benutzerkonten erstellen, die Clientanmeldeinformationen entsprechen.
- Ntlm (Standard): Clients senden die Anmeldeinformationen, ohne ein Kennwort an diesen Empfangsspeicherort zu senden. Sie müssen die Domäne oder lokale Benutzerkonten erstellen, die Clientanmeldeinformationen entsprechen.
- Windows: Die integrierte Windows-Authentifizierung verhandelt Kerberos oder NTLM und bevorzugt Kerberos, wenn eine Domäne vorhanden ist. Um Kerberos zu verwenden, ist es wichtig, dass der Client den Dienst mit einem Dienstprinzipalnamen (Service Principal Name, SPN) identifiziert. Sie müssen die Domäne oder lokale Benutzerkonten erstellen, die Clientanmeldeinformationen entsprechen.
- Zertifikat: Verwenden eines Clientzertifikats. Sie müssen die Zertifizierungsstellenzertifikatkette für die X.509-Clientzertifikate im Zertifikatspeicher der vertrauenswürdigen Stammzertifizierungsstellen dieses Computers installieren, damit sich die Clients für diesen Empfangsspeicher authentifizieren können.
- InheritedFromHost-Einmaliges Anmelden verwenden Optional. Verwenden Sie auf der Registerkarte Nachrichten die Ausgehenden HTTP-Header Eigenschaft, um benutzerdefinierte Header hinzuzufügen, und verwenden Sie die zusätzlichen Eigenschaften, um Fehler zu unterstützen:
Eigentum Beschreibung ausgehende HTTP-Header Geben Sie alle HTTP-Header ein, die in der Antwortnachricht gestempelt werden sollen. Speicherort beim Fehler deaktivieren Deaktivieren Sie den Empfangsspeicherort, wenn die eingehende Verarbeitung aufgrund eines Empfangspipelinefehlers oder eines Routingfehlers fehlschlägt. Standardmäßig ist die Option deaktiviert. Meldung "Anforderung anhalten" bei Halten Sie die Anforderungsnachricht an, wenn die eingehende Verarbeitung aufgrund eines Empfangspipelinefehlers oder eines Routingfehlers fehlschlägt. Standardmäßig ist die Option deaktiviert. Ausnahmedetails in Fehler einschließen Wenn ein Fehler auftritt, geben Sie SOAP-Fehler zurück, um das Debuggen zu unterstützen. Standardmäßig ist die Option deaktiviert.
Weitere Empfangsport- und Standorteigenschaften finden Sie unter Verwalten von Empfangsspeicherorten.
Schritt 4: Senden einer Nachricht
Öffnen Sie Ihr Tool zum Senden von HTTP-Nachrichten oder Anforderungen.
Fügen Sie die Endpunkt-URL ein, die Sie aus dem Request Trigger in Ihrem Logik-App-Workflow gespeichert haben. Sie haben diese URL in einen früheren Schritt kopiert.
Wählen Sie POST- als zu verwendende HTTP-Methode aus. Legen Sie den Inhaltstyp Kopfzeile auf
application/json
fest. Fügen Sie im Anforderungstext den folgenden JSON-Code ein, und folgen Sie den Anweisungen des Tools, um die HTTP-Nachricht zu senden.{"hello":"world"}
Da die Anforderung ein unidirektionales Aufrufen von BizTalk ist, sollten Sie als Ergebnis ein HTTP 202 erwarten.
Wenn Sie das HelloWorld SDK-Beispiel verwenden, wechseln Sie zu Ihrem BizTalk-Server. Möglicherweise ist eine Datei in Ihrem Sendeordner vorhanden.
Senden einer Nachricht an den Logik-App-Workflow
Schritt 1: Erstellen eines Logik-App-Workflows
Erstellen Sie im Azure-Portaleine neue Logik-App-Ressource und einen leeren Workflow.
Führen Sie diese allgemeinen Schritte aus, um den Request Trigger namens Wenn eine HTTP-Anforderung zu Ihrem Workflow empfangen wird.
Wenn Sie über ein Microsoft-Geschäfts-, Schul- oder Unikonto verfügen, die folgenden allgemeinen Schritte ausführen, um die Office 365 Outlook Aktion namens Senden einer E-Mail- an Ihren Workflow hinzuzufügen.
Wenn Sie dazu aufgefordert werden, melden Sie sich bei Office 365 Outlook an.
Geben Sie im Verbindungsbereich der Aktion die folgenden Informationen an:
Eigentum Beschreibung An Geben Sie Ihre Office 365-E-Mail-Adresse ein. Betreff- Geben Sie Senden von BizTalkein. Body- Wählen Sie im Bearbeitungsfeld aus. Wenn die Blitz- und Funktionssymbole angezeigt werden, wählen Sie das Blitzsymbol aus, um die dynamische Inhaltsliste zu öffnen. Wählen Sie in der Liste unter Wenn eine HTTP-Anforderungempfangen wird, die Triggerausgabe aus, die Sie in die E-Mail aufnehmen möchten. Ihr Workflow sieht ähnlich wie im folgenden Beispiel aus:
Speichern Sie Ihren Workflow. Wählen Sie im Designer Speichernaus.
Kopieren Sie im Anforderungsauslöser Informationen die HTTP-URL, die beim Speichern des Workflows automatisch erstellt wird. Sie benötigen diese URL für den nächsten Schritt. Wenn die URL nicht angezeigt wird, müssen Sie die Logik-App möglicherweise schließen und erneut öffnen.
Schritt 2: Erstellen eines Sendeports
Damit BizTalk Server Nachrichten an einen Logik-App-Workflow sendet, muss der Workflow mit einem manual
Trigger beginnen, z. B. Wenn eine HTTP-Anforderung empfangenwird.
Erweitern Sie in der BizTalk Server-Verwaltung Folgendes:
BizTalk Server Administration>BizTalk Group>Anwendungen
Erweitern Sie die Anwendung, die zum Ausführen des Sendeports verwendet werden soll. Erweitern Sie beispielsweise BizTalk Application - Send.
Wählen Sie im Kontextmenü "Ports senden""Neue" aus, und wählen Sie statischen Unidirektionale Sendeport-aus.
Geben Sie einen Namen für den Sendeport ein. Geben Sie beispielsweise LASendPort-ein.
Wählen Sie in der Liste Typ-LogicAppaus, und wählen Sie Konfigurierenaus.
Geben Sie auf der Registerkarte Allgemeine den Rückruf-URI für den Workflow für die Logik-App an, indem Sie eine Option auswählen:
Option 1
Fügen Sie in der eigenschaft Trigger (Callback URI) die zuvor kopierte HTTP-URLein.
Trinkgeld
Sie können auch Ihre Azure Resource Manager-APIs verwenden, um diesen URI abzurufen.
Option 2
Wenn Sie den Rückruf-URI-nicht kennen, wählen Sie Konfigurierenaus, und melden Sie sich bei Azure an. Wählen Sie die Werte für Subscription, Resource Group, Logic Appund Triggeraus.
Optional. Konfigurieren Sie auf der Registerkarte Bindung alle Timeout- und Codierungseigenschaften der zugrunde liegenden WCF-WebHttp Bindung. Diese Eigenschaften sind beim Behandeln großer Nachrichten hilfreich:
Eigentum Beschreibung Timeout- Geben Sie das für den Kanalöffnungsvorgang erwartete Zeitintervall ein. Dieser Wert ist größer oder gleich System.TimeSpan.Zero.
- Standardwert: 00:01:00
- Maximalwert: 23:59:59Timeout- senden Geben Sie das für den Sendevorgang erwartete Zeitintervall ein. Dieser Wert ist größer oder gleich System.TimeSpan.Zero. Wenn Sie einen Anforderungsantwort-Empfangsport verwenden, gibt dieser Wert eine Zeitspanne für die gesamte Interaktion an, auch wenn der Client eine große Nachricht zurückgibt.
- Standardwert: 00:01:00
- Maximalwert: 23:59:59Timeout- schließen Geben Sie das für den Abschlussvorgang des Kanals erwartete Zeitintervall ein. Dieser Wert ist größer oder gleich System.TimeSpan.Zero.
- Standardwert: 00:01:00
- Maximalwert: 23:59:59Maximale Empfangene Nachrichtengröße (Bytes) Geben Sie die maximale Größe in Byte für eine Nachricht ein, einschließlich Kopfzeilen, die an der Leitung empfangen werden sollen. Die Nachrichtengröße ist an die Für jede Nachricht zugewiesene Arbeitsspeichermenge gebunden. Sie können diese Eigenschaft verwenden, um die Gefährdung von Denial-of-Service-Angriffen (DoS) zu begrenzen.
Der Azure Logic Apps-Adapter verwendet die WebHttpBinding-Klasse im Pufferübertragungsmodus, um mit einem Endpunkt zu kommunizieren. Für den gepufferten Transportmodus ist die WebHttpBinding.MaxBufferSize Eigenschaft immer gleich dem Wert dieser Eigenschaft.
- Standardwert: 65536
- Maximalwert: 2147483647Optional. Verwenden Sie auf der Registerkarte Nachrichten die ausgehenden HTTP-Header Eigenschaft, um benutzerdefinierte Kopfzeilen für die ausgehende Nachricht hinzuzufügen.
Wählen Sie OK aus, um Ihre Konfiguration zu speichern.
Weitere Sendeporteigenschaften finden Sie unter Managing Send Ports and Send Port Groups.
Schritt 3: Senden einiger Nachrichten
Sie können einen Empfangsport und einen Empfangsspeicherort erstellen, indem Sie den Datei--Adapter verwenden. Stellen Sie sicher, dass Ihre Logik-App-Ressource aktiviert ist.
Erstellen Sie einen Empfangsport, z. B. *FileSendPort.
Erstellen Sie einen Empfangsspeicherort, und legen Sie die Eigenschaften fest, die den folgenden Beispielwerten ähneln:
Eigentum Beispieleingabe Empfangen von Ordnern C:\temp\In\
*.txt
Pipeline- PassThruReceive
Legen Sie im zuvor erstellten Sendeport den Filter auf die folgenden Beispielwerte fest:
Eigentum Operator Wert BTS. ReceivePortName- == FileSendPort
Erstellen Sie eine Textdatei mit dem Namen {file-name}-.txt mit folgendem Text, und führen Sie dann diese Textdatei als Beispielnachricht aus:
<Data> <DataID>DataID_0</DataID> <DataDetails>DataDetails_0</DataDetails> </Data>
Kopieren Sie {file-name}-.txt in den Empfangsordner.
Der Sendeport sendet die .txt Datei mithilfe des von Ihnen bereitgestellten URI an den Logik-App-Workflow. Nachdem Ihr Workflow die Dateien empfangen hat, sendet der Workflow eine E-Mail mit der Beispielnachricht an die angegebene An Adresse.