Mit Funktionen arbeiten

Lerne, wie du Ninox Funktionen nach Kategorien nutzt und die richtigen Werkzeuge für Berechnungen, Text, Datum, Datensätze und mehr findest.

Funktionen sind die Bausteine der Ninox Logik. Sie helfen dir, Werte zu berechnen, Text zu formatieren, mit Datumswerten zu arbeiten, Datensätze zu filtern und mehr.

Wenn du Funktionen noch nicht kennst, starte mit der Parametersyntax unten. Sobald du Einträge wie text(any) oder count([any]) lesen kannst, wird der Rest der Referenz deutlich einfacher.

Funktionsparameter verstehen

Funktions­einträge zeigen, was eine Funktion erwartet. Lies sie von links nach rechts:

• Der Funktionsname zeigt dir, was sie macht.

• Der Teil in Klammern zeigt die erwartete Eingabe.

So erkennst du schnell, ob eine Funktion zu deiner Aufgabe passt.

Zum Beispiel:

• odd(number) erwartet eine Zahl.

• text(any) kann viele Werttypen in lesbaren Text umwandeln.

• count([any]) erwartet eine Liste, ein Array oder eine Auswahl.

Was any bedeutet

any bedeutet, dass die Funktion mit verschiedenen Werttypen arbeiten kann. Ninox konvertiert oder interpretiert den Wert innerhalb der Funktion. Zum Beispiel kann text(any) eine Zahl, ein Datum, einen Auswahlwert oder einen anderen Wert in Text umwandeln.

Das ist flexibler als eine Funktion wie odd(number), die eine Zahl erwartet.

any bedeutet nicht, dass jeder Wert gleich sinnvoll ist. Übergib einen Wert, der für die Funktion passt, die du verwendest.

Was [any] bedeutet

[any] bedeutet, dass die Funktion eine Liste von Werten erwartet. Wenn du neu im Skripting bist, lies die eckigen Klammern als "eine Liste von".

Das ist meistens:

• ein Array

• eine Datensatzauswahl

• eine Liste von Feldwerten

Zum Beispiel:

• count([any]) zählt Elemente in einer Liste oder Auswahl.

• first([any]) gibt das erste Element zurück.

• concat([any]) verbindet Werte zu Text.

Die Elemente in dieser Liste können je nach Funktion unterschiedliche Typen haben.

Wenn eine Funktion any zurückgibt

Wenn eine Funktion any zurückgibt, kann das Ergebnis variieren. Eine Funktion kann zum Beispiel zurückgeben:

• Text in einem Fall

• eine Zahl in einem anderen Fall

• einen Datensatz oder JSON-Wert in einem weiteren Fall

Prüfe die Funktionsbeschreibung und das Beispiel, damit du weißt, welches Ergebnis du erwarten kannst.

Wenn du gerade erst anfängst, konzentriere dich zuerst auf die Eingabe. Die Beispiele machen das Ergebnis meist klar.

Wenn eine Funktion JSON erwartet

Manche Funktionen brauchen mehrere zusammengehörige Werte auf einmal. JSON ist eine kompakte Möglichkeit, sie zu gruppieren.

Jeder Eintrag hat links einen Namen und rechts einen Wert. In der Dokumentation ist das als JSON gekennzeichnet.

Du schreibst es mit geschweiften Klammern:

sendEmail({
	from: "[email protected]",
	to: "[email protected]",
	subject: "Thank you for your email",
	text: "We received your request."
})

In diesem Beispiel:

• from ist die Absenderadresse.

• to ist die Empfängeradresse.

• subject ist der E-Mail-Betreff.

• text ist der Nachrichtentext.

Nutze dieses Muster, wenn eine Funktion mehrere benannte Werte wie to, subject oder text braucht.

Häufige Beispiele sind:

• sendEmail(JSON)

• http(..., JSON)

• printRecord(..., JSON)

JSON bedeutet hier einen Wert, den du direkt übergibst, zum Beispiel {to: "[email protected]"}. Es bedeutet keinen Text in Anführungszeichen wie "{\"to\":\"[email protected]\"}".

Weitere Parameterbezeichnungen, die du sehen wirst

Manche Bezeichnungen zeigen einen Typ. Andere zeigen die Rolle des Werts.

Zum Beispiel sind number, date und record Typbezeichnungen. Bezeichnungen wie pattern, separator, from und to zeigen, wie das Argument in der Funktion verwendet wird.

Lies immer beides zusammen:

• Die Bezeichnung zeigt dir die Art des Werts.

• Die Beschreibung zeigt dir, wie dieser Wert verwendet wird.

Parameter-Glossar

Dieser Abschnitt erklärt die Parameterbezeichnungen, die in den Funktionskapiteln unten verwendet werden.

