Diese Funktion ermittelt den Arkuskosinus einer Zahl.

Syntax

acos(number)

Rückgabewert

number

Beispiele

acos(x) berechnet den Arkuskosinus einer Zahl x zwischen -1 und 1.

acos(-0.25)

Ergebnis: 1,8234765819369754

Mit dieser Funktion berechnen Sie die aktuelle Anzahl voller Jahre, die seit einem bestimmten Datum vergangen sind.

Die häufigste Verwendung ist sicher die Berechnung des Alters einer Person anhand des Geburtsdatums, aber es sind auch andere Zwecke denkbar:

• Abschreibungsfristen

• Sonderkündigungsrechte, die nach einer bestimmten Laufzeit möglich sind (z.B. Immobilienkredit)

• Festlegung von Jahrestagen etc.

Syntax

age(date)

Rückgabewert

number

Beispiele

1 age('Geburtsdatum')

Ergebnis: Das Alter in Jahren am aktuellen Tag, ausgehend vom Wert im Feld Geburtsdatum.

1 age(date(1976, 4, 12)) 

Ergebnis: 45 (am 27. Mai 2021)

Mit dieser Funktion können Sie anhand von 2 Zeitstempeln einen Von-bis-Termin erstellen. Statt des 2. Zeitstempels können Sie auch eine Dauer angeben und Ninox erstellt den Ende-Zeitstempel automatisch.

Syntax

appointment(any, any)

Rückgabewert

appointment

Beispiele

appointment(start, ende) / appointment(start, dauer) konvertiert 2 zeitbezogene Werte in einen Termin um.

Ergebnis:

06.03.2021 17:00 – 16.03.2021 19:00 ​

Ergebnis:

22.05.2021 10:00 - 11:45

Siehe auch

Die Funktion ermittelt den Arkussinus einer Zahl.

Syntax

asin(number)

Rückgabewert

number

Beispiele

asin(x) berechnet den Arkussinus einer Zahl x zwischen -1 und 1.

asin(-0.25) 

Ergebnis: -0,25268025514207865

asin(1) 

Ergebnis: 1,5707963267948966

asin(2) 

Ergebnis: (invalid)

Siehe auch

sin, berechnet den Sinus einer Zahl.

Die Funktion ermittelt den Arkustangens einer Zahl.

Syntax

atan(number)

Rückgabewert

number

Beispiele

atan(x) berechnet den Arkustangens einer Zahl x zwischen -1 und 1.

atan(15) 

Beispiele: 1,5042281630190728

Siehe auch

atan2, berechnet den Arkustangens des Quotienten x/y.

tan, berechnet den Tangens.

Mit dieser Funktion können Sie 2 Arrays des gleichen Datentyps verbinden und ein neues Array erzeugen, das aus den Werten beider Arrays besteht.

Es kann praktisch sein, Arrays zur Evaluierung zu verbinden, sodass Sie nur 1 Array abfragen müssen.

Syntax

array([any], [any])

Rückgabewert

[any]

Beispiele

array(meinArray1, meinArray2)

Ergebnis: 1,2,3,4,5,6

Siehe auch

Diese Funktion fügt den gegebenen Inhalt einer temporären Datei hinzu, die über einen durch createTempFile()erzeugten Link abgerufen werden kann.

Verwenden Sie diese Funktion in Verbindung mit createTempFile(), um große Exporte oder solche mit langer Laufzeit zu rendern.

Syntax

appendTempFile(link, string)

appendTempFile(string, string)

Rückgabewert

void

Beispiele

appendTempFile(url, inhalt)fügt einer temporären Datei auf dem Ninox-Server zusätzlichen Inhalt hinzu.

let zeilenumbruch := "
";
let titel := "KundenID,Umsätze" + zeilenumbruch;
URL := do as server
		createTempFile(titel, "export.csv")
	end;
