Automatisches Löschen von alten Aufgabenausführungen (Robot-Jobs)

Ihnen stehen drei vordefinierte Python-/HCL-Skripts zur Verfügung, mit denen Sie den Prozess zum Löschen alter Aufgabenausführungen in Robots automatisieren können. Wenn Sie einen oder mehrere Robots haben, die regelmäßig ausgeführt werden, können sich schnell viele gespeicherte Ausgabenausführungen ansammeln. Bei Organisationen, die einen lokalen Robots-Agent nutzen, kann eine Anhäufung alter Aufgabenausführungen mit den dazugehörigen Ergebnisdaten dazu führen, dass Ihrem Server der Speicherplatz ausgeht. Durch das automatisierte Löschen alter Aufgabenausführungen ersparen Sie sich die Arbeit, diese ständig manuell löschen zu müssen. Sie sparen außerdem Speicherplatz auf dem Server und sorgen dafür, dass die Robots-Benutzeroberfläche übersichtlich bleibt.

Diligent One-Kontoanforderungen

Für die vordefinierten Skripts wird ein HighBond-Zugriffstoken als einer der Skripteingabeparameter benötigt. Um Aufgabenausführungen zu löschen, muss dem Diligent One-Benutzerkonto, das dem Token zugeordnet ist, die Rolle „Eigentümer“ oder „Bearbeiter“ für den Ziel-Robot zugewiesen werden.

Weitere Informationen finden Sie unter HighBond-Zugriffstoken erstellen und verwalten und Berechtigungen der Robots-App.

So funktionieren die vordefinierten Löschskripts

Sie laden eines oder mehrere der Löschskripts über die unten aufgeführten Links herunter und laden dann die jeweiligen Skripts auf seinen eigenen HighBond-Robot hoch. (Ein Skript pro Robot.) Im Robot erstellen Sie dann eine Aufgabe, um das Löschskript zu konfigurieren und die Ausführung zu planen. Sie können mithilfe der konfigurierbaren Skriptparameter angeben, welche Aufgabenausführungen gelöscht werden sollen.

Lösch- und Ziel-Robots

Stellen Sie sich den Robot, der ein Löschskript enthält, als Lösch-Robot vor. Die Aufgabe, mit der Sie das Löschskript konfigurieren und planen, ist die Löschaufgabe. Mit dem Lösch-Robot und der Löschaufgabe löschen Sie alte Aufgabenausführungen in einem anderen Robot. Dieser andere Robot ist somit der Ziel-Robot. Wenn Sie Löschvorgänge auf eine bestimmte Aufgabe im Ziel-Robot beschränken, ist dies die Zielaufgabe.

Sie können so viele Lösch-Robots oder Löschaufgaben erstellen, wie Sie benötigen. Was Sie sich schlussendlich merken müssen, ist dass Sie ein Löschskript in einem Robot einrichten und es verwenden, um alte Aufgabenausführungen in einem anderen Robot zu löschen.

Löschskripts funktionieren für jeden Robot-Typ

Auch wenn die Löschskripts aus Python-/HCL-Code bestehen und in HighBond-Robots enthalten sind, können Sie sie verwenden, um alte Aufgabenausführungen in einem beliebigen Robot-Typen zu löschen, einschließlich ACL-Robots. Sie müssen sich nicht mit Python/HCL auskennen, um die Löschskripts zu verwenden. Weiter unten finden Sie Schritt-für-Schritt-Anweisungen für die Einrichtung der Löschskripts.

HCL-HighBond-API-Methoden und die HighBond-API

Die Löschskripts nutzen HCL-HighBond-API-Methoden und die HighBond-API, um Aufgabenausführungen abzurufen und zu löschen. Wenn Sie den Umgang mit Python/HCL beherrschen, können Sie gegebenenfalls das Verhalten der Löschskripts ändern. Weitere Informationen finden Sie unter HCL-HighBond-API-Methoden und in der HighBond-API-Referenz.

Löschen von Aufgabenausführungsdaten

Durch das Löschen einer Aufgabenausführung werden nur die der Ausführung zugeordneten Ergebnisdaten gelöscht:

• Ergebnistabellen

• Ergebnisdateien

• Ergebnisprotokolle

