SB-Messaging-Adapter

Der Service Bus (SB-Messaging) wird zum Empfangen und Senden von Service Bus Entitäten wie Warteschlangen, Themen und Relays verwendet. Sie können den SB-Messaging-Adapter verwenden, um Ihre lokale Umgebung mit BizTalk Server Azure zu verbinden.

Ab BizTalk Server 2016 Feature Pack 2, Service Bus Premium wird unterstützt. Wenn Sie einen Sendeport mit diesem Adapter konfigurieren, können Sie Nachrichten an partitionierte Warteschlangen und Themen senden.

Authentifizieren mit Service Bus

Service Bus bietet zwei Methoden für die Authentifizierung:

  • Zugriffssteuerungsdienst (ACS)
  • Shared Access Signature (SAS)

Es wird empfohlen, Shared Access Signature (SAS) für die Authentifizierung mit Service Bus. Der Wert für den Gemeinsam genutzten Zugriffsschlüssel wird im Azure-Portal.

Wenn Sie einen Service Bus erstellen, wird der Access Control(ACS)-Namespace nicht automatisch erstellt. Um die Access Control verwenden zu können, benötigen Sie die Werte für Ausstellername und Ausstellerschlüssel dieses Namespace. Diese Werte sind verfügbar, wenn Sie einen neuen ACS-Namespace mithilfe Windows PowerShell. Diese Werte werden nicht im Azure-Portal.

Um ACS für die Authentifizierung zu verwenden und die Werte für Ausstellernamen und Ausstellerschlüssel abzurufen, müssen folgende Schritte ausgeführt werden:

  1. Installieren Sie die Azure PowerShell-Cmdlets.

  2. Fügen Sie Ihr Azure-Konto hinzu: Add-AzureAccount

  3. Geben Sie den Abonnementnamen an zurück: get-azuresubscription

  4. Wählen Sie Ihr Abonnement aus: select-azuresubscription <name of your subscription>

  5. Erstellen Sie einen neuen Namespace: new-azuresbnamespace <name for the service bus> "Location" -CreateACSNamespace $true -NamespaceType Messaging

    Beispiel: new-azuresbnamespace biztalksbnamespace "South Central US" -CreateACSNamespace $true -NamespaceType Messaging

  6. Wenn der neue ACS-Namespace erstellt wird (was einige Minuten dauern kann), werden die Werte IssuerName und IssuerKey in der Verbindungszeichenfolge aufgeführt:

    Name                  : biztalksbnamespace
    Region                : South Central US
    DefaultKey            : abcdefghijklmnopqrstuvwxyz
    Status                : Active
    CreatedAt             : 10/18/2016 9:36:30 PM
    AcsManagementEndpoint : https://biztalksbnamespace-sb.accesscontrol.windows.net/
    ServiceBusEndpoint    : https://biztalksbnamespace.servicebus.windows.net/
    ConnectionString      : Endpoint=sb://biztalksbnamespace.servicebus.windows.net/;SharedSecretIssuer=owner;SharedSecretValue=abcdefghijklmnopqrstuvwxyz
    NamespaceType         : Messaging
    

Eine Anleitung finden Sie unter New-AzureSBNamespace.

Empfangen von Nachrichten von Service Bus

  1. Erweitern Sie BizTalk Server-Verwaltungskonsole BizTalk-Gruppe, Anwendungen und dann Ihre Anwendung.

  2. Klicken Sie mit der rechten Maustaste auf Empfangsports, wählen Sie Neu aus, und wählen Sie Den Empfangsport in einer richtungsbasierten Richtung aus.

  3. Geben Sie ihm einen Namen, und wählen Sie Empfangsstandorte aus.

  4. Wählen Sie Neu aus, und geben Sie ihm den Namen. Wählen Sie im Abschnitt Transport in der Dropdownliste Typ die Option SB-Messaging und dann Konfigurieren aus.

  5. Konfigurieren Sie die Allgemeinen Eigenschaften:

    Option Aufgabe
    Warteschlangen- oder Abonnement-URL Geben Sie die URL an, an der die Service Bus-Warteschlange bereitgestellt wird. Die URL weist normalerweise das folgende Format auf:

    sb://<namespace>.servicebus.windows.net/<queue_name>
    Timeout des Öffnungsvorgangs Gibt einen Wert für einen Zeitraum an, der bis zum vollständigen Öffnen eines Kanals zur Verfügung steht.

    Standardwert: 1 Minute
    Timeout des Schließvorgangs Gibt einen Wert für einen Zeitraum an, der bis zum vollständigen Schließen eines Kanals zur Verfügung steht.

    Standardwert: 1 Minute
    Empfangszeitüberschreitung Gibt einen Wert für einen Zeitraum an, der bis zum Abschluss eines Empfangsvorgangs zur Verfügung steht.

    Standardwert: 10 Minuten
    Anzahl der Vorabrufe Gibt die Anzahl der Nachrichten an, die gleichzeitig von der Service Bus-Warteschlange oder einem -Thema empfangen werden. Vorabrufe ermöglichen es dem Warteschlangen- oder Abonnementclient, weitere Nachrichten aus dem Dienst zu laden, wenn er einen Empfangsvorgang ausführt. Der Client speichert diese Nachrichten in einem lokalen Cache. Die Größe des Caches wird durch den Wert der hier angegebenen Eigenschaft Vorabrufwert bestimmt.

    Weitere Informationen finden Sie im Abschnitt "Vorabrufen" unter . https://azure.microsoft.com/documentation/articles/service-bus-performance-improvements/

    Standardwert: -1
    Sitzung verwenden Aktivieren Sie dieses Kontrollkästchen, um eine Service Bus-Sitzung zum Empfangen von Nachrichten aus einer Warteschlange oder einem Abonnement zu verwenden.
  6. Konfigurieren Sie die Authentifizierungseigenschaften:

    Option Aufgabe
    Zugriffssteuerungsdienst (ACS) Wählen Sie diese Option, um ACS für die Authentifizierung zu verwenden, und geben Sie die folgenden Werte an:

    – Geben Sie den Service Bus Access Control Service STS-URI ein. Der URI weist normalerweise das folgende Format auf:

    https://<namespace>-sb.accesscontrol.windows.net/

    – Geben Sie den Ausstellernamen für den Service Bus ein.

    – Geben Sie den Ausstellerschlüssel für den Service Bus ein.
    Shared Access Signature (neu ab BizTalk Server 2013 R2 ) Wählen Sie diese Option, um SAS (Shared Access Signature) für die Authentifizierung zu verwenden, und geben Sie den SAS-Schlüsselnamen und -Schlüsselwert an.
  7. Geben Sie auf der Registerkarte Eigenschaften im Namespace für Brokernachrichteneigenschaften den Namespace ein, den der Adapter zum Schreiben der Brokernachrichteneigenschaften als Nachrichtenkontexteigenschaften für die von empfangene Nachricht BizTalk Server verwendet. Wenn Sie die Brokernachrichteneigenschaften promoten möchten, aktivieren Sie das Kontrollkästchen Brokernachrichteneigenschaften promoten.

  8. Klicken Sie auf OK.

  9. Wählen Sie Ihren Receive-Handler und die Empfangspipeline aus. Klicken Sie zum Speichern der Änderungen auf OK . Informationen zum Erstellen eines Empfangsspeicherorts finden Sie hier.

