Erstellen von TIBCO Rendezvous Receive-Artefakten
Das Erstellen von Benachrichtigungen oder Ereignissen ähnelt dem Erstellen anderer Aufrufe in BizTalk Server. In diesem Abschnitt wird erläutert, wie ein Empfangsspeicherort zur Überwachung auf TIBCO Rendezvous-Nachrichten erstellt wird.
Ereignisse und Empfangsspeicherorte
Ein TIBCO Rendezvous-System kann Nachrichten an den ausgewählten Betreffnamen senden. Das Konzept des Ereignisses ist die Generierung von Nachrichten durch andere TIBCO Rendezvous-Programme.
In den nachstehenden Schritten wird der Lebenszyklus eines Empfangsspeicherorts beschrieben:
Der Empfangsspeicherort wird erstellt.
Der Empfangsspeicherort wird einem Host zugeordnet.
Der Empfangsspeicherort wird an eine Orchestrierung gebunden.
Der Empfangsspeicherort wird aktiviert.
Der Empfangsspeicherort empfängt Nachrichten
Wichtig
Jeder Empfangsspeicherort muss einen eindeutigen Namen aufweisen. Zwei Empfangsspeicherorte können in derselben BizTalk Server Bereitstellung nicht denselben Namen haben.
Wichtig
In den Ablageverzeichnissen der Empfangsspeicherorte sollten Sie starke Zugriffssteuerungslisten (Access Control Lists, ACLs) einrichten. So müssen Sie zum Beispiel für das Verzeichnis, aus dem der Dateiempfangsspeicherort Nachrichten entnimmt, starke ACLs verwenden, damit dort nur autorisierte Benutzer Nachrichten ablegen können.
Erstellen eines Empfangsports
Erweitern Sie in BizTalk Server Verwaltungdie Optionen BizTalk-Gruppe, Anwendungen, und erweitern Sie dann Ihre Anwendung.
Klicken Sie mit der rechten Maustaste auf Empfangsports, zeigen Sie auf Neu, und klicken Sie dann auf Unidirektionale Empfangsports.
Gehen Sie im Fenster Eigenschaften des Empfangsports auf der Seite Allgemein wie folgt vor:
Geben Sie im Feld Name den Namen ein
ReceiveFromTIBCORV.Geben Sie im Feld Authentifizierungsgruppe an, wie Nachrichten bei Verwendung der Authentifizierung behandelt werden.
Aktivieren Sie das Kontrollkästchen Routing für fehlerhafte Nachrichten aktivieren .
Gehen Sie auf der Seite Empfangsspeicherorte wie folgt vor:
Klicken Sie auf Neu.
Geben Sie im Fenster Empfangsspeicherorte auf der Seite Allgemein den Namen des Empfangsspeicherorts ein.
Wählen Sie in der Dropdownliste Typ den BizTalkServerIsolatedHost aus, und wählen Sie in der Dropdownliste Empfangshandler die Transportadresse aus.
Wählen Sie in der Dropdownliste Empfangspipelinedie Option XMLReceive oder eine entsprechende Pipeline aus.
Wählen Sie auf der Seite Zeitplan das Startdatum und das Enddatum aus, um den Empfang von Dokumenten einzuschränken.
Aktivieren Sie das Kontrollkästchen Dienstfenster aktivieren .
Klicken Sie auf OK.
Wählen Sie auf der Seite Eingehende Karten die eingehenden Zuordnungen zum Transformieren von Dokumenten am ausgewählten Port aus.
Wählen Sie auf der Seite Nachverfolgung die gewünschten Nachverfolgungsnachrichtentexte und Überwachungsnachrichteneigenschaften aus.
Klicken Sie auf OK.
Festlegen der Transporteigenschaften
Wenn Sie den Microsoft BizTalk-Adapter für TIBCO Rendezvous zur Überwachung von Nachrichten konfigurieren, geben Sie die zu überwachenden Betreffnamen an. Dies ist die einzige erforderliche Eigenschaft.
Erweitern Sie im Dialogfeld TIBCO Rendezvous-Transporteigenschaften die Option Adapter Erforderliche Eigenschaften, und geben Sie den Namen des Rendezvous-Antragstellers ein.
Dies ist der Betreffname (Rendezvous-Platzhalterzeichen sind zulässig), den der Adapter überwacht. Im einfachsten Bereitstellungsszenario ist dies die einzige erforderliche Eigenschaft.
Geben Sie in den Einstellungen für zertifizierte Listener den wiederverwendbaren Namen und den Ledgerdateinamen an, wenn Sie zertifiziertes Messaging wünschen.
Dies ist obligatorisch, wenn Sie eine verteilte Warteschlange definieren. Wenn kein zertifiziertes Messaging erforderlich ist, lassen Sie diese Einträge leer. Der Hauptdateiname und der wiederverwendbare Name müssen über alle auf diesem Host definierten Ports und weitere auf diesem Host ausgeführte TIBCO Rendezvous-Programme hinweg eindeutig sein. Wenn dies nicht der Fall ist, wird dies von der Benutzeroberfläche nicht erkannt. Zur Laufzeit wird jedoch ein Fehler aufgefangen und protokolliert.
Ändern Sie in den Einstellungen für verteilte Warteschlangen die Einträge nicht, wenn die verteilte Warteschlange nicht erforderlich ist.
Die folgenden Werte werden mit einer BizTalk Server-Gruppe verwendet. Der BizTalk-Adapter für TIBCO Rendezvous verwendet diese Werte in API-Aufrufe an TIBCO RV.
Option Aufgabe Ledgerdateiname Hauptdateiname für den zertifizierten Listener (oder das Gruppenmitglied). Der Standardwert ist Null.
Wenn kein Wert angegeben ist, wird eine Speicherhauptdatei verwendet.Wiederverwendbarer Name Wiederverwendbarer Name für den zertifizierten Listener (oder das Gruppenmitglied). Der Standardwert ist Null.
Ein wiederverwendbarer Name ist erforderlich, damit er beim Neustart eines Prozesses bestehen bleibt. Wenn kein Wert angegeben ist, wird ein generierter (nicht wiederverwendbarer) Name verwendet.Verteilte Warteschlangen sind nützlich, wenn Sie einen TIBCO Rendezvous-Empfangsspeicherort in einer BizTalk Server-Gruppe bereitstellen. Geben Sie in diesem Fall die gewünschten Werte für die Intervalle und Richtlinien ein. Aktivierungsintervalle und Taktintervalle werden für TIBCO Rendezvous unverändert bereitgestellt. Da beide Intervalle für alle Teilnehmer einer verteilten Warteschlange identisch sein müssen, werden die Werte nur einmal eingegeben. Die Richtlinienwerte können dagegen auf allen Hosts unterschiedlich sein. Geben Sie Richtlinienwerte als durch Semikolons getrennte Liste aus durch Doppelpunkt getrennte Host:Wert-Paare ein. Die Syntax ist immer gleich.
Beispiel: host1:10; host2:20; host3:30
Bei dem Hostnamen muss es sich um einen gültigen DNS-Hostnamen oder eine IP-Adresse handeln. Bei allen diesen Richtlinien sucht der Adapter den dem jeweiligen Host zugeordneten Wert und verwendet diesen für die TIBCO Rendezvous-API.
Wenn Werte auf allen Computern identisch sein sollen, können Sie auf dem Tibr einen einfachen Wert anstelle der Liste der Name:Wert-Paare (z. B. 20) verwenden.
Option Aufgabe Aktivierungsintervall Für diese verteilte Warteschlange verwendete Planergewichtungsrichtlinie. Hierbei handelt es sich um das Zeitintervall ohne Taktnachricht vom Planer, nach dem TIBCO RV einen neuen Planer aktiviert. Der Standardwert ist 20 Sekunden. Taktintervall Das innerhalb dieser verteilten Warteschlange verwendete Taktintervall. Es wird zusammen mit dem BizTalk Server-Gruppe-Parameter verwendet. Der BizTalk-Adapter für TIBCO Rendezvous verwendet diese Werte in API-Aufrufe an TIBCO RV. Der Wert wird von der Instanz des Adapters verwendet, bei dem es sich um den aktiven Planer für die Gruppe handelt und der in diesem Intervall (in Sekunden) Taktnachrichten sendet. Der Standardwert ist 10. Planergewichtungsrichtlinie Standardmäßig (Nullwert) können alle Mitglieder einer Gruppe mit gleicher Wahrscheinlichkeit zum Planer werden. Für eine andere Gewichtungsrichtlinie geben Sie eine Liste von Paaren aus Host und Gewichtung ein. Der Standardwert ist Null. Arbeitskapazitätsrichtlinie Die für diese verteilte Warteschlange verwendete Arbeitskapazitätsrichtlinie. Der Wert gibt an, wie viele Tasks ein Gruppenmitglied gleichzeitig verarbeiten kann. Wenn nicht angegeben, ist der Standardwert 1. Eine Liste der Werte von Host-Kapazität-Paaren enthält unterschiedliche Kapazitätsrichtlinien. Arbeitsgewichtungsrichtlinie Die für diese verteilte Warteschlange verwendete Arbeitsgewichtungsrichtlinie. Der Wert stellt einen Gewichtungswert dar, was TIBCO bei der Zuweisung von Tasks in einer verteilten Warteschlange unterstützt. Ein Task wird dem verfügbaren Arbeitsprozess mit der höchsten Gewichtung zugewiesen. Der Standardwert ist 1. Erweitern Sie Allgemeine Einstellungen , und geben Sie alle erforderlichen Informationen für die Verbindung mit dem TIBCO Rendezvous-Server ein.
Option Aufgabe Anhangplatzhalterersatz Geben Sie einen Platzhaltertextersatz an. Die Betreffnamen, die ein Empfangsspeicherort überwacht, werden zum Generieren des XML-Zielnamespace in den resultierenden Nachrichten verwendet. Standardmäßig ersetzt der Adapter alle ">" -Wildcards durch den Text GTWILDCARD in generierten Nachrichten. Sie können in diesem Feld einen anderen Platzhalter angeben. Codepagenummer Gibt die Codepage an, die vom Urheber der Nachricht zum Codieren der in den eingehenden Nachrichten enthaltenen Zeichenfolgen verwendet wird. Der Standardwert ist 65001. (Der Adapter unterstützt nicht, dass die gleichen Nachrichtensubjekte aus zwei verschiedenen Codepageumgebungen generiert werden.) Elementplatzhalterersatz Geben Sie einen anderen Platzhaltertextersatz an. Die Betreffnamen, die ein Empfangsspeicherort überwacht, werden zum Generieren des XML-Zielnamespace in den resultierenden Nachrichten verwendet. Standardmäßig ersetzt der Adapter alle „*“-Platzhalter in generierten Nachrichten durch den Text STARWILDCARD. Sie können in diesem Feld einen anderen Platzhalter angeben. Ereigniswarteschlangenname Geben Sie den Namen an, den Sie beim Erstellen des Rendezvous-Warteschlangenobjekts verwenden möchten. Diese Funktion steht aus praktischen Gründen zur Verfügung, denn in entsprechenden Protokollmeldungen wird der Name der Ereigniswarteschlange angezeigt. Der Standardwert ist leer. Filter Wenn Sie in überwachten Betreffnamen Platzhalterzeichen angeben, wird von der Zielorchestrierung nur ein Teil der potenziell sehr großen Anzahl an möglicherweise eingehenden Betreffnamen berücksichtigt. Wenn Sie die Auswirkungen auf BizTalk Server und den Zugriff auf die Datenbanken minimieren möchten, können Sie näher eingrenzen, welche Nachrichten an BizTalk Server gesendet werden sollen. Dieser Eintrag enthält eine durch Semikolons getrennte Liste mit Betreffnamen (Platzhalterzeichen sind nicht zulässig). Alle Nachrichten, deren Betreffname dem durch Platzhalterzeichen festgelegten Muster entspricht, jedoch in dieser Liste enthalten ist, werden herausgefiltert und nicht an BizTalk Server gesendet. Die Filterlogik kann umgekehrt werden. Stellen Sie dazu dem Filterwert das Zeichen „!“ voran. Standardmäßig ist dieser Wert leer (kein Filter). Zuordnen nicht unterstützter Typen zu Zeichenfolgen Hier legen Sie fest, ob nicht unterstützte Typen einen Fehler generieren oder einer Zeichenfolge zugeordnet werden. Diese Option kann bei Verwendung des Adapters mit einer neueren Version von TIBCO Rendezvous nützlich sein, in der möglicherweise neue Typen hinzugekommen sind. Mitglied der BizTalk-Gruppe Wenn Sie für diese Option Wahr festlegen, müssen die Parameter für die verteilte Warteschlange (unter dem Knoten Einstellungen für verteilte Warteschlange) und den zertifizierten Listener (unter dem Knoten Einstellungen für zertifizierten Listener) festgelegt werden. Der Standardwert lautet False. Pfad Geben Sie hier den Pfad zu den TIBCO Rendezvous-Binärdateien an, sofern diese Angabe nicht bereits in der Umgebungsvariablen PATH enthalten ist. Reihenfolge beibehalten Legen Sie hier fest, ob der Adapter eingehende Nachrichten in derselben Reihenfolge an BizTalk Server verteilt, in der sie empfangen wurden, also z. B. mit einem einzelnen Verteilerthread. Wenn die Parameter für zertifiziertes Messaging nicht festgelegt sind, bedeutet das nicht, dass der Adapter die Nachrichten in derselben Reihenfolge empfängt, in der sie gesendet wurden (in Bezug auf eine einzige Quelle). Empfangsspeicherortbezeichner Der Name des Empfangsspeicherorts. Reserved Dieses Feld ist für besondere Zwecke reserviert. Erweitern Sie den Rendezvous-Transport, und geben Sie alle erforderlichen Informationen für die Kommunikation zwischen den TIBCO Rendezvous-Daemons und -Programmen ein.
Der Transport (Netzwerk, Daemon, Dienst) gibt an, wie die TIBCO Rendezvous-Daemons Nachrichten austauschen. Diese Einstellungen werden unverändert an die TIBCO Rendezvous-API gesendet. Wenn Sie die Standardwerte (leer) verwenden, wird die Standardkommunikationsstrategie verwendet.
Ein TIBCO Rendezvous-Transport definiert den Übermittlungsbereich, also die möglichen Ziele für die gesendeten Nachrichten. Mit diesen Eigenschaften wird ein Transport definiert.
Parameter BESCHREIBUNG Daemon Geben Sie den numerischen Bezeichner für den Rendezvous-Transportdaemonparameter ein. Network Geben Sie den Namen des Rendezvous-Netzwerkparameters ein. Service Nam eGeben Sie den Namen des Rendezvous-Transportdiensts ein. Geben Sie an, ob die Anmeldeinformationen über Einmaliges Anmelden (SSO) angegeben werden sollen.
Sie haben zwei Möglichkeiten, auf das TIBCO Rendezvous-System zuzugreifen. Sie können die Anmeldeinformationen mit den Parametern für Benutzername und Kennwort angeben oder Einmaliges Anmelden verwenden.
Wählen Sie unter Einmaliges Anmelden verwenden die Option Ja aus.
Hinweis
Informationen zum Einrichten des einmaligen Anmeldens finden Sie unter Sicherheit .
Wählen Sie eine Partneranwendung aus der Liste aus.
Eine durch SSO-Tools (Enterprise Single Sign-On, Einmaliges Anmelden für Unternehmen) erstellte Partneranwendung stellt eine Anwendung wie TIBCO Rendezvous dar. Microsoft BizTalk-Adapter für TIBCO Rendezvous verwendet die Anmeldeinformationen eines Benutzers der Anwendung. Diese Anmeldeinformationen werden aus der SSO-Datenbank für das Serversystem für die angegebene Partneranwendung abgerufen.
Hinweis
Informationen zum Erstellen einer Partneranwendung finden Sie unter Erstellen von Partneranwendungen.
Nachdem Sie alle erforderlichen Informationen angegeben haben, klicken Sie auf Übernehmen, und klicken Sie dann auf OK.
Sie müssen Verbindungsparameter für den BizTalk-Adapter für TIBCO Rendezvous festlegen, damit TIBCO Rendezvous-Nachrichten empfangen werden können.