Automatisch verwijderen van oude taakuitvoeringen (robottaken)

Drie vooraf gebouwde Python/HCL-scripts zijn beschikbaar waarmee u het proces van het verwijderen van oude taakuitvoeringen in Robots kunt automatiseren. Als u een of meer robots hebt die regelmatig worden uitgevoerd, kan het aantal opgeslagen taakuitvoeringen snel oplopen. Voor organisaties die een on-premise Robots Agent gebruiken, kan een opeenhoping van oude taakuitvoeringen met bijbehorende resultaatgegevens ertoe leiden dat uw server geen ruimte meer heeft. Het automatisch verwijderen van oude taakuitvoeringen bespaart u de moeite om ze steeds handmatig te moeten verwijderen. Bovendien bespaart het serverruimte en houdt het de Robots-interface vrij van overbodige gegevens.

Opmerking

In sommige delen van de Robots-interface en in de vooraf gebouwde scripts worden taakuitvoeringen "jobs" genoemd. Een taakuitvoering en een robotklus zijn hetzelfde. Ze zijn één enkele uitvoering, of run, van een robottaak.

Let op

Controleer zorgvuldig de invoerwaarden die u hebt opgegeven voordat u een van de vooraf gebouwde verwijderingsscripts uitvoert. Zorg ervoor dat de waarden geschikt zijn voor de Robots-gegevens van uw organisatie. U kunt per ongeluk huidige gegevens verwijderen als u een fout maakt bij het specificeren van invoerwaarden.

Verwijderingen zijn definitief en kunnen niet ongedaan worden gemaakt.

Houd er rekening mee dat twee van de scripts in aanmerking komende taakuitvoeringen verwijderen uit zowel de productiemodus als de ontwikkelmodus. De modus waarin u het script uitvoert, heeft geen invloed op dit gedrag.

Diligent One-accountvereiste

De vooraf gebouwde scripts vereisen een Diligent One-toegangstoken als een van de scriptinvoerparameters. Om taakuitvoeringen te verwijderen, moet het Diligent One-gebruikersaccount dat aan het token is gekoppeld, de rol van Eigenaar of Bewerker hebben voor de doelrobot.

Raadpleeg Diligent One-toegangstokens aanmaken en beheren en Machtigingen Robots-app voor meer informatie.

Hoe de vooraf gebouwde verwijderingsscripts werken

U downloadt een of meer verwijderingsscripts via de onderstaande links en uploadt vervolgens elk script naar een eigen specifieke HighBond-robot. (Eén script per robot.) In de robot maakt u een taak om het verwijderingsscript te configureren en te plannen. U kunt via configureerbare scriptparameters opgeven welke taakuitvoeringen verwijderd moeten worden.

Verwijderingsrobots en doelrobots

Beschouw de robot die een verwijderingsscript bevat als de verwijderingsrobot. De taak die u gebruikt om het verwijderingsscript te configureren en te plannen is de verwijderingstaak. U gebruikt de verwijderingsrobot en de verwijderingstaak om oude taakuitvoeringen in een andere robot te verwijderen. Beschouw de andere robot als de doelrobot. Als u verwijderingen beperkt tot een specifieke taak in de doelrobot, beschouw de taak dan als de doeltaak.

U kunt zoveel verwijderingsrobots of verwijderingstaken aanmaken als u nodig hebt. Het belangrijkste om te begrijpen is dat u een verwijderingsscript in één robot opzet en het gebruikt om oude taakuitvoeringen in een andere robot te verwijderen.

Verwijderingsscripts werken voor elk type robot

Hoewel de verwijderingsscripts zijn geschreven in Python/HCL en zich bevinden in HighBond-robots, kunt u ze gebruiken om oude taakuitvoeringen van elk robottype te verwijderen, inclusief ACL-robots. U hoeft geen kennis van Python/HCL te hebben om de verwijderingsscripts te gebruiken. Hieronder vindt u stapsgewijze instructies voor het instellen van de verwijderingsscripts.

HCL HighBond API-methoden en de HighBond API

De verwijderingsscripts gebruiken HCL HighBond API-methoden en de HighBond API om taakuitvoeringen op te halen en te verwijderen. Als u Python/HCL kent, kunt u indien nodig het gedrag van de verwijderingsscripts aanpassen. For more information, see HCL HighBond API-methodes and the HighBond API Reference.

