Verwaltung von Warteschlangen in Orchestrator

Erstellen einer Warteschlange

1. Klicken Sie auf der Seite Warteschlangen auf Warteschlange hinzufügen. Es werden zwei Optionen angezeigt, mit denen Sie eine neue Warteschlange erstellen oder Warteschlangen aus anderen Ordnern verknüpfen können.
2. Klicken Sie auf Neue Warteschlange erstellen. Das Fenster Warteschlange erstellen wird angezeigt.
3. Geben Sie im Feld Name einen Namen für die Warteschlange ein.
4. Fügen Sie im Feld Beschreibung eine Beschreibung für die Warteschlange hinzu.
5. Aktivieren Sie das Kontrollkästchen Eindeutige Referenzen erzwingen, wenn die Transaktionsreferenzen eindeutig sein sollen.
6. Aktivieren Sie das Kontrollkästchen In verschlüsselter Form speichern, wenn Sie die Daten und die Ausgabe der Warteschlangenelemente in der Datenbank verschlüsseln möchten.
   Hinweis:

   • Der Verschlüsselungsvorgang kann nicht rückgängig gemacht werden.
   • Nur die spezifischen Daten- und Ausgabewerte eines Warteschlangenelements werden verschlüsselt. Diese Werte werden nur in der Datenbank verschlüsselt, wodurch sensible Inhalte vor Datenbankadministratoren geschützt werden. Die Orchestrator-UI zeigt weiterhin den entschlüsselten Inhalt an. Für die Ende-zu-Ende-Verschlüsselung müssen Sie das Warteschlangenelement verschlüsseln, bevor Sie es der Warteschlange hinzufügen.
   • Vorhandene Warteschlangen können nicht verschlüsselt werden. Alternativ können Sie die Warteschlange neu erstellen und das Kontrollkästchen In verschlüsselter Form speichern aktivieren.
   • Aufgrund des verschlüsselten Formats ist es nicht mehr möglich, Analyseberichte für die Datenbankfelder Spezifische Daten und Ausgabewerte zu erstellen, und die entsprechenden Dashboards in Insights sind nicht verfügbar.
7. Im Abschnitt Automatische Wiederholung finden Sie die folgenden zwei Optionen:
   • Fehlgeschlagene Elemente – Wenn aktiv, werden alle Warteschlangenelemente wiederholt, die nach dem Erstellen der Warteschlange fehlschlagen.
   • Abgebrochene Elemente – Wenn aktiv, wird das Feld Max. Anzahl der Wiederholungen angezeigt, in dem Sie die maximale Anzahl der Wiederholungen für abgebrochene Warteschlangenelemente festlegen können. Wenn inaktiv, werden die Transaktionen nach 24 Stunden der Inaktivität abgebrochen.
   Hinweis: Die wiederholten Warteschlangenelemente werden in der Benutzeroberfläche entsprechend markiert.
8. Laden Sie ein JSON-Schema für bestimmte Daten, Ausgabedaten und Analysedaten hoch, indem Sie die entsprechende Schaltfläche Durchsuchen verwenden.
9. Aktivieren Sie SLA-Vorhersagen, wenn Sie die Bearbeitungszeit Ihrer Elemente besser steuern möchten und bewerten wollen, welche Ressourcen Sie benötigen, damit sie ihre Frist einhalten. Wenn SLA-Vorhersagen aktiviert sind, konfigurieren Sie die folgenden Felder:
   • Wählen Sie in der Dropdown-Liste Prozess den Prozess aus, der die Warteschlangenelemente verwaltet, und tragen Sie dann den SLA-Wert unten ein. Der Maximalwert beträgt 90 Tage.
   • Aktivieren Sie Risiko-SLA, wenn Sie eine Pufferzone vor dem eigentlichen SLA definieren möchten, und geben Sie den folgenden Wert ein. Das Risiko-SLA muss kleiner als das SLA sein.