Bezeichnung	Bedeutung
any	Jeder Werttyp, den die Funktion interpretieren oder konvertieren kann
[any]	Eine Liste von Werten
appointment	Ein einzelner Wert, der Start und Ende zusammen enthält
background	Eine Hintergrundfarbe oder ein Stilwert
base	Die Basiszahl in einem Logarithmus oder Potenzausdruck
boolean	true oder false
choice	Ein Wert aus einem Einfachauswahlfeld
date	Ein Datumswert ohne Uhrzeit
datetime	Ein lokaler Datums- und Uhrzeitwert
year, month, day	Numerische Datumsbestandteile
dmulti	Ein dynamisches Mehrfachauswahlfeld
exponent	Die Potenz, die auf eine Basiszahl angewendet wird
field	Ein Feldobjekt
file	Ein Dateiobjekt oder ein Verweis auf einen Anhang
[file]	Eine Liste von Dateiobjekten
flags	Optionale Optionen für reguläre Ausdrücke
fontColor	Ein Textfarbwert
hour, minute, second, millisecond	Numerische Zeitbestandteile
icon	Ein Symbolname oder Symbolwert
id	Eine numerische ID
JSON	Ein strukturiertes Objekt mit benannten Werten
language	Ein Sprachcode für lokalisierte Ausgabe
length	Eine Ziellänge oder Anzahl von Zeichen
link	Ein Linkwert, oft ein Dateilink
location	Ein Standortwert mit Koordinaten
milliseconds	Unix-Zeit in Millisekunden
multi	Ein Mehrfachauswahlfeld
name	Ein Name, zum Beispiel für eine Farbe
nid	Eine Ninox Datensatz-ID
number	Ein numerischer Wert
[number]	Eine Liste numerischer Werte
options	Ein Einstellungsobjekt für eine bestimmte Funktion
padding	Die Zeichen, mit denen Text aufgefüllt wird
pattern	Ein Formatmuster oder regulärer Ausdruck
period	Eine Kalendereinheit wie "day", "week" oder "month"
r, g, b, a	Rot-, Grün-, Blau- und optional Deckkraftwerte
record	Ein Datensatz aus einer Tabelle
[record]	Eine Liste oder Auswahl von Datensätzen
replacement	Der Wert, der einen Treffer ersetzt
script	Ein Ausdruck oder Logikblock, den Ninox auswertet
search	Der Wert oder Text, nach dem gesucht wird
start, end	Start- und Endwerte oder Positionen
separator	Ein Texttrenner oder Teilungszeichen
step	Die Schrittweite in einem Zahlenbereich
string	Einfacher Text, zum Beispiel ein Name, eine Bezeichnung, eine URL oder ein Feldname
[string]	Eine Liste von Textwerten
table	Ein Tabellenobjekt
text	Texteingabe, meist der Quelltext in String-Funktionen
time	Ein Uhrzeitwert
timestamp	Ein UTC-basierter Zeitwert
from, to	Start- und Endwerte oder Positionen
unit	Eine Dauer-Einheit wie "minutes" oder "days"
user	Ein Nutzerwert aus dem Arbeitsbereich
value, value1, value2, ...	Generische Eingabewerte, einzeln oder getrennt übergeben

Tipps zum schnellen Lesen

• Einfache Bezeichnungen wie number oder record zeigen den erwarteten Typ.

• Eckige Klammern wie [number] oder [file] bedeuten "eine Liste von".

• Bezeichnungen wie pattern, separator, from oder subject beschreiben die Rolle des Arguments.

Funktionen nach Kategorien erkunden

Wenn dir die Syntax vertraut ist, nutze diese Kategorien, um schneller die richtige Funktion zu finden:

• Text und Strings: Text kombinieren, bereinigen und formatieren.

• Zahlen und Mathematik: rechnen, runden und aggregieren.

• Datum und Uhrzeit: mit Datumswerten, Dauern und Zeitplänen arbeiten.

• Datensätze und Tabellen: Datensätze auswählen, zählen und verwalten.

• Benutzeroberfläche: Dialoge anzeigen und Datensätze öffnen.

• Dateien und Export: Dateien importieren, erstellen und teilen.

• Nutzer und Arbeitsbereich-Rollen: Verhalten anhand von Nutzerinformationen personalisieren.

• Standort und Geräte: GPS, Telefon und URLs nutzen.

• Integration und HTTP: externe Dienste anbinden.

• System und Ablaufsteuerung: Caching, Timing und Umgebungsprüfungen steuern.

Wenn du die vollständige Referenz brauchst, gehe zur Funktionsbibliothek. Dort findest du einen vollständigen Überblick über dokumentierte Funktionen, inklusive einer alphabetischen Liste für die schnelle Suche.