Analytics-Datentabellen oder Python/HCL-Arbeitsdateien, die bei einer Aufgabenausführung erstellt wurden, werden nicht gelöscht. Diese Tabellen und Dateien werden auf der Registerkarte Eingabe/Ausgabe (ACL-Robot) oder auf der Registerkarte Arbeitsdaten tab (HighBond- oder Workflow-Robots) gespeichert und können ggf. an diesen Stellen einzeln gelöscht werden. Weitere Informationen finden Sie unter Arbeitsdaten verwalten, die in einem Robot gespeichert sind.

Erstmaliges, automatisches Löschen von alten Aufgabenausführungen

Seien Sie vorsichtig, wenn Sie alte Aufgabenausführungen zum ersten Mal löschen. Wenn Sie eine große Anzahl alter Aufgabenausführungen und eine große Menge zugeordneter Ergebnisdaten haben, kann ein gleichzeitiges Löschen aller Daten Ihren Server verlangsamen. Verwenden Sie eine der nachfolgenden Strategien, um die alten Aufgabenausführungen stapelweise zu löschen.

Menge und Datumsbereich alter Aufgabenausführungen ermitteln

Nutzen Sie die globale Ansicht Aufgabenausführungen, um die Menge und den Datumsbereich alter Aufgabenausführungen zu ermitteln. Verwenden Sie diese Informationen, wenn Sie entscheiden müssen, welche Werte als Eingabeparameter für Löschskripts verwendet werden sollen.

Führen Sie folgende Schritte in der globalen Ansicht Aufgabenausführungen aus:

• Legen Sie für den Filter Ausgelöst um einen angemessen Zeitraum fest. Der Filter ist zunächst standardmäßig auf die letzten 10 Tage eingestellt. Dieser Datumsbereich ist für Ihre Bedürfnisse wahrscheinlich zu kurz.

• Verwenden Sie die Filter Robot-Name und Aufgabenname, um Aufgabenausführungen für den Ziel-Robot oder die Zielaufgaben zu isolieren. Im Bereich Aufgabenausführungen nach Status wird die Gesamtzahl der Aufgabenausführungen für den Robot oder die Aufgabe angezeigt.

• Sortieren Sie in der Tabelle Aufgabenausführungen die Spalte Abgeschlossen um so, dass die älteste Aufgabenausführung als oberstes angezeigt wird.

Weitere Informationen finden Sie unter Robot-Aufgaben und -Aufgabenausführungen anzeigen.

Löschaufgaben manuell ausführen

Planen Sie zunächst nicht die Ausführung einer Löschaufgabe. Konfigurieren Sie die Aufgabe und führen Sie sie manuell aus, um alte Aufgabenausführungen stapelweise zu löschen. Durch das manuelle, stapelweise Löschen von Aufgabenausführungen können Sie den Löschvorgang in kürzere Zeitabschnitte unterteilen. Nachdem Sie den großen Rückstau aus alten Aufgabenausführungen gelöscht haben, können Sie die automatische Ausführung der Löschaufgabe planen.

Aufgabenausführungen nach Monat löschen

Wenn Sie alte Aufgabenausführungen basierend auf einem Datum löschen, legen Sie das Datum der frühesten Aufgabenausführung fest und konfigurieren Sie ein Löschdatum, das einen Monat nach dem frühesten Datum liegt. Führen Sie die Löschaufgabe wiederholt manuell aus und verschieben Sie dabei das Löschdatum jedes Mal um einen Monat nach vorne. Wenn das Löschen der Aufgabenausführungen eines einzelnen Monats relativ schnell geht, können Sie versuchen, Aufgabenausführungen in Blöcken von drei oder sechs Monaten zu löschen.

50 oder 100 Aufgabenausführungen gleichzeitig löschen

Wenn Sie alte Aufgabenausführungen basierend auf der Anzahl der Ausführungen löschen, ermitteln Sie die Gesamtanzahl der Aufgabenausführungen und konfigurieren Sie eine maximale Anzahl an Aufgabenausführungen, die 50 oder 100 Ausführungen unter der Gesamtanzahl liegt. Führen Sie die Löschaufgabe wiederholt manuell aus und reduzieren Sie dabei die maximale Anzahl jedes Mal um 50 oder 100 Ausführungen. Wenn das Löschen von 50 oder 100 Ausführungen relativ schnell geht, können Sie versuchen, Aufgabenausführungen in größeren Blöcken zu löschen.

Eine Aufgabenausführung nach der anderen löschen

Wenn Sie über einen oder mehrere Robots verfügen, die jeweils mehrere Aufgaben enthalten, löschen Sie die Aufgabenausführungen einzeln, anstatt alle Aufgabenausführungen in einem Robot gleichzeitig zu löschen.

