Freigeben über

Schritt 2: Konfigurieren eines bidirektionalen WCF-WebHttp Sendepunkts

In diesem Schritt konfigurieren Sie einen bidirektionalen WCF-WebHttp-Sendeport, um die REST-Ressourcen-URL aufzurufen und Verzögerungen in den Zeitplänen der US-Luftfahrtunternehmen abzurufen.

So konfigurieren Sie WCF-WebHttp Sendeport

  1. Klicken Sie in der BizTalk Server-Verwaltungskonsole unter dem Knoten BizTalk Application 1 mit der rechten Maustaste auf Sendports, wählen Sie Neu und klicken Sie dann auf Statische Solicit-Response-Sendeport.

  2. Auf der Registerkarte Allgemein führen Sie die folgenden Schritt aus:

    Verwenden Sie diese Aktion
    Name Geben Sie SendPortRESTAzureMarketPlace ein.
    Typ Wählen Sie WCF-WebHttp aus.
    Sendungsverwalter Wählen Sie BizTalkServerApplication aus.
    Pipeline senden Wählen Sie "PassThruTransmit" aus.
    Empfangspipeline Wählen Sie PassThruReceive aus.

    Klicken Sie auf Konfigurieren.

  3. Gehen Sie im Dialogfeld WCF-WebHttp Transporteigenschaften wie folgt vor:

    1. Auf der Registerkarte "Allgemein", geben Sie unter Adresse (URI)https://api.datamarket.azure.com/oakleaf/US_Air_Carrier_Flight_Delays_Incr/ ein.

    2. Geben Sie auf der Registerkarte "Allgemein" für die HTTP-Methode und die URL-Zuordnung Folgendes ein:

      <BtsHttpUrlMapping>
<Operation Method="GET" Url="/On_Time_Performance" />
</BtsHttpUrlMapping>

      Hier ist GET das HTTP-Verb, und On_Time_Performance wird an den Basis-URI angefügt, um eine eindeutige Ressourcen-URL zum Abrufen von Flugverzögerungen zu erstellen.

      Von Bedeutung

      Innerhalb des URL-Felds müssen Sie alle speziellen XML-Zeichen maskieren, um sicherzustellen, dass der Port die Sonderzeichen verarbeitet und erhält. Sie müssen beispielsweise das Sonderzeichen & als &amp; escapen.

      Für den folgenden Text: Url="/Customer?{ID}&group={Location}"

      Verwenden Sie stattdessen die folgende Version: Url="/Customer?{ID}&amp;group={Location}"

      Wenn der REST-Dienst auch erfordert, dass Sie das Sonderzeichen innerhalb der URL, die zur Laufzeit verwendet wird, maskieren müssen, müssen Sie möglicherweise doppeltes Maskieren verwenden.

      Für den folgenden Text: Url="/Customer?{ID}&amp;group={Location}"

      Verwenden Sie stattdessen die folgende Version: Url="/Customer?{ID}&amp;amp;group={Location}"

    3. Wählen Sie auf der Registerkarte "Bindungen " für das Feld " Maximale Größe der empfangenen Nachricht " einen ausreichend großen Wert aus. Der Grund dafür ist, dass die Antwortnachricht, die den Flight-Status enthält, in der Regel erheblich groß ist und die angegebene Standardnachrichtengröße überschreitet.

    4. Führen Sie auf der Registerkarte Sicherheit die folgenden Schritte aus:

      1. Wählen Sie für den Sicherheitsmodus " Transport" aus.

      2. Wählen Sie für den Transport-Clientanmeldeinformationstyp"Einfach" aus.

      3. Wählen Sie im Feld "Benutzernamenanmeldeinformationen" die Option "Bearbeiten" aus.

      4. Wählen Sie im Feld Clientanmeldeinformationen die Option Nicht verwenden Single-Sign Aus aus.

      5. Geben Sie den Benutzernamen und das Kennwort ein, den Sie auf der Registerkarte "Mein Konto " abgerufen haben, nachdem Sie sich bei Microsoft Azure Marketplace angemeldet haben.

        Die Anmeldeinformationen werden anhand der Bezeichnungen "Kunden-ID (Benutzername)" und " Primärer Kontoschlüssel (Kennwort)" aufgelistet.

      6. Wählen Sie OK aus.

    5. Auf der Registerkarte Nachrichten wählen Sie Textkörper für Verben ausblenden und geben das Verb an, dessen Nachrichtennutzlast Sie aus der Anforderungsnachricht entfernen möchten. Geben Sie für dieses Tutorial GET an. Dies ist der Grund: Ein GET-Methodenaufruf für den REST-Endpunkt der US-Luftfahrtfluggesellschaft erfordert keine Nachrichtennutzlast; die REST-Ressourcen-URL reicht aus, um die Informationen abzurufen. Um jedoch den WCF-WebHttp-Sendeport auszulösen, der den REST-Aufruf vorgibt, legen Sie eine Dummynachricht ab, die einen Nachrichtentext enthält. Der Sendeport darf diese Dummynachricht nicht an den REST-Endpunkt senden, da der Endpunkt, wie bereits erläutert, keine Nachrichtennutzlast erwartet. Bevor der REST-Endpunkt aufgerufen wird, entfernt der Adapter den Nachrichteninhalt aus der Dummy-Nachricht nur für die Verben, die Sie im Textfeld "Nachrichtentext für Verben unterdrücken" angeben.

    6. Klicken Sie auf 'OK ', bis Sie wieder im Dialogfeld 'Porteigenschaften senden' sind. Klicken Sie im linken Bereich auf Filter und geben Sie den Filter an, um alle Nachrichten zu verarbeiten, die über den Empfangsport eingehen, den Sie in Schritt 1: Konfigurieren eines DATEI-Empfangsspeicherorts erstellt haben.

      Parameter Wert
      Eigentum Festgelegt auf BTS.ReceivePortName
      Operator Auf == festlegen
      Wert Auf ReceivePortRestAzureMarketPlace festlegen

    7. Klicke auf OK.

Siehe auch

Lernprogramm 5: Aufrufen einer REST-Schnittstelle mit BizTalk Server