Nutzeroberfläche

Lerne, wie du mit Ninox-Skripten Meldungen anzeigst, Bestätigungen abfragst und Nutzer durch die App navigierst.

Diese Funktionen steuern, was Nutzer sehen. In diesem Kapitel lernst du, wie du Meldungen anzeigst, Entscheidungen abfragst und Nutzer durch die App führst.

Alle Funktionen in diesem Kapitel laufen nur auf dem Client, da sie Elemente der Nutzeroberfläche betreffen. Auf dem Server haben sie keine Wirkung.

Funktion (A-Z)	Aufgabe
alert()	Zeigt eine einfache Meldung an
closeAllRecords()	Schließt alle offenen Formularansichten
closeFullscreen()	Schließt die Formularansicht im Vollbildmodus
closeRecord()	Schließt die aktuelle Formularansicht
dialog()	Zeigt einen Dialog mit Antwortoptionen an
openFullscreen()	Öffnet einen Datensatz im Vollbildmodus
openPage()	Öffnet eine Seite
openPrintLayout()	Öffnet einen Datensatz in einem Druck-Layout
openRecord()	Öffnet einen Datensatz in seiner Tabelle
openTable()	Öffnet eine Tabelle
popupRecord()	Öffnet einen Datensatz in einem Pop-up

Meldungen anzeigen und Bestätigungen abfragen

Nutze diese Funktionen, wenn du Nutzer mit einer Meldung führen oder eine Bestätigung abfragen willst.

Mit alert() eine einfache Meldung anzeigen

Nutze alert(), um ein Pop-up mit einer Meldung und einer OK-Schaltfläche anzuzeigen.

Nutze es, wenn du:

• eine erfolgreiche Aktion bestätigen willst.
• auf fehlende Eingaben hinweisen willst.
• Informationen anzeigen willst, die Nutzer vor dem Fortfahren bestätigen sollen.

alert(any)

• any der Wert oder die Meldung, die angezeigt werden soll

alert() gibt keinen Wert zurück.

Schauen wir uns einige Beispiele an:

alert("I am a pop-up. Please click 'OK' to confirm.")

Zeigt ein Pop-up mit einer OK-Schaltfläche an.

alert("This was the time at the very moment you clicked the button: " + time(now()) + ".")

Zeigt die aktuelle Uhrzeit an, wenn sich das Pop-up öffnet.

Tipps:

• Halte Meldungen kurz.
• alert() läuft nur auf dem Client.
• Wenn ein Skript alert() mehrmals aufruft, wird nur der letzte Aufruf angezeigt.
• Nutze dialog(), wenn Nutzer eine Auswahl treffen sollen.

Mit dialog() eine Bestätigung abfragen

Nutze dialog(), um einen Dialog mit Titel, Meldung und Antwortoptionen anzuzeigen.

Nutze es, wenn du:

• Nutzer um eine Entscheidung bitten willst.
• klare Antworten wie Yes und No anbieten willst.

dialog(string, string, [string])

• erstes string der Titel des Dialogs
• zweites string die Meldung im Dialog
• drittes [string] die Antwortoptionen, die angezeigt werden sollen

dialog() gibt die ausgewählte Antwort als String zurück.

Das Skript wartet, bis der Nutzer eine Antwort auswählt.

Schauen wir uns einige Beispiele an:

dialog("Bestätigung", "Diesen Datensatz wirklich löschen?", ["Ja", "Nein"])

Öffnet einen Bestätigungs-Dialog für eine Löschaktion.

let mytitel := "Datensatz löschen";
let myAnzeige := "Soll dieser Datensatz gelöscht werden? Bist du 100% sicher?";
let myOptionen := ["Ja, er kann weg.", "Nein! Ich brauche ihn noch!"];
if dialog(mytitel, myAnzeige, myOptionen) = "Ja, er kann weg." then
    delete this
end

Löscht den aktuellen Datensatz nur, wenn der Nutzer dies bestätigt.

dialog("Duplizieren!", "Möchtest du den duplizierten Namen behalten?", ["Nein", "Ja"])

Fordert den Nutzer auf, die fragliche Eingabe noch einmal zu prüfen.

Tipps:

• Speichere das Ergebnis in einer Variable, wenn spätere Schritte davon abhängen.

