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
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.
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.