10. Klicken Sie auf Hinzufügen. Die Warteschlange wird erstellt und auf der Seite Warteschlangen angezeigt, ist jedoch leer.

Sie können die Warteschlangen entweder mit Studio oder im Fenster Objekte hochladen füllen. Objekte aus einer Warteschlange zu bearbeiten ist nur mit Studio möglich. Weitere Informationen entnehmen Sie der Seite Verwalten von Warteschlangen in Studio.

Bearbeiten von Warteschlangen

Sie können vorhandene Warteschlangeneinstellungen aktualisieren, z. B.:

• Der Name und die Beschreibung der Warteschlange
• Der Abschnitt Automatische Wiederholung
• Die maximale Anzahl an Wiederholungen

Bearbeiten eines Warteschlangennamens oder einer Beschreibung

So bearbeiten Sie einen vorhandenen Warteschlangennamen im Orchestrator:

1. Klicken Sie auf der Seite Warteschlangen auf Weitere Optionen für die gewünschte Warteschlange.
2. Klicken Sie auf Bearbeiten . Der Assistent Warteschlange aktualisieren wird angezeigt.
3. Geben Sie im Feld Name den neuen Namen für die ausgewählte Warteschlange ein.
   Hinweis:

   • Stellen Sie sicher, dass Sie einen eindeutigen Namen eingeben. Wenn in Ihrem Mandanten bereits eine Warteschlange mit demselben Namen vorhanden ist, wird Ihnen diese Fehlermeldung angezeigt: The name <QueueName> is already used. (#1001).
   • Beim Namen wird die Groß-/Kleinschreibung nicht beachtet. Daher sind NEW_QueueName und new_queuename Duplikate.
4. Fügen Sie im Feld Beschreibung eine Beschreibung für die Warteschlange hinzu.
5. Klicken Sie auf Aktualisieren.
   Wichtig: Stellen Sie sicher, dass Sie den Warteschlangennamen in den entsprechenden Workflows in Studio aktualisieren. Sie müssen dies manuell tun, da es keine automatische Möglichkeit gibt, den Warteschlangennamen in Studio zu aktualisieren.

Ändern der Optionen für „Automatische Wiederholung“

So ändern Sie die Optionen im Abschnitt Automatische Wiederholung für eine vorhandene Warteschlange:

1. Wählen Sie auf der Seite Warteschlangen die Schaltfläche Weitere Optionen für die gewünschte Warteschlange aus.
2. Wählen Sie Bearbeiten aus. Als Nächstes wird der Assistent Warteschlange aktualisieren angezeigt.
3. Wählen Sie im Abschnitt Automatische Wiederholung die gewünschte Option aus.
4. Wählen Sie Aktualisieren aus.

Festlegen einer maximalen Anzahl von Wiederholungen

Abgebrochene Elemente: Kontrollkästchen aktiviert

Wenn Sie die Option Abgebrochene Elemente auswählen, wird das Feld Maximale Anzahl der Wiederholungen eingeblendet.

Geben Sie einen Wert im Bereich zwischen 1 und 50 als die Anzahl der Wiederholungen der fehlgeschlagenen Transaktion ein.

Wichtig:

1. Die vorhandenen fehlgeschlagenen Transaktionen werden nicht wiederholt. Nur die Transaktionen, die fehlschlagen, nachdem Sie den neuen Wert festgelegt haben, werden wiederholt.

2. Manuelle Wiederholungen werden nicht zu der maximalen Anzahl von Wiederholungen gezählt, die Sie für Warteschlangenelemente festgelegt haben. In solchen Fällen ist in der API RetryNumber gleich 0 und AncestorId gleich null.

Darüber hinaus verweist jedes Element der Warteschlange über das Feld Key auf das ursprüngliche Warteschlangenelement einer Wiederholungskette.

Die folgenden Felder sind enthalten:

• ManualRetryNumber – Die Anzahl der manuellen Wiederholungen eines Warteschlangenelements.
• ManualAncestorId – Die ID des Warteschlangenelements, das manuell wiederholt wurde.
• ManualAncestorUniqueKey – Die globale eindeutige GUID des Warteschlangenelements, das manuell wiederholt wurde.
• UniqueKey – Die globale eindeutige GUID eines beliebigen Warteschlangenelements (bei jeder Wiederholung unterschiedlich, manuell oder automatisch).
• AncestorUniqueKey – Die globale eindeutige GUID des Warteschlangenelements, das automatisch wiederholt wurde.
• RetryNumber – Die Anzahl der automatischen Wiederholungen eines Warteschlangenelements.
• AncestorId – Die ID des Warteschlangenelements, das automatisch wiederholt wurde.
• Key – Die GUID des ursprünglichen Warteschlangenelements einer Wiederholungskette.

Ziel ist es, eine vollständige Rückverfolgbarkeit der Wiederholungen von Warteschlangenelementen zu gewährleisten.

3. Wiederholte und gelöschte Warteschlangenelemente nehmen nicht an eindeutigen Referenzprüfungen teil. Daher empfehlen wir, ein ursprüngliches Warteschlangenelement nicht aus einer Wiederholungskette zu löschen, da dies die Validierung eindeutiger Referenzen verhindert. Wenn das ursprüngliche Warteschlangenelement jedoch durch die Datenaufbewahrung erfasst wurde, wird diese Validierung dennoch durchgeführt.

Angenommen, Sie haben eine Liste fehlgeschlagener Transaktionen, die einmal wiederholt werden. Der aktuelle Wert der Maximalen Anzahl der Wiederholungen ist 2. Aktualisieren Sie den Wert auf 3 und die fehlgeschlagenen Transaktionen werden zweimal statt einmal wiederholt.

Abgebrochene Elemente: Kontrollkästchen nicht aktiviert

Wenn Sie die Option Abgebrochene Elemente nicht auswählen, wird das Feld Maximale Anzahl der Wiederholungen ausgeblendet.

Keine Transaktion wird wiederholt.

Verwalten von Warteschlangenverknüpfungen

Durch die Freigabe von Warteschlangen zwischen Ordnern können Aufträge in mehreren Ordnern gestartet werden, ohne Ihre Workflows in Studio anpassen zu müssen, wenn die zugrundeliegenden Prozesse auf die gleiche Warteschlange abzielen. Wenn Sie eine Warteschlange mit einem Ordner verknüpfen, werden die Warteschlange und alle mit der Warteschlange verbundenen Objekte, z. B. Warteschlangenelemente, in diesem Ordner verfügbar.

Hinweis:

Eine Warteschlange, die mit mehreren Ordnern verknüpft ist, wird mit dem -Symbol markiert. Wenn das Symbol nicht vorhanden ist, ist der aktuelle Ordner der einzige Ordner, in dem sich die Warteschlange befindet. Wenn Sie sie hier löschen, wird die Warteschlange vollständig aus dem Orchestrator entfernt.

Sie benötigen die Berechtigungen Warteschlangen – Erstellen in den Ordnern, in denen Sie die Warteschlange (Zielordner) hinzufügen möchten, sowie Warteschlangen – Anzeigen in dem Ordner, in dem sich die Warteschlange derzeit befindet (ursprünglicher Ordner). Wenn Sie Warteschlangen – Bearbeiten im Zielordner haben, benötigen Sie auch Warteschlangen – Bearbeiten im ursprünglichen Ordner.

Verknüpfen mehrerer Warteschlangen mit dem aktuellen Ordner

1. In dem Ordner, mit dem Sie eine Warteschlange verknüpfen möchten, klicken Sie auf der Seite Warteschlangen auf Hinzufügen. Es werden drei Schaltflächen angezeigt, mit denen Sie eine Warteschlange hinzufügen, Warteschlangen aus anderen Ordnern verknüpfen oder die Optionen ausblenden können.
2. Klicken Sie auf Von anderen Ordnern verknüpfen. Das Fenster Warteschlangen verlinken wird angezeigt mit einer Liste aller Warteschlangen in den Ordnern, in denen Sie Anzeige-Berechtigungen für Warteschlangen haben.
3. Wählen Sie im Abschnitt Warteschlangen auswählen ein oder mehrere Warteschlangen von der Liste aus.
   
   

   

   
   
4. Klicken Sie auf Fortfahren. Sie werden zum Abschnitt Ordnervalidierung weitergeleitet. Hier sehen Sie die Ordner, mit denen die Warteschlangen bereits verknüpft sind. Bei mehreren Ordnern wird deren Name angezeigt.
   
   

   

   
   
5. Klicken Sie für die jeweilige Warteschlange auf Entfernen, damit die Änderung rückgängig gemacht wird, oder auf Beenden, um den Vorgang abzubrechen.
6. Klicken Sie auf Verknüpfen, wenn Sie die ausgewählten Warteschlangen mit dem aktuellen Ordner verknüpfen möchten. Die Warteschlangen werden auf der Seite Warteschlangen angezeigt.
   
   

   

   
   

Verknüpfen einer Warteschlange mit mehreren Ordnern

1. Navigieren Sie zu dem Ordner, in dem sich die zu verknüpfende Warteschlange befindet.
2. Klicken Sie auf Weitere Aktionen > Links verwalten für die gewünschte Warteschlange, um das Fenster Links verwalten zu öffnen. Das Fenster Warteschlangenverlinkungen verwalten wird angezeigt.

   1. Der linke Bereich zeigt alle Ordner an, für die Sie Berechtigungen zum Anzeigen für Warteschlangen erhalten haben. 2. Der aktuelle Status der Warteschlange mit der Anzahl der Ordner, in denen sie sich derzeit befindet, sowie deren Namen. 3. Die Ordner, in welche die Warteschlange entsprechend Ihrer Auswahl im linken Bereich eingefügt werden soll. 4. Die Ordner, aus denen die Warteschlange entfernt wird.

   
   

   

   
   
3. Klicken Sie auf Aktualisieren. Ein Fenster wird zur Bestätigung angezeigt.
4. Klicken Sie auf Abbrechen, wenn Sie die Änderungen verwerfen möchten, oder auf Fortfahren, damit die Änderungen wirksam werden. Die Vorgänge werden nun gemäß Ihren Änderungen im Orchestrator angezeigt.

Aufheben der Verknüpfung von Warteschlangen mit Ordnern

Das Aufheben der Verknüpfung von Warteschlangen mit Ordnern erfolgt auf ähnliche Weise wie das Verknüpfen. Navigieren Sie zu den in den oben beschriebenen Verfahren genannten Bereichen für die Verknüpfungsverwaltung und entfernen Sie die Verbindungen zwischen einer bestimmten Warteschlange und einem bestimmten Ordner.

Alternativ können Sie die Funktion Entfernen verwenden, um eine Warteschlange zu entfernen.

Wichtig:

Wenn Sie eine Warteschlange entfernen, die in mehreren Ordnern vorhanden ist, wird sie nur aus dem Ordner entfernt, in dem der Entfernungsvorgang ausgeführt wird. Sie wird dadurch nicht auch aus den anderen Ordnern entfernt. Um eine Warteschlange vollständig zu löschen, müssen Sie alle ihre vorhandenen Verknüpfungen entfernen.

In den folgenden Fällen können Sie die Verknüpfung einer Warteschlange mit einem Ordner nicht aufheben:

• Warteschlangen-SLA wurde in diesem Ordner aktiviert;
• Ein Warteschlangen-Trigger ist mit der Warteschlange verbunden.

Anzeigen von Transaktionen

Klicken Sie auf der Seite Warteschlangen auf Weitere Aktionen > Transaktionen anzeigen. Die Seite Transaktionen wird angezeigt, die nur die Elemente aus der angegebenen Warteschlange enthält.

Anzeigen von Review-Anfragen (Displaying Review Requests)

Klicken Sie auf der Seite Warteschlangen auf Anforderungen überprüfen, um alle Warteschlangenelemente anzuzeigen, die dem aktuell angemeldeten Benutzer zur Überprüfung zugewiesen wurden. Die Seite ermöglicht Statusänderungen und die Verwaltung von Elementinformationen.

Anzeigen des Warteschlangendiagramms

Um das Diagramm einer bestimmten Warteschlange anzuzeigen, klicken Sie auf die Schaltfläche Weitere Aktionen (More Actions) und anschließend auf Diagramm anzeigen (View Chart).

Ein Liniendiagramm zeigt die Entwicklung des Transaktionsstatus während eines bestimmten Zeitraums. Der Zeitraum (letzte(r) Stunde, Tag, Woche, 30 Tage) kann geändert werden und Sie können die durchschnittliche Ausführungszeit und die maximale Anzahl von Wiederholungsversuchen anzeigen.

Hochladen von Elementen in eine Warteschlange mithilfe einer CSV-Datei

Hier finden Sie Details zum Hochladen von Warteschlangenelementen mithilfe einer CSV-Datei.

Überwachung einer Warteschlange

Um eine Warteschlange zu überwachen, klicken Sie auf die entsprechende Schaltfläche Weitere Aktionen (More Actions) und dann auf Warteschlange überwachen (Monitor Queue). Alternativ können Sie diese aus dem Widget Warteschlangenübersicht (Queues Overview) (Überwachung > Warteschlangen) auswählen.

Beachten Sie, dass Ihr Benutzer zum Überwachen einer Warteschlange Anzeige- (View) Berechtigungen für Warteschlangen und Überwachung benötigt. Darüber hinaus ist Bearbeiten (Edit) für Überwachung erforderlich, um Fehler aus dem Widget Error Feed auf der Seite Überwachung (Monitoring) > Warteschlangen (Queues) zu deaktivieren.

Hinzufügen von Tags zu Warteschlangen

Hinweis:

Sie benötigen Bearbeiten für Warteschlangen und Anzeigen für Tags, um vorhandene Tags zu Warteschlangen hinzuzufügen.

Sie benötigen Bearbeiten für Warteschlangen und Erstellen für Tags, um neue Tags zu Warteschlangen hinzuzufügen.

Hinweis:

• Jede Warteschlange kann maximal eine Million Schlüssel-/Wertpaare haben.
• Beschriftungen und Schlüssel-/Werteigenschaften sind auf 256 Zeichen begrenzt.
• Tag-Namen dürfen die folgenden Zeichen nicht enthalten: <, >, %, &, \)\), ?, /, :

