Naar de inhoud springen
Geverifieerd

Workflow

De gedeelde stappentaal die in elk programma en elk element zit, een geordende array van acties.

Een workflow is geen eigen programmatype, maar het logica-bouwblok dat in elk ander type zit. Component-events, veldwijzigingen, klikken op knoppen, de on_load van een programma: ze dragen allemaal hetzelfde, een geordende array van stappen, elk met één actie om uit te voeren. Leer deze vorm één keer en je kent hem overal in Xuda.

Waar workflows voorkomen

progEvents[*].workflow in elk programma, de eigen workflow-array van een veld (change- en input-handlers), het attribuut xu-on:<event> van een element, en genest in acties als call_library of invoke_action.

Vorm van een stap

Actiecatalogus

Elke actie die data.action kan noemen, waarbij verouderde acties die nu worden afgewezen als deprecated zijn gemarkeerd:

Verouderde acties zijn harde fouten

Een verouderde rij hierboven (alter_ui_element, create_ui_element, info_ui_element, remove_ui_element, empty_ui_element, cache_ui_element, load_ui_element) laat de checker nu falen. Stuur UI-wijzigingen aan via velden plus xu-exp / xu-render in plaats van elementen direct te manipuleren.

Waardehouders voor parameters

Elk item onder data.name.parameters heeft een van twee vormen: { "value": <literal> } voor een vaste waarde, of { "fx": "@expression" } voor een expressie. outputField (bij set_data en batch) geeft een veld van de aanroeper aan dat het resultaat ontvangt.

Uitgewerkt voorbeeld

Eén actie per stap

Elk item in de array is één actie, de volgorde is de uitvoervolgorde.

Een stap afschermen

props.condition, een expressie. Bij onwaar wordt de stap stilzwijgend overgeslagen, zonder fout.

Afvuren en vergeten

Met props.async: true op een stap als call_external_api draaien latere stappen door zonder te wachten. Dat is goed voor achtergrondwerk, maar fout als een latere stap het resultaat nodig heeft.

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 groepeert stappen in een benoemd blok onder <actions> en koppelt het met @click="<name>" aan een element, de verkorte schrijfwijze voor een xu-on:click-handler waarvan de workflow dat blok is.

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