Saltar al contenido
Verificada

Flujo de trabajo

El lenguaje de pasos compartido incrustado en cada programa y en cada elemento, un array ordenado de acciones.

Un flujo de trabajo no es un tipo de programa propio, es la primitiva de lógica incrustada dentro de todos los demás. Los eventos de un componente, los cambios de un campo, los clics de un botón, el on_load de un programa, todos llevan lo mismo: un array ordenado de pasos, cada uno con el nombre de una acción que ejecutar. Aprende esta forma una vez y es la misma en todo Xuda.

Dónde aparecen los flujos de trabajo

progEvents[*].workflow en cualquier programa, el propio array workflow de un campo (manejadores de cambio y de entrada), el atributo xu-on:<event> de un elemento, y anidados dentro de acciones como call_library o invoke_action.

Forma de un paso

Catálogo de acciones

Todas las acciones que puede nombrar data.action, con las acciones heredadas que ahora rechaza marcadas como obsoletas:

Las acciones obsoletas son errores duros

Una fila obsoleta de arriba (alter_ui_element, create_ui_element, info_ui_element, remove_ui_element, empty_ui_element, cache_ui_element, load_ui_element) hace fallar hoy el comprobador. Gestiona los cambios de interfaz mediante campos más xu-exp / xu-render en lugar de la manipulación imperativa de elementos.

Contenedores de valores de parámetros

Cada entrada de data.name.parameters tiene una de dos formas: { "value": <literal> } para un valor estático, o { "fx": "@expression" } para una expresión. outputField (en set_data y batch) nombra un campo de quien llama que recibe el resultado.

Ejemplo práctico

Una acción por paso

Cada entrada del array es una acción; el orden es el orden de ejecución.

Condiciona un paso

props.condition, una expresión: si es falsa omite el paso en silencio, sin error.

Lanzar y olvidar

props.async: true en un paso como call_external_api permite que los pasos posteriores se ejecuten sin esperarlo, la decisión correcta para el trabajo en segundo plano, la equivocada cuando un paso posterior necesita su 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>

.xu agrupa los pasos en un bloque con nombre bajo <actions> y lo conecta a un elemento con @click="<name>", la abreviatura de un manejador xu-on:click cuyo flujo de trabajo es ese bloque.

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