Verwijdering van taakuitvoeringsgegevens

Het verwijderen van een taakuitvoering verwijdert alleen de resultaatgegevens die bij de uitvoering horen:

  • Resultatentabellen

  • Resultatenbestanden

  • Resultatenlogboeken

De tijdens de uitvoering van een taak gegenereerde analytics-gegevenstabellen of Python/HCL-werkbestanden worden niet verwijderd. Die tabellen en bestanden worden bewaard in het tabblad Invoer/uitvoer (ACL-robots) of het tabblad Werkgegevens (HighBond- of Workflow-robots), en kunnen indien nodig individueel uit die locaties worden verwijderd. Voor meer informatie raadpleegt u Het beheren van werkgegevens opgeslagen in een robot.

Oude taakuitvoeringen voor het eerst automatisch verwijderen

Wees voorzichtig bij het voor de eerste keer verwijderen van oude taakuitvoeringen. Als u een groot aantal oude taakuitvoeringen hebt, met grote hoeveelheden bijbehorende resultaatgegevens, kan het proberen alles in één keer te verwijderen uw server vertragen. Gebruik een van de hieronder beschreven strategieën om de oude taakuitvoeringen in batches te verwijderen.

Bekijk het aantal en de datumreeks van voorgaande taakuitvoeringen

Gebruik de Taakuitvoeringen globale weergave om de hoeveelheid en datumbereik van oude taakuitvoeringen te achterhalen. Gebruik deze informatie bij het bepalen van de waarden die u als invoerparameters voor verwijderingsscripts wilt gebruiken.

In de globale weergave Taakuitvoeringen:

  • Werk het filter Geactiveerd op bij naar een geschikte tijdsduur. Het filter staat aanvankelijk standaard op de laatste 10 dagen, wat een datumbereik creëert dat waarschijnlijk te kort is voor uw behoeften.

  • Gebruik het filter Robotnaam of het filter Taaknaam om taakuitvoeringen voor de doelrobot of de doeltaak te isoleren. Het Taakuitvoeringen per status paneel toont het totale aantal taakuitvoeringen voor de robot of de taak.

  • In de Taakuitvoeringen-tabel, sorteer de kolom Voltooid op zo dat de oudste taakuitvoering bovenaan staat.

Voor meer informatie raadpleegt u Robottaken en taakuitvoeringen bekijken.

Voer de verwijderingstaak handmatig uit

Stel aanvankelijk geen verwijderingstaak in. Configureer en voer de taak handmatig uit om oude taakuitvoeringen in batches te verwijderen. Het verwijderen van taakuitvoeringen in kleinere batches maakt het mogelijk om het proces op te splitsen in kortere segmenten, zodat u het handmatig kunt uitvoeren. Nadat u de grote achterstand van oude taakuitvoeringen heeft verwijderd, kunt u de verwijderingstaak plannen om automatisch uit te voeren.

Taakuitvoeringen per maand verwijderen

Als u oude taakuitvoeringen verwijdert op basis van datum, stel dan de datum van de vroegste taakuitvoering vast en configureer een verwijderingsdatum die een maand na de vroegste datum ligt. Voer de verwijderingstaak handmatig herhaaldelijk uit en verschuif de verwijderingsdatum elke keer met een maand vooruit. Als het verwijderen van een maand aan taakuitvoeringen relatief snel gaat, kunt u proberen taakuitvoeringen in blokken van drie of zes maanden te verwijderen.

Taakuitvoeringen verwijderen, 50 of 100 uitvoeringen per keer

Als u oude taakuitvoeringen verwijdert op basis van het aantal uitvoeringen, stel dan het totale aantal taakuitvoeringen vast en configureer een maximum aantal taakuitvoeringen dat 50 of 100 uitvoeringen minder is dan het totale aantal. Voer de verwijderingstaak handmatig herhaaldelijk uit en verminder het maximale aantal telkens met 50 of 100. Als het verwijderen van 50 of 100 taakuitvoeringen relatief snel gaat, kunt u proberen taakuitvoeringen in grotere blokken te verwijderen.

Taakuitvoeringen één voor één verwijderen