Sie können einer Warteschlange Tags zuweisen, wenn Sie eine Warteschlange erstellen oder eine bestehende Warteschlange bearbeiten. Führen Sie die folgenden Schritte aus, um einer Warteschlange beim Bearbeiten Tags hinzuzufügen:

1. Klicken Sie auf der Seite Warteschlangen neben der gewünschten Warteschlange auf Weitere Aktionen > Bearbeiten. Die Warteschlange wird zur Bearbeitung geöffnet.
2. Geben Sie in das Feld Beschriftungen den Namen der Beschriftung ein. Sie können eine vorhandene Beschriftung auswählen oder eine neue erstellen.
3. Klicken Sie im Feld Eigenschaften (Schlüssel-Wert-Paare) auf Neu hinzufügen.
4. Fügen Sie neue Schlüssel und Werte hinzu. Sie können vorhandene Schlüssel und/oder Werte auswählen oder neue erstellen.
5. Wenn Sie fertig sind, klicken Sie auf Aktualisieren. Ihre Warteschlange wird aktualisiert und die neu erstellten Tags werden, falls vorhanden, für andere Objekte verfügbar.

Entfernen von Tags aus Warteschlangen

Führen Sie die folgenden Schritte aus, um Tags aus einer Warteschlange zu entfernen:

