Sari la conținut
Verificat

Batch

Un program apelabil care orchestrează mai mulți pași, o procedură în mai multe părți cu un singur id prin care o apelezi.

Un program Batch orchestrează mai mulți pași ca o singură operațiune apelabilă. Oriunde o procedură ar fi altfel copiată în mai multe Componente, o salvare în mai mulți pași, o buclă peste înregistrări, o secvență de apeluri API, un Batch îi dă un singur nume și un singur id. Din punctul de vedere al apelantului, arată exact ca un program Get Data sau Set Data: îl apelezi cu acțiunea batch, trimiți parametri și primești un rezultat.

Proprietăți

progFields

Parametrii unui Batch urmează forma comună (data.field_id, data.type: "virtual", props.fieldType) și sunt referiți în fluxul de lucru al Batch-ului ca @field_id.

progEvents și corpul fluxului de lucru

Spre deosebire de un Table sau un Alert, logica reală a unui Batch nu este un array de nivel superior, ci se află în progEvents, aproape întotdeauna în evenimentul on_load, al cărui array workflow este corpul Batch-ului:

Un pas din acest flux de lucru poate fi orice acțiune din catalogul Workflow: get_data, set_data, call_native_javascript, call_project_api, call_external_api, delay, update, raise_event, un apel batch imbricat și altele. Fiecare pas poate avea props.condition ca să fie condiționat sau props.async: true ca să fie pornit fără a se aștepta după el.

Apelarea unui Batch

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

Exemplu lucrat

Declară parametrii

progParams pentru tot ce are nevoie Batch-ul de la apelant, reflectați în progFields.

Construiește corpul pe on_load

Adaugă pași în fluxul de lucru al evenimentului on_load: un get_data pentru citire, un calcul, un set_data pentru a scrie înapoi.

Apelează-l ca orice alt program

Acțiunea batch, cu name.prog setat la id-ul acestui Batch, iar rezultatele sunt accesibile prin câmpurile apelantului.

Creează un nod Batch sub Programe, declară parametrii în fila Proprietăți, apoi construiește secvența de pași în editorul Events → on_load → Workflow, același editor de flux de lucru pe care îl folosește orice alt 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>

Un Batch legat direct de un datasource își rulează pașii before_record / after_record o dată pentru fiecare rând potrivit, forma iterativă a unității.

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": {} }
      ]
    }
  ]
}