Einrichten eines Löschskripts

Folgen Sie diesem Prozess, um ein Löschskript einzurichten, um alte Aufgabenausführungen automatisch zu löschen:

1. Ein oder mehrere Löschskripts herunterladen

2. Einen Lösch-Robot erstellen

3. Eine Löschaufgabe im Lösch-Robot erstellen und die Ausführung planen

Ort der Löschaufgabe

Sie können die Löschaufgabe sowohl im Produktionsmodus als auch im Entwicklermodus erstellen. Die Löschskripts funktionieren über die Grenze zwischen den beiden Modi hinweg, sodass Sie die Löschaufgabe und das Löschskript in einem beliebigen Modus platzieren.

Wenn Sie die Löschaufgabe im Produktionsmodus erstellen, müssen Sie zunächst das Löschskript vom Entwicklermodus in den Produktionsmodus aktivieren. Weitere Informationen finden Sie unter Skriptversion aktivieren.

Zwei der Löschskripts löschen die entsprechenden Aufgabenausführungen sowohl im Produktionsmodus als auch im Entwicklermodus.

• HB-Robot – Jobs, die älter als eine bestimmte Anzahl an Tagen sind, werden aus robot.json gelöscht.

• HB-Robot – Eine bestimmte Anzahl an Jobs wird in robot.json beibehalten.

Das dritte Löschskript löscht entsprechende Aufgabenausführungen im Modus (Produktion oder Entwickler) in dem sich die Zielaufgabe befindet:

• HB-Robot – Jobs, die älter als eine bestimmte Anzahl an Tagen sind, werden aus task.json gelöscht.

Im Fall des dritten Löschskripts ist es nicht erforderlich, dass sich die Löschaufgabe im gleichen Modus befindet wie die Zielaufgabe. Dies kann jedoch dabei helfen, für eine übersichtliche Organisation von Lösch- und Zielaufgaben zu sorgen.

Eindeutige Kennungen für Robots und Aufgaben finden

Alle drei Skripts benötigen die eindeutige Kennung des Ziel-Robots als Eingabeparameter. Das Löschskript auf Aufgabenebene benötigt außerdem die eindeutige Zielaufgaben-Kennung. Navigieren Sie in Robots zum Ziel-Robot oder zur Zielaufgabe und kopieren Sie die eindeutige Kennung aus der URL in der Adressleiste des Browsers heraus.

Eindeutige Robot-Kennung

Im URL-Pfad folgt die eindeutige Robot-Kennung unmittelbar dem Produktions- oder Entwicklersegment. Demzufolge lautet die eindeutige Robot-Kennung in den beiden folgenden Beispielen 63034.

https://vincicorp.robotics.highbond.com/production/63034/working-data

https://vincicorp.robotics.highbond.com/development/63034/task-runs

Eindeutige Aufgabenkennung

Im URL-Pfad folgt die eindeutige Aufgabenkennung unmittelbar dem Aufgabensegment. Demzufolge lautet die eindeutige Aufgabenkennung im ersten folgenden Beispiel 57275 und 54731 im zweiten Beispiel.

https://vincicorp.robotics.highbond.com/production/63034/tasks/57275

https://vincicorp.robotics.highbond.com/development/63034/tasks/54731

Ein oder mehrere Löschskripts herunterladen

Laden Sie eines oder mehrere der unten verlinkten Löschskripts herunter. Wählen Sie das Skript, das Ihren Anforderungen am ehesten entspricht. Sie können gegebenenfalls mehrere Löschskripts mit unterschiedlichen Konfigurationseinstellungen einrichten.

1. Klicken Sie mit der rechten Maustaste auf einen der folgenden Links und wählen Sie Link speichern unter.

   Skript-Link	Skript-Beschreibung
   HB-Robot – Jobs, die älter als eine bestimmte Anzahl an Tagen sind, werden aus task.json gelöscht.	Löscht die Aufgabenausführungen (Jobs) aus einer Aufgabe, die älter als eine bestimmte Anzahl an Tagen sind. Löscht entsprechende Aufgabenausführungen im Modus (Produktion oder Entwickler) in dem sich die Zielaufgabe befindet.
   HB-Robot – Jobs, die älter als eine bestimmte Anzahl an Tagen sind, werden aus robot.json gelöscht.	Löscht die Aufgabenausführungen (Jobs) aus allen Aufgaben in einem Robot, die älter als eine bestimmte Anzahl an Tagen sind. Löscht die entsprechenden Aufgabenausführungen sowohl im Produktionsmodus als auch im Entwicklermodus.
   HB-Robot – Eine bestimmte Anzahl an Jobs wird in robot.json beibehalten.	Löscht eine Anzahl an Aufgabenausführungen (Jobs) aus allen Aufgaben in einem Robot, die größer als eine festgelegte Anzahl an Ausgabenausführungen ist. Beginnt mit der ältesten Aufgabenausführung. Löscht die entsprechenden Aufgabenausführungen sowohl im Produktionsmodus als auch im Entwicklermodus.

