Batch
Eén aanroepbaar programma dat meerdere stappen aanstuurt, een procedure in meerdere delen met één id om het aan te roepen.
Een Batch-programma stuurt meerdere stappen aan als één aanroepbare bewerking. Overal waar een procedure anders gekopieerd zou worden tussen Components, een opslagactie in meerdere stappen, een lus over records, een reeks API-aanroepen, geeft een Batch die één naam en één id. Vanuit de aanroeper ziet het er precies uit als een Get Data- of Set Data-programma: roep het aan met de actie batch, geef parameters mee en krijg een resultaat terug.
Eigenschappen
progFields
Batch-parameters volgen de gewone vorm (data.field_id, data.type: "virtual", props.fieldType) en worden in de workflow van de Batch aangeduid als @field_id.
progEvents en de workflow-body
In tegenstelling tot een Table of een Alert staat de eigenlijke logica van een Batch niet in een array op het hoogste niveau, maar in progEvents, bijna altijd in het event on_load, waarvan de workflow-array de body van de Batch is:
Een stap in die workflow kan elke actie uit de Workflow-catalogus zijn: get_data, set_data, call_native_javascript, call_project_api, call_external_api, delay, update, raise_event, een geneste batch-aanroep en meer. Elke stap kan props.condition hebben om hem af te schermen, of props.async: true om hem af te vuren zonder te wachten.
Een Batch aanroepen
Uitgewerkt voorbeeld
Declareer de parameters
progParams voor alles wat de Batch van de aanroeper nodig heeft, gespiegeld in progFields.
Bouw de body op on_load
Voeg stappen toe aan de workflow van het event on_load: een get_data om te lezen, een berekening, een set_data om terug te schrijven.
Roep hem aan zoals elk ander programma
De actie batch, met name.prog ingesteld op de id van deze Batch. De resultaten zijn bereikbaar via de eigen velden van de aanroeper.
Maak een Batch-node onder Programma's, declareer parameters op het tabblad Eigenschappen en bouw de stappenreeks in de editor Events → on_load → Workflow, dezelfde workflow-editor die elk ander programma gebruikt.
Een Batch die direct aan een datasource is gekoppeld, draait zijn before_record- en after_record-stappen één keer per passende rij, de iteratieve vorm van de eenheid.