1. Klicken Sie auf der Seite Warteschlangen neben der gewünschten Warteschlange auf Weitere Aktionen > Bearbeiten. Die Warteschlange wird zur Bearbeitung geöffnet.
2. Klicken Sie im Feld Beschriftungen neben dem Namen der Beschriftung auf X, um sie zu entfernen. Die Beschriftung wird entfernt.
3. Klicken Sie im Feld „Eigenschaften“ (Schlüssel-Wert-Paare) auf das X neben den Schlüsseln und/oder Werten, um sie zu entfernen. Die Schlüssel und/oder Werte werden entfernt.
4. Um ein Schlüssel-/Wertpaar zu löschen, klicken Sie auf das Symbol Entfernen für den jeweiligen Eintrag. Das Schlüssel-/Wert-Paar wird entfernt.
5. Wenn Sie fertig sind, klicken Sie auf Aktualisieren. Ihre Warteschlangen werden aktualisiert und Tags entfernt.

Entfernen einer Warteschlange

Um eine Warteschlange zu entfernen, klicken Sie auf die entsprechende Schaltfläche Weitere Aktionen und dann auf Entfernen.

Alternativ wählen Sie sie auf der Seite Warteschlangen aus und klicken Sie auf Entfernen. Die Warteschlange wird auf der Seite Warteschlangen nicht mehr angezeigt.

