Aktionen - Kurzfassung

Die Aktion Hinweis anzeigen erzeugt einen bestimmten Typ von Hinweis, der dem Benutzer die über die Parameter Hinweistitel und Hinweisnachricht angezeigten Textinformationen anzeigt.

images/download/attachments/189434389/image-2024-10-15_9-18-36-version-1-modificationdate-1728976716348-api-v2.png

Optional kann ein Zielelement verknüpft werden, das in Zusammenhang mit dem Hinweis den Fokus erhalten soll. Sofern das Zielelement dies aufgrund seines Typs und der zur Laufzeit geltenden Einstellungen überhaupt zulässt, passiert dabei Folgendes:

In Verbindung mit dem Typ "Hinweisbox" (Standard) wird der Fokus erst dann auf das Zielelement gesetzt, wenn der als Dialogfenster angezeigte Hinweis wieder geschlossen wird.
Für alle anderen Typen, die als sogenannte "Notifications" am rechten Bildrand eingeblendet werden, wird der Fokus sofort gesetzt, wenn die Meldung erscheint.

Textinformationen für die Parameter Hinweistitel und Hinweisnachricht können mit zwei unterschiedlichen Methoden zugeordnet werden:

Methode für Bereitstellung der Textinformation

Hinweise

Zuweisen eines Lokalisierungseintrags

images/download/attachments/189434389/image-2024-11-6_16-1-29-version-1-modificationdate-1730905288367-api-v2.png

Immer wenn ein Verweis auf einen Lokalisierungseintrag eingerichtet oder aktualisiert wird, gilt dieser für jede unterstützten Sprache. Die Zuweisung kann aber nachträglich für ausgewählte Sprachen durch eine Direkteingabe (s. unten) übersteuert werden.

Zur Laufzeit wird der Verweis über Sprachverwaltung bzw. Firmenspezifische Sprachanpassungen passend zur in der Sitzung verwendeten Sprache interpretiert. Im Beispiel erscheint der deutsche Text "Hinweistitel" als Hinweistitel, während auf Englisch "Alert title" erscheinen würde.

Direkteingabe (Text, Beschriftungsausdruck bzw. eine Kombination von beidem). Beispiele (mit unterschiedlichem Typ):

images/download/attachments/189434389/image2020-7-9_15-54-44-version-1-modificationdate-1728976706788-api-v2.png

images/download/attachments/189434389/image2020-7-9_15-53-10-version-1-modificationdate-1728976706785-api-v2.png

Hier wird ausschließlich Klartext verwendet, der direkt angezeigt wird.

►HINWEIS◄ Im Text kann die Zeichenfolge \n als Zeilenumbruch eingesetzt werden, um mehrzeiligen Text auszugeben.

images/download/attachments/189434389/image2020-7-9_15-45-57-version-1-modificationdate-1728976706783-api-v2.png

images/download/attachments/189434389/image2020-7-9_15-45-5-version-1-modificationdate-1728976706780-api-v2.png

Hier wird Klartext mit dem Platzhalter $input für die anliegenden Eingabedaten kombiniert.

Im Beispiel wurde der Wert "10" als Eingabedaten in einem Textfeld registriert (z. B. per Auslöser Feld verlassen und geändert) und an die Aktion weitergeleitet.

images/download/attachments/189434389/image2020-7-9_16-5-42-version-1-modificationdate-1728976706796-api-v2.png

images/download/attachments/189434389/image2020-7-9_16-4-32-version-1-modificationdate-1728976706794-api-v2.png

Hier wird Klartext mit einem Verweis auf ein Detail innerhalb der anliegenden Eingabedaten kombiniert.

Im Beispiel verweist der $input auf ein Wiederholendes Element, dessen Eigenschaft length die aktuelle Anzahl der Einträge angibt.

images/download/attachments/189434389/image2020-7-9_15-27-17-version-1-modificationdate-1728976706770-api-v2.png

images/download/attachments/189434389/image2020-7-9_15-41-2-version-1-modificationdate-1728976706778-api-v2.png

Hier wird die Funktion avg (Durchschnitt) verwendet, um einen Mittelwert über alle Instanzen des Elements mit der ID#48 ($el(48,true)) zu berechnen.

Links vom Ergebnis wird die passende Beschriftung aus der Sprachverwaltung zugewiesen, wobei die Syntax [Bundle, Resource] verwendet wird.

images/download/attachments/189434389/image2020-7-9_16-17-14-version-1-modificationdate-1728976706802-api-v2.png

images/download/attachments/189434389/image2020-7-9_16-16-24-version-1-modificationdate-1728976706799-api-v2.png

-------------------------------------------------------------------------

In Anlehnung an das vorige Beispiel wird hier die Funktion concatWs (Texte verketten) verwendet, um aus Einzelwerten in einem Element mit der ID#48, das innerhalb eines Wiederholendes Element-Containers eingesetzt wird, eine mehrzeilige Textausgabe zu erzeugen. Als Trennzeichen wird dabei die Zeichenfolge \n verwendet, die als Zeilenumbruch interpretiert wird.

Direkteingaben müssen immer für jede unterstütze Sprache individuell eingegeben werden, sonst erscheint in der betreffenden Sprache ggf. kein Text.

Wie im letzten Beispiel gezeigt, können Berechnungsausdruck auch Verweise auf Lokalisierungseinträge enthalten.

Der Parameter Typ definiert das Erscheinungsbild des Hinweises zur Laufzeit und hat auch funktionale Auswirkungen:

