metadata collection form

Interne ID: agorum.metadata.collection.form

Mit diesem Knoten stellen Sie eine form anhand einer metadata collection dar. Die im Knoten gewählte metadata collection zeigt das System innerhalb einer Bedienoberfläche an. Der Bedienoberfläche können Sie Schaltflächen und ein Hinweistext hinzufügen.

Aussehen des Knotens

Verhaltensweise

Erreicht das System den Knoten, prüft das System die hinterlegten Parameter und zeigt die verwendete metadata collection in einer Bedienoberfläche an.

Anwendungsbeispiel

Siehe Workflow-Beispiel Positionen splitten.

Endpoints

Standard	Veränderbar?	Weitere Endpoints möglich?
Default (Inlet)	Nein, kann nur ausgeblendet werden.	nicht nötig

Parameter

Parameter	Beschreibung	Beispiel
Usage	(optional) Definiert den zu verwendenden Usage (Verwendungszweck). Wenn Sie diesen Parameter nicht angeben, verwendet das System den Usage form.	–
metadata collection	(optional) Definiert die zu verwendende metadata collection. Wenn Sie diesen Parameter nicht angeben, erhält der Benutzer in der Bedienoberfläche eine Auswahl von metadata collections in Abhängigkeit des in Usage definierten Parameters und kann sie dort wählen.	–
Beschreibungstext	(optional) Definiert den Text, der vor der Bedienoberfläche erscheint, etwa eine Einleitung.	–
Buttons	Definiert Schaltflächen, die am unteren Ende der Bedienoberfläche erscheinen.	Buttons
Anzeigename	Definiert einen Namen, der im Workflow in der Spalte Prozessschritt in der Bedienoberfläche erscheint.	Anzeigename
Beschreibung	Definiert die Beschreibung, die im Workflow in der Spalte Prozessbeschreibung erscheint.	Beschreibung
Automatisches Annehmen	Definiert, ob die UI-Maske automatisch vom Benutzer angenommen wird, wenn dieser eine Eingabe in der Bedienoberfläche tätigt. Gilt für Masken, die an mehrere Benutzer gleichzeitig gerichtet sind. Im Standard ist der Parameter aktiviert.	–
Benutzer/Gruppen (Bearbeiter)	Setzt die definierten Benutzer / Benutzergruppen des passierenden Tokens als Bearbeiter des Workflowschritts und aller nachfolgenden Schritte inklusive Zugriff auf die Anhänge des Workflows. Haben Sie eine Benutzergruppe als Bearbeiter gesetzt, darf jedes Mitglied aus dieser Benutzergruppe den Workflow annehmen, bearbeiten und abgeben.	Benutzer/Gruppen (Bearbeiter)
Benutzer/Gruppen (Betrachter)	Setzt die definierten Benutzer / Benutzergruppen als Betrachter des Workflowschritts und aller nachfolgenden Schritte inklusive Zugriff auf die Anhänge des Workflows. Haben Sie eine Benutzergruppe als Betrachter gesetzt, darf jedes Mitglied aus dieser Benutzergruppe den Workflowschritt bei Bedarf annehmen, bearbeiten und abgeben.	Benutzer/Gruppen (Betrachter)

Buttons

Im Editor

Über legen Sie einen neuen Eintrag für eine Schaltfläche an.

Folgende Felder bei den Schaltflächen existieren:

Feld	Beschreibung
Outlet	Definiert den Ausgang (das Outlet des Knotens), der genommen wird, wenn diese Schaltfläche in der Bedienoberfläche geklickt wird. Der Name muss eindeutig sein. Sie müssen das Outlet erst am Knoten erstellen, damit das System es finden kann.
Text	(optional) Definiert den Text, der auf der Schaltfläche erscheint. Ist kein Text definiert, müssen Sie ein Icon definiert haben. Icon und Text können Sie kombinieren, d. h. Sie können beide verwenden.
Icon	(optional) Definiert das Icon, das auf der Schaltfläche erscheint. Ist kein Icon definiert, müssen Sie einen Text definiert haben. Icon und Text können Sie kombinieren, d. h. Sie können beide verwenden.
Validieren	Aktiviert Alle Werte in den Feldern der Bedienoberfläche müssen valide sein, ansonsten kann die Schaltfläche nicht angeklickt werden und bleibt grau. Deaktiviert Die Bedienoberfläche kann über die Schaltfläche verlassen werden, ohne dass die Werte valide sein müssen.
Ausrichtung	Definiert, ob die Schaltfläche in der Bedienoberfläche links oder rechts erscheint. Die Schaltflächen erscheinen in den definierten Reihenfolge jeweils auf links und rechts aufgeteilt. Ist keine Ausrichtung definiert, ist der Standard rechts.