2. Speichern Sie das Löschskript im Ordner Downloads oder in einem anderen Ordner auf Ihrem Computer.

   Das Löschskript wird als JSON-Datei (*.json) heruntergeladen.

Einen Lösch-Robot erstellen

Folgen Sie dem Standardprozess zum Erstellen eines HighBond-Robots und laden Sie ein einzelnes Löschskript von Ihrem Computer auf den Robot hoch. Erstellen Sie für jedes weitere Löschskript, das Sie verwenden möchten, einen zusätzlichen HighBond-Robot.

Robot erstellen

1. Wählen Sie auf der Launchpad-Startseite (www.highbond.com) die Robots-App aus, um sie zu öffnen.

   Wenn Sie sich bereits in Diligent One befinden, können Sie über das linke Navigationsmenü zur Robots-App wechseln.

2. Wählen Sie auf dem Dashboard in Robots die Registerkarte HighBond-Robot aus.
3. Wenn Sie den Robot in einem Ordner erstellen möchten, klicken Sie auf den Ordner, um ihn zu öffnen.

   Weitere Informationen zum Erstellen von Ordnern finden Sie unter Robot-Ordner erstellen und verwalten.

4. Klicken Sie auf HighBond-Robot erstellen.
5. Wählen Sie ein Symbol und geben Sie einen Namen für den Robot ein.

   Tipp

   Mit Hilfe von Symbolen können Sie Robots in leicht identifizierbare Gruppen einteilen.

   Hinweis

   Verwenden Sie keine Währungssymbole im Robot-Namen, z. B.: $, €.

6. Optional. Geben Sie in das Feld Beschreibung eine Beschreibung für den Robot ein, damit die Benutzer verstehen, was der Robot macht.
7. Klicken Sie auf HighBond-Robot erstellen.

   Der Robots-Skript-Editor beginnt den Startprozess.

   Hinweis

   Wenn die Meldung Robot kann nicht erstellt werden angezeigt wird, müssen Sie einen anderen Namen für den Robot angeben. Dann ist bereits ein anderer Robot mit demselben Namen vorhanden.

   Wenn Sie kein Mitarbeiter mit Berechtigungen für den vorhandenen Robot sind, ist der Robot für Sie nicht sichtbar.

8. Klicken Sie in der oberen linken Ecke von Skript-Editor auf den Namen des Robots und dann auf Nicht übermitteln.

   Sie werden zur Registerkarte Skriptversionen des neu erstellten Robots im Entwicklermodus weitergeleitet.

Löschskript hochladen

1. Klicken Sie auf der Registerkarte Skriptversionen des neuen Robots auf Hochladen.

2. Wählen Sie in dem daraufhin angezeigten Dialogfeld das Löschskript von Ihrem Computer oder ziehen Sie es in den Bereich Hochgeladenes Skript.

   Jedes Löschskript ist in einer JSON-Datei (*.json) enthalten.

3. Geben Sie eine Übermittlungsnachricht ein und klicken Sie auf Hochladen und übermitteln.

   Das Skript wird als aktuellste Version der Registerkarte Skript-Versionen hinzugefügt. Es wird eine Benachrichtigung angezeigt, die bestätigt, dass das Skript erfolgreich übermittelt wurde.

   Auch wenn der Upload- und Übermittlungsprozess fehlschlägt, wird eine Benachrichtigung angezeigt. Versuchen Sie erneut, das Skript hochzuladen. Wenn der Upload erneut fehlschlägt, versuchen Sie, eine neue Kopie des Löschskripts herunterzuladen und die neue Kopie hochzuladen.

Eine Löschaufgabe im Lösch-Robot erstellen und die Ausführung planen

Folgen Sie dem Standardprozess zum Erstellen und Planen einer Robot-Aufgabe. Sie können die Löschaufgabe sowohl im Produktionsmodus als auch im Entwicklermodus erstellen. Weitere Informationen finden Sie unter Ort der Löschaufgabe.

