Vai al contenuto
Verificata

Workflow

Il linguaggio a passi condiviso, incorporato in ogni programma e in ogni elemento, un array ordinato di azioni.

Un workflow non è un tipo di programma a sé, è la primitiva logica incorporata in tutti gli altri. Eventi dei componenti, modifiche dei campi, clic sui pulsanti, l'on_load di un programma: tutti portano la stessa cosa, un array ordinato di passi, ciascuno con una sola azione da eseguire. Impara questa forma una volta e sarà la stessa ovunque in Xuda.

Dove compaiono i workflow

progEvents[*].workflow su qualsiasi programma, l'array workflow di un campo (gestori di change e input), l'attributo xu-on:<event> di un elemento e annidati dentro azioni come call_library o invoke_action.

Forma di un passo

Catalogo delle azioni

Ogni azione che data.action può nominare, con le azioni legacy che ora rifiuta contrassegnate come deprecate:

Le azioni deprecate sono errori bloccanti

Una riga deprecata qui sopra (alter_ui_element, create_ui_element, info_ui_element, remove_ui_element, empty_ui_element, cache_ui_element, load_ui_element) oggi fa fallire il controllo. Gestisci le modifiche all'interfaccia tramite i campi più xu-exp / xu-render invece di manipolare gli elementi in modo imperativo.

Contenitori dei valori dei parametri

Ogni voce sotto data.name.parameters ha una di due forme: { "value": <literal> } per un valore statico, oppure { "fx": "@expression" } per un'espressione. outputField (su set_data e batch) indica un campo del chiamante che riceve il risultato.

Esempio pratico

Un'azione per passo

Ogni voce dell'array è un'azione; l'ordine è l'ordine di esecuzione.

Condiziona un passo

props.condition, un'espressione: se è falsa il passo viene saltato in silenzio, senza errori.

Avvia e dimentica

props.async: true su un passo come call_external_api permette ai passi successivi di essere eseguiti senza attenderlo: la scelta giusta per il lavoro in background, quella sbagliata quando un passo successivo ha bisogno del suo risultato.

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>

.xu raggruppa i passi in un blocco con nome sotto <actions> e lo collega a un elemento con @click="<name>", la scorciatoia per un gestore xu-on:click il cui workflow è quel blocco.

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 } }
]