Typ	Kategorie	Beispiel
Hinweisbox	Dialog muss mit "OK" Button oder per X-Symbol (rechts oben) geschlossen werden berücksichtigt die Option Sperren, die festlegt, ob der aktuelle View gesperrt wird, bis die Hinweisbox geschlossen wird (Option gesetzt) oder zugänglich bleibt während die Hinweisbox angezeigt wird (Option nicht gesetzt)
Notification: Info	Notification erscheint am rechten Rand im Browser kann per X-Symbol (rechts oben) geschlossen werden berücksichtigt den Parameter Schließen nach (Sekunden), der bestimmt nach welcher Zeit ein angezeigter Hinweis automatisch wieder verschwindet (Einstellung: >0 Sekunden) bzw. ob er "unbegrenzt" (bis zum interaktiven Schließen) angezeigt bleiben soll (Einstellung: 0 Sekunden)
Notification: Fehler
Notification: Warnung
Notification: Erfolg

Beispiel

In einem Formular wird eine Aufstellung von Bestellpositionen in einem Wiederholendes Element-Container aufgelistet.

Auf Knopfdruck soll die teuerste Einzelposition ermittelt, der zugehörige Betrag angezeigt und der Text der entsprechenden Position anschließend fokussiert werden.

Laufzeit-Beispiel:

Unter "Gehe zu ..." wurde der Button "Maximum" betätigt. Die teuerste Bestellposition wird ermittelt und der Betrag erscheint in einer "Hinweisbox":

images/download/attachments/189434389/image2020-7-9_17-16-19-version-1-modificationdate-1728976706809-api-v2.png

Nach dem Bestätigen des Hinweises per "OK" wird der Fokus in das Textfeld "Bestellposition" der zugehörigen Bestellung gesetzt:

images/download/attachments/189434389/image2020-7-9_17-20-1-version-1-modificationdate-1728976706812-api-v2.png

Konfiguration:

images/download/attachments/189434389/image-2024-10-15_9-42-15-version-1-modificationdate-1728978135436-api-v2.png

Für das Textfeld "Betrag", das die Eingabe von Zahlenwerten vorsieht, wird das links abgebildete Verhalten "maximumAlert" konfiguriert:

Das Verhalten spezifiziert keinen Auslöser, da es ausschließlich per Verhalten ausführen-Aktion über den Button "Maximum" ausgelöst werden soll.
Die Verhaltensweise Vergleiche mit (Vergleichstyp) wird verwendet, um festzustellen, ob der eingegeben Zahlenwert "gleich" (Vergleichstyp) dem Wert aus dem "Ausdruck" (Vergleichsquelle) ist. Der angegebene Berechnungsausdruck ermittelt über die Funktion max (Maximum) den höchsten Wert über alle Instanzen für das Textfeld "Betrag" (mit der Element-ID#48). Die Aktionen bei "wahr" werden ausgeführt, wenn dieser Vergleich zutrifft. Dann handelt es sich beim ausgewerteten Eintrag um die "höchstwertige" Bestellposition innerhalb des umgebenden Wiederholendes Element-Containers.
Unter den Aktionen bei "wahr" wird eine .Hinweis anzeigen v4.12.0-Aktion ausgeführt, die neben dem Hinweistitel "MAXIMUM" in der Hinweisnachricht den Berechnungsausdruck verwendet, der bereits in der Verhaltensweise genutzt wurde, um den gesuchten Maximalwert zu ermitteln. Als Typ wird "Hinweisbox" ausgewählt, da das verknüpfte Zielelement, das Textfeld "Bestellposition", erst fokussiert werden soll, wenn der Hinweis quittiert wurde.

images/download/attachments/189434389/image-2024-10-15_10-50-8-version-1-modificationdate-1728982208242-api-v2.png

Damit die Auswertung der "Bestellpostionen" über den Button "Maximum" angestoßen werden kann, wird für diesen das links abgebildete Verhalten "gotoMax" konfiguriert:

Das Verhalten reagiert auf den Auslöser Angeklickt.
Die Verhaltensweise Statisch stellt sicher, dass die Aktionen bei "wahr" unbedingt ausgeführt werden.
Unter den Aktionen bei "wahr" wird per Verhalten ausführen-Aktion das Verhalten "maximumAlert" aufgerufen, das im Zielement (Textfeld "Betrag"), wie oben beschrieben konfiguriert ist. Entscheidend ist dabei die Option Auch für Duplikate, die sicherstellt, dass alle Instanzen des Zielelements ausgewertet werden.

►HINWEIS◄ Sollte der Maximalwert für den Betrag in mehr als einer Rechnungsposition gefunden werden, wird für jeden Fund ein eigener Hinweis generiert, der quittiert werden muss. Da die Hinweisboxen "gestapelt" erscheinen durchläuft der Fokus dabei die Liste rückwärts, da der zuletzt angezeigte Hinweis zuerst bestätigt wird.

►ANMERKUNG◄ Die beschriebene Konfiguration kann hinsichtlich der Performance optimiert werden, so dass der Berechnungsausdruck $max($el(48,true)) nur einmalig ausgeführt werden muss. Wenn dieser Ausdruck als Wertausdruck anstelle von $input in der Verhalten ausführen-Aktion des Verhaltens "gotoMax" verwendet wird, erhält das aufgerufene Verhalten "maximumAlert" den Maximalwert als $input, auf den sich die Vergleiche mit (Vergleichstyp)-Verhaltensweise als Berechnungsausdruck und die Hinweis anzeigen -Aktion als Hinweisnachricht beziehen können. Allerdings wirkt die Konfiguration dann etwas weniger transparent. Deshalb wurde oben anders verfahren.