Ereignisse

  • Bei der Neuanlage, dem Bearbeiten oder dem Löschen bietet die Ereignisse die Möglichkeit zusätzliche Logik zu unterschiedlichen Zeitpunkten auszuführen.
    Ereignisse (Symbol: Blitz): Zu bestimmten Ereignissen können SQL-Anweisungen, JavaScript-Anweisungen und Sage-API-Aufrufe hinterlegt werden.


    1 SQL

    Folgende Eingabefelder sind für ein Ereignisse vom Typ SQL verfügbar:


    EingabefeldBedeutung
    BezeichnungZur internen Zuordnung/Verwaltung von Ereignissen
    EreignisAuslöser für das Ereignis, folgende Auswahl ist vorhanden:

    - Neuanlange eines Datensatzes
    - Vor Einfügen eines neuen Datensatzes
    - Nach Einfügen eines neuen Datensatzes
    - Vor Aktualisierung eines vorhandenen Datensatzes
    - Nach Aktualisierung eines vorhandenen Datensatzes
    - Vor Löschen eines Datensatzes
    - Nach Löschen eines Datensatzes
    - Beim Ändern eines Feldes
    - Beim Öffnen eines Formulars mit Daten

    Hinweis: Siehe Ausführungsreihenfolge in Abbildung 1.
    FeldNur bei dem Ereignis "Beim Ändern eines Feldes" vorhanden. Auswahl des Listenfeldes welches bei einer Änderung das Ereignis auslöst.
    TypSQL (Sage API-Aufruf und JavaScript)
    SQL-SkriptDas auszuführende Skript. Für Hilfe zu den Platzhaltern kann der Editor über den Button "SQL Skript" in der Aktionsleiste aufgerufen werden.
    SQL-BedingungDie optionale Bedingung, welche zutreffen muss, damit das Ereignis ausgeführt wird. Für Hilfe zu den Platzhaltern kann der Editor über den Button "SQL Bedingung" in der Aktionsleiste aufgerufen werden.
    AktivNur wenn die Checkbox aktiviert ist, wird das Ereignis ausgeführt.

    Tabelle 1: Eingabefelder Ereignis (Liste)


    Besonderheiten SQL Ereignisse


    AnsichtEreignisse und deren Besonderheiten
    Aktivierte MehrfachauswahlEs werden nur die Ereignisse “Vor Aktualisieren eines vorhandenen Datensatzes” und “Nach aktualisieren eines vorhandenen Datensatzes” ausgelöst.
    Systemparameter Mandantennummer im AppBuilder (nicht für veröffentlichte Apps)Der Parameter [$System:Mandantennummer] ist im Kontext des AppBuilders immer "123". Unabhängig von dem für die App im Gateway hinterlegten Wert.

    Tabelle 2: Besonderheiten in Verbindung mit Ereignissen


    Abbildung 1: Ausführungsreihenfolge der Ereignisse für "Neuanlage" und "Aktualisieren"


    2 Sage API-Aufruf

    Dokumentation folgt.


    3 JavaScript

    Die gleichen Ereignisse wie für den Typ SQL.

    Mit JavaScript werden die Ereignisse direkt im Browser des Benutzers ausgeführt. Das Skript muss in JavaScript Syntax hinterlegt sein.


    Für JavaScript sind folgende Funktionen hilfreich, welche in dem Skript aufgerufen werden können.


    NameFunktion
    this.preventDefault();Bricht die Ausführung ab (z.B. das Speichern in einem Dialog).
    $app.alert('Nachricht');Öffnet eine Nachricht in einem Dialog
    $app.touch.notify('Nachricht');Zeigt eine Nachricht am unteren Rand an.
    $app.input.focus({ fieldName: 'NameDesKategoriefelds' });Fokussiert ein Kategoriefeld welches über den Namen des Feldes angesprochen wird.


    Beispiel:


    Code
    if ([$Field:FeldFuerBearbeiten] == '1') {
    this.preventDefault();
    // Nachricht anzeigen
    $app.alert('Die Eingabe von 1 ist nicht bei der Neuanlage erlaubt.').done(function () {
        // Feld fokusieren
        $app.input.focus({ fieldName: 'FeldFuerBearbeiten' });
    });
}


    3.1 Besonderheiten JavaScript

    Alle Anweisungen müssen mit einem Semikolon (;) abgeschlossen werden, sonst kann die JavaScript Anweisung in mydatastream nicht korrekt ausgeführt werden.

    Bei Neuanlagen sind Felder ohne Wert "undefined". Es muss z.B. auf

    Code
    if ([$Field:FeldFuerBearbeiten] != undefined [...]

    geprüft werden.

Teilen