Zum Inhalt springen

Jitterbit MQ-Verbindung

Einführung

Eine Jitterbit MQ-Verbindung, die mit dem Jitterbit MQ-Connector erstellt wurde, ermöglicht den Zugriff auf den Jitterbit-Nachrichtenschlangenservice. Sobald eine Verbindung konfiguriert ist, können Instanzen von Jitterbit MQ-Aktivitäten erstellt werden, die mit dieser Verbindung verknüpft sind, um entweder als Quellen (um Daten in einem Vorgang bereitzustellen) oder als Ziele (um Daten in einem Vorgang zu konsumieren) verwendet zu werden.

Hinweis

Dieser Connector unterstützt die Re-Authentifizierung bei Änderung Organisationsrichtlinie. Wenn aktiviert, erfordert eine Änderung der Organisations-ID, Umgebungs-ID oder Jitterbit-Region in dieser Verbindung, dass Benutzer das Auth-Token für die Verbindung erneut eingeben.

Erstellen oder Bearbeiten einer Jitterbit MQ-Verbindung

Eine neue Jitterbit MQ-Verbindung wird mit dem Jitterbit MQ-Connector von einem dieser Standorte erstellt:

Eine vorhandene Jitterbit MQ-Verbindung kann von diesen Standorten bearbeitet werden:

Konfigurieren einer Jitterbit MQ-Verbindung

Jedes Benutzeroberflächenelement des Jitterbit MQ-Verbindungs-Konfigurationsbildschirms wird im Folgenden beschrieben.

Tipp

