Preskočiť na obsah
Overené

Batch

Jeden volateľný program, ktorý riadi niekoľko krokov, viacdielny postup s jedným id, pod ktorým ho zavoláte.

Program Batch riadi niekoľko krokov ako jednu volateľnú operáciu. Všade tam, kde by sa postup inak kopíroval medzi komponentmi, pri viackrokovom ukladaní, cykle cez záznamy alebo sekvencii volaní API, mu Batch dá jeden názov a jedno id. Z pohľadu volajúceho vyzerá presne ako program Get Data alebo Set Data: zavoláte ho akciou batch, odovzdáte parametre a dostanete výsledok.

Vlastnosti

progFields

Parametre Batchu majú spoločný tvar (data.field_id, data.type: "virtual", props.fieldType) a vo workflow Batchu sa odkazuje na ne ako @field_id.

progEvents a telo workflow

Na rozdiel od tabuľky alebo upozornenia nie je skutočná logika Batchu pole na najvyššej úrovni, nachádza sa v progEvents, takmer vždy v udalosti on_load, ktorej pole workflow je telom Batchu:

Krokom v tomto workflow môže byť ľubovoľná akcia z katalógu Workflow: get_data, set_data, call_native_javascript, call_project_api, call_external_api, delay, update, raise_event, vnorené volanie batch a ďalšie. Každý krok môže mať props.condition, ktorá ho podmieňuje, alebo props.async: true, ktoré ho spustí bez čakania.

Volanie Batchu

json
{
  "id": "1", "data": {
    "action": "batch",
    "name": { "prog": "5b1_bth_…", "properties": {}, "parameters": { "class_id": { "fx": "@glb_class_id" } } },
    "enabled": true
  }, "props": {}
}

Ukážkový príklad

Deklarujte parametre

progParams pre všetko, čo Batch potrebuje od volajúceho, zrkadlené do progFields.

Zostavte telo v on_load

Pridajte kroky do workflow udalosti on_load: get_data na čítanie, výpočet, set_data na zápis späť.

Zavolajte ho ako každý iný program

Akcia batch, name.prog nastavené na id tohto Batchu, výsledky sú dostupné cez polia volajúceho.

Vytvorte uzol Batch v časti Programy, parametre deklarujte na karte Vlastnosti a postupnosť krokov zostavte v editore Events → on_load → Workflow, rovnakom editore workflow, aký používa každý iný program.

xml
<meta lang="json5">
{
  id: "rebuild_class_roster",
  menuTitle: "Batch Print Student Packets"
}
</meta>

<params lang="json5">
{
  in: { campus_in: "string" }
}
</params>

<datasource lang="json5">
{
  type: "table",
  table: "student_profiles_table",
  filter: {
    mode: "index",
    activeIndex: "campus_idx",
    indexes: { campus_idx: { campus: { from: "@campus_in", to: "@campus_in" } } }
  },
  limit: 50
}
</datasource>

<events lang="json5">
{
  before_record: [
    { action: "delay", name: { value: "1" } }
  ],
  after_record: [
    { action: "debug", name: { value: "Prepared one student packet for printing" } }
  ]
}
</events>

Batch viazaný priamo na zdroj dát spúšťa svoje kroky before_record / after_record raz pre každý zodpovedajúci riadok, čo je iteratívna podoba tejto jednotky.

json
{
  "properties": { "menuType": "batch", "menuName": "Rebuild Class Grades", "runAt": "server", "progParams": [] },
  "progFields": [
    { "id": "b2c3d4e5-…", "data": { "field_id": "class_id", "type": "virtual" }, "props": { "fieldType": "string" } }
  ],
  "progEvents": [
    {
      "id": "d4e5f6a7-…", "data": { "type": "on_load", "parameters": [], "condition": "" },
      "workflow": [
        { "id": "step-1", "data": { "action": "get_data", "name": { "prog": "97a_gtd_…", "parameters": { "class_id": { "fx": "@class_id" } } }, "enabled": true }, "props": {} },
        { "id": "step-2", "data": { "action": "set_data", "name": { "prog": "97a_std_…", "parameters": { "class_id": { "fx": "@class_id" } }, "outputField": "GLB_Grades" }, "enabled": true }, "props": {} }
      ]
    }
  ]
}