Senden von Nachrichten an Service Bus

  1. Klicken Sie in BizTalk Server-Verwaltungskonsole mit der rechten Maustaste auf Sendeports, wählen Sie Neu aus, und wählen Sie statischer, ein-wege-Sendeport aus.

    Informationen zum Erstellen eines Sendeports finden Sie hier.

  2. Geben Sie einen Namen ein. Legen Sie unter Transport den Typ auf SB-Messaging fest, und wählen Sie Konfigurieren aus.

  3. Konfigurieren Sie die Allgemeinen Eigenschaften:

    Option Aufgabe
    Ziel-URL Geben Sie die URL ein, unter der Service Bus Warteschlange bereitgestellt wird. Die URL weist normalerweise das folgende Format auf:

    sb://<namespace>.servicebus.windows.net/<queue_name>
    Batchleerungsintervall Gibt einen Wert für ein Zeitintervall an, in dem die an eine Warteschlange oder ein Thema gesendeten Nachrichtenbatches geleert werden. Der Standardwert sind 20 Millisekunden.

    Weitere Informationen zur Batchverarbeitung in Bezug auf Service Bus-Warteschlangen und -Themen finden Sie im Abschnitt Clientseitige Batchverarbeitung unter https://azure.microsoft.com/documentation/articles/service-bus-performance-improvements .
    Timeout des Öffnungsvorgangs Gibt einen Wert für einen Zeitraum an, der bis zum vollständigen Öffnen eines Kanals zur Verfügung steht.

    Standardwert: 1 Minute
    Sendetimeout Gibt einen Wert für einen Zeitraum an, der bis zum Abschluss eines Sendevorgangs zur Verfügung steht.

    Standardwert: 1 Minute
    Timeout des Schließvorgangs Gibt einen Wert für einen Zeitraum an, der bis zum vollständigen Schließen eines Kanals zur Verfügung steht.

    Standardwert: 1 Minute
  4. Konfigurieren Sie die Authentifizierungseigenschaften:

    Option Aufgabe
    Zugriffssteuerungsdienst (ACS) Wählen Sie diese Option, um ACS für die Authentifizierung zu verwenden, und geben Sie die folgenden Werte an:

    – Geben Sie den Service Bus Access Control Service STS-URI ein. Der URI weist normalerweise das folgende Format auf:

    https://<namespace>-sb.accesscontrol.windows.net/

    – Geben Sie den Ausstellernamen für den Service Bus ein.

    – Geben Sie den Ausstellerschlüssel für den Service Bus ein.
    Shared Access Signature (neu ab BizTalk Server 2013 R2 ) Wählen Sie diese Option, um SAS (Shared Access Signature) für die Authentifizierung zu verwenden, und geben Sie den SAS-Schlüsselnamen und -Schlüsselwert an.
  5. Geben Sie auf der Registerkarte Eigenschaften den Namespace für die benutzerdefinierten Brokernachrichteneigenschaften ein, der die Kontexteigenschaften von BizTalk-Nachrichten enthält, die Sie in die ausgehende Nachricht schreiben möchten, um Service Bus. Alle Namespaceeigenschaften werden als benutzerdefinierte Brokernachrichteneigenschaften in die Nachricht geschrieben. Der Adapter ignoriert den Namespace, während er die Eigenschaften als Brokernachrichteneigenschaften schreibt. Er verwendet den Namespace nur, um zu ermitteln, welche Eigenschaften geschrieben werden sollen.

    Sie können auch die Werte für die BrokeredMessage-Eigenschaften eingeben. Diese Eigenschaften werden unter BrokeredMessage-Eigenschaften beschrieben,einschließlich des Partitionsschlüssels.

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

Siehe auch

Verwenden von Adaptern