Als u een of meer robots hebt die meerdere taken bevatten, verwijder dan de taakuitvoeringen één taak tegelijk, in plaats van voor een hele robot in één keer.

Maak een verwijderingsscript

Volg dit proces om een verwijderingsscript in te stellen dat automatisch oude taakuitvoeringen verwijdert:

  1. Download een of meer verwijderingsscripts

  2. Een verwijderrobot maken

  3. Een verwijderingstaak aanmaken en inplannen in de verwijderingsrobot

Locatie van de verwijderingstaak

U kunt de verwijderingstaak maken in zowel productiemodus als ontwikkelingsmodus. De verwijderingsscripts werken over de grens tussen de twee modi heen, zodat u de verwijderingstaak en het script kunt plaatsen in de modus die u het beste uitkomt.

Als u de verwijderingstaak in productiemodus maakt, moet u eerst het verwijderingsscript van ontwikkelingsmodus naar productiemodus activeren. Voor meer informatie raadpleegt u Een scriptversie activeren.

Twee van de verwijderingsscripts verwijderen in aanmerking komende taakuitvoeringen uit zowel de productiemodus als de ontwikkelingsmodus:

  • HB-robot - Taken ouder dan een bepaald aantal dagen uit robot.json verwijderen

  • HB-robot - Houd een aantal taken uit robot.json

Het derde verwijderingsscript verwijdert in aanmerking komende taakuitvoeringen uit de modus (productie of ontwikkeling) waarin de doeltaak zich bevindt:

  • HB-robot - Verwijder taken die ouder zijn dan een bepaald aantal dagen uit task.json

In het geval van het derde verwijderingsscript hoeft u de verwijderingstaak niet in dezelfde modus te lokaliseren als de doeltaak. Het zou echter gemakkelijker kunnen zijn om verwijderingstaken en doeltaken duidelijk georganiseerd te houden.

Het vinden van unieke identificatoren voor robots en taken

Alle drie de scripts vereisen de unieke identificator van de doelrobot als invoerparameter. De taak-niveau verwijderingsscript vereist ook de unieke identificator van de doeltaak. Navigeer in Robots naar de betreffende robot of taak en haal de unieke identificator op uit de URL in de adresbalk van de browser.

Opmerking

De Unieke identificator wordt ook weergegeven in de zijpanelen Robotdetails en Taakdetails in de gebruikersinterface voor robots. De Robot-ID en de Taak-ID die in de zijpanelen worden weergegeven zijn niet de invoerwaarden die vereist zijn voor de verwijderingsscripts.

Unieke robotidentificator

In de URL volgt de unieke robot-id direct op het productie- of ontwikkelings-segment in het pad. Dus in de twee onderstaande voorbeelden is de unieke identificator van de robot 63034.

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

Unieke taakidentificator

In de URL volgt de unieke identificator van de taak onmiddellijk na het taken-segment in het pad. Dus in de twee voorbeelden hieronder is de unieke taakidentificator 57275 in het eerste voorbeeld, en 54731 in het tweede voorbeeld.

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

Download een of meer verwijderingsscripts

Download een of meer van de verwijderingsscripts die hieronder gelinkt zijn. Kies het script dat het beste bij uw behoeften past. Indien nodig kunt u meerdere verwijderingsscripts instellen met verschillende configuratie-instellingen.

  1. Klik met de rechtermuisknop op een van de onderstaande koppelingen en selecteer Link opslaan als.

    Script-koppeling Standaardscriptbeschrijving

    HB-robot - Verwijder taken die ouder zijn dan een bepaald aantal dagen uit task.json

    Verwijdert taakuitvoeringen (jobs) die ouder zijn dan een opgegeven aantal dagen uit een taak.

    Verwijdert in aanmerking komende taakuitvoeringen uit de modus (productie of ontwikkeling) waarin de doeltaak zich bevindt.

    HB-robot - Taken ouder dan een bepaald aantal dagen uit robot.json verwijderen

    Verwijdert taakuitvoeringen (taken) die ouder zijn dan een opgegeven aantal dagen uit alle taken in een robot.

    Verwijdert in aanmerking komende taakuitvoeringen uit zowel de productiemodus als de ontwikkelingsmodus.

    HB-robot - Houd een aantal taken uit robot.json

    Verwijdert taakuitvoeringen (jobs) die groter zijn dan een opgegeven aantal uitvoeringen van alle taken in een robot. Begint met de oudste taakuitvoering.

    Verwijdert in aanmerking komende taakuitvoeringen uit zowel de productiemodus als de ontwikkelingsmodus.

  2. Sla het verwijderingsscript op in de Downloads-map of een andere map op uw computer.

    Het verwijderingsscript wordt gedownload als een JSON-bestand (*.json).