Wichtig: Wenn Sie eine Warteschlange entfernen, die in mehreren Ordnern vorhanden ist, wird sie nur aus dem Ordner entfernt, in dem der Entfernungsvorgang ausgeführt wird. Sie wird dadurch nicht auch aus den anderen Ordnern entfernt. Um eine Warteschlange vollständig zu löschen, müssen Sie alle ihre vorhandenen Verknüpfungen entfernen.

Hinweis: Nachdem eine Warteschlange gelöscht wurde, sind zugewiesene Transaktionsobjekte, die zur Warteschlange gehören, nicht länger auf der Seite Review-Anfragen (Review Requests) sichtbar.

Aufzeichnen fehlgeschlagener Warteschlangentransaktionen

Sie können fehlgeschlagene Warteschlangentransaktionen aufzeichnen, die einem Prozess zugeordnet sind, bei dem die Aufzeichnungsoption aktiviert ist. Dies hilft bei der Identifizierung und Behebung von Problemen, die zu Fehlern führen, sowie bei der Überwachung und Prüfung.

Diese Option wird auf Prozessebene im Abschnitt Auftragsaufzeichnung der Registerkarte Zusätzliche Einstellungen aktiviert.

Wenn ein Prozess fehlschlägt, der eine Warteschlange enthält, wird seine Ausführung aufgezeichnet und im Orchestrator an folgenden Stellen zur Verfügung gestellt:

• Auf Warteschlangenebene, indem Sie im Kontextmenü der betroffenen Warteschlange auf Aufzeichnung öffnen klicken.

  Diese Option ist nicht aktiv, wenn:

  • die Warteschlange einem Prozess zugeordnet ist, dessen Ausführung nicht fehlgeschlagen ist;

  • die Option Fehlgeschlagene Warteschlangentransaktionen aufzeichnen und speichern für den Prozess, dem diese Warteschlange zugeordnet ist, nicht aktiviert wurde.

• Auf Transaktionsebene durch Klicken auf Aufzeichnung öffnen im Fenster Details anzeigen der betroffenen Transaktion.

Aufzeichnungsdauer

Die maximale Aufzeichnungslänge beträgt 3 Minuten und gilt für die letzten Momente der Ausführung.

Die minimale Aufzeichnungslänge beträgt 10 Sekunden. Wenn die Verarbeitung einer Transaktion weniger als 10 Sekunden dauert, kann die Aufzeichnung auch andere Transaktionen umfassen.