Tabellen, Seiten, Datensätze und Druck-Layouts öffnen

Mit diesen Funktionen führst du Nutzer zur nächsten relevanten Stelle in der App. Du kannst auch Datensätze aus anderen Tabellen anzeigen, ohne die aktuelle Ansicht zu verlassen.

Eine Seite mit openPage() öffnen

Nutze openPage(), um eine Seite anhand ihres Namens zu öffnen.

Nutze die Funktion, wenn du:

• Nutzer mit Schaltflächen und Triggern durch deine App führen möchtest.

openPage(string)

• string Bezeichnung oder Interner Name der Seite

openPage() schließt die aktuelle Seite, das Formular oder die Tabelle. Anschließend öffnet die Funktion die ausgewählte Seite.

Beim Text in der Funktion wird Groß- und Kleinschreibung nicht unterschieden.

Schauen wir uns einige Beispiele an:

openPage("Dashboard")

Öffnet die Seite mit dem Namen „Dashboard“.

openPage("Rechnungen_Dash")

Öffnet die Seite mit dem internen Namen „rechnungen_dash“.

Wenn du die Bezeichnung oder den internen Namen einer Seite änderst, passe auch den Text in dieser Funktion an. Ninox aktualisiert ihn nicht automatisch.

Tipps:

• Wenn die Seite Tabs hat, öffnet Ninox den ersten Tab.

Eine Tabelle mit openTable() öffnen

Nutze openTable(), um eine Tabelle anhand ihres Namens zu öffnen.

Nutze die Funktion, wenn du:

• Nutzer mit Schaltflächen und Triggern durch deine App führen möchtest.

openTable(string)

• string der Name (Bezeichnung) der zu öffnenden Tabelle

openTable() schließt die aktuelle Tabelle oder Seite. Anschließend öffnet die Funktion die ausgewählte Tabelle.

Beim Text in der Funktion wird Groß- und Kleinschreibung nicht unterschieden.

Schauen wir uns ein Beispiel an:

openTable("Rechnungen")

Öffnet die Tabelle "Rechnungen".

Tipps:

• Ninox öffnet die erste Ansicht der Tabelle.

Wenn du den Namen (die Bezeichnung) einer Tabelle änderst, passe auch den String in dieser Funktion an. Im Gegensatz zu den internen Feldnamen kann Ninox den String nicht automatisch aktualisieren.

Einen Datensatz mit openRecord() öffnen

Nutze openRecord(), um einen Datensatz direkt zu öffnen.

Nutze die Funktion, wenn du:

• Nutzer mit Schaltflächen und Triggern durch deine App führen möchtest.
• einen bestimmten Datensatz zur Bearbeitung öffnen möchtest.

openRecord(nid)

• nid der Datensatz, den du öffnen möchtest

openRecord() schließt das aktuelle Formular. Liegt der Zieldatensatz in einer anderen Tabelle, schließt die Funktion auch die aktuelle Tabelle. Anschließend öffnet sie die Tabelle und das Formular des Zieldatensatzes.

Schauen wir uns einige Beispiele an:

openRecord(record(einstellungen, 1))

Öffnet den Datensatz mit der ID 1 in der Tabelle „Einstellungen“.

openRecord(first(select kontakte where name = "Renate Muster"))

Öffnet die Tabelle „Kontakte“ und den ersten Datensatz, in dem im Feld „Name“ „Renate Muster“ steht.

Tipps:

• Nutze popupRecord(), wenn eine kurze Anzeige genügt. Nutzer bleiben dabei in der aktuellen Tabelle.

Einen Datensatz mit popupRecord() anzeigen

Nutze popupRecord(), um einen Datensatz in einem Pop-up anzuzeigen.

Nutze die Funktion, wenn du:

• einen bestimmten Datensatz kurz öffnen und bearbeiten möchtest, ohne deinen Arbeitsablauf zu verlassen.

popupRecord(nid)

• nid der Datensatz, der angezeigt werden soll

Schauen wir uns einige Beispiele an:

popupRecord(record(Einstellungen, 1))

Öffnet den Datensatz mit der ID 1 aus der Tabelle „Einstellungen“ in einem Pop-up-Formular.

