Flower

← Alle Module · Hilfsmittel

dialog

Das Modul "dialog" öffnet während eines laufenden Workflows Fenster, in denen der Anwender etwas eingeben, bestätigen, auswählen oder eine Datei bzw. einen Ordner aussuchen kann. So lassen sich Workflows an Stellen, die menschliche Entscheidungen brauchen, kurz anhalten und mit Nutzer-Eingaben fortsetzen.

Aktionen

eingabelesend

Zeigt ein Formular mit beliebig vielen Feldern und liefert die vom Nutzer eingegebenen Werte zurück.

Eingaben

FeldTypPflichtBeschreibung
titelTextjaÜberschrift des Eingabe-Fensters.
felderListe—Liste der Eingabefelder; jeder Eintrag ist ein Objekt mit name, label, typ, standard und pflicht. Fehlt die Liste, wird ein leeres Formular gezeigt.
beschreibungText—Erklärender Text unter dem Titel.

Ausgaben (über ergebnis:)

<feldname>Je eingegebenem Feld ein gleichnamiger Ausgabewert mit dem vom Nutzer erfassten Inhalt.
abgebrochenWahrheit: true, wenn der Nutzer das Formular abgebrochen hat, sonst false.

bestätigunglesend

Stellt eine Ja/Nein-Frage und liefert die Antwort als Wahrheitswert.

Eingaben

FeldTypPflichtBeschreibung
titelTextjaÜberschrift des Frage-Fensters.
textTextjaDer Frage-Text, den der Nutzer beantworten soll.
ja-textText—Beschriftung der Ja-Schaltfläche (Standard: "Ja").
nein-textText—Beschriftung der Nein-Schaltfläche (Standard: "Nein").

Ausgaben (über ergebnis:)

ergebnisWahrheit: true bei Ja, false bei Nein oder Abbruch.

auswahllesend

Lässt den Nutzer aus einer Liste von Optionen eine oder mehrere auswählen.

Eingaben

FeldTypPflichtBeschreibung
titelTextjaÜberschrift des Auswahl-Fensters.
optionenListe—Die zur Wahl stehenden Optionen. Fehlt die Liste, wird sie leer angezeigt.
textText—Erklärender Text über der Auswahl.
mehrfachWahrheit—Wenn true, darf der Nutzer mehrere Optionen wählen (Standard: false).

Ausgaben (über ergebnis:)

ergebnisDie gewählte Option; bei mehrfach=true eine Liste der gewählten Optionen. Bricht der Nutzer ab, schlägt die Aktion mit dem Fehler "NutzerAbgebrochen" fehl.

text-anzeigenlesend

Zeigt eine reine Hinweis-Meldung, die der Nutzer nur bestätigen muss.

Eingaben

FeldTypPflichtBeschreibung
textTextjaDer anzuzeigende Meldungstext.
titelText—Überschrift des Hinweis-Fensters (Standard: "Hinweis").
artText—Art der Meldung, z. B. info/warnung/fehler, für die Darstellung.

Ausgaben (über ergebnis:)

bestätigtWahrheit: true, sobald der Nutzer die Meldung bestätigt hat.

datei-wählenlesend

Öffnet einen Datei-Auswahl-Dialog und liefert den gewählten Dateipfad.

Eingaben

FeldTypPflichtBeschreibung
titelText—Titel des Dialogs (Standard: "Datei wählen").
mehrfachWahrheit—Wenn true, dürfen mehrere Dateien gewählt werden (Standard: false).
start-pfadText—Ordner, in dem der Dialog startet.
filterListe—Dateityp-Filter für den Dialog.

Ausgaben (über ergebnis:)

ergebnisPfad der gewählten Datei; bei Abbruch ein leerer Text.

ordner-wählenlesend

Öffnet einen Ordner-Auswahl-Dialog und liefert den gewählten Ordnerpfad.

Eingaben

FeldTypPflichtBeschreibung
titelText—Titel des Dialogs (Standard: "Ordner wählen").
start-pfadText—Ordner, in dem der Dialog startet.

Ausgaben (über ergebnis:)

ergebnisPfad des gewählten Ordners; bei Abbruch ein leerer Text.

speicher-ziel-wählenlesend

Öffnet einen Speichern-unter-Dialog und liefert den gewählten Zielpfad.

Eingaben

FeldTypPflichtBeschreibung
titelText—Titel des Dialogs (Standard: "Speichern unter").
vorgeschlagener-nameText—Vorgeschlagener Dateiname; wird auch zurückgegeben, falls der Nutzer abbricht.
start-pfadText—Ordner, in dem der Dialog startet.
filterListe—Dateityp-Filter für den Dialog.

Ausgaben (über ergebnis:)

ergebnisDer gewählte Speicherpfad; bei Abbruch der vorgeschlagene Name.

Beispiele

Vor dem Versand bestätigen lassen

Der Workflow fragt den Nutzer, ob die fertige Rechnung wirklich verschickt werden soll, bevor er weiterläuft.

dialog
bestätigung
titelRechnung senden?
textDie Rechnung an Müller GmbH jetzt per Mail versenden?
ja-textSenden
nein-textAbbrechen
ergebnissoll_senden
- dialog:
    aktionen:
      - bestätigung:
          titel: "Rechnung senden?"
          text: "Die Rechnung an Müller GmbH jetzt per Mail versenden?"
          ja-text: "Senden"
          nein-text: "Abbrechen"
          ergebnis: soll_senden

Daten per Formular erfassen

Der Workflow öffnet ein Formular, in dem der Nutzer Name und Abteilung eines neuen Mitarbeiters einträgt.

dialog
eingabe
titelNeuer Mitarbeiter
beschreibungBitte Stammdaten eintragen.
felder[ {name: name, label: Name, typ: text, pflicht: true}, {name: abteilung, label: Abteilung, typ: text} ]
ergebnis (name)Erika Muster
ergebnis (abteilung)Vertrieb
abgebrochenfalse
- dialog:
    aktionen:
      - eingabe:
          titel: "Neuer Mitarbeiter"
          beschreibung: "Bitte Stammdaten eintragen."
          felder:
            - name: name
              label: "Name"
              typ: text
              pflicht: true
            - name: abteilung
              label: "Abteilung"
              typ: text