Een verwijderrobot maken

Volg het standaardproces voor het maken van een HighBond-robot en upload een enkel verwijderingsscript vanaf uw computer naar de robot. Maak een extra HighBond-robot voor elk extra verwijderingsscript dat u wilt gebruiken.

Tip

In een enkele verwijderingsrobot kunt u meerdere verwijderingstaken maken om hetzelfde verwijderingsscript uit te voeren tegen verschillende doelrobots of verschillende doeltaken.

De robot maken

  1. Selecteer vanaf de startpagina van Launchpad (www.highbond.com) de Robots-app om deze te openen.

    Als u zich reeds in Diligent One bevindt, kunt u het navigatiemenu aan de linkerkant gebruiken om naar de Robots-app te switchen.

  2. Selecteer in het dashboard in Robots het tabblad HighBond-robots.
  3. Als u de robot in een map wilt maken, klikt u op de map om deze te openen.

    Voor informatie over het maken van mappen, zie Een robotmap maken en beheren.

  4. Klik op Een HighBond-robot maken.
  5. Selecteer een pictogram en voer een naam in voor de robot.

    Tip

    U kunt pictogrammen gebruiken om robots te ordenen in gemakkelijk herkenbare groepen.

    Opmerking

    Gebruik nergens in de robotnaam valutasymbolen, bijvoorbeeld: $ , .

  6. Optioneel. In het veld Beschrijving geeft u een omschrijving van de robot zodat andere gebruikers begrijpen wat de robot doet.
  7. Klik op Een HighBond-robot maken.

    Het script-bewerkingsprogramma van Robots begint met het opstartproces.

    Opmerking

    Als het bericht Kan robot niet maken verschijnt, moet u een andere naam voor de robot opgeven. Er bestaat al een andere robot met dezelfde naam.

    Als u geen medewerker bent met rechten voor de bestaande robot, is de robot niet zichtbaar voor u.

  8. In de linkerbovenhoek van de scripteditor klikt u op de naam van de robot en vervolgens op Niet vastleggen.

    U wordt naar het tabblad Scriptversies van de nieuw gemaakte robot in ontwikkelingsmodus gebracht.

Het verwijderingsscript uploaden

  1. In het tabblad Scriptversies in de nieuwe robot klikt u op Uploaden.

  2. Selecteer in het dialoogvenster dat verschijnt een verwijderingsscript van uw computer of sleep het naar het gebied Geüpload script.

    Elk verwijderingsscript staat in een JSON-bestand (*.json).

  3. Voer een Toepassingsbericht in en klik op Uploaden en toepassen.

    Het script wordt toegevoegd als de meest recente versie in het tabblad Scriptversies. Er verschijnt een melding die bevestigt dat het script succesvol is vastgelegd.

    Er verschijnt ook een melding als het uploadproces en vastleggen mislukt. Probeer opnieuw te uploaden. Als het uploaden opnieuw mislukt, probeer dan een nieuwe kopie van het verwijderingsscript te downloaden en upload de nieuwe kopie.

Een verwijderingstaak aanmaken en inplannen in de verwijderingsrobot

Volg het standaardproces voor het aanmaken en inplannen van een robottaak. U kunt de verwijderingstaak maken in zowel productiemodus als ontwikkelingsmodus. Voor meer informatie raadpleegt u Locatie van de verwijderingstaak.

Opmerking

Wanneer u de verwijderingstaak aanmaakt, moet u een HighBond-toegangstoken opgeven als een van de parameters van het verwijderingsscript. Om taakuitvoeringen te verwijderen, moet het Diligent One-gebruikersaccount dat aan het token is gekoppeld, de rol van Eigenaar of Bewerker hebben voor de doelrobot.

