Actions

Innerhalb einer Component können Schaltflächen erzeugt werden, die Actions auslösen. Diese Schaltflächen werden immer am oberen Rand vor dem Inhalt der Component angezeigt. Typische Actions sind z. B. das Löschen und Speichern von Inhalten. Actions werden innerhalb des <Actions>-Elements definiert.

Folgende Actions können definiert werden:

Action „Neu“: <NewAction>
Action „Speichern“: <SaveAction>
Action „Löschen“: <DeleteAction>
Action „Datei hochladen“: <UploadAction>
Action „Datei herunterladen“: <DownloadAction>
Action „Custom“: <CustomAction>
Action „Neu laden“: <ReloadAction>
Action „Abbrechen“: <CancelAction>
Action „Auswählen“: <SelectAction>

Die Action SelectAction erzeugt keine Schaltfläche.

Alle Actions außer der benutzerdefinierten Action (CustomAction) und der SelectAction haben vordefinierte Beschriftungen und Icons. Diese können überschrieben werden, wenn es notwendig ist.

In der folgenden Tabelle sind die Attribute erläutert, die für alle Actions verwendet werden können.

Attribut	Beschreibung
`background`	Definiert eine Farbe für den Hintergrund des Controls. Diese Einstellung überschreibt die Standardfarbe des Farbschemas! Mögliche Werte: Hexadezimaler Farbwert, z. B. `ff5a00` Verwenden Sie keine Raute (`#`) vor dem Farbwert! Verwenden Sie keine verkürzte Schreibweise des Farbwerts! Farbcode aus der Farbpalette der Web App (vgl. Theming), z. B. `A200`
`componentName`	Name der Component, zu der am Ende der Action navigiert werden soll. Mögliche Werte: Beliebige Zeichenkette Dieses Attribut kann für die Aktion "Abbrechen" nicht definiert werden und führt zu einem Validierungsfehler, falls das Attribut trotzdem gesetzt wird.
`displayName`	Beschriftung des Controls. Übersetzbar Mögliche Werte: Beliebige Zeichenkette oder Sprachschlüssel Dieses Attribut kann für die Action `SelectAction` nicht definiert werden.
`enabled`	Aktiviert die Action Data Binding (Boolean) möglich Mögliche Werte: `true`/`false` oder Ausdruck für Data Binding Das Attribut `enabled` ersetzt das veraltete Attribut `disabled`. `enabled="true"` entspricht damit dem veralteten Attribut `disabled="false"`.
`fontFamily`	Legt die Schriftfamilie fest. Mit diesem Attribut wird die Standardschrift der Web App für dieses Control überschrieben. Mögliche Werte: Fontcode aus der Font-Palette, z. B. `Font04`
`fontSize`	Legt die Schriftgröße fest. Mit diesem Attribut wird die Standardschriftgröße der Web App für dieses Control überschrieben. Mögliche Werte: Schriftgröße in Pixel, z. B. `20px` Schriftgröße in Punkt, z. B. `18pt` Schriftgröße im Vergleich zur Schriftgröße des Elternelements, z. B. `.8em` oder `120%` Schlüsselwörter, z. B. `small` oder `larger`
`fontStretch`	Legt die Breite der einzelnen Schriftzeichen fest. Mit diesem Attribut wird die Standardbreite der Schriftzeichen für dieses Control überschrieben. Mögliche Werte: `Condensed` `Expanded` `ExtraCondensed` `ExtraExpanded` `Medium` `Normal` (Standard) `SemiCondensed` `SemiExpanded` `UltraCondensed` `UltraExpanded`
`fontStyle`	Legt die Neigung der Schrift fest. Mit diesem Attribut wird die Standardneigung der Schriftzeichen für dieses Control überschrieben. Mögliche Werte: `italic`: kursive Schrift `normal`: normale Schrift (Standard) `oblique`: schräg gestellter Schriftstil (berechnet)
`fontWeight`	Legt die Schriftstärke fest. Mit diesem Attribut wird die Standardstärke der Schriftzeichen für dieses Control überschrieben. Mögliche Werte: `Black` `Bold` `DemiBold` `ExtraBlack` `ExtraBold` `ExtraLight` `Heavy` `Light` `Medium` `Normal` (Standard) `Regular` `SemiBold` `Thin` `UltraBlack` `UltraBold` `UltraLight`
`foreground`	Definiert eine Farbe für den Vordergrund (Texte, Icons) des Buttons. Diese Einstellung überschreibt die Standardfarbe des Farbschemas! Wenn für die Aktion mit dem Attribut `iconUrl` ein benutzerdefiniertes Icon verwendet wird, wird dieses Icon nicht in der benutzerdefinierten Farbe angezeigt. Die Grafikdatei, die als Icon verwendet wird, muss direkt in der gewünschten Farbe hinterlegt werden. Mögliche Werte: Hexadezimaler Farbwert, z. B.`ff5a00` Verwenden Sie keine Raute vor dem Farbwert! Verwenden Sie keine verkürzte Schreibweise des Farbwerts! Farbcode aus der Farbpalette der Web App (vgl. Theming), z. B. `A200`
`iconColor`	Definiert die Farbe des Icons. Mögliche Werte: Hexadezimaler Farbwert, z. B. `ff5a00` Verwenden Sie keine Raute vor dem Farbwert oder eine verkürzte Schreibweise des Farbwerts! Farbcode aus der Farbpalette der Web App (vgl. Theming), z. B. `A200`
`iconPosition`	Legt die Position des Icons auf dem Button fest. Mögliche Werte: `left`: Das Icon wird links auf dem Button angezeigt (Standard). `right`: Das Icon wird rechts auf dem Button angezeigt.
`iconUrl`	Pfad zu einer Grafikdatei oder Angabe eines Material Icons, der als Icon verwendet wird. Die Grafikdatei muss im Ordner `Resources` direkt unterhalb des Web-App-Projekts enthalten sein. Pfadangabe relativ zum Ordner `Resources`. Das Material Icon muss mit dem Präfix `icon`, z. B. `icon:<MaterialIconName>` angegeben werden. Mögliche Werte: Zeichenkette (URI), z. B. `clock.png` `icon:<MaterialIconName>` , z. B. `icon:extension` Mit `Strg`+`Leertaste` erhalten Sie eine Übersicht der verfügbaren Icons. Die Auswahl kann von den tatsächlich verfügbaren Material Icons abweichen.
`process`	Pfad zur `.wrf`-Datei. Der Technical Process muss im Ordner `Services/Processes` enthalten sein. Pfadangabe relativ zum Ordner `Services/Processes`. Mögliche Werte: Zeichenkette (URI) Dieses Attribut kann für die Aktion "Abbrechen" nicht definiert werden und führt zu einem Validierungsfehler, falls das Attribut trotzdem gesetzt wird.
`selectionNeeded`	Legt fest, ob für die Aktion ein Eintrag aus einer Liste gewählt sein muss. Funktioniert nur in List Component. Mögliche Werte: `true` / `false`
`tooltip`	Legt den Text fest, der als Tooltip der Aktion angezeigt wird, sobald der Aktions-Button mit der Maus überfahren wird. Mögliche Werte: Zeichenkette Wenn der Wert des Attributs `tooltip` leer ist, dann wird kein Tooltip angezeigt.
`visible`	Legt fest, ob der Button für die Aktion sichtbar ist. Data Binding (Boolean) möglich Mögliche Werte: `true` / `false` oder Zeichenkette für Data Binding

Jede der oben genannten Actions kann mit dem Element <Parameters> erweitert werden. Innerhalb des Elements <Parameters> können Sie mit dem Element <Parameter> weitere Definitionen vornehmen.

Das Element <Parameter> enthält die folgenden obligatorischen Attribute:

Attribut Beschreibung

key

Name des Parameters

Data Binding (Boolean) möglich

Mögliche Werte: Zeichenkette oder Ausdruck für Data Binding

value

Parameterwert

Data Binding (Boolean) möglich

Mögliche Werte: Zeichenkette oder Ausdruck für Data Binding