do as server
	for kunde in select Kunden do
		let zeile := kunde.Nr + "," + kunde.Umsätze + zeilenumbruch;
		appendTempFile(URL, zeile
	end
end

Ergebnis: Zuerst wird eine temporäre CSV-Datei auf dem Server erzeugt und der Link zu der Datei im URL-Feld gespeichert. Dann werden Daten aus der Tabelle Kunden der Datei Zeile für Zeile hinzugefügt.

Siehe auch

createTempFile, erstellt eine temporäre Datei auf dem Ninox-Server.

Diese Funktion wandelt den ersten Buchstaben jedes Worts in einen Großbuchstaben um. Das ist praktisch, um eingetragene Daten zu korrigieren, die immer mit einem Großbuchstaben beginnen sollen, zum Beispiel der Vor- und Nachname einer Person.

In Trigger nach Änderung können Sie die Funktion hinzufügen, um die eingetragenen Daten automatisch zu korrigieren.

Syntax

capitalize(string)

Rückgabewert

string

Beispiele

capitalize(Nachname)

Ergebnis: Chamani (mit dem Feld Nachname = chamani)

capitalize("Sam chamani")

Ergebnis: Sam Chamani

Nachname := capitalize(Nachname)

Ergebnis: Dacosta (mit Nachname = dacosta) zum Beispiel, wenn es in Trigger nach Änderung in den Feld-Einstellungen des Text-Feldes Nachname hinzugefügt wurde.

Siehe auch

lower, gibt einen String in Kleinbuchstaben zurück.

upper, gibt einen String in Großbuchstaben zurück.

Die Funktion entfernt vorhandene Vorzeichen und ermittelt den absoluten, positiven Betrag einer Zahl.

Es kommt ziemlich selten vor, aber für bestimmte Berechnungen kann es notwendig sein, weiter mit dem positiven Betrag eines möglicherweise negativen Ergebnisses zu rechnen. In diesen Fällen erspart die Funktion das Abfragen des Betrags und gegebenenfalls das Ändern des Vorzeichens durch Multiplikation.

Syntax

abs(number)

Rückgabewert

number

Beispiele

abs(-9.3)

Ergebnis: 9,3

Siehe auch

sign, gibt das Vorzeichen einer Zahl zurück.

Die Funktion ermittelt den Arkustangens des Quotienten der gegebenen Parameter.

Syntax

atan2(number, number)

Rückgabewert

number

Beispiele

atan2(x,y) berechnet den Arkustangens von x geteilt durch y.

atan2(7,4) 

Ergebnis: 1,0516502125483738

Siehe auch

atan, berechnet den Arkustangens.

tan, berechnet den Tangens einer Zahl.

Mit dieser Funktion können Sie eine Dezimalzahl auf die nächste ganze Zahl aufrunden. Bestehende Dezimalstellen werden entfernt und die verbleibende ganze Zahl wird um 1 erhöht.

Wenn eine ganze Zahl bereits als Parameter übergeben wird, bleibt sie unverändert.

Syntax

ceil(number)

Rückgabewert

number

Beispiele

ceil(2.5) 

Ergebnis: 3

ceil(12.00001) 

Ergebnis: 13

ceil(27) 

Ergebnis: 27

Siehe auch

floor, rundet eine Zahl auf die nächste ganze Zahl a

round, rundet eine Zahl auf bzw. ab.

Mit dieser Funktion berechnen Sie den mathematischen Durchschnitt der numerischen Werte eines Arrays oder einer Tabelle.

Sie können zum Beispiel den durchschnittlichen Umsatz pro Auftrag oder die durchschnittliche Zahlungsdauer von Rechnungen in Tagen etc. berechnen.

Syntax

avg([number])

Rückgabewert

number

Beispiele

avg([1,2,3,4,5,6,7,8,9])

Ergebnis: 5

avg((select Rechnungen).Summe) 

Ergebnis: Durchschnitt aller Rechnungssummen in der Tabelle Rechnungen.

Mit dieser Funktion können Sie Berechnungen eines aufwendigen Skripts bei der ersten Ausführung im Cache zwischenspeichern. Anstelle einer erneuten Berechnung wird dann der gespeicherte Wert zurückgegeben.

Wenn Sie aber eine Neuberechnung Ihres Skriptes anstoßen möchten, haben Sie folgende Optionen:

• Aktivieren Sie den Bearbeitungsmodus

• Führen Sie in einer beliebigen Tabelle Ihrer Datenbank die Funktion invalidate() aus

Mehr zur Optimierung von Skripten

Syntax

cached(skript)

Rückgabewert

any

Beispiele

let cache := cached(
    let nutzer := user();
    select Aufgaben where 'Fälligkeitsdatum' > today() and 'Zugewiesener Nutzer'.'Ninox user' = nutzer
);
cache

Ergebnis: Die Datensätze aus der Tabelle Aufgaben, die noch offen sind und dem aktuellen Nutzer zugewiesen wurden, werden im Cache gespeichert und zurückgegeben.

Siehe auch

invalidate, leert den Cache der Datenbank und die von cached() hinterlegten Werte.

Diese Funktion öffnet ein Pop-up mit einer Meldung und einem OK-Button.

Sie können diese Funktion nutzen, um dem Nutzer Informationen anzuzeigen, die er bestätigen muss, wenn er fortfahren will.

Wenn Sie dem Nutzer Optionen zur Auswahl anbieten wollen, empfehlen wir dialog().

Wenn Sie diese Funktion mehr als einmal im gleichen Skript aufrufen, wird nur der letzte Aufruf der Funktion ausgeführt, der Nutzer muss also nur ein Pop-up bestätigen.

Syntax

alert(any)

Mehr über any >

Rückgabewert

void

Beispiele

alert("Ich bin ein Pop-up. Bitte bestätigen Sie mit 'OK'.") 

Ergebnis: Wenn Sie den Code-Block in einen Button einsetzen, bekommen Sie, wenn Sie den Button klicken, ein Pop-up mit einem OK-Button.

alert("Das ist die aktuelle Zeit: " + time(now()) + ".")

Ergebnis: Das ist die aktuelle Zeit: 17:18. (zeigt die exakte Zeit an, wenn das Pop-up ausgelöst wird.

Siehe auch

dialog, öffnet einen Dialog mit Antwort-Optionen.

Diese Funktion ermittelt alle gewählten Optionen eines Mehrfachauswahl-Feldes und gibt sie in einem Array wieder. Sie können auch abfragen, ob ein spezieller Wert in dem Array enthalten ist.

Syntax

chosen(multi)

chosen(multi, string)

chosen(multi, number)

chosen(dmulit, number)

chosen(multi, [number])

chosen(dmulti, [number])

Rückgabewert

boolean

[string]

Beispiele

Wir haben ein Mehrfachauswahl-Feld Lieblingssportarten mit den folgenden Auswahlwerten:

Basketball, Tanzen, Segeln und Fußball sind ausgewählt.

chosen(mehrfachauswahl, auswahlIdListe) gibt Ja (true) zurück, wenn die Zahlen, die für die Auswahlwert-IDs stehen, in der Auswahl voll abgedeckt sind.

Ergebnis: Ja (true) (Segeln ist auch ausgewählt, aber nicht relevant)

chosen(mehrfachauswahl, auswahlIdListe) gibt Ja (true) zurück, wenn eine Zahl der ID eines der ausgewählten Werte entspricht.

Ergebnis: Ja (true) (Basketball, Tanzen und Fußball sind auch ausgewählt, aber das ist nicht relevant)

chosen(mehrfachauswahl, suchString) gibt Ja (true) zurück, wenn ein String mindestens einem der ausgewählten Auswahlwerte entspricht.

Ergebnis: Ja (true) Ja (wahr) (Tanzen ist die relevante Auswahl, die anderen sind nicht relevant)

Ergenis: Nein (false)

chosen(mehrfachauswahl) gibt alle gewählten Werte aus einem Mehrfachauswahl-Feld zurück

Result: Basketball,Tanzen,Segeln,Fußball

Ergebnis: Ja (true), wenn nur Tanzen gewählt wird, und Nein (false), wenn Tanzen nicht gewählt wird oder auch andere Sportarten gewählt werden. Nein (false) wäre also die Antwort in unserem Beispiel. Damit können Sie diese Datensätze filtern, wenn nur der angegebene Wert ausgewählt wird.

Siehe auch

Diese Funktion schließt das aktuelle Formular.

Sie sehen dann entweder das darunter liegende Formular oder die aktuelle Ansicht ihrer Tabelle, wenn kein anderes Formular geöffnet war.

Nutzen Sie diese Funktion, um eine alternative Möglichkeit hinzuzufügen, das Formular zu schließen. Bei Bedarf können Sie weitere Aktionen hinzufügen.

Syntax

closeRecord()

Rückgabewert

void

Beispiele

Ergebnis: Das aktuelle Datensatz-Formular wird geschlossen.

Siehe auch

, springt zur entsprechenden Tabelle und öffnet einen bestimmten Datensatz.

, schließt alle Datensatz-Formulare.

Mit dieser Funktion können Sie einen Strichcode oder QR-Code mit der Kamera ihres Mobilgeräts scannen.

Syntax

barcodeScan()

Rückgabewert

string

Beispiele

Setzen Sie dieses Skript in einem Button ein.

Ergebnis: Die Kamera scannt den Strichcode und fügt den Wert dem Text-Feld Artikel-Nr. hinzu.

Mit dieser Funktion können Sie einem Farb- oder Formel-Feld einen Farbwert zuweisen. Sie können auch den Farbwert einer gewählten Option in einem Auswahl-Feld erhalten.

Um eine spezielle Farbe zurückzugeben, übergeben Sie entweder einen die Farbe bezeichnenden String oder 3 (bis 4) auf die RGB-/RGBA-Farben verweisende Zahlen.

Syntax

color(string)

color(number, number, number)

color(number, number, number, number)

color(choice)

Rückgabewert

color

Beispiele

Ergebnis: Blau, aber nicht das Ninox-Blau.

Ergebnis: Das Ninox-Blau

Ergebnis: Das Ninox-Blau im RGB-Code

Ergebnis: Das Ninox-Blau im RGB-Code mit einer Deckkraft von 50%

Ergebnis: Gibt die Farbe der gewählten Option des Auswahl-Feldes Status zurück.

Siehe auch

Mit dieser Funktion können Sie die Sprache abfragen, die der Anwender in der jeweiligen App eingestellt hat. Die Sprache wird mit der entsprechenden Abkürzung dargestellt, wie de für Deutsch oder en für Englisch.

Mehr über die

Syntax

clientLang()

Rückgabewert

string

Beispiele

Ergebnis: es (wenn der Anwender Spanisch als Sprache eingestellt hat)

Mit dieser Funktion können Sie die Anzahl an Einträgen in Arrays oder Tabellen zählen, die nicht null oder leere Strings ("") sind.

In Verbindung mit select ... where können Sie Datensätze zählen, die eine bestimmte Bedingung erfüllen. Zum Beispiel, wie viele Einträge den Status offen haben, oder wie viele Nachnamen mit B anfangen.

Diese Funktion kann auch sehr nützlich sein, um festzustellen, ob es Duplikate in Ihrer Tabelle gibt.

Syntax

count([any])

cnt([any])

Rückgabewert

number

Beispiele

count("A", "B", "")

Ergebnis: 2

count(select Rechnungen where Summe >= 1000)

Ergebnis: 98

(wenn die Tabelle Rechnungen 98 Datensätze enthält, wo die Summe höher als 1.000 Euro ist).

let ids := (select Kontakt).'Kunden-Id';
cnt(ids) = cnt(unique(ids))

Ergebnis: Wenn alle IDs eindeutig sind, ist das Ergebnis Ja (true). Wenn es Duplikate gibt, ist das Ergebnis Nein (false).

Siehe auch

select ... where

length, gibt die Länge eines bestimmten Strings als Anzahl der Zeichen zurück.

Die Funktion ermittelt den Kosinus eines Winkels im Bogenmaß. Das Ergebnis ist ein numerischer Wert zwischen -1 und 1.

Syntax

cos(number)

Rückgabewert

number

Beispiele

cos(x) berechnet den Kosinus einer Zahl x zwischen -1 und 1.

cos(-0.25) 

Ergebnis: 0,9689124217106447

Siehe auch

acos, berechnet den Arkuskosinus einer Zahl.

Diese Funktion schließt den aktuellen Vollbildmodus des Formulars.

Syntax

closeFullscreen()

Return

void

Beispiele

Fügen Sie diese Funktion im Formel-Feld eines Buttons hinzu.

closeFullscreen()

Ergebnis: Durch das Klicken des Buttons wird der Vollbildmodus geschlossen.

Siehe auch

openFullscreen, öffnet einen Datensatz im Vollbildmodus.

Mit dieser Funktion können Sie prüfen, ob ein gegebener String oder ein gegebenes Array von beliebiger Länge eine exakte Übereinstimmung enthält.

Wenn Sie nicht nur nach einem speziellen String oder Array suchen, sondern auch seine Position brauchen, eignet sich die Funktion index().

Strings

Hier kommt es auf Groß- und Kleinschreibung an, daher können Sie Ihren Text zunächst mit upper() oder lower() formatieren. Mit contains() kann nach Keywords in Textfeldern gesucht werden oder um festzustellen, ob in einem Mehrfachauswahl-Feld eine spezielle Option ausgewählt wurde.

Arrays

Eine exakte Übereinstimmung bedeutet, dass der gesuchte Wert mit einem der Array-Elemente übereinstimmt.

Syntax

contains(string, string)

contains([any], any)

Rückgabewert

boolean

Beispiele

Strings

contains (meinText, suchString) prüft, ob ein gegebener String eine exakte Übereinstimmung enthält.

contains("Hallo Welt!", "Hallo")  

Ergebnis: Ja (true)

contains("Hallo Welt!", "hallo") 

Ergebnis: Nein (false)

contains(lower("Hallo Welt!"), "hallo") 

Ergebnis: Ja (true)

Arrays

contains([meinArray], suchWert) prüft, ob ein gegebenes Array eine exakte Übereinstimmung enthält.

contains(["A", "B", "C"], "B")

Result: Ja (true)

contains([{ name: "Sam" }], { name: "Sam" })

Result: Nein (false)

JSON-Objekte werden nicht über ihren Inhalt, sondern über ihre Identität verglichen.

Siehe auch

index, ermittelt die erste Position einer gesuchten Übereinstimmung in einem String oder Array.

Diese Funktion schließt alle derzeit geöffneten Formulare. Sie kehren zur aktuellen Ansicht Ihrer Tabelle zurück.

Nutzen Sie die Funktion beispielsweise in einem Button, um verschiedene übereinander liegende Formular-Ebenen schneller zu schließen.

Wenn Sie nur das oberste Formular schließen wollen, empfehlen wir closeRecord().

Syntax

closeAllRecords()

Rückgabewert

void

Beispiele

closeAllRecords()

Ergebnis: Alle offenen Formulare werden geschlossen und Sie kehren zur aktuellen Ansicht Ihrer Tabelle zurück.

Siehe auch

closeRecord, schließt das oberste Datensatz-Formular.

Mit dieser Funktion erstellen Sie eine Erinnerung in der Apple Reminder App.

Syntax

createCalendarReminder(string)

createCalendarReminder(string, timestamp)

createCalendarReminder(string, timestamp, timestamp)

createCalendarReminder(string, string, timestamp, timestamp)

Rückgabewert

void

Beispiele

createCalendarReminder(title) erstellt eine Erinnerung in der Apple Erinnerungen-App mit einem vorgegebenen Titel.

createCalendarReminder(title, start) erstellt eine Erinnerung in der Apple Erinnerungen-App mit einem vorgegebenen Titel und Beginn.

createCalendarReminder(title, from, to) erstellt eine Erinnerung in der Apple Erinnerungen-App mit einem vorgegebenen Titel, Beginn und Ende.

Siehe auch

createCalendarEvent, erstellt ein Ereignis in der Apple Kalender-App.

Mit dieser Funktion können Sie einen direkten Eintrag in der Kalender-App von Apple erzeugen. Wenn kein spezieller Kalender angegeben wird, erstellt Ninox den Eintrag im Standard-Kalender.

Syntax

createCalendarEvent(string, string, timestamp, timestamp)

createCalendarEvent(string, appointment)

createCalendarEvent(string, timestamp, timestamp)

createCalendarEvent(string, string, appointment)

Rückgabewert

void

Beispiele

createCalendarEvent(kalender, titel, von, bis) erstellt ein Ereignis in einem Apple-Kalender mit einem bestimmten Titel sowie einem bestimmten Beginn und Ende.

createCalendarEvent("Privat", "Ninox-Webinar", Beginn, Dauer) 

Ergebnis: Erstellt einen Eintrag namens „Ninox-Webinar“ mit der Startzeit von „Beginn“ und dem aus „Dauer“ im Apple-Kalender „Privat“ berechneten Ende.

createCalendarEvent(titel, termin)erstellt ein Ereignis in der Kalender-App von Apple mit einem bestimmten Titel.

createCalendarEvent(titel, von, bis)erstellt ein Ereignis in der Kalender-App von Apple mit einem bestimmten Titel sowie einem bestimmten Beginn und Ende.

Siehe auch

createCalenderReminder, erstellt eine Erinnerung in der Apple Erinnerungen-App.

Mit dieser Funktion erstellen Sie ein Zip-Archiv, das alle Dateien beinhaltet, die in einem Array übergeben worden sind.

Syntax

createZipFile(nid, [file], string)

Rückgabewert

file

Beispiele

createZipFile(datensatz, dateien, dateiname) erstellt ein Zip-Archiv mit allen Dateien des Arrays dateien und einem bestimmten Namen.

do as server
let produkte := (select Produkte).Foto
Datei := createZipFile(this, produkte, "Produkte.zip")
end

Ergebnis: Im Bild-Feld Datei wird das Zip-Archiv Produkte.zip gespeichert, das alle Produkt-Fotos aus der Tabelle Produkte enthält.

Sieh auch

createTextFile, erstellt eine Textdatei mit einem bestimmten Namen und Inhalt.

Die Funktion createTextFile ermöglicht das Erstellen und Anhängen von Textdateien direkt an Datensätze in Ninox. Dabei können verschiedene Dateitypen wie .txt, .html und .csv generiert werden, die anschließend heruntergeladen oder außerhalb von Ninox weiterverwendet werden können.

Sie können den Dateinamen, die Erweiterung und den Inhalt der Datei festlegen und optional ein Kodierungsformat definieren (im serverseitigen Modus). Wird kein spezifischer Speicherort angegeben, wird die Datei automatisch an den Datensatz angehängt und ist über das Büroklammersymbol (📎) im Anhänge-Tab zugänglich.

Syntax

createTextFile(nid, string, string)

createTextFile(nid, string, string, JSON)

Parameter

• record: Der Datensatz, an den die Textdatei angehängt wird.

• content: Der Textinhalt, der in die Datei geschrieben wird. Er kann auf folgende Weise bereitgestellt werden:

  • Direkte Eingabe als Text in Anführungszeichen, z. B. "Hello, world!".

  • Text aus einem Textfeld, mehrzeiligen Textfeld oder Rich-Text-Feld.

• filename: Der gewünschte Dateiname inklusive Erweiterung, z. B. datei.txt oder dokument.html.

• options (optional, nur serverseitig): Ein JSON-Objekt zur Spezifikation von Kodierungsoptionen.

  • encoding: Legt das Kodierungsformat der Datei fest. Verfügbare Kodierungswerte:

    • 'utf8', 'utf-8'

    • 'utf16le', 'utf-16le' (Aliase: 'usc2', 'usc-2')

    • 'latin1' (Alias: 'binary')

    • 'base64'

    • 'base64url'

    • 'hex'

    • 'ascii'

Rückgabewert

file: Eine generierte Datei, die an den angegebenen Datensatz angehängt wird.

Beispiele

In den folgenden Beispielen enthält Ihre Datenbank folgende Felder:

• Ein Rich-Text-Feld namens Mein Text, das den zu speichernden Inhalt enthält.

• Ein Bild-Feld namens Datei.

• Ein Button namens Dokument erstellen.

Um die folgenden Beispiele auszuführen, öffnen Sie die Einstellungen des Buttons Dokument erstellen und fügen Sie das jeweilige Skript im Formel-Editor unter Beim Klicken hinzu.

1. Einfaches Anhängen einer Textdatei mit Umwandlung in Klartext

Um eine Textdatei mit dem Namen MeinTextDateiBeispiel.txt zu erstellen, die den Klartext aus Mein Text enthält, verwenden Sie:

createTextFile(this, text('Mein Text'), "MeinTextDateiBeispiel.txt")

Erklärung: Die Funktion text('Mein Text') entfernt jegliche Formatierung und gibt den Klartext aus Mein Text zurück.

Ergebnis: Beim Anklicken von Dokument erstellen wird eine .txt-Datei mit dem Namen MeinTextDateiBeispiel.txt erstellt und an den Datensatz angehängt. Sie können die Datei im Tab Anhänge (📎) finden; ein Klick auf das Bildfeld lädt die Datei automatisch herunter.

2. HTML-Datei-Anhang mit Rohtext (einschließlich HTML-Tags)

Um eine HTML-Datei (mit HTML-Tags) namens MeinTextDateiBeispiel.html zu erstellen, die den Inhalt aus Mein Text nutzt und an das Bildfeld Datei angehängt wird, verwenden Sie:

Datei := createTextFile(this, raw('Mein Text'), "MeinTextDateiBeispiel.html")

Erklärung: Die Funktion raw('Mein Text') bewahrt alle HTML-Tags im Feld Mein Text, sodass die Datei als formatierte HTML-Seite im Browser angezeigt werden kann.

Ergebnis: Beim Anklicken von Dokument erstellen wird eine .html-Datei mit dem Namen MeinTextDateiBeispiel.html erstellt und an das Bildfeld Datei angehängt. Ein Klick auf das Bildfeld lädt die Datei automatisch herunter.

3. HTML-Datei mit UTF-8-Kodierung

Um eine UTF-8-Kodierung auf eine HTML-Datei anzuwenden, die aus Mein Text erstellt wird, verwenden Sie die serverseitige Variante der Funktion in einem do as server-Block:

do as server
  Datei := createTextFile(this, raw('Mein Text'), "MeinTextDateiBeispiel.html", {encoding: "utf8"})
end

Erklärung: Der serverseitige Block (do as server ... end) ist erforderlich, um encoding anzugeben.

Ergebnis: Beim Anklicken von Dokument erstellen wird eine .html-Datei (in UTF-8 kodiert) mit dem Namen MeinTextDateiBeispiel.html erstellt und an das Bildfeld Datei angehängt. Ein Klick auf das Bildfeld lädt die Datei automatisch herunter.

Siehe auch

file, gibt auf Basis des Dateinamens eine bestimmte Datei aus einem Datensatz zurück.

importFile, importiert eine Datei über eine URL und speichert diese als Anhang eines Datensatzes.

Diese Funktion gibt Werte aus einem Array, einer Tabelle oder einem Mehrfachauswahl-Feld hintereinander und durch ein Komma getrennt in einem Text-Feld oder einer Textvariablen zurück.

Sie wird verwendet, um die gewählten Optionen eines Mehrfachauswahl-Feldes als fortlaufenden Text darzustellen, zum Beispiel bei Formularen oder Druck-Layouts.

Es wird häufig für Zwischenschritte in einem Script verwendet.

Syntax

concat([any])

Rückgabewert

string

Beispiele

concat(Nachname, Vorname) 

Ergebnis: Böhmer, Frank (mit Nachname = Böhmer und Vorname = Frank)

Siehe auch

join, gibt einen String aus allen Elementen eines Arrays zurück, getrennt durch ein bestimmtes Zeichen.

Diese Funktion extrahiert das Datum aus einem Zeitstempel. Sie gibt auch ein Datum basierend auf den numerischen Werten für Jahr, Monat und Tag zurück.

Wenn Sie „0“ als Wert für den Tag angeben, wird der letzte Tag des vorangegangenen Monats zurückgegeben. Dies ist eine praktische Art, den letzten Tag eines Monats zu bestimmen.

Außerdem kann eine Unix-Zeit-Spezifikation in Millisekunden in ein Datum umgewandelt werden.

Syntax

date(any)

date(number, number, number)

Rückgabewert

‌date

‌Beispiele

‌date(jahr, monat, tag)gibt einen Datumswert zurück.

date(2021, 8, 0)

‌Ergebnis: 31.07.2021 (letzter Tag des vorangegangenen Monats)

‌date(zeitWert)wandelt einen bestimmten zeitbezogenen Wert in einen Datumswert um. Wenn der Wert eine Zahl ist, stellt er die Unix-Zeit in Millisekunden dar.

date('Datum + Uhrzeit')

‌Ergebnis: Datum aus dem Feld Datum + Uhrzeit

date(start(Termin))

‌Ergebnis: Datum des Beginns aus dem Feld Termin.

date(1617873118285)

‌Ergebnis: 09.04.2021

‌Siehe auch

‌time, gibt die aktuelle Zeit zurück.

Mit dieser Funktion können Sie einen Zeitstempel aus einem Datum und einer Zeit oder numerischen Werten erzeugen. Wenn der Parameter für die Zeit fehlt, wird automatisch 00:00 Uhr verwendet.

Syntax

datetime(number)

datetime(number, number, number)

datetime(number, number, number, number)

datetime(number, number, number, number, number)

datetime(number, number, number, number, number, number)

Rückgabewert

timestamp

Beispiele

‌datetime(jahr, monat, tag)gibt einen Zeitstempel aus den gegebenen Zahlen für Jahr, Monat und Tag zurück.numbers.

‌Ergebnis: 27.05.2021 00:00 (die Uhrzeit wird automatisch gesetzt)

‌datetime(jahr, monat, tag, stunde) gibt einen Zeitstempel aus den gegebenen Zahlen für Jahr, Monat, Tag und Stunde zurück.

‌datetime(jahr, monat, tag, stunde, minute) gibt einen Zeitstempel aus den gegebenen Zahlen für Jahr, Monat, Tag, Stunde und Minute zurück.

‌Ergebnis: 05/27/2021 18:05 (US) 27.05.2021 18:05

‌datetime(jahr, monat, tag, stunde, minute, sekunde) gibt einen Zeitstempel aus den gegebenen Zahlen für Jahr, Monat, Tag, Stunde, Minute und Sekunde zurück.

‌datetime(jahr, monat, tag, stunde, minute, sekunde, millis)gibt einen Zeitstempel aus den gegebenen Zahlen für Jahr, Monat, Tag, Stunde, Minute, Sekunde und Millisekunde zurück.

datetime(datum, uhrzeit)wandelt ein Datum und eine Zeit in einem Zeitstempel um.

‌Ergebnis: Das Datum des Felds Datum und die Uhrzeit des Felds Uhrzeit, zum Beispiel 27.05.2021 18:05.

‌datetime(millis)wandelt eine gegebene Zahl in einen Zeitstempel um, wenn die Zahl die Unix-Zeit in Millisekunden darstellt.

Siehe auch

Diese Funktion erstellt eine temporäre Datei auf dem Ninox-Server mit dem gegebenen Inhalt und Dateinamen und gibt einen Link zu dieser Datei zurück.

Nur Mitglieder des entsprechenden Arbeitsbereichs (Team) können über den Link auf die Datei zugreifen.

Verwenden Sie diese Funktion in Verbindung mit appendTempFile(), um große Exporte oder solche mit langer Laufzeit zu rendern.

Da diese Datei zeitlich begrenzt ist, wird sie irgendwann automatisch gelöscht. Behalten Sie das bitte im Kopf.

Syntax

createTempFile(string, string)

Rückgabewert

link

Beispiele

createTempFile(inhalt, dateiName) erstellt eine temporäre Datei auf dem Ninox-Server

Ergebnis: Das URL-Feld enthält einen Link zur export.csv-Datei.

Siehe auch

Mit dieser Funktion können Sie die Anzahl an Tagen zwischen 2 Datumswerten berechnen. Alle Tage der Woche zählen, d.h. Montag bis Sonntag. Alle Datentypen, die ein Datum enthalten, können verwendet werden.

Die Funktion ist praktisch, um Fristen, Zeiträume und Fälligkeitstage festzulegen und zu prüfen.

Syntax

days(date, date)

‌Rückgabewert

‌number

Beispiele

‌days(start, ende)gibt die Anzahl an Tagen zwischen 2 gegebenen Datumswerten zurück.

Datum1 = 24.12.2022 und Datum2 = 31.12.202

‌Ergebnis: 183 (Tage bis Silvester)

‌Siehe auch

‌, gibt die Anzahl der Arbeitstage (Montag – Freitag) zwischen 2 Datumswerten zurück.

Die Funktion ermittelt den entsprechenden Gradwert eines Bogenmaßes. Sie wird vor allem für trigonometrische Berechnungen benutzt.

Syntax

degrees(number)

Rückgabewert

number

Beispiele

degrees(x)wandelt einen Winkel x von Bogenmaß in Grad um.

Result: 180

Siehe auch

, wandet einen Winkel von Grad in Bogenmaß um.

Mit dieser Funktion erstellen Sie ein exaktes Duplikat des Datensatzes, auf den Sie diese Funktion anwenden. Außerdem werden verknüpfte Daten aus Untertabellen übertragen.

Syntax

duplicate(nid)

Return

nid

Examples

Ergebnis: Der vorliegende Datensatz – mit allen Einträgen – wird dupliziert.

Ergebnis: Erstellt ein Duplikat des vorliegenden Datensatzes und öffnet es.

Siehe auch

‌Diese Funktion extrahiert den Tag eines Monats aus einem Datum, einem Termin oder einem Zeitstempel; daher ist das Ergebnis ein numerischer Wert zwischen 1 und 31.

Für die Berechnung können Sie alle Datentypen verwenden, die ein Datum enthalten.

Syntax

day(appointment)

day(date)

day(timestamp)

‌Rückgabewert

‌number

Beispiele

‌day(termin)gibt den Tag eines gegebenen Beginns eines Termins zurück.

‌day(datum)gibt den Tag des Monats eines Termins zurück.

‌Ergebnis: 1

(mit Datum = 01.07.2021)

‌day(zeitstempel)gibt den Tag des Monats eines Zeitstempels zurück.

‌Ergebnis: 20 (von 20. Juni 2021)

‌Siehe auch

Diese Funktion löst ein Pop-up mit von Ihnen eingerichteten Hinweisen aus. Sie können eine Reihe an möglichen Antworten hinzufügen, beispielsweise Ja oder Nein.

Das laufende Skript wird angehalten, bis der Anwender eine Antwort gewählt hat.

Das Ergebnis kann in einem Feld oder einer Variablen gespeichert werden und daher bei der weiteren Ausführung des Skripts verarbeitet werden.

Syntax

dialog(string, string, [string])

Rückgabewert

string

Beispiele

dialog(titel, nachricht, antwortOptionen) öffnet einen Dialog mit Antwortoptionen.

Fügen Sie dieses Skript einem Button hinzu.

Ergebnis: Sie sollten dieses Pop-up bekommen. Durch das Anklicken von Ja wird dieser Datensatz gelöscht.

Siehe auch

Diese Funktion liefert Ihnen die ID der aktuellen Datenbank, in der Sie sind.

Syntax

databaseId()

Rückgabewert

string

Beispiele

databaseId()

Ergebnis: mcxhedkkmvpp (zum Beispiel)

Siehe auch

teamId, gibt die ID des aktuellen Arbeitsbereichs zurück.

tableID, gibt die ID einer Tabelle zurück.

Die Funktion berechnet die Exponentialfunktion mit der Euler‘schen Zahl als Basis und heißt deswegen natürliche Exponentialfunktion.

Syntax

exp(number)

Rückgabewert

number

Beispiele

exp(x)berechnet die Potenz zur Basis e (e ist die Euler‘sche Zahl) mit einer Zahl x als Exponent.

exp(1) 

Ergebnis: 2,718281828459045 (die Euler‘sche Zahl)

exp(0) 

Ergebnis: 1

exp(5 - 2)

Ergebnis: 20,085536923187668

Siehe auch

ln, berechnet den natürlichen Logarithmus einer Zahl.

Diese Funktion berechnet für Sie die Dauer eines Termins, d.h. die Zeit zwischen Beginn und Ende. Das Ergebnis wird in Stunden und Minuten ausgegeben.

Wenn die Dauer länger als 24 h ist, werden zusätzlich die Tage angezeigt. Es gibt keine Umwandlung von Tagen in Wochen, Monate oder Jahre.

Syntax

duration(appointment)

Rückgabewert

timeinterval

Beispiele

duration(Urlaub1)

Ergebnis: 4 Tage 9:00 (mit Urlaub1: 24.05.2021 09:00 – 28.05.2021 18:00)

duration(appointment(date(2021, 3, 27), date(2021, 3, 29)))

Ergebnis: 2 Tage

Siehe auch

appointment, konvertiert bestimmte zeitbezogene Werte in einen Termin um.

Mit dieser Funktion können Sie einen bestimmten Dateianhang eines Datensatzes abrufen, z.B. um ihn in einem Bild-Feld darzustellen oder ihn als Anhang einer automatisch generierten E-Mail zu versenden.

Syntax

file(nid, string)

Rückgabewert

file

Beispiele

file(datensatz, dateiName)gibt anhand des Dateinamens eine bestimmte Datei aus einem Datensatz zurück.

file(this,"RE-2021_13874.pdf")

Ergebnis: Gibt die Datei “RE-2021_13874.pdf” aus dem aktuellen Datensatz zurück.

Siehe auch

files, gibt alle Anhänge eines Datensatzes als Array zurück.

importFile, importiert eine Datei über eine URL und speichert diese als Anhang eines Datensatzes.

Diese Funktion gibt den internen Bezeichner eines bestimmten Feldes zurück. Ein Feld ist eine Stelle, die in einer Zeile einer Tabelle in einer Datenbank gespeichert ist. Jedes Feld ist durch eine ID, einen Namen und einen Feldtyp definiert. Feld-IDs sind Großbuchstaben und beginnen mit „A”, „B”, ..., „AA”, „AB” usw.

Syntax

fieldId(nid, string)

fieldId(string, string)

Rückgabewert

string

Vorteile von fieldId

• Keine direkten UI-Referenzen im Skript: Mit dieser Funktion können Sie mit Feld-IDs anstelle von Feldnamen arbeiten, so dass Ihre Skripte nicht an bestimmte UI-Elemente gebunden sind. Dies ist nützlich, wenn sich Feldnamen im Laufe der Zeit ändern.

Anwendungsfälle für fieldId

• Berechnungen ohne Feldnamen: Sie können fieldId nutzen, um Berechnungen durchzuführen oder mit Daten zu arbeiten, ohne den genauen Feldnamen zu kennen. Das macht Ihre Skripte flexibler.

• Zeile mit JSON-Objekten füllen: Sie können fieldId verwenden, um eine Zeile einfach mit Daten aus JSON-Objekten zu füllen. Das vereinfacht die Dateneingabe und -verwaltung.

Beispiele

1. Verwenden Sie fieldId(nid, feldname), um die Feld-ID zu erhalten. Geben Sie dafür die Datensatz-ID der aktuellen Tabelle (nid) und den Feldnamen an.

fieldId(this, "Name")

Rückgabewert: D

Dies ist die ID des Feldes mit dem Namen „Name“ in der aktuellen Tabelle.

1. Verwenden Sie fieldId(tabellenname, feldname), um die Feld-ID zu erhalten. Geben Sie dafür den Tabellen- und Feldnamen an.

fieldId("Kunde", "Name")

Rückgabewert: A

Dies ist die ID des Feldes mit dem Namen „Name“ in der Tabelle „Kunde“.

1. Verwenden Sie fieldId(feldname), um die Feld-ID zu erhalten. Geben Sie dafür den Feldnamen an.

fieldId(Zahl)

Rückgabewert: D

Dies ist die ID des Feldes mit dem Namen „Zahl” in der aktuellen Tabelle.

Siehe auch

tableId, gibt die ID der aktuellen Tabelle zurück.

databaseId, gibt die ID der aktuellen Datenbank zurück.

teamId, gibt die ID des aktuellen Arbeitsbereichs zurück.

Mit dieser Funktion können Sie prüfen, ob eine Zahl gerade, d.h. ohne Rest durch 2 teilbar ist. Der Rückgabewert ist entweder Ja (true) oder Nein (false). Die 0 wird auch als gerade bewertet.

Syntax

even(number)

Rückgabewert

boolean

Beispiele

even(10 + 12) 

Ergebnis: Ja (true)

even(10 + 13) 

Ergebnis: Nein (false)

even(0) 

Ergebnis: Ja (true)

even(10.2) 

Ergebnis: Nein (false)

Siehe auch

odd, gibt Ja (true) zurück, wenn die Zahl ungerade ist.

Die Funktion gibt den Zeitstempel des Endes eines Termins zurück. Das Ergebnis ist ein Wert mit Datum und Zeit, der weiterverarbeitet oder formatiert werden kann.

Syntax

endof(appointement)

Rückgabewert

timestamp

Beispiele

endof('Termin') 

Ergebnis: 03.07.2021 18:00

(mit „Termin“ = 02.06.2021 09:00 - 03.07.2021 18:00)

format(endof('holiday1'), "dddd, HH:mm") + " h" 

Ergebnis: Freitag, 18:00 h

(mit Urlaub1: 24.05.2021 09:00 - 28.05.2021 18:00)

Siehe auch

start, gibt den Zeitstempel des Beginns eines Termins zurück.

Sie können mit dieser Funktion auf den ersten Eintrag eines Arrays zugreifen. Diese Funktion ist praktisch, wenn Sie auf einen Datensatz in einem Array von Datensätzen zugreifen wollen.

Wenn Sie diese Funktion mit select verbinden und das entsprechende Array mehr als 1 Element hat, empfehlen wir, das Array zuerst mit order by zu sortieren.

Syntax

first([any])

Rückgabewert

any

Beispiele

first(["B", "A", "C"])

Ergebnis: B

first(select Kunde)

Ergebnis: Gibt den ersten Datensatz der Tabelle Kunde zurück.

first((select Kunde where substr('Nachname', 0, 1) = "A") order by 'Nachname')

Ergebnis: Gibt den ersten Datensatz der Tabelle Kunde zurück, bei dem der Nachname mit A beginnt.

Siehe auch

last, gibt das letzte Element eines Arrays zurück.

item, extrahiert einen Wert aus einem Array oder Objekt.

Diese Funktion konvertiert ein JSON-Objekt in einen String. Das kann hilfreich sein, wenn Sie den Inhalt eines eingehenden JSON-Objekts prüfen oder es mit anderen Text-Funktionen modifizieren wollen.

Syntax

formatJSON(JSON)

Rückgabewert

string

Beispiele

Wenn dieses Skript in einen Button eingefügt ist, können Sie die Antwort auf eine API GET-Anfrage im Feld Text speichern, um das Antwort-Objekt (response) zu prüfen. Ohne formatJSON() wäre das Ergebnis nicht sehr hilfreich.

Mehr über API bei Ninox (im Moment nur in unserer englischen Dokumentation).

let datenbankURL := "https://api.ninoxdb.de/v1/teams/" + teamId() + "/databases/" + databaseId() + "/tables/" + tableId(this);
let APIKey := "Bearer abcd1234-0000-xxxx-zzzz-1a1aa1aaa1a111";
let response := http("GET", datenbankURL, {
		Authorization: APIKey
	}, null);
'Text' := formatJSON(response)

Ergebnis: Sie bekommen einen JSON-String mit Daten ihrer aktuellen Tabelle:

{"result":{"id":"I","name":"Tabelle1","fields":[{"id":"A","name":"Text","type":"string"},{"id":"B","name":"Zahl","type":"number"},{"id":"D","name":"Text 2","type":"string"}]}}

Siehe auch

parseJSON, konvertiert einen JSON-String in ein JSON-Objekt.

text, konvertiert einen Wert in einen String und berücksichtigt dabei möglichst die Format-Optionen.

Mit dieser Funktion finden Sie die Metadaten einer Datei. Sie erhalten:

• Dateiname

• Dateigröße

• Änderungsdatum

Syntax

fileMetadata(nid, string)

Rückgabewert

JSON

Beispiele

fileMetadata(datensatz, dateiname)gibt die Metadaten wie Dateiname, Dateigröße und Änderungsdatum einer bestimmten Datei und Dateinamens zurück.

filedata(this, "Rechnung_001.pdf")

Ergebnis:

{"name":"Rechnung_001.pdf","size":95935,"modifiedDate":1661385600000}

fileMetadata(this, last(split(text(Rechnung), "/"))) 

Ergebnis:

{"name":"Rechnung_001.pdf","size":95935,"modifiedDate":1661385600000}

wobei der Dateiname aus dem Bild-Feld Rechnung gezogen wird.

Siehe auch

item, extrahiert einen Wert aus einem Array oder Objekt.

Verwenden Sie diese Funktion, um Daten in das XML-Format zu konvertieren. XML ist neben JSON eines der gängigsten Formate für den Datenaustausch. Deswegen ist diese Funktion von besonderem Interesse bei der Verbindung zu externen Servern über API.

Mehr über API bei Ninox (im Moment nur in unserer englischen Dokumentation).

Syntax

formatXML(JSON)

formatXML(JSON, boolean)

Rückgabewert

string

Beispiele

formatXML(JSON)konvertiert ein gegebenes JSON-Objekt in XML-Text.

formatXML(json,istFormatiert)konvertiert ein gegebenes JSON-Objekt in XML-Text. Wenn istFormatiert wahr (true) ist, ist der Text optisch strukturiert.

formatXML({
    kontakt: {
        @type: "Person",
        vorname: {
            @: 'Vorname'
        },
        nachname: {
            @: 'Nachname'
        },
        telefon: [{
                @type: "Mobil",
                @: Mobil
            }, {
                @type: "Telefon",
                @: Telefon
            }]
    }
}, true)

Ergebnis: Sie erhalten einen XML-String mit den Daten des JSON-Objekts.

<?xml version="1.0" encoding="utf-8"?>
<kontakt type="Person">
    <vorname>Steve</vorname>
    <nachname>Rogers</nachname>
    <telefon type="Mobil">(+1) (202) 123 45 67</telefon>
    <telefon type="Telefon">+1.151.11 ++66 14 66</telefon>
</kontakt>

Siehe auch

parseXML, konvertiert einen XML-String in ein JSON-Objekt.

Im Gegensatz zu file() können Sie mit dieser Funktion alle Dateianhänge eines Datensatzes ansprechen, z.B. um sie als Anhang einer automatisch generierten E-Mail zu versenden oder nach bestimmten Dateien in einer Tabelle suchen.

Syntax

files(nid)

Rückgabewert

[file]

Beispiele

files(this)

Ergebnis: Ein Array mit allen Anhängen des vorliegenden Datensatzes.

count(files(this))

Ergebnis: 10 (wenn der vorliegende Datensatz 10 Anhänge hat).

Sie (Steve Rogers) würden gerne eine E-Mail mit den Anhängen des aktuellen Datensatzes an Hulk schicken. Das wäre das Skript im Button innerhalb des Datensatzes, den Steve anklicken würde, um den Vorgang auszulösen.

sendEmail({
	from: "steve@avengers.com",
	to: "hulk@avengers.com",
	subject: "Wichtige Dokumente",
	body: "Hier kommen die wichtigen Dokumente!",
	attachments: files(this)
})

Ergebnis: Hulk erhält eine E-Mail mit allen Anhängen des aktuellen Datensatzes.

Siehe auch

file, gibt auf Basis des Dateinamens eine bestimmte Datei aus einem Datensatz zurück.

importFile, importiert eine Datei über eine URL und speichert diese als Anhang eines Datensatzes.

Mit dieser Funktion können Sie feststellen, ob ein Passwort notwendig ist, um den Bearbeitungsmodus zu aktivieren, und ob es bereits eingegeben ist … oder nicht.

Wenn die Funktion Nein (false) zurückgibt, wurde das Passwort bereits eingegeben oder die Datenbank ist nicht durch ein Passwort geschützt.

Syntax

isDatabaseLocked()

Rückgabewert

boolean

Beispiele

isDatabaseLocked()

Ergebnis: Nein (false), wenn die Datenbank nicht durch ein Passwort geschützt ist oder der Aministrator das Passwort bereits eingegeben hat.

if isDatabaseLocked() then  
    "Geben Sie das Passwort ein, um den  Bearbeitungsmodus zu aktivieren!" 
end 

Wenn Sie das obige Script in ein Formel-Feld eingeben, erhalten Sie das folgende Ergebnis.

Ergebnis:

(wenn der Bearbeitungsmodus in einer Datenbank passwortgeschützt ist und das Passwort noch nicht eingegeben wurde)

Siehe auch

isDatebaseProtected, gibt Ja (true) zurück, wenn ein Passwort erforderlich ist, um den Bearbeitungsmodus zu aktivieren.

Mit dieser Funktion können Sie Zahlen, Datums- und Zeitwerte nach Ihrem Bedarf formatieren und sie in Text- oder Formelfeldern verwenden.

Besonderheit: Zahlen formatieren

Wenn Sie mit dieser Funktion Zahlen formatieren möchten, müssen Sie die Vorgaben zur Formatierung in einer bestimmten Reihenfolge angeben:

1. Zuerst geben Sie an, ob ein Präfix eingefügt werden soll, z.B. ein Währungssymbol.

2. Soll ein 1000er-Trennzeichen eingefügt werden?

3. Machen Sie Angaben dazu, ob bzw. wie viele Dezimalstellen Sie anzeigen möchten.

4. Geben Sie eine Einheit an, z.B. ein Währungszeichen.

5. Art des Dezimalstellen-Zeichens, z.B. Punkt (.), Komma (,), einfacher Anführungsstrich (') oder doppelte Anführungsstriche (").

6. Art des 1000er-Trennzeichens, z.B. Punkt (.), Komma (,), einfacher Anführungsstrich ('), doppelte Anführungsstriche (") oder ein Leerzeichen ( )

Syntax

format(number, string)

format(date, string)

format(date, string, string)

format(appointment, string)

format(appointment, string, string)

format(timestamp, string)

format(timestamp, string, string)

format(time, string)

Rückgabewert

string

Beispiele

format(meineZahl, formatExpression) formatiert eine Zahl als String.

format(2385.97, "#,##0.00 €#,#0.0")

Ergebnis: 2.385,97 €

format(2385.97, "$#,##0.00US#.#0,0")

​Ergebnis: $2,385.97US

format(12345, "0000000000")

Ergebnis: 0000012345

​

format(datum, formatAusdruck) formatiert ein Datum als String.

format(Datum, "ddd, Do MMMM YYYY")

Ergebnis: Mo., 31. Mai 2021

(mit „Datum“ = 31.05.2021)

​

format(datum, formatAusdruck, sprache) formatiert ein Datum als String, wo das Ergebnis in einer bestimmten von Ninox unterstützten Sprache erscheint.

​

format(datum, formatAusdruck) formatiert einen Zeitstempel als String.

format(now(),"X")

Ergebnis: 1622466387 (am 31. Mai 2021 15:06)

X zeigt das Ergebnis ohne Millisekunden! x zeigt das Ergebnis mit Millisekunden.

​

format(meinTermin, formatAusdruck) formatiert den Beginn eines Termins als String.

​

format(meinTermin, formatExpression, sprache) formatiert den Beginn eines Termins als String, wo das Ergebnis in einer bestimmten von Ninox unterstützten Sprache erscheint.

​

format(zeit, formatAusdruck) formatiert eine Zeit als String.

​

format(zeitstempel, formatAusdruck, sprache) formatiert einen Zeitstempel als String, wo das Ergebnis in einer bestimmten von Ninox unterstützten Sprache erscheint.

Mit dieser Funktion können Sie Text darstellen, der HTML-Tags enthält. Sie können alle grundlegenden HTML-Tags zur Darstellung verwenden, aber auch Tabellen, Listen und Inline-Styles.

Das Ergebnis kann zum Beispiel in einem Formel-Feld dargestellt oder zusammen mit sendEmail verwendet werden.

In einem normalen Textfeld werden HTML-Tags nicht interpretiert, sondern einfach als Text dargestellt.

In einem Rich-Text-Feld wird der Text entsprechend den HTML-Tags formatiert.

Syntax

html(any)

Rückgabewert

html

Beispiele

Ergebnis: Ninox ist toll!

Ergebnis: Ninox ist toll! in einem roten Kasten der Größe (100px x 100px) in einem Rich-Text-Feld.

Mit dieser Funktion können Sie eine Datei importieren und sie an einen Datensatz anhängen oder in ein Bild-Feld einfügen.

Die Datei kann aus einer externen URL gezogen/abgerufen werden. Aber mit printAndSaveRecord() können Sie auch eine extra erstellte Datei anhängen.

Syntax

importFile(nid, string)

importFile(nid, link)

importFile(nid, string, string)

importFile(nid, link, string)

Rückgabewert

file

Beispiele

importFile(datensatz, link, dateiname) importiert eine Datei über einen gegebenen URL-String und speichert sie als Anhang eines Datensatzes.

Ergebnis: Die über den gegebenen Link gelieferte Datei hängt am aktuellen Datensatz mit dem Namen Bild.jpg.

Ergebnis: Druckt den aktuellen Datensatz im Rechnungs-Layout als PDF und speichert die Datei im Bild-Feld Rechnung.

Siehe auch

Diese Funktion konvertiert ein reguläres Formel-Feld in ein E-Mail-Feld mit einem Mailto-Button.

Klicken Sie auf den Button, um Ihren lokalen E-Mail-Client zu öffnen und eine E-Mail zu versenden.

Syntax

email(any)

Rückgabewert

email

Beispiele

email(emailAdresse)

Ergebnis: steve.rogers@theavengers.com

(als E-Mail-Feld mit einem kleinen Briefumschlag, den Sie anklicken können und der sich direkt mit ihrem voreingestellten E-Mail-Client verbindet)

Siehe auch

Mit dieser Funktion können Sie die Position eines gesuchten Wertes innerhalb eines gegebenen Strings oder Arrays ermitteln.

Im Gegensatz zu contains() wird dabei nicht nur geprüft, ob der gesuchte Wert vorhanden ist, sondern es wird auch der numerische Wert seiner Startposition innerhalb eines Strings oder Arrays ermittelt. Gezählt wird ab 0.

Strings

Wenn der gesuchte Wert Teil eines Strings ist, wird die Position der ersten Zeichen der Übereinstimmung zurückgegeben. Das Ergebnis ist dann 0.

Arrays

Wenn es kein Array-Element gibt, das mit dem gesuchten Wert identisch ist, wird das Ergebnis -1 ausgegeben.

Syntax

index(string, string)

index([any], any)

Rückgabewert

number

Beispiele

Strings

index(string, suchString) ermittelt die erste Position einer gesuchten Übereinstimmung in einem String, beginnend mit 0.

Ergebnis: 3

Ergebnis: 0

Ergebnis: -1 (keine genaue Übereinstimmung gefunden)

Arrays

index([meinArray], suchWert) ermittelt die erste Position einer gesuchten Übereinstimmung in einem Array, beginnend mit 0.

Ergebnis: 2

Ergebnis: 2

Ergebnis: -1 (keine genaue Übereinstimmung gefunden)

Siehe auch

Mit dieser Funktion können Sie die erste Entsprechung eines Such-Strings in einem Text extrahieren.

Statt einfacher Strings in einem Suchmuster können Sie reguläre Ausdrücke (regex) verwenden. Das heißt, Sie haben viel mehr Möglichkeiten zur Textanalyse.

Sie können diese Funktion zum Beispiel verwenden, um relevante Informationen aus importierten Daten zu extrahieren.

Syntax

extractx(string, string)

extractx(string, string, string)

extractx(string, string, string, string)

Rückgabewert

string

Beispiele

extractx(meinText, regex, flags, extract)extrahiert einen String aus einem gegebenen Text unter Verwendung eines regulären Ausdrucks. Dem regulären Ausdruck können Flaggen hinzugefügt werden. Der String kann mit einem gegebenen Auszug weiterverarbeitet werden..

Wir haben eine Datenbank mit einigen Datensätzen. Wir haben auch …

• ein Bild-Feld Mein Anhang mit einer Datei WichtigesDokument.pdf

• ein Formel-Feld Dateiname

Öffnen Sie den Feld-Editor Ihres Formel-Felds Dateiname und fügen Sie das folgende Skript dem Formel-Feld Formel hinzu:

Result: Im Formel-Feld sehen Sie den Namen des Anhangs: WichtigesDokument.pdf

extractx(meinText, regex, extract)extrahiert einen String aus einem gegebenen Text unter Verwendung eines regulären Ausdrucks. Der String kann mit einem gegebenen Auszug weiterverarbeitet werden.

extractx(myText,regex)extrahiert einen String aus einem gegebenen Text unter Verwendung eines regulären Ausdrucks.

Siehe auch

Diese Funktion können Sie anhand eines Indexes oder Keys auf ein bestimmtes Element in einem Array oder JSON-Objekt zugreifen.

Ein Key in einem JSON-Objekt kann ein String oder eine Zahl sein.

Syntax

item([any], number)

item(JSON, number)

item(JSON, string)

Rückgabewert

any

Beispiele

item(myArray, auswahl)extrahiert ein einzelnes Element aus einem Arrays. Dabei fängt der Index bei 0 an.

Ergebnis: Gurke

Ergebnis: Ninox Software GmbH, wobei das Komma (,) der Separator ist und 0 für den ersten Eintrag steht. 1 würde Monbijouplatz 5 ergeben.

item(myJSON, key)extrahiert den Wert eines Key-/Wert-Paars in einem JSON-Objekt. Der Key kann ein String oder eine Zahl sein.

Ergebnis: Steve

Siehe auch

Stellen Sie fest, ob für die Aktivierung des Bearbeitungsmodus ein Passwort erforderlich ist.

Syntax

isDatabaseProtected()

Rückgabewert

boolean

Beispiele

Ergebnis: Ja (true), wenn die Datenbank durch ein Passwort geschützt ist.

Wenn Sie das obige Script in ein Formel-Feld eingeben, erhalten Sie das folgende Ergebnis.

Ergebnis: Der Bearbeitungsmodus erfordert ein Passwort! (wenn der Bearbeitungsmodus in einer Datenbank passwortgeschützt ist).

Siehe auch

Führen Sie mehrere Elemente aus einem Array bzw. einer Tabelle in einem String zusammen.

Im Gegensatz zur Funktion concat() können Sie hier jedoch angegeben, welches Zeichen die Elemente trennen soll. Das kann zum Beispiel ein Komma sein, aber auch ein Zeilenumbruch. Wählen Sie einen Zeilenumbruch aus, können Sie die Einträge in einem mehrzeiligen Textfeld ausgeben.

Syntax

join([string], string)

Rückgabewert

string

Beispiele

join(stringArray, trennzeichen) Gibt einen String aus allen Elementen eines angegebenen Arrays zurück, getrennt durch ein bestimmtes Zeichen. Das Trennzeichen kann auch ein Zeilenumbruch sein.

Ergebnis: A B C

Ergebnis: Die Namen aller Kunden, deren Umsatz größer als 10.000 € ist, nacheinander durch Komma getrennt.

Siehe auch

Mit dieser Funktion können Sie feststellen, ob der aktuelle Anwender im Bearbeitungsmodus ist, d.h. das Werkzeug-Symbol aktiviert ist (rot).

Syntax

isAdminMode()

Rückgabewert

boolean

Beispiele

Ergebnis: Ja (true), wenn Sie das Werkzeug-Symbol aktiviert haben, um Ihre Datenbank zu bearbeiten

Siehe auch

, gibt Ja (true) zurück, wenn die Datenbank gesperrt ist.

, gibt Ja (true) zurück, wenn ein Passwort erforderlich ist, um den Bearbeitungsmodus zu aktivieren.

, gibt Ja (true) zurück, wenn ein bestimmter Anwender die Administrator-Rolle hat.

Diese Funktion gibt den Wert eines Feldes zurück. Mit get können Sie auf Felder über ihren Namen oder ihre ID zugreifen, um Daten für Skripts und Berechnungen zu ermitteln.

Syntax

get(nid, string)

Rückgabewert

text

number

boolean

void

Vorteile von get

• Einfache Handhabung: Unabhängig von der Art der Daten können Sie diese einheitlich aus den Feldern abrufen, was die Arbeit deutlich vereinfacht.

• Integration: Die Funktion get lässt sich nahtlos mit anderen Funktionen wie kombinieren, sodass Sie Daten in Ihren Skripten dynamisch aktualisieren und verwalten können.

• Mehr Flexibilität: Mit der Funktion get können Sie Daten entweder anhand des Namens oder der ID eines Feldes abrufen. Das erleichtert den Umgang mit unterschiedlichen Benennungen und Datenbankstrukturen.

Beispiele

Hier sind ein paar einfache Beispiele, die zeigen, wie die Funktion mit unterschiedlichen Eingaben funktioniert.

Rückgabewert: Vania

Rückgabewert: true

Rückgabewert: 42

Rückgabewert: void

Herkömmliche Methode

In einem typischen Szenario sind die Feldnamen in Checklisten-Formularen oft nummeriert. Zum Beispiel:

• Objekt Name 1, Wert 1, Datum 1

• Objekt Name 2, Wert 2, Datum 2

• Objekt Name 3, Wert 3, Datum 3

Zum Sammeln all dieser Daten und zum Ablegen in einer Untertabelle könnten Sie normalerweise Folgendes verwenden:

Dynamische Datenerfassung mit get und set

Siehe auch

Mit dieser Funktion können Sie eine API-Anfrage senden, um auf Daten außerhalb Ihrer aktuellen Datenbank zuzugreifen. Sie können einige externe Dienste integrieren oder Daten zwischen 2 Datenbanken austauschen.

Diese Funktion kann bis zu 4 Parameter aufnehmen:

• Methode Ein String, der die HTTP-Methode für den API-Aufruf festlegt. Das ist normalerweise "GET", "POST", "PUT" oder"DELETE"

• URL Ein String mit der URL zum externen Dienst

• Header Ein optionales JSON-Objekt mit Metadaten zum API-Aufruf wie einen API-Schlüssel oder den Content-Type.

• Body Ein optionales JSON-Objekt üblicherweise mit den Daten, die mit anderen externen Diensten geteilt werden.

API zu verwenden, erfordert eventuelle zusätzliche Kenntnisse. Erfahren Sie

Syntax

http(string, string)

http(string, string, JSON)

http(string, string, JSON, JSON)

Mit Dateien

http(string, string, JSON, [file])

http(string, string, JSON, JSON, [file])

Rückgabewert

JSON

Beispiel

http(methode, url)ruft REST-Services ohne Header oder Body ab.

http(methode, url, header) ruft REST-Services auf – die Methode und die URL sind Strings; der (optionale) Header ist ein JSON-Objekt.

http(method, url, header, body) ruft REST-Services auf – die Methode und die URL sind Strings (Header und Body sind optionale Objekte).

Ergebnis: Sie enthalten ein JSON-Objekt, das entweder alle Tabellen der Datenbank enthält, wenn der API-Aufruf erfolgreich ist, oder ein JSON-Objekt mit einer Fehlermeldung, wenn nicht.

Ergebnis: Sie erhalten ein JSON-Objekt mit allen Datensätzen der Kunden-Tabelle, wo der Status = 4 ist, wenn der API-Aufruf erfolgreich ist, oder ein JSON-Objekt mit einer Fehlermeldung, wenn nicht.

Mit Dateien

http(methode, url, header, dateien) ruft REST-Services auf und sendet eine Liste von Dateien mit – die Methode und die URL sind Strings; der (optionale) Header ist ein JSON-Objekt.

http(methode, url, header, body, dateien) ruft REST-Services auf und sendet eine Liste von Dateien mit – die Methode und die URL sind Strings (Header und Body sind optionale Objekte).

Siehe auch

Wenn Sie diese Funktion in einer beliebigen Tabelle Ihrer Datenbank ausführen, werden alle im Cache der Datenbank zwischengespeicherte Werte (z.B. über cached()) gelöscht.

Syntax

invalidate()

Rückgabewert

void

Beispiele

Ergebnis: Der Cache der Datenbank ist leer.

Siehe auch

, führt ein bestimmtes Skript nur einmal aus und speichert den Ausgabewert im Cache und gibt ihn zurück.

Mit dieser Funktion können Sie einem Symbol- oder Formel-Feld einen Symbol-Wert zuweisen. Sie können auch den Symbol-Wert einer gewählten Option in einem Auswahl-Feld erhalten.

Aktuell gibt es bei Ninox 254 verfügbare Symbole. Jedes Symbol hat einen internen Namen als Referenz.

Syntax

icon(choice)

icon(string)

Rückgabewert

icon

Beispiele

Ergebnis: Das Symbol der Auswahl des Auswahl-Feldes.

Ergebnis:

Siehe auch

Mit dieser Funktion können Sie eine Dezimalzahl auf die nächstniedrigere ganze Zahl abrunden. Vorhandene Dezimalstellen werden entfernt.

Wenn eine ganze Zahl bereits als Parameter übergeben wird, bleibt sie unverändert.

Syntax

floor(number)

Rückgabewert

number

Beispiele

Ergebnis: 2

Ergebnis: 12

Ergebnis: 27

Siehe auch

Diese Funktion konvertiert eine Datei in einen base64-String. Diesen können Sie dann zum Beispiel in einem REST-API-Aufruf verwenden.

Syntax

loadFileAsBase64(file)

loadFileAsBase64(nid, string)

Rückgabewert

string

Beispiele

loadFileAsBase64(datensatz, dateiname) Wandelt eine bestimmte Datei aus dem Anhang eines Datensatzes in ein base64-Format um.

loadFileAsBase64(this, "meinFoto.jpg")

Ergebnis: R0lGODlhgACAAPYpAPDNPv///+fBL/L1+Nff6qp9HLWvhvj5+/n7/MKoYNGtQ5urunRTJey4Jfv8/f39/t/l7qmVZe3w9O67J5acotfFjM+PFKy90+SmG+qyIvDAKY+PjbbI3Obs8vHz9vjRL/b4+tCrL7uaKsaUH9mhI4B+e+etH8LR4PfNLufIVaCzzAAAAERERB8fHzwpEfDAJvXQTOTi3/reZnxpUsDAv/z8/ ...

(ein base64-String wurde aus der Datei "meinFoto.jpg" aus dem Anhang des aktuellen Datensatzes generiert)

loadFileAsBase64(datei) Wandelt eine bestimmte Datei in ein base64-Format um.

loadFileAsBase64(Foto)

Ergebnis: R0lGODlhgACAAPYpAPDNPv///+fBL/L1+Nff6qp9HLWvhvj5+/n7/MKoYNGtQ5urunRTJey4Jfv8/f39/t/l7qmVZe3w9O67J5acotfFjM+PFKy90+SmG+qyIvDAKY+PjbbI3Obs8vHz9vjRL/b4+tCrL7uaKsaUH9mhI4B+e+etH8LR4PfNLufIVaCzzAAAAERERB8fHzwpEfDAJvXQTOTi3/reZnxpUsDAv/z8/ ...

(ein base64-String wurde aus der Datei im Bild-Feld Foto generiert)

Siehe auch

loadFileAsBasedURL, wandelt eine Datei in ein URL-konformes base64-Format um.

Die Funktion ermittelt den Logarithmus zur Basis e (die Euler‘sche Zahl) und heißt deswegen natürlicher Logarithmus.

Sie gibt eine positive Zahl zurück. Bei 0 ist das Ergebnis -∞ (minus unendlich).

Syntax

ln(number)

Rückgabewert

number

Beispiele

ln(x) berechnet den natürlichen Logarithmus einer Zahl x zur Basis e (e ist die Euler‘sche Zahl).

ln(1) 

Ergebnis: 0

ln(0)

Ergebnis: -∞

ln(100) 

Ergebnis: 4,605170185988092

Siehe auch

exp, berechnet die natürliche Exponential-Funktion.

Diese Funktion konvertiert eine Datei in einen URL-konformen base64-String. Diesen können Sie dann zum Beispiel in einem REST-API-Aufruf verwenden.

Syntax

loadFileAsBase64URL(file)

loadFileAsBase64URL(nid, string)

Rückgabewert

string

Beispiele

loadFileAsBase64(datensatz, dateiname) Wandelt eine bestimmte Datei aus dem Anhang eines Datensatzes in ein base64URL-Format um.

loadFileAsBase64URL(this, "meinFoto.jpg")

Ergebnis: data:image/gif;base64,R0lGODlhgACAAPYpAPDNPv///+fBL/L1+Nff6qp9HLWvhvj5+/n7/MKoYNGtQ5urunRTJey4Jfv8/f39/t/l7qmVZe3w9 ...

(ein base64URL-String wurde aus der Datei "meinFoto.jpg" aus dem Anhang des aktuellen Datensatzes generiert)

loadFileAsBase64(datei) Wandelt eine bestimmte Datei in ein base64URL-Format um.

loadFileAsBase64(Foto)

Ergebnis: data:image/gif;base64,R0lGODlhgACAAPYpAPDNPv///+fBL/L1+Nff6qp9HLWvhvj5+/n7/MKoYNGtQ5urunRTJey4Jfv8/f39/t/l7qmVZe3w9 ...

(ein base64URL-String wurde aus der Datei im Bild-Feld Foto generiert)

Siehe auch

loadFileAsBase64, wandelt eine Datei in ein base64-Format um.

shareFile, gibt die URL einer bestimmten Datei zurück.

Diese Funktion extrahiert den Breitengrad einer Adresse aus einem Standort-Feld als Dezimalzahl.

Syntax

latitude(location)

Rückgabewert

number

Beispiele

latitude(standort)

Ergebnis: 52,5235175 (für Monbijouplatz 5, 10178 Berlin – Büroanschrift von Ninox)

Siehe auch

location, gibt einen Standortwert mit einem bestimmten Titel, Breiten- und Längengrad zurück.

longitude, gibt den Längengrad eines bestimmten Standortwerts zurück.

Sie können mit dieser Funktion den letzten Eintrag eines Arrays abrufen. Diese Funktion ist praktisch, wenn Sie auf einen Datensatz in einem Array von Datensätzen zugreifen wollen.

Wenn Sie diese Funktion mit select verbinden und das entsprechende Array mehr als 1 Element hat, empfehlen wir, das Array zuerst mit order byzu sortieren.

Syntax

last([any])

Rückgabewert

any

Mehr über any >

Beispiele

last(["B", "A", "C"])

Ergebnis: C

last(select Kunde)

Ergebnis: Gibt den letzten Datensatz der Tabelle Kunde zurück.

last((select Kunde where substr('Nachname', 0, 1) = "A") order by 'Nachname')

Ergebnis: Gibt den letzten Datensatz der Tabelle Kunde zurück, wo der Nachname mit A beginnt.

Siehe auch

first, gibt das erste Element eines Arrays zurück.

item, extrahiert einen Wert aus einem Array oder Objekt.

Diese Funktion ermittelt die Anzahl der Zeichen (mit Leerzeichen) eines gegebenen Textes oder die Anzahl der Elemente in einem gegebenen Array zurück.

Zusammen mit den Funktionen substr() oder index(), hilft Ihnen diese Funktion auch, die Anzahl an Zeichen ab einem bestimmten Startpunkt zu ermitteln.

Syntax

length(string)

length([any])

Rückgabewert

number

Beispiele

length("Ninox ist toll!")

Ergebnis: 15

length(["A", "B", "", "D", null])

Ergebnis: 5

Siehe auch

count, gibt die Anzahl an konkreten Elementen eines Arrays zurück.

index, ermittelt die erste Position einer gesuchten Übereinstimmung in einem String.

substr, gibt einen Teil aus einem vorgegebenen Text zurück.

text, konvertiert einen Wert in einen String und berücksichtigt dabei möglichst die Format-Optionen.

Diese Funktion ermittelt den Standortwert anhand eines gegebenen Breiten- und Längengrads, der einen beliebigen Titel haben kann. Diese Information kann in einem Standort-Feld gespeichert werden.

Syntax

location(string, number, number)

Rückgabewert

location

Beispiele

location(titel, breitengrad, laengengrad) gibt einen Standortwert mit einem bestimmten Titel, Breiten- und Längengrad zurück.

Adresse := location("Ninox-Büroanschrift", 52.5235175, 13.3989201)

Ergebnis: Speichert den Standort mit den gegebenen Koordinaten im Standort-Feld Adresse.

Siehe auch

latitude, gibt den Breitengrad eines bestimmten Standortwerts zurück.

longitude, gibt den Längengrad eines bestimmten Standortwerts zurück.

Mit dieser Funktion füllen Sie einen Text am Anfang, also links vom Text, mit einem oder mehreren angegebenen Zeichen bis zur gewünschten Gesamtlänge auf. Dabei werden die angegeben Zeichen so lange wiederholt, bis die angegebene Gesamtlänge erreicht wird.

Dies kann sehr nützlich sein, wenn - aus technischen Gründen - Daten eine bestimmte Länge haben müssen, oder zum optischen Auffüllen bei Drucklayouts in einer nichtproportionalen Schrift.

Syntax

lpad(string, number, string)

Rückgabewert

string

Beispiele

lpad(meinText, laenge, platzhalter) Füllt den Anfang eines Texts bis zu einer bestimmten Länge mit einem angegebenen Platzhalter auf, falls der Text kürzer als die bestimmte Länge ist.

Ergebnis: + + + + + + Ein Text

Ergebnis: 00000123

Siehe auch

, füllt das Ende eines Texts bis zur gewünschten Länge mit einem angegebenen Platzhalter auf.

Diese Funktion extrahiert den Längengrad einer Adresse aus einem Standort-Feld als Dezimalzahl.

Syntax

longitude(location)

Rückgabewert

number

Beispiele

Ergebnis: 13,3989201 (für Monbijouplatz 5, 10178 Berlin – Büroanschrift von Ninox)

Siehe auch

, gibt den Breitengrad eines bestimmten Standortwerts zurück.

, gibt einen Standortwert mit einem bestimmten Titel, Breiten- und Längengrad zurück.

Diese Funktion konvertiert Großbuchstaben in einem Text in Kleinbuchstaben. Andere Buchstaben bleiben unberührt.

Das ist hilfreich, um Strings zu vergleichen oder Rechtschreibfehler zu korrigieren. Zum Beispiel in Namen und Bezeichnungen oder um Texte zur weiteren Verarbeitung vorübergehend zu vereinheitlichen.

Syntax

lower(string)

Rückgabewert

string

Beispiele

Ergebnis: lower

Ergebnis: Ja (true)

Siehe auch

, gibt einen String in Großbuchstaben zurück.

Mit dieser Funktion können Sie aus einem Datumswert den Monat extrahieren. Das ist eine Zahl zwischen 1 und 12, wobei Januar = 1, Februar = 2, … Dezember = 12 ist.

Syntax

month(date)

month(appointment)

month(timestamp)

Rückgabewert

number

Beispiele

month(meinDatum) gibt den Monat eines gegebenen Datums als Zahl aus.

Ergebnis: 5 (mit 31. Mai 2021)

Ergebnis: 8 (mit 31. Mai 2021)

month(termin) gibt den Monat des Startdatums eines Termins als Zahl zurück.

month(Zeitstempel) gibt den Monat eines Zeitstempels als Zahl zurück.

Siehe auch

Mit dieser Funktion finden Sie den höchsten oder spätesten Wert eines Arrays.

Syntax

max([any])

max([number])

max([timestamp])

Rückgabewert

any

Beispiele

max([zahl)]gibt die höchste Zahl eines Zahlen-Arrays zurück.

Ergebnis: 35

max([datum])gibt den spätesten Zeitstempel eines Zeitstempel-Arrays zurück.

Ergebnis: Der letzte Geburtstag eines Jahres (zum Beispiel eines Mitarbeiters).

Siehe auch

Mit dieser Funktion finden Sie den niedrigsten oder frühesten Wert eines Arrays.

Syntax

min([any])

min([number])

min([timestamp])

Rückgabewert

any

Beispiele

min([zahl])gibt die niedrigste Zahl eines Zahlen-Arrays zurück.

Ergebnis: 1

min([datum])gibt das früheste Datum eines Datums-Arrays zurück.

Ergebnis: Der erste Geburtstag eines Jahres (zum Beispiel eines Mitarbeiters)

Siehe auch

Die Funktion ermittelt den Logarithmus einer Zahl zu einer Basis. Wenn kein Parameter für die Basis angegeben ist, ist es 10. Bei einer 0 ist es -∞ (minus unendlich).

Syntax

log(number)

log(number, number)

Rückgabewert

number

Beispiele

log(x,y)berechnet den Logarithmus einer Zahl x zur Basis einer Zahl y.

log(x)berechnet den Logarithmus einer Zahl x zur Basis 10.

Ergebnis: 0

Ergebnis: -∞

Ergebnis: 0,6826061944859853

Diese Funktion zeigt den Namen des Monats an. Das kann nützlich sein, wenn Sie Datumswerte in einem Jahr nach Monat sortieren wollen.

Syntax

monthName(date)

monthName(date, string)

monthName(number)

monthName(number, string)

Rückgabewert

string

Beispiele

monthName(myDate) gibt den vollen Monatsnamen eines gegebenen Datums aus.

monthName(myDate, language) gibt den vollen Monatsnamen eines gegebenen Datums in einer von aus.

Ergebnis: Juillet

monthName(monthNumber) gibt den vollen Monatsnamen einer gegebenen Monatszahl aus, wobei 1 = Januar, 2 = Februar, … 12 = Dezember ist.

Ergebnis: Juli

Siehe auch

Mit dieser Funktion können Sie die Zahl des Monats aus einem String extrahieren, beispielsweise wird März zu 3.

Das ist hilfreich, wenn der Monat nur als String zur Verfügung steht, d.h. der Name des Monats, Sie ihn aber für weitere Berechnungen als Zahl brauchen.

Syntax

monthIndex(string)

Rückgabewert

number

Beispiele

Ergebnis: 7

Siehe auch

, gibt den Namen eines bestimmten Wochentags als Zahl zurück.

Diese Funktion liefert Ihnen die IDs der ausgewählten Optionen.

• Mehrfachauswahl-Feld: Sie erhalten die Auswahl-IDs

• Dynamisches Mehrfachauswahl-Feld: Sie bekommen die Datensatz-IDs

Syntax

numbers(multi)

numbers(dmulti)

Rückgabewert

[number]

Beispiele

Wir haben ein Mehrfachauswahl-Feld Lieblingssportarten mit den folgenden Auswahl-Werten:

Basketball, Tanzen, Segeln und Fußball werden ausgewählt.

numbers(mehrfachauswahl)gibt die internen IDs der gewählten Auswahl-Werte eines bestimmten Mehrfachauswahl-Feldes zurück.

numbers(Status)

Ergebnis: [1,3,4,5]

numbers(dynMehrfachauswahl)gibt die Datensatz-IDs der gewählten Auswahl-Werte eines bestimmten dynamischen Mehrfachauswahl-Feldes zurück.

numbers('Lieblingssportarten')

Ergebnis: [1,3,4,5]

In diesem Beispiel ist Lieblingssportarten ein dynamisches Auswahlfeld, das sich auf die Tabelle Sportarten bezieht.

Sie können Tabellenansichten dynamisch ändern, je nach Auswahl in Ihrem dynamischen Auswahlfeld.

Das folgende Script muss dem Formel-Feld der Tabellenansicht hinzugefügt werden.

let dynAuswahlIds := numbers('Meine dynamische Mehrfachauswahl');
for person in select Mitarbeiter do
	for id in dynAuswahlIds do
		if id = number(rec.Id) then person end
	end
end

Ergebnis: Sie sehen die Datensätze der Mitarbeiter in der Tabellenansicht, die im dynamischen Mehrfachauswahl-Feld ausgewählt wurden.

Siehe auch

chosen, wertet Mehrfachauswahl-Felder aus.

Diese Funktion liefert Ihnen den exakten Datums- und Uhrzeitwert des exakten Moments, in dem diese Funktion ausgeführt wird. Sie erzeugen einen exakten Zeitstempel.

Dies kann sehr nützlich sein beim Berechnen von Zeiträumen, die auf Datums- und Zeitwerten beruhen.

Syntax

now()

Rückgabewert

timestamp

Beispiele

now() 

Ergebnis: (zum Beispiel am 2. Juni 2021, um 16:45) 02.06.2021 16:45

date(now()) + 7 

Ergebnis: (zum Beispiel am 2. Juni 2021, um 16:45) 09.06.2021

Siehe auch

today, gibt das aktuelle Datum (ohne Zeit) zurück

Mit dieser Funktion können Sie prüfen, ob eine Zahl ungerade, d. h. nicht ohne Rest durch 2 teilbar ist. Der Rückgabewert ist entweder Ja (true) oder Nein (false). 0 wird als gerade bewertet und gibt daher Nein (false) zurück.

Syntax

odd(number)

Rückgabewert

boolean

Beispiele

odd(10 + 12) 

Ergebnis: Nein (false)

odd(10 + 13) 

Ergebnis: Nein (true)

odd(0) 

Ergebnis: Nein (false)

odd(10.2) 

Ergebnis: Ja (true)

See also

even, gibt Ja (true) zurück, wenn die Zahl gerade ist.

Diese Funktion schließt die aktuelle Seite und öffnet eine bestimmte Seite. Sie können die Aufforderung präzisieren, indem Sie eine Registerkarte angeben, in der die Seite geöffnet werden soll.

Wenn Sie keine besondere Registerkarte angeben, öffnet sich die Standard- oder letzte aktive Registerkarte.

Syntax

openPage(string)

openPage(string, string)

Rückgabewert

void

Beispiele

openPage("Rechnungen")

Ergebnis: Die Registerkarte Rechnungen öffnet sich.

openPage(seite, registerkarte)öffnet eine bestimmte Seite in einer bestimmten Registerkarte.

openPage("Rechnungen", "Aktueller Monat")

Ergebnis: Die Registerkarte Aktueller Monat der Seite Rechnungen öffnet sich.

Siehe auch

openTable, öffnet eine bestimmte Tabelle.

openRecord, springt zur entsprechenden Tabelle und öffnet einen bestimmten Datensatz.

popupRecord, öffnet einen bestimmten Datensatz in einem Pop-up-Formular.

Diese Funktion schließt die aktuelle Tabelle und öffnet eine bestimmte Tabelle. Sie können die Aufforderung präzisieren, indem Sie eine Ansicht angeben, in der die Tabelle geöffnet werden soll.

Wenn Sie keine besondere Ansicht angeben, öffnet sich die Standard- oder letzte aktive Ansicht.

Syntax

openTable(string)

openTable(string, string)

Rückgabewert

void

Beispiele

openTable("Rechnungen")

Ergebnis: Die Tabelle Rechnungen öffnet sich.

openTable(tabelle, ansicht)öffnet eine bestimmte Tabelle in einer bestimmten Ansicht.

openTable("Rechnungen", "Aktueller Monat")

Ergebnis: Die Ansicht Aktueller Monat der Tabelle Rechnungen öffnet sich.

Siehe auch

openPage, öffnet eine bestimmte Seite.

openRecord, springt zur entsprechenden Tabelle und öffnet einen bestimmten Datensatz.

popupRecord, öffnet einen bestimmten Datensatz in einem Pop-up-Formular.

Diese Funktion öffnet ein spezielles Print-Layout eines bestimmten Datensatzes.

Syntax

openPrintLayout(nid, string)

Rückgabewert

void

Beispiele

openPrintLayout(this, "Rechnung")

Ergebnis: Öffnet das Rechnung genannte Print-Layout des aktuellen Datensatzes.

Siehe auch

printAndSaveRecord, speichert einen bestimmten Datensatz in einem bestimmten Layout als PDF im internen Datei-System und gibt den Pfad als Link zurück.

printRecord, druckt einen bestimmten Datensatz in einem bestimmten Layout als PDF und öffnet die Datei im Standard-Programm.

Die Funktion parseCSV liest CSV-formatierten Text aus und gibt ihn als strukturierte Liste oder Array zurück. Sie können das Ausleseprozess anpassen, indem Sie Kopfzeilen, Trennzeichen und Text-Anführungszeichen festlegen.

Syntax

parseCSV(string, json)

Parameter

• data (string): Der Eingabetext im CSV-Format. Beispiel: "Name,Alter\nKiran,42\nLisa,27"

• options (JSON-Objekt): Optionale Konfiguration mit folgenden Eigenschaften:

  • firstLineIsHeader: boolean, Standardwert ist false. Wenn true, wird die erste Zeile als Spaltenüberschrift behandelt.

  • separator: string. Legt das Trennzeichen zwischen den Feldern fest, z. B. "," oder ";". Wird automatisch erkannt, wenn es nicht angegeben ist.

  • textQuote: string. Gibt das Zeichen an, das zum Anführen von Textfeldern verwendet wird. Standard ist " (doppelte Anführungszeichen).

Rückgabewert

JSON: Eine Liste oder ein Array von JSON-Objekten, mit Schlüsseln aus der Kopfzeile, wenn firstLineIsHeader true ist.

[text]: Eine Liste oder ein Array von Text-Arrays (Zeilen), wenn firstLineIsHeader false ist.

Beispiele

1. Standard firstLineIsHeader=false

Beispiel:

Oder setzen Sie firstLineIsHeader ausdrücklich auf false:

Ergebnis:

2. Verwendung von firstLineIsHeader=true

Beispiel:

Ergebnis:

3. Benutzerdefiniertes Trennzeichen

Beispiel:

Ergebnis:

4. Angabe von textQuote

In diesem Beispiel sind die Textfelder mit einfachen Anführungszeichen markiert.

Beispiel:

Ergebnis:

5. Verwendung eines benutzerdefinierten textQuote-Zeichens

Sie können ein textQuote-Zeichen, wie ein einfaches Anführungszeichen ('), festlegen, um Felder mit zitierten Texten spezifisch zu behandeln.

Beispiel:

Ergebnis:

Diese Funktion öffnet das Formular in Vollbild-Ansicht. Geben Sie den Datensatz an, den Sie bildschirmfüllend anzeigen möchten.

Wenn Sie wollen, können Sie auch die Registerkarte angeben, die geöffnet werden soll.

Syntax

openFullscreen(nid)

openFullscreen(nid, string)

Rückgabewert

void

Beispiele

openFullscreen(this)

Ergebnis: Der aktuelle Datensatz wird mit der gewählten Standard-Registerkarte im Vollbildmodus gezeigt.

openFullscreen(this, "Firmeninfos")

Ergebnis: Der aktuelle Datensatz wird im Vollbildmodus in der ausgewählten Registerkarte Firmeninfos angezeigt.

Siehe auch

closeFullscreen, schließt den Vollbildmodus.

Diese Funktion konvertiert einen String in ein JSON-Objekt.

Das kann ganz praktisch sein, wenn Sie ein JSON-Objekt modifizieren und in die http()–Funktion übergeben wollen.

Syntax

parseJSON(string)

Rückgabewert

JSON

Beispiele

parseJSON(jsonString)konvertiert einen JSON-String in ein JSON-Objekt.

Ergebnis: {"test":123}

Siehe auch

Mit dieser Funktion können Sie eine Webseite in Ihrem Standard-Browser öffnen. Sie können jeden String übergeben, die Funktion kodiert ihn, sodass es ein gültiger Link ist.

Syntax

openURL(string)

Rückgabewert

void

Beispiele

openURL(link) konvertiert einen String in einen Link und öffnet ihn im Standard-Browser.

Ergebnis: Google Maps öffnet sich und zeigt das Ninox-Büro an.

Siehe auch

, gibt eine Rich-Text-Darstellung eines beliebigen Werts zurück.

, sendet einen HTTP-Request.

Die Funktion gibt die Werte verschiedener Datentypen als Zahl zurück. Sie können sich vorstellen, dass das ziemlich oft gebraucht wird!

Das Ergebnis hängt vom Datentyp ab. Ein paar Beispiele:

• ein nur aus Ziffern bestehender Text wird zum Beispiel in eine Zahl konvertiert

• Datum und Zeit werden in Unix-Zeit dargestellt

• bei einem Termin bezieht sich Ninox standardmäßig auf den Beginn, wenn Sie nicht mit endof() ausdrücklich auf das Ende verweisen

• ein Zeitintervall wird zu Millisekunden konvertiert

• auf ein Auswahl-Feld angewandt, wird die Nummer der gewählten Option zurückgegeben