Den Modus für die Löschaufgabe auswählen

Verwenden Sie die Schaltflächen Produktion und Entwicklung in der oberen rechten Ecke des Lösch-Robots, um zwischen den gewünschten Modi zu wechseln.

Wenn Sie die Löschaufgabe im Produktionsmodus erstellen möchten, müssen Sie zunächst das Löschskript vom Entwicklermodus in den Produktionsmodus aktivieren. Weitere Informationen finden Sie unter Skriptversion aktivieren.

Eine Aufgabe erstellen und das Löschskript auswählen

1. Klicken Sie auf der Registerkarte Aufgaben auf Aufgabe erstellen.

   Der Aufgaben-Designer wird geöffnet, und Sie können mit der Konfiguration der Aufgabeneinstellungen beginnen.

2. Geben Sie einen Namen für die Aufgabe ein und klicken Sie auf Speichern.
3. Wählen Sie auf der Seite Skripts auswählen die Option Alle auswählen aus.

   Das Löschskript ist ausgewählt.

Skriptparameterwerte und einen HighBond-Zugriffstoken eingeben

1. Klicken Sie auf den Pfeil nach unten , um die Parameterauswahl zu erweitern und die Werte für das Skript einzugeben.
2. Wenn Sie anderen Benutzern erlauben möchten, die Löschaufgabe auszuführen, zu deaktivieren oder zu aktivieren, klicken Sie auf Kennwörter teilen.
   • Kennwörter teilen ist eingeschaltet Alle Benutzer mit Zugriff auf den Robot können die Aufgabe ausführen, deaktivieren oder aktivieren.
   • Kennwörter teilen ist ausgeschaltet Nur Sie können die Aufgabe ausführen, deaktivieren oder aktivieren.

   Unabhängig von der Einstellung können andere Benutzer mit Zugriff auf den Robot die Aufgabe bearbeiten und ihr eigenes HighBond-Zugriffstoken eingeben.

   Weitere Informationen finden Sie unter Skripts mit Kennwörtern.

3. Klicken Sie unten auf der Seite auf Weiter.

Aufgabe planen

1. Wählen Sie oben auf der Seite Aufgabe auf einen Ablaufplan setzen.
2. Geben Sie die Planungsdetails an:
   • Häufigkeit Das Intervall für die wiederholte Ausführung der Aufgabe
   • Uhrzeit Die Uhrzeit, wenn die Aufgabenausführung gestartet wird, und die zu verwendende Zeitzone

     Verwenden Sie Ihre eigene Zeitzone, es sei denn, Sie möchten die Startzeit in einer anderen Zeitzone angeben.

   • Datum Das Datum für die Ausführung der Aufgabe
3. Klicken Sie unten auf der Seite auf Weiter.

Benutzer benachrichtigen, wenn die Aufgabe nicht ausgeführt wird

1. Aktivieren Sie Benachrichtigungen bei Fehler senden, wenn Sie einen oder mehrere bestimmte Benutzer benachrichtigen möchten, wenn eine Aufgabe nicht ausgeführt wird.

   Falls aktiviert, wird eine Benachrichtigung automatisch gesendet, wenn eine Aufgabe aus einem der folgenden Gründe nicht ausgeführt wird:

   • Das Skript in der Aufgabe schlägt fehl.

   • Die Aufgabe wird übersprungen.

   • Die Aufgabe wird manuell abgebrochen.

2. Klicken Sie auf einen oder mehrere Benutzer in der Liste, um sie auszuwählen.

   Nur Benutzer mit ausreichend Berechtigungen für den Robot können ausgewählt werden.

3. Klicken Sie unten auf der Seite auf Weiter.

Einstellungen prüfen und die Aufgabe finalisieren

1. Prüfen Sie die Einstellungen, die Sie für die Aufgabe konfiguriert haben.
2. Optional. Um eine Einstellung zu aktualisieren, klicken Sie auf und nehmen Sie die erforderlichen Änderungen vor.
3. Wenn die Einstellungen der Aufgabenkonfiguration Ihren Vorstellungen entsprechen, klicken Sie auf Aufgabe bestätigen und erstellen.

   Ergebnis Die Aufgabe wird mit den von Ihnen festgelegten Einstellungen erstellt. Die Aufgabe wird beim ersten geplanten Vorkommen ausgeführt.