Als Expression

Die Schaltflächen können Sie programmatisch über eine Expression setzen.

Format

[
  {
    outlet: 'next',
    text: 'Next',
    icon: 'aguila-icon cancel',
    validate: true,
    alignment: 'right'
  }
]

Sie können etwa solche Schaltflächen über den Knoten Skript erstellen, der dem Knoten metadata collection form vorangestellt ist.

Inhalt des Skript-Knotens

token.variables.myButtons = [
  {
    outlet: 'next',
    text: 'Next',
    icon: 'aguila-icon cancel',
    validate: true,
    alignment: 'right'
  }
];

Als Expression geben Sie Folgendes an:

token.variables.myButtons

Hinweis: Schaltflächen können Sie nur als Expression programmatisch setzen.

Anzeigename

Angabe eines Anzeigenamens im Editor:

Bitte geben Sie die Wiedervorlage Daten ein!

Hinterlegen Sie einen Anzeigenamen als Parameter, zeigt das System diesen als Prozessschritt in der Bedienoberfläche an.

Anzeigename in der Bedienoberfläche

Beschreibung

Im Editor

Angabe einer Beschreibung im Editor:

Dokument korrigieren

Als Expression

Angabe einer Beschreibung als Expression:

token.variables.taskTitle

Hinterlegen Sie hier einen Text oder eine Variable, zeigt das System deren Inhalt als Prozessbeschreibung in der Bedienoberfläche an. Meistens ist es nicht sinnvoll, einen festen Text im Editor einzutragen, etwa wenn es sich um einen Aufgabenworkflow handelt, da die Aufgabe pro Durchlauf eines Workflows unterschiedlich ausfällt. Stattdessen sollten Sie mit Variablen in der Expression arbeiten. So können Sie etwa ein Eingabefeld im ui-Knoten mit der Beschreibung vom Benutzer dynamisch befüllen:

 // task title
    {
      type: 'agorum.composite.form.element.text',
      name: 'taskTitle',
      label: '_acmsg:taskTitle.label=Titel',
      validation: [
        {
          // this value is required
          required: true
        }
      ]
    },

Der Benutzer gibt in diesem ui-Knoten den Titel der Aufgabe in einem Feld namens Titel (label). Der Titel wird in der Variable taskTitle (name) gespeichert. Durch einen nachfolgenden set-Knoten, der die Interne Variable sys_acw_processDescription verwendet, wird die Variable taskTitle aus dem ui-Knoten als Prozessbeschreibung gesetzt:

Eingesetzter set-Knoten mit interner Variable und Wert

In der Bedienoberfläche taucht der Titel überall in der Spalte Prozessbeschreibung auf:

Spalte Prozessbeschreibung in der Bedienoberfläche

Benutzer/Gruppen (Bearbeiter)

Im Editor

Gesetzter Benutzer als Bearbeiter mit lesenden Rechten auf Anhänge

Als Expression

Als Expression können Sie zuvor definierte Variablen setzen, etwa solche, die Sie über einen vorherigen Skript-Knoten definiert haben:

Aufbau der Variable / Zugriff auf die Variable

token.variables.sampleRecipient

Zugriff auf mehrere Variablen über ein Array

[ token.variables.sampleRecipient, token.variables.testAssign ]

Zum Vergeben von Rechten auf Anhänge mit einem Skript-Knoten, siehe Rechte auf Anhänge (Attachments) vergeben.

Alternativ setzen Sie die Werte direkt in der Expression:

[ {id: 'group:GRP_sample_escalation_3', attachmentPermission: 'write'} ]

Benutzer/Gruppen (Betrachter)

Definiert einen Stellvertreter oder eine Urlaubsvertretung.

Die Benutzer oder Benutzergruppen, die Sie hier als Betrachter wählen, können jeden Schritt eines Workflows nachvollziehen und etwa Auskunft geben, sofern nötig.
Bei Bedarf können Sie in den Workflow eingreifen, indem Sie die Schaltfläche Annehmen anklicken. Die Betrachter können danach genauso wie ein Bearbeiter Daten in den Dialog eingeben.
Betrachter können den Schritt in der Bedienoberfläche einsehen, sofern diese den Filter für mich in den Workflow Aufgaben deaktivieren.

Im Editor

Gesetzte Benutzergruppe als Betrachter mit lesenden Rechten auf Anhänge

Als Expression

siehe Benutzer/Gruppe (Bearbeiter)