Scheduler
Binnen de Spider is het mogelijk om taken vooruit te plannen (Scheduled requests). Dit zijn taken die op een bepaalde datum lopen en dagelijks, wekelijks of maandelijks worden herhaald. De taken maken deel uit van een proces dat één of meer processtappen bevat.
Overzicht
Navigeer naar More > Scheduler > Scheduled Requests.
Taak Configuratie
De overzichtspagina toont de Geplande configuraties en in het tweede tabblad de daadwerkelijk geplande verzoeken.
Toevoegen taak
Klik op Add new om een nieuwe taak in te plannen
Proces Informatie
- Name: Geef een duidelijke naam op voor de taak
- Process: Selecteer het proces voor deze taak
-
ProcessStep: Als de taak vanaf een bepaalde processstep mag/moet starten.
-
ParentID: (optioneel) Als je een referentie wil maken naar een vorige request, kun je dat Id hier invullen.
- Body: Als een taak afhankelijk is van inhoud dan wordt die hier toegevoegd. Dit kan variëren van een string tot een JSON of XML body.
Info
Voorbeeld: Stel dat een verzoek fout is gegaan en deze volgende week pas opnieuw aangeboden mag worden. Dan kan hiervan een (éénmalige) geplande taak gemaakt worden. De variabelen kunnen uit het vorige verzoek meegenomen worden en het ParentID als referentie gebruikt worden.
Variabelen
Vanaf versie 1.8.0 kun je variabelen meegeven in het verzoek. Met name als de taak vanaf een tweede processtep moet draaien kan het makkelijk zijn om variabelen mee te sturen.
Een variabele bestaat uit een key en value. Klik op Add new variable om er één of meerdere toe te voegen.
Klik vervolgens in het key en Value veld om de variabelen te wijzen. Een Enter bevestigd de keuze.
Op dezelfde manier kan de variable ook verwijdert worden door op Remove selected variable te klikken.
Timing
Vul hier de begin- en eindtijd in. Hoewel er geen controle is op de eindtijd, moet deze wel gevuld zijn. Dus 15min later dan de start-tijd is prima.
Een voorbeeld van een geplande taak die start vanaf de tweede processstap met de benodigde variabelen van de eerste stap en het parentId als referentie naar het oorspronkelijke verzoek.
Terugkeer patroon
Drie types kunnen gekozen worden
Dagelijks
Wekelijks
Maandelijks
Terugkeerpatroon
- Start date : Vul de eerste datum in vanaf wanneer het verzoek mag beginnen.
- End date : De einddatum van de taak. Als deze taak de hele maand elke dag moet worden uitgevoerd, kan de einddatum hier worden ingevuld. OF
- Ends after: x aantal keren. Hoe vaak moet dit verzoek worden herhaald?
Klik op Save. De geplande taak is aangemaakt.
Geplande verzoeken
De manier om te controleren welke verzoeken tot de Scheduler behoren is door te klikken op de ScheduleConfigurationId.
Je wordt automatisch doorgestuurd naar de Scheduled requests tab.
Zoals je in het overzicht kunt zien, is de taak voor meerdere dagen gepland en dit is vastgelegd op één ScheduleConfigurationId. Deze taak is dus aan de Spider toegevoegd als een batchverzoek (terugkerende) taak.
zoekfilters
In het eerste en tweede tabblad kan je de filteropties gebruiken.
Op de tweede tab Scheduled requests kan je filteren op een Configuratie taak en/of het onderwerp (Procesnaam)
Je kan ook de verzoeken controleren die voor vandaag, morgen, enz. gepland zijn.
Bewerken planning
Tip
Om een taak te wijzigen dien je rekening te houden met het volgende:
- Als een taak meerdere taken aanmaakt (batch) dan zullen al deze taken op Mislukt worden gezet en nieuwe taken zullen in hun plaats worden aangemaakt.
- Als er Mt Informatie aan dit proces is gekoppeld dan zullen de gewijzigde (mislukte) taken ten onrechte als fout gemarkeerd worden in het proces. Om dit te voorkomen kunnen de oude verzoeken een andere status (RFC) krijgen.
Meer informatie hierover: Changed Requests
Klik op het potlood icoontje om de planning te bewerken.
Verwijderen planning
Een taak kan verwijderd worden. Klik op het delete icoontje. Een popup verschijnt. Vanaf versie 1.7.0 dient er nu een opmerking opgegeven te worden. De onderliggende requests gaan hierna automatisch naar de status RFC (Request Failed Changed) en worden niet meer als fout gemarkeerd.
De planning wordt verwijderd. In de tweede tab kan nog steeds achterhaald worden welke requests bij deze planning hoorden en welke status ze hebben.
Zoals je hieronder kunt zien zijn alle geplande verzoeken (sinds versie 1.7.0) gemarkeerd als Request Failed Changed. De verzoeken die al verwerkt zijn, worden niet aangepast.
De verwijderde requests zijn ook terug te vinden in Requests > Changed
Voorbeelden
In de voorbeelden gaan we er even van uit dat de taak:
- Vanaf 08:00 AM mag de robot een taak oppakken. We moeten wel de eindtijd invullen, maar daar wordt niet op gecontroleerd.
- Name: ImportUrenSheets
- Process: Hours Processing
| Informatie | Waarde |
|---|---|
| Name | ImportUrenSheets |
| Process | Urenververwerking |
| Body | string |
| Timing | Waarde |
|---|---|
| Start time | 08:00 |
| End Time | 08:15 |
UseCase 1
Deze taak moet elke dag worden opgepakt, maar mag maximaal 8 keer worden gerouleerd. Deze taak mag morgen worden opgehaald.
| Return Pattern | Waarde |
|---|---|
| Daily | |
| Every | 1 DAYS |
| Return Pattern Range | Waarde |
|---|---|
| Start Date | 03-02-2022 |
| Ends After | 8 Times |
De taak wordt automatisch ingepland voor de komende 8 dagen.
UseCase 2
Deze mag één keer lopen. Volgende maand op woensdag.
| Terugkeerpatroon | Waarde 1 | Waarde 2 |
|---|---|---|
| Dagelijks | ||
| Elke | 1 DAYS |
| Terugkeerpatroon bereik | Waarde |
|---|---|
| Start Date | 02-03-2022 |
| Ends After | 1 Times |
De taak is gepland voor de volgende maand op woensdag.
UseCase 3
Deze taak moet elke 1e dag van de maand worden uitgevoerd, voor de komende 3 maanden.
| Terugkeerpatroon | Waarde | Waarde 2 |
|---|---|---|
| Monthly | ||
| Day | 1 | Of each 1 Months |
| Terugkeerpatroon bereik | Waarde |
|---|---|
| Start Date | 02-03-2022 |
| Ends After | 3 Times |
De taak wordt automatisch ingepland voor de komende 3 maanden.
UseCase 4
Deze taak moet wekelijks op donderdag worden uitgevoerd. De einddatum van de taak is 1 juni van dit jaar. De taak zal dan voor de laatste keer worden gepland op 26 mei.
| Terugkeerpatroon | Waarde | Waarde 2 |
|---|---|---|
| Weekly | ||
| Every | 1 Weeks | On Thursday |
| Terugkeerpatroon bereik | Waarde |
|---|---|
| Start Date | 02-03-2022 |
| Ends After | 3 Times |
De taak zal elke week worden gepland tot 26 mei.
Aanpassen geplande taak
We gaan de taak wijzigen die we gemaakt hebben in UseCase 1. In plaats van elke dag, willen we het alleen op weekdagen laten lopen.
Dit kan op 2 manieren gedaan worden.
- Controle van de Todo verzoeken voor de 2 taken die op zaterdag en zondag zouden lopen en ze verwijderen.
Je wil echter dat de taak 8 keer wordt uitgevoerd, alleen op weekdagen. De andere 2 taken kunnen apart worden ingepland, of je kunt de hoofdtaak aanpassen.
Verwijderen taak
Het kan ook gebeuren dat van de hele partij alleen de taak van, zeg, morgen niet opgehaald hoeft te worden. U hoeft dan niet de hoofdtaak te veranderen, maar kunt dit oplossen door de taak te "laten vallen
Navigeer naar Requests > Todo en "drop" de taak. Bevestig de popup.
Om de taak niet mee te laten tellen bij de Mtinfo als mislukte verwerking (omdat de taak niet is opgepakt), ga je naar Information > More > Change requests > Failed Requests. Wijzig daar het request, voeg een opmerking toe en sla deze op.
De taak wordt niet langer gezien als een foutief verzoek, maar als Changed request. Deze worden niet meegeteld in de Mtinfo.
Navigeer naar Requests > Changed om het aangepaste verzoek terug te vinden.
Als voorbeeld gebruiken we de taak in UseCase 2.
Navigeer naar More > Scheduler > Maintain.
Klik nu op de ScheduleConfiguration Id voor de taak. U zult dan automatisch zien welke onderliggende taken er voor dit schema bestaan. Onthoud het ScheduleConfigurationId.
We zien nu de taak die in dit schema is aangemaakt. Een RequestId is automatisch aangemaakt voor de taak. Je ziet dat deze is gekoppeld aan ScheduleConfigurationId 5.
Navigeer naar More > Scheduler > Maintain. Klik nu op het kruisje naast de taak.
Een waarschuwings popup verschijnt. Klik op Ok om te bevestigen.
We zien het bericht rechtsboven dat het gelukt is.
a
De planning is nu verwijderd. Het onderliggende verzoek is verplaatst naar Change Requests en we gaan deze aanpassen. Dit is omdat we niet willen dat deze taak zichtbaar is in de MtInfo als deze niet is uitgevoerd en dus niet fout is.
Navigeer naar More > Change Requests > Failed Requests.
Klik nu op het potlood icoon achter de betreffende taak om een opmerking toe te voegen.
Voer een duidelijke opmerking in en klik op Save.
De taak is dan niet meer zichtbaar in het overzicht. Deze wordt verplaatst naar Gewijzigde Verzoeken (Changed requests.) navigeer naar Requests > Changed om het verzoek terug te vinden.
Op die manier kunnen alle taken die onder de hoofdtaak vielen, worden gewijzigd.