Parameter "Typ"

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

Option "Ausführung beim Commit"

Wird die Option Ausführung beim Commit abweichend vom Standard gesetzt, dann erscheint der betreffende Hinweis erst bzw. nur dann, wenn am Ende der Ereignisverarbeitung (also ggf. nach Abarbeiten einer kompletten Ereigniskette) ein "Commit" auf der Datenbank erfolgt. Dies ist nur dann der Fall, wenn die Ereignisbehandlung überhaupt im Kontext einer Transaktion ausgelöst wird und fehlerfrei und ohne Abbrechen (also ohne Rollback) abläuft.

►WICHTIG◄ In Zusammenhang mit der Option Ausführung beim Commit ist es wichtig die folgenden Aspekte zu berücksichtigen:

• Ein Eigenes Aktionsevent bedingt nicht automatisch einen transaktionalen Kontext. Ohne diesen werden Hinweise, für die die Option Ausführung beim Commit gesetzt ist, nicht angezeigt.

• Auch beim Ausführen von Tests für Ereignisbehandlungen entfällt der "Commit", so dass Hinweise, für die die Option Ausführung beim Commit gesetzt ist, nicht erscheinen.

• Die Wertauflöser für den Inhalt von Titel und Meldung eines Hinweises werden erst beim Commit verarbeitet, wenn die Option Ausführung beim Commit gesetzt ist. Dies bedeutet, dass der Inhalt der Meldung (soweit überhaupt relevant) den Datenstand von Variablen und Objekten berücksichtigt, der zum Zeitpunkt des Commits gilt und nicht den zum Zeitpunkt der Ausführung der Hinweis anzeigen (Popup)-Ereignisaktion. Die einzige Information, die zum Zeitpunkt der Ereignisaktion zur späteren Verwendung "festgehalten" wird, ist das aktuelle Bezugsobjekt (entity). Allerdings wird auch dabei nur eine Referenz "gemerkt" und nicht etwa ein Schnappschuss erstellt, so dass Wertauflöser, die sich auf das Bezugsobjekt beziehen, wiederum den ggf. abweichenden Datenstand beim Commit "auflösen".

Parameter "Titel" und "Meldung"

Als Wert für die Parameter Titel und Meldung werden Zeichenfolgen erwartet, die abhängig vom Typ (s. o.) an unterschiedlichen Positionen im Hinweisformat erscheinen.

►HINWEIS◄ Für den Parameter Titel erscheint der Standardwert "Title", wenn die vom Wertauflöser zurückgegebene Zeichenfolge keine Zeichen enthält oder "kein Wert" (null) zurückgegeben wird.

Liefert einer der verwendeten Wertauflöser zur Laufzeit einen anderen Datentyp als String, also keine Zeichenfolge als Rückgabewert, dann wird versucht den Rückgabewert automatisch in eine Zeichenfolge zu konvertieren:

• Aus einem booleschen Wert wird dabei z. B. der Textwert true oder false.

• Anstelle eines komplexen Datenobjekts für eine Entität z. B. vom Typ Benutzer erscheint ein Textwert wie 1901:de.lobster.scm.base.security.user.User@5ffd2762.

• Wird eine Liste zurückgegeben, dann wird jedes Element in eine Zeichenfolge konvertiert und die Zeichenfolgen aller Elemente erscheinen kommasepariert zwischen eckigen Klammern. Wie der folgende Ausdruck verdeutlicht greift dieses Konzept auch rekursiv, wenn ein Listenwert wiederum eine Liste ist:
  

  [2021, ist ein gutes Jahr für, [Entscheidungen, Wein, Lobster]]

• Anstelle der Lokalisierung für den Wert einer Dynamischen Aufzählung erscheint dessen interner Name (name), z. B. CNE für den Firmentyp "Empfänger".
  ►HINWEIS◄ Im Kontext eines Formulars greifen per Hinweis anzeigen erzeugte Hinweise ggf. automatisch auf die Sprachverwaltung bzw. Firmenspezifische Sprachanpassungen zu, um lokalisierbare Inhalte im Titel- oder Meldungstext zu berücksichtigen. .Hinweis anzeigen (Popup) v4.12.0 greift dagegen immer auf den betreffenden internen Namen eines lokalisierbaren Inhalts zu und berücksichtigt Lokalisierungen nur, wenn der Wertauflöser Wert aus Sprachverwaltung verwendet wird (siehe Beispiel).

Parameter "Schließen nach Sekunden"

Die Angabe für den Parameter Schließen nach Sekunden betrifft nur Hinweise mit einem Typ aus der Kategorie Notification, da der Typ Alert nicht automatisch geschlossen wird.

Mit einem Wert von 0 Sekunden wird eine Notification unbegrenzt angezeigt, also bis der Benutzer das X-Symbol verwendet, um sie zu schließen.