Raadpleeg Diligent One-toegangstokens aanmaken en beheren en Machtigingen Robots-app voor meer informatie.

Kies de modus voor de verwijderingstaak

Gebruik de knoppen Productie en Ontwikkeling in de rechterbovenhoek van de verwijderingsrobot om te schakelen naar de modus die u wilt gebruiken.

Als u de verwijderingstaak in productiemodus wilt aanmaken, moet u eerst het verwijderingsscript activeren van ontwikkelmodus naar productiemodus. Voor meer informatie raadpleegt u Een scriptversie activeren.

Maak een taak en selecteer het verwijderingsscript

  1. Klik op het tabblad Taken op Taak maken.

    De Taakdesigner wordt geopend en u kunt de taak gaan configureren.

  2. Typ een naam voor de taak en klik op Opslaan.
  3. In de Selecteer uw scripts pagina, selecteer Alles selecteren.

    Het verwijderingsscript is geselecteerd.

Voer scriptparameterwaarden en een Diligent One-toegangstoken in

Let op

Controleer de nauwkeurigheid van de scriptparameterwaarden die u invoert nogmaals. Als u een onjuiste robot- of taakidentificator invoert, zou u per ongeluk taakuitvoeringsgegevens van de verkeerde plaats kunnen verwijderen. Als u een onjuist aantal dagen of aantal uitgevoerde taken invoert, kunt u per ongeluk huidige gegevens verwijderen.

Als u 0 invoert voor het aantal dagen of het aantal taakuitvoeringen, worden alle gegevens van taakuitvoeringen verwijderd in de doelrobot of de doeltaak.

  1. Klik op het pijltje omlaag om het parameterdeel uit te vouwen en voer de waarden voor het script in.
  2. Als u andere gebruikers wilt toestaan om de verwijderingstaak uit te voeren, uit te schakelen of in te schakelen, klikt u op Wachtwoorden delen.
    • Wachtwoorden delen is ingeschakeld elke gebruiker met toegang tot de robot kan de taak uitvoeren, uitschakelen of inschakelen
    • Wachtwoorden delen is uitgeschakeld alleen u kunt de taak uitvoeren, uitschakelen of inschakelen

    Ongeacht de instelling kunnen andere gebruikers die toegang hebben tot de robot de taak bewerken om hun eigen Diligent One-toegangstoken in te voeren.

    Voor meer informatie raadpleegt u Scripts met wachtwoorden.

  3. Klik onderaan de pagina op Doorgaan.

De taak plannen

  1. Selecteer Uw taak in een planning zetten bovenaan de pagina.
  2. Specificeer de planningsdetails:
    • Frequentie het interval waarmee de taak herhaaldelijk wordt uitgevoerd
    • Beginnend om het tijdstip van de dag waarop de taak moet worden uitgevoerd en de tijdzone die moet worden gebruikt

      Gebruik uw eigen tijdzone, tenzij u wilt dat de starttijd een andere tijdzone weergeeft.

    • Beginnend op de datum waarop de taak moet worden gestart
  3. Klik onderaan de pagina op Doorgaan.

Gebruikers op de hoogte stellen als de taak niet wordt uitgevoerd

  1. Selecteer Notificaties verzenden bij mislukking om een of meer specifieke gebruikers te informeren als de taak niet wordt uitgevoerd.

    Als deze optie is ingeschakeld, wordt automatisch een melding verzonden als de taak om een van de volgende redenen niet wordt uitgevoerd:

    • Het script in de taak mislukt

    • De taak wordt overgeslagen

    • De taak is handmatig geannuleerd

  2. Klik op een of meer gebruikers in de lijst om ze te selecteren.

    Alleen gebruikers met de juiste robotrechten kunnen geselecteerd worden.

  3. Klik onderaan de pagina op Doorgaan.

Controleer de instellingen en rond de taak af

  1. Controleer de instellingen die u hebt geconfigureerd voor de taak.
  2. Optioneel. Om een instelling bij te werken, klikt u op en brengt u de vereiste wijzigingen aan.
  3. Wanneer u tevreden bent met de taakinstellingen, klikt u op Bevestigen en taak aanmaken.

    Resultaat De taak wordt gemaakt met de door u opgegeven instellingen. De taak begint te lopen bij de eerste geplande gebeurtenis.