Saltar para o conteúdo
Verificado

Fluxo de trabalho

A linguagem de passos partilhada incorporada em todos os programas e em todos os elementos, um array ordenado de ações.

Um fluxo de trabalho não é um tipo de programa por si só, é a primitiva de lógica incorporada dentro de todos os outros. Eventos de componentes, alterações de campos, cliques em botões, o on_load de um programa, todos eles transportam a mesma coisa: um array ordenado de passos, cada um com o nome de uma ação a executar. Aprenda esta forma uma vez e é a mesma forma em todo o lado na Xuda.

Onde aparecem os fluxos de trabalho

progEvents[*].workflow em qualquer programa, o próprio array workflow de um campo (handlers de alteração e de entrada), o atributo xu-on:<event> de um elemento e aninhados dentro de ações como call_library ou invoke_action.

Forma de um passo

Catálogo de ações

Todas as ações que data.action pode indicar, com as ações antigas que agora rejeita marcadas como obsoletas:

As ações obsoletas são erros definitivos

Uma linha obsoleta acima (alter_ui_element, create_ui_element, info_ui_element, remove_ui_element, empty_ui_element, cache_ui_element, load_ui_element) falha hoje o verificador. Conduza as alterações de interface através de campos mais xu-exp / xu-render em vez de manipulação imperativa de elementos.

Suportes de valores de parâmetros

Cada entrada em data.name.parameters tem uma de duas formas: { "value": <literal> } para um valor estático, ou { "fx": "@expression" } para uma expressão. outputField (em set_data e batch) indica um campo de quem chama que recebe o resultado.

Exemplo prático

Uma ação por passo

Cada entrada do array é uma ação; a ordem é a ordem de execução.

Condicione um passo

props.condition, uma expressão, se for falsa o passo é ignorado silenciosamente, sem erro.

Disparar e esquecer

props.async: true num passo como call_external_api permite que os passos seguintes corram sem esperar por ele, a escolha certa para trabalho em segundo plano, a errada quando um passo posterior precisa do seu resultado.

xml
<actions lang="json5">
{
  signIn: [
    { action: "update", name: { value: "@is_logged_in_v: true" } },
    { action: "update", name: { value: "@active_view_v: 'overview'" } }
  ]
}
</actions>

<template>
  <button type="button" @click="signIn">Enter dashboard</button>
</template>

O .xu agrupa passos num bloco nomeado em <actions> e liga-o a um elemento com @click="<name>", a abreviatura de um handler xu-on:click cujo fluxo de trabalho é esse bloco.

json
[
  { "id": "1", "data": { "action": "get_data", "name": { "prog": "97a_gtd_…", "parameters": { "doc_in": { "value": "345" } } }, "enabled": true }, "props": {} },
  {
    "id": "2", "data": { "action": "alert", "name": { "alertDisplay": "modal", "alertType": "error", "alertTitle": "File not found", "alertBody": "the file \"document\" not found", "createLog": true }, "enabled": true },
    "props": { "condition": "@user_id===\"222\"" }
  },
  { "id": "3", "data": { "action": "call_external_api", "name": { "url": "https://stocks.example.com", "method": "GET" }, "enabled": true }, "props": { "async": true } }
]