Aller au contenu
Vérifié

Workflow

Le langage d'étapes partagé, intégré à chaque programme et à chaque élément : un tableau ordonné d'actions.

Un workflow n'est pas un type de programme à part entière : c'est la primitive de logique intégrée à tous les autres. Les événements d'un composant, les changements de champ, les clics de bouton, le on_load d'un programme, tous portent la même chose : un tableau ordonné d'étapes, chacune nommant une action à exécuter. Apprenez cette forme une fois et c'est la même partout dans Xuda.

Où apparaissent les workflows

progEvents[*].workflow sur n'importe quel programme, le tableau workflow propre à un champ (gestionnaires de changement et de saisie), l'attribut xu-on:<event> d'un élément, et imbriqués dans des actions comme call_library ou invoke_action.

Forme d'une étape

Catalogue d'actions

Toutes les actions que data.action peut nommer, avec les actions héritées qu'il rejette désormais marquées comme obsolètes :

Les actions obsolètes sont des erreurs bloquantes

Une ligne obsolète ci-dessus (alter_ui_element, create_ui_element, info_ui_element, remove_ui_element, empty_ui_element, cache_ui_element, load_ui_element) échoue aujourd'hui au vérificateur. Pilotez les changements d'interface via des champs plus xu-exp / xu-render plutôt que par une manipulation impérative des éléments.

Porteurs de valeur de paramètre

Chaque entrée sous data.name.parameters a l'une de deux formes : { "value": <literal> } pour une valeur statique, ou { "fx": "@expression" } pour une expression. outputField (sur set_data et batch) nomme un champ de l'appelant qui reçoit le résultat.

Exemple concret

Une action par étape

Chaque entrée du tableau est une action ; l'ordre est l'ordre d'exécution.

Conditionnez une étape

props.condition, une expression : si elle est fausse, l'étape est sautée silencieusement, sans erreur.

Lancer et oublier

props.async: true sur une étape comme call_external_api laisse les étapes suivantes s'exécuter sans l'attendre : le bon choix pour du travail en arrière-plan, le mauvais quand une étape suivante a besoin de son résultat.

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 regroupe les étapes dans un bloc nommé sous <actions> et le relie à un élément avec @click="<name>", le raccourci d'un gestionnaire xu-on:click dont le workflow est ce bloc.

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