Zum Inhalt springen
Geprüft

Workflow

Die gemeinsame Schrittsprache, eingebettet in jedes Programm und jedes Element, ein geordnetes Array von Aktionen.

Ein Workflow ist kein eigener Programmtyp, sondern das Logik-Primitiv, das in jedem anderen eingebettet ist. Komponentenereignisse, Feldänderungen, Schaltflächenklicks, das on_load eines Programms, alle tragen dasselbe: ein geordnetes Array von Schritten, die jeweils eine auszuführende Aktion benennen. Lerne diese Form einmal, und sie ist überall in Xuda dieselbe.

Wo Workflows vorkommen

progEvents[*].workflow bei jedem Programm, das eigene Array workflow eines Felds (Change- und Input-Handler), das Attribut xu-on:<event> eines Elements und verschachtelt in Aktionen wie call_library oder invoke_action.

Schrittform

Aktionskatalog

Jede Aktion, die data.action nennen kann, wobei die veralteten Aktionen, die jetzt abgelehnt werden, als veraltet markiert sind:

Veraltete Aktionen sind harte Fehler

Eine veraltete Zeile oben (alter_ui_element, create_ui_element, info_ui_element, remove_ui_element, empty_ui_element, cache_ui_element, load_ui_element) scheitert heute am Prüfer. Steuere UI-Änderungen stattdessen über Felder plus xu-exp / xu-render, nicht über imperative Elementmanipulation.

Parameter-Wert-Halter

Jeder Eintrag unter data.name.parameters hat eine von zwei Formen: { "value": <literal> } für einen statischen Wert oder { "fx": "@expression" } für einen Ausdruck. outputField (bei set_data und batch) nennt ein Feld beim Aufrufer, das das Ergebnis erhält.

Praxisbeispiel

Eine Aktion pro Schritt

Jeder Array-Eintrag ist eine Aktion; die Reihenfolge ist die Ausführungsreihenfolge.

Einen Schritt sperren

props.condition, ein Ausdruck, bei false wird der Schritt stillschweigend übersprungen, ohne Fehler.

Auslösen und vergessen

props.async: true bei einem Schritt wie call_external_api lässt spätere Schritte laufen, ohne auf ihn zu warten, die richtige Wahl für Hintergrundarbeit, die falsche, wenn ein späterer Schritt sein Ergebnis braucht.

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 gruppiert Schritte in einem benannten Block unter <actions> und verbindet ihn mit @click="<name>" mit einem Element, der Kurzform für einen xu-on:click-Handler, dessen Workflow dieser Block ist.

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