popupRecord(first(select kontakte where name = "Max Muster"))

Öffnet den ersten Datensatz aus der Tabelle „Kontakte“, in dem im Feld „Name“ „Max Muster“ steht, in einem Pop-up-Formular.

Tipps:

• Nutze record() statt select, um einen Datensatz abzurufen. Das ist bei großen Tabellen deutlich schneller.

Ein Druck-Layout mit openPrintLayout() öffnen

Nutze openPrintLayout(), um einen Datensatz in einem bestimmten Druck-Layout zu öffnen.

Nutze die Funktion, wenn du:

• ein bestimmtes Druck-Layout eines definierten Datensatzes öffnen möchtest.

openPrintLayout(nid, string)

• nid Datensatz, den du im Druck-Layout anzeigen möchtest
• string Name des Druck-Layouts

Beim Text in der Funktion wird Groß- und Kleinschreibung nicht unterschieden.

Schauen wir uns einige Beispiele an:

openPrintLayout(this, "Rechnung")

Öffnet das Druck-Layout "Rechnung" für den aktuellen Datensatz.

let myRe := first(select rechnungen where text(status) = "Bestätigt");
openPrintLayout(myRe, "rechnung pdf")

Sucht den ersten Datensatz in der Tabelle "Rechnungen", dessen Feld "Status" auf "Bestätigt" gesetzt ist. Öffnet ihn anschließend im Druck-Layout "Rechnung PDF".

Aktuelle Ansicht ändern

Nutze diese Funktionen, wenn du Anzeigemodi wechseln oder offene Formularansichten schließen möchtest.

Vollbildmodus mit openFullscreen() und closeFullscreen() aktivieren oder verlassen

Nutze diese Funktionen, um einen Datensatz in seiner Formularansicht im Vollbildmodus zu öffnen oder den Vollbildmodus zu verlassen.

openFullscreen(nid) closeFullscreen()

• nid der Datensatz, den du im Vollbildmodus öffnen möchtest

Schauen wir uns einige Beispiele an:

openFullscreen(this)

Öffnet den aktuellen Datensatz im Vollbildmodus.

closeFullscreen()

Verlässt den Vollbildmodus und kehrt zur Ansicht zurück, die zuvor geöffnet war.

Tipp:

• openFullscreen() füllt das gesamte Fenster mit der Formularansicht aus.

Nutze closeRecord() und closeAllRecords() zum Schließen offener Formularansichten

Nutze diese Funktionen, um:

• Nutzer zur darunterliegenden Tabelle, Ansicht oder Seite zurückzuführen.
• mehrere übereinanderliegende Formularansichten schnell zu schließen.

closeRecord() closeAllRecords()

Schauen wir uns einige Beispiele an:

closeRecord()

Schließt die aktuelle Formularansicht. Nutzer sehen danach das darunterliegende Formular. Ist kein weiteres Formular geöffnet, sehen sie die aktuelle Tabellenansicht.

closeAllRecords()

Schließt alle offenen Formularansichten und führt Nutzer zur aktuellen Tabellenansicht zurück.

Tipps:

• Schließe nur die Ansichten, die nicht mehr benötigt werden.
• Vermeide mehrere Öffnen- und Schließen-Aktionen in einem Skript, wenn der Ablauf unklar ist.

Häufige Anwendungen von Meldungen und Navigationen

Diese kurzen Muster zeigen typische Wege, Nutzer in einer App zu führen.

Kurze Erfolgsmeldung anzeigen

alert("✔ E-Mail gesendet!")

Zeigt direktes Feedback nach einer erfolgreichen Aktion an.

Löschbestätigung abfragen

dialog("Bestätigung", "Diesen Datensatz wirklich löschen?", ["Ja", "Nein"])

Fragt den Nutzer vor einer Aktion, die nicht rückgängig gemacht werden kann.

Beim Erstellen neuer Datensätze im Arbeitsablauf bleiben

let neu := create kontakte;
neu.erstellungsdatum := today();
popupRecord(neu)

Erstelle Datensätze in einer anderen Tabelle, ohne deine aktuelle Position in der App zu verlassen. Erstelle den Datensatz über einen Button und öffne ihn in einem Pop-up-Formular, um weitere Daten hinzuzufügen.