Saltar para o conteúdo
Verificado

Lote

Um programa chamável que orquestra vários passos, um procedimento em várias partes com um só id para o chamar.

Um programa Lote orquestra vários passos como uma só operação chamável. Sempre que um procedimento seria de outra forma copiado e colado em vários Componentes, uma gravação em vários passos, um ciclo sobre registos, uma sequência de chamadas de API, um Lote dá-lhe um só nome e um só id. Do lado de quem chama, parece exatamente um programa Obter Dados ou Definir Dados: chame-o com a ação batch, passe parâmetros, obtenha um resultado.

Propriedades

progFields

Os parâmetros do Lote seguem a forma comum (data.field_id, data.type: "virtual", props.fieldType), referenciados dentro do fluxo de trabalho do Lote como @field_id.

progEvents e o corpo do fluxo de trabalho

Ao contrário de uma Tabela ou de um Alerta, a lógica real de um Lote não é um array de nível superior, vive dentro de progEvents, quase sempre o evento on_load, cujo array workflow é o corpo do Lote:

Um passo dentro desse fluxo de trabalho pode ser qualquer ação do catálogo de Fluxo de trabalho: get_data, set_data, call_native_javascript, call_project_api, call_external_api, delay, update, raise_event, uma chamada batch aninhada e mais. Cada passo pode levar props.condition para o condicionar, ou props.async: true para o disparar sem esperar.

Chamar um Lote

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

Exemplo prático

Declare os parâmetros

progParams para tudo o que o Lote precisa de quem o chama, espelhado em progFields.

Construa o corpo em on_load

Adicione passos ao fluxo de trabalho do evento on_load: um get_data para ler, um cálculo, um set_data para escrever de volta.

Chame-o como qualquer outro programa

Ação batch, name.prog definido para o id deste Lote, resultados acessíveis através dos próprios campos de quem chama.

Crie um nó Lote em Programas, declare parâmetros no seu separador Propriedades e depois construa a sequência de passos no editor Eventos → on_load → Fluxo de trabalho, o mesmo editor de fluxos de trabalho que todos os outros programas utilizam.

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>

Um Lote associado diretamente a uma fonte de dados executa os seus passos before_record / after_record uma vez por cada linha correspondente, a forma iterativa da unidade.

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