Felder mit einem Variablen-Icon unterstützen die Verwendung von globalen Variablen, Projektvariablen und Jitterbit-Variablen. Beginnen Sie entweder, indem Sie eine öffnende eckige Klammer [ in das Feld eingeben oder indem Sie auf das Variablen-Icon klicken, um ein Menü anzuzeigen, das vorhandene Variablen zur Auswahl auflistet.

  • Verbindungsname: Geben Sie einen Namen ein, um die Verbindung zu identifizieren. Der Name muss für jede Jitterbit MQ-Verbindung eindeutig sein und darf keine Schrägstriche / oder Doppelpunkte : enthalten. Dieser Name wird auch verwendet, um den Jitterbit MQ-Endpunkt zu identifizieren, der sich sowohl auf eine bestimmte Verbindung als auch auf deren Aktivitäten bezieht.

  • Auth-Token: Geben Sie ein Authentifizierungstoken ein, das mit der Umgebung verbunden ist. Das Authentifizierungstoken wird auf der Seite Nachrichtenwarteschlangen im Tab Authentifizierungstoken generiert.

  • Optionale Einstellungen: Klicken Sie, um zusätzliche optionale Einstellungen zu erweitern:

    • Jitterbit-Region: Wählen Sie die Jitterbit-Region aus, zu der die Organisation gehört, entweder APAC, EMEA oder NA. Dieses Feld ist erforderlich, wenn Sie die Agent-Version 10.73 oder früher verwenden. Wenn Sie die Agent-Version 10.74 oder später verwenden, wählt das System standardmäßig die Region der Organisation aus, auf die Sie zugreifen.

    • Organisations-ID: Geben Sie die Harmony-Organisations-ID ein. Dieses Feld ist erforderlich, wenn Sie die Agent-Version 10.73 oder früher verwenden. Wenn Sie die Agent-Version 10.74 oder später verwenden, können Sie dieses Feld leer lassen, wenn das Auth-Token mit derselben Organisation verbunden ist, in der sich das Projekt befindet. Andernfalls müssen Sie die mit dem Authentifizierungstoken verbundene Organisations-ID eingeben.

    • Umgebungs-ID: Geben Sie die Harmony-Umgebungs-ID für die Umgebung ein, die die Nachrichtenwarteschlange enthält. Dieses Feld ist erforderlich, wenn Sie die Agent-Version 10.73 oder früher verwenden. Wenn Sie die Agent-Version 10.74 oder später verwenden, können Sie dieses Feld leer lassen, um die Umgebung des Projekts zu verwenden.

    • Verbindungsanfrage-Timeout in Sekunden: Geben Sie die maximale Zeit (in Sekunden) an, die die Verbindung nach Abschluss einer Anfrage offen bleibt. Dieses Leerlauf-Timeout steuert, wie lange eine etablierte Verbindung offen bleibt, bevor sie geschlossen wird. Der Standardwert beträgt 10 Sekunden und der maximale Wert ist 180 Sekunden. Eine Änderung dieses Wertes wird nicht empfohlen.

    • Antwort-Timeout in Sekunden: Geben Sie die maximale Zeit (in Sekunden) an, die gewartet werden soll, bis der Nachrichtenwarteschlangenservice Daten zurückgibt, nachdem eine Anfrage gesendet wurde. Wenn der Service innerhalb dieses Zeitraums nicht antwortet, läuft die Anfrage ab. Der Standardwert beträgt 10 Sekunden und der maximale Wert ist 300 Sekunden.

    • Verbindungs-Timeout in Sekunden: Geben Sie die maximale Zeit (in Sekunden) an, die gewartet werden soll, um eine erste Verbindung mit dem Nachrichtenwarteschlangenservice herzustellen, bevor der Versuch abläuft. Diese Einstellung gilt, wenn Sie eine neue Verbindung öffnen, bevor Sie Anfragen senden. Der Standardwert beträgt 10 Sekunden und der maximale Wert ist 300 Sekunden.

    • Wiederholen: Aktivieren Sie dieses Kontrollkästchen, um zu versuchen, eine Verbindung erneut herzustellen, wenn der erste Versuch während der Ausführung einer Get, Get Bulk oder Get Queue Details Aktivität fehlschlägt oder abläuft. Wenn dieses Kontrollkästchen aktiviert ist, stehen die folgenden Optionen zur Verfügung:

      • Wiederholungsanzahl: Geben Sie die maximale Anzahl der Verbindungsversuche an (von 1 bis 5).

      • Wiederholungsintervall (in Sekunden): Geben Sie an, wie viele Sekunden zwischen jedem Verbindungsversuch gewartet werden soll (mindestens 1 und maximal 5).

  • Test: Klicken Sie, um die Verbindung mit der bereitgestellten Konfiguration zu überprüfen. Wenn die Verbindung getestet wird, wird die neueste Version des Connectors von den Agenten in der Agentengruppe heruntergeladen, die mit der aktuellen Umgebung verbunden ist. Dieser Connector unterstützt das Aussetzen des Downloads der neuesten Connector-Version durch die Verwendung der Deaktivieren Sie die automatische Connector-Aktualisierung Organisationsrichtlinie.

  • Änderungen speichern: Klicken Sie, um die Konfiguration der Verbindung zu speichern und zu schließen.

  • Änderungen verwerfen: Nachdem Sie Änderungen an einer neuen oder bestehenden Konfiguration vorgenommen haben, klicken Sie, um die Konfiguration ohne Speichern zu schließen. Eine Nachricht fragt Sie, ob Sie die Änderungen wirklich verwerfen möchten.

  • Löschen: Nachdem Sie eine bestehende Verbindungs-Konfiguration geöffnet haben, klicken Sie, um die Verbindung dauerhaft aus dem Projekt zu löschen und die Konfiguration zu schließen (siehe Komponentenabhängigkeiten, Löschung und Entfernung). Eine Nachricht fragt Sie, ob Sie die Verbindung wirklich löschen möchten.

Nächste Schritte

Nachdem eine Jitterbit MQ-Verbindung erstellt wurde, platzieren Sie einen Aktivitätstyp auf der Entwurfsgrafik, um Aktivitätsinstanzen zu erstellen, die entweder als Quellen (um Daten in einem Vorgang bereitzustellen) oder als Ziele (um Daten in einem Vorgang zu konsumieren) verwendet werden.

Menüaktionen für eine Verbindung und ihre Aktivitätstypen sind im Projektbereich und in der Palette der Entwurfskomponenten zugänglich. Für Details siehe Aktionsmenüs in Connector-Grundlagen.

Diese Aktivitätstypen sind verfügbar:

  • Bulk abrufen: Ruft eine Gruppe von Nachrichten ab, die in einer bestimmten Jitterbit Nachrichtenwarteschlange verfügbar sind, und ist dafür gedacht, als Quelle in einem Vorgang verwendet zu werden.

  • Bestätigen: Bestätigt Nachrichten in einer Jitterbit Nachrichtenwarteschlange und ist dafür gedacht, als Ziel in einem Vorgang verwendet zu werden.

  • Send Bulk: Sendet eine Gruppe von Nachrichten an eine Jitterbit Nachrichtenwarteschlange und ist als Ziel in einer Operation vorgesehen.

  • Get: Ruft eine einzelne Nachricht ab, die in einer bestimmten Jitterbit Nachrichtenwarteschlange verfügbar ist, und ist als Quelle in einer Operation vorgesehen.

  • NACK: Bestätigt Nachrichten negativ (unter Verwendung der ackId) und ist als Ziel in einer Operation vorgesehen.

  • Get Queue Details: Ruft die Warteschlangendetails für eine bestimmte Jitterbit Nachrichtenwarteschlange ab und ist als Quelle in einer Operation vorgesehen.

  • Send: Sendet eine einzelne Nachricht an eine Jitterbit Nachrichtenwarteschlange und ist als Ziel in einer Operation vorgesehen.