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

Ergebnis: 9,3

Siehe auch

, gibt das Vorzeichen einer Zahl zurück.

acos

Berechnet den Arkuskosinus

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.

Ergebnis: 1,8234765819369754

Funktionen – Überblick

Alle Funktionen von Ninox auf einen Blick – jede Funktion ist mit ihrer eigenen Seite verlinkt

abs

Gibt den Betrag einer Zahl zurück

acos

Berechnet den Arkuskosinus

age

Gibt die Anzahl der vollen Jahre zwischen jetzt und einem gegebenen Datum zurück, z.B. das Altern einer Person

alert

Öffnet ein Pop-up mit einer Meldung

appendTempFile

Erstellt eine temporäre Datei auf dem Ninox-Server

appointment

Konvertiert bestimmte zeitbezogenen Werte in einen Termin

array

Erstellt ein neues Array, indem 2 Arrays, die im Typ ähnlich sind, zusammengeführt werden

asin

Berechnet den Arkussinus

atan

Berechnet den Arkustangens

atan2

Berechnet den Arkustangens des Quotienten x/y

avg

Gibt den Durchschnittswert eines Zahlen-Arrays zurück

barcodeScan

Öffnet den Barcode-Scanner und gibt einen gescannten Wert als String zurück

cached

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

capitalize

Schreibt den ersten Buchstaben eines jeden Worts groß

ceil

Rundet eine Zahl auf die nächste ganze Zahl auf

chosen

Wertet Mehrfachauswahl-Felder aus

clientLang

Gibt die aktuell verwendete Sprache des Browsers oder der App in Kurzform zurück

closeAllRecords

Schließt alle Datensatz-Formulare

closeFullscreen

Schließt den Vollbild-Modus

closeRecord

Schließt das oberste Datensatz-Formular

color

Ermittelt den Farbwert oder konvertiert in einen

concat

Gibt alle Elemente eines Arrays in einem String zurück

contains

Prüft, ob ein String oder Array eine exakte Übereinstimmung enthält

cos

Berechnet den Kosinus

count

Gibt die Anzahl an konkreten Elementen eines Arrays zurück

createCalendarEvent

Erstellt ein Ereignis in der Kalender-App von Apple

createCalendarReminder

Erstellt eine Erinnerung in der Apple Erinnerungen-App

createTempFile

Fügt Text zu einer temporären Datei auf dem Ninox-Server hinzu

createZipFile

Erstellt ein Zip-Archiv mit allen Dateien eines bestimmten Arrays vom Dateityp file

createTextFile

Erstellt eine Textdatei mit einem bestimmten Namen und Inhalt

databaseId

Gibt die ID der aktuellen Datenbank zurück

date

Konvertiert in einen Datumswert oder gibt einen zurück

datetime

Konvertiert in einen Zeitstempel oder gibt einen zurück

day

Gibt den Tag des Monats aus einem Datumswert als Zahl zurück

days

Gibt die Anzahl an Tagen zwischen 2 Datumsangaben zurück

degrees

Konvertiert den Winkel von Bogenmaß in Grad

dialog

Öffnet ein Pop-up mit Antwort-Optionen

duplicate

Erstellt ein Duplikat von einem bestimmten Datensatz

duration

Gibt die Dauer eines Termins zurück

email

Konvertiert einen gegebenen Wert in einen E-Mail-Wert

endof

Gibt das Ende eines Termins zurück

even

Gibt Ja (true) zurück, wenn die Zahl gerade ist

exp

Berechnet die natürliche Exponential-Funktion

extractx

Extrahiert aus einem String einen bestimmten Teil mithilfe eines regulären Ausdrucks

file

Gibt auf Basis des Dateinamens eine bestimmte Datei aus einem Datensatz zurück

fileMetadata

Gibt die Metadaten, wie Name, Größe und Änderungsdatum einer Datei auf Basis eines bestimmten Datensatzes und Dateinamens zurück

files

Gibt alle Anhänge eines Datensatzes als Array zurück

first

Gibt das erste Element eines Arrays zurück

floor

Rundet eine Zahl auf die nächste ganze Zahl ab

format

Formatiert einen gegebenen Wert

formatJSON

Erstellt aus einem gültigen JSON-Objekt einen JSON-String

formatXML

Konvertiert ein bestimmtes JSON-Objekt in XML-Text, der optisch strukturiert sein kann

html

Gibt eine Rich-Text-Darstellung eines beliebigen Werts zurück

http

Sendet einen HTTP-Request

icon

Gibt ein Symbol zurück

importFile

Importiert eine Datei über eine URL und speichert diese als Anhang eines Datensatzes

index

Ermittelt die erste Position einer gesuchten Übereinstimmung in einem String oder Array

invalidate

Leert den Cache der Datenbank und die von cached() hinterlegten Werte

isAdminMode

Gibt Ja (true) zurück, wenn der Bearbeitungsmodus aktiv ist

isDatabaseLocked

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

isDatabaseProtected

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

item

Extrahiert einen Wert aus einem Array oder Objekt

join

Gibt einen String aus allen Elementen eines gegebenen Arrays zurück, getrennt durch ein gegebenes Zeichen

last

Gibt das letzte Element eines Arrays zurück

latitude

Gibt den Breitengrad eines bestimmten Standortwerts zurück

length

Gibt die Anzahl aller Zeichen in einem String oder aller Elemente in einem Array zurück

ln

Berechnet den natürlichen Logarithmus

loadFileAsBase64

Wandelt eine Datei in ein base64-Format um

loadFileAsBase64URL

Wandelt eine Datei in ein URL-konformes base64-Format um

location

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

log

Berechnet den Logarithmus

longitude

Gibt den Längengrad eines bestimmten Standortwerts zurück

lower

Gibt einen String in Kleinbuchstaben zurück

lpad

Füllt den Anfang eines Texts bis zu einer angegebenen Länge mit einem angegebenen Platzhalter auf

max

Gibt den höchsten oder spätesten Wert eines Arrays zurück

min

Gibt den niedrigsten oder frühesten Wert eines Arrays zurück

month

Gibt den Monat aus einem Datumswert als Zahl zurück

monthIndex

Gibt aus einem String einen gegebenen Monat als Zahl zurück

monthName

Gibt aus einem gegebenen Datumswert den ausgeschriebenen Monatsnamen zurück

ninoxApp

Ermittelt die Art der zurzeit genutzten Umgebung

now

Gibt den aktuellen Zeitstempel zurück

number

Konvertiert einen gegebenen Wert in eine Zahl

numbers

Gibt die IDs der ausgewählten Werte eines Mehrfachauswahl-Feldes zurück

odd

Gibt Ja (true) zurück, wenn die Zahl ungerade ist

openFullscreen

Öffnet einen bestimmten Datensatz im Vollbild-Modus

openPrintLayout

Öffnet einen Datensatz in einem vorgegebenen Layout im Druck-Layout-Editor

openRecord

Springt zur entsprechenden Tabelle und öffnet einen bestimmten Datensatz

openTable

Öffnet eine bestimmte Tabelle

openURL

Konvertiert einen String in einen Link und öffnet ihn im Standard-Browser

parseCSV

Gibt eine strukturierte Liste oder ein Array von Zeilen und Daten aus dem angegebenen CSV-Text zurück

parseJSON

Konvertiert einen JSON-String in ein JSON-Objekt

parseXML

Konvertiert einen XML-String in ein JSON-Objekt um

phone

Konvertiert einen Wert in einen Telefon-Wert

popupRecord

Öffnet einen bestimmten Datensatz in einem Pop-up-Formular

pow

Berechnet die Potenz einer Zahl

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

printTable

Druckt die angezeigten Spalten einer Ansicht entsprechend Ihren Datenbank-Einstellungen (PDF oder HTML)

quarter

Gibt das Quartal eines Datumswerts als Zahl zurück

queryConnection

Sendet einen SQL-Befehl an eine verknüpfte SQL-Datenbank und gibt die Daten des Datensatzes zurück

radians

Konvertiert einen Winkel von Grad in Bogenmaß

random

Gibt eine Zufallszahl zurück

range

Gibt ein Array von aufeinanderfolgender Zahlen zurück

raw

Gibt einen angegebenen Wert in seiner internen Raw-Text-Darstellung zurück

record

Gibt den Datensatz einer bestimmten Tabelle über die ID zurück

removeItem

Entfernt ein Schlüssel-Wert-Paar aus einem gegebenen JSON-Objekt

replace

Ersetzt in einem Text gefundene Übereinstimmungen mit einem angegebenen String

replacex

Ersetzt in einem Text die gefundenen Übereinstimmungen eines regulären Ausdrucks mit einem angegebenen String

round

Rundet eine Zahl auf bzw. ab

rpad

Füllt das Ende eines Texts bis zu einer angegebenen Länge mit einem angegebenen Platzhalter

rsort

Sortiert einen Array in absteigender Reihenfolge

sendCommand

Sendet einen SQL-Befehl an eine verknüpfte SQL-Datenbank

sendEmail

Sendet eine E-Mail aus Ninox heraus

setItem

Aktualisiert oder ergänzt in einem gegebenen JSON-Objekt ein Schlüssel-Wert-Paar

shareFile

Gibt die URL einer bestimmten Datei zurück

shareView

Gibt die URL einer bestimmten Ansicht zurück

sign

Gibt das Vorzeichen einer Zahl zurück

sin

Berechnet den Sinus

sleep

Zwingt Ninox eine bestimmte Zeit (in Millisekunden) zu warten, bevor der Code weiter ausgeführt wird

slice

Extrahiert einen Teilbereich aus einem String oder Array

sort

Sortiert ein Array in aufsteigender Reihenfolge

split

Teilt einen String an jedem Trennzeichen in ein Array auf

splitx

Teilt einen String mithilfe eines regulären Ausdrucks in ein Array auf

sqr

Berechnet das Quadrat

sqrt

Berechnet die Quadratwurzel

start

Gibt den Zeitstempel des Beginns eines Termins zurück

string

Gibt einen gegebenen Wert als String zurück

styled

Konvertiert einen bestimmten String in ein gestaltetes Objekt

substr

Gibt einen Teil aus einem vorgegebenen Text zurück

substring

Gibt einen Teil aus einem Text ab einem bestimmten Start bis zu einem bestimmten Ende zurück

sum

Gibt die Gesamt-Summe eines Zahlen-Arrays zurück

tableId

Gibt die ID einer Tabelle zurück

tan

Berechnet den Tangens

teamId

Gibt die ID des aktuellen Arbeitsbereichs zurück

testx

Prüft, ob ein Text Übereinstimmungen mit einem bestimmten regulären Ausdruck hat

text

Konvertiert einen Wert in einen String und berücksichtigt dabei möglichst die Format-Optionen

time

Gibt die aktuelle Zeit zurück

timeinterval

Konvertiert einen gegebenen zeitbezogenen Wert in ein Zeitintervall, d.h. eine Dauer

timestamp

Konvertiert einen gegebenen zeitbezogenen Wert in einen Zeitstempel

today

Gibt das aktuelle Datum (ohne Zeit) zurück

trim

Entfernt vorangehende und nachfolgende Leerzeichen

unique

Gibt einen Array mit eindeutigen Elementen zurück

unshareAllViews

Hebt die Freigabe aller Ansichten einer bestimmten Tabelle auf

unshareFile

Hebt die Freigabe einer bestimmten Datei auf

unshareView

Hebt die Freigabe einer bestimmten Ansicht einer Tabelle auf

upper

Gibt einen String in Großbuchstaben zurück

url

Konvertiert einen Wert in ein Link

urlDecode

Dekodiert einen gegebenen String aus einem URL-konformen Format in Text

urlEncode

Konvertiert einen gegebenen String basierend auf dem ASCII-Zeichensatz in eine URL-konformen String

urlOf

Gibt einen Link für einen bestimmten Datensatz oder eine bestimmte Ansicht zurück

user

Gibt den aktuellen oder einen bestimmten Anwender zurück

userEmail

Gibt die E-Mail-Adresse eines Anwenders zurück

userFirstName

Gibt den Vornamen eines Anwenders zurück

userFullName

Gibt den Vor- und Nachnamen eines Anwenders zurück

userHasRole

Gibt Ja (true) zurück, wenn ein Anwender eine bestimmte Rolle hat

userId

Gibt die ID eines Anwenders zurück

userIsAdmin

Gibt Ja (true) zurück, wenn ein bestimmter Anwender die Admin-Rolle hat

userLastName

Gibt den Nachnamen des Anwenders zurück

userName

Gibt den Anwendername eines Anwenders zurück

userRole

Gibt die Rolle eines Anwenders zurück

userRoles

Gibt alle Rollen eines Anwenders zurück

users

Gibt die IDs aller Nutzer in einem Array zurück

validateXML

Validiert XML-Dokumente gegen ein XSD-Schema

waitForSync

Gibt Ja (true) zurück, wenn die Datenbank mit der Ninox-Cloud synchronisiert ist

week

Gibt die Kalenderwoche eines Datumswerts zurück

weekday

Gibt den Wochentag eines bestimmten Datumswerts als Zahl zurück

weekdayIndex

Gibt den Namen eines bestimmten Wochentags als Zahl zurück

weekdayName

Gibt den vollen Namen des Wochentags eines bestimmten Datumswerts zurück

workdays

Gibt die Anzahl der Arbeitstage zwischen 2 Datumswerten zurück

year

Gibt das Jahr eines Datumswerts zurück

yearmonth

Gibt den Monat und das Jahr eines Datumswerts zurück

yearquarter

Gibt das Quartal und das Jahr eines Datumswerts zurück

yearweek

Gibt die Woche und das Jahr eines Datumswerts zurück

createTextFile

Erstellt eine Textdatei mit festgelegtem Namen, Inhalt und optionaler Kodierung

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.

Achtung: Die encoding-Option kann nur innerhalb eines do as server-Codeblocks verwendet werden.

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'

Hinweis: Bei Kodierungs-Strings wird nicht zwischen Groß- und Kleinschreibung unterschieden. UTF-8 kann beispielsweise als utf8, UTF8 oder uTf8 angegeben werden.

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:

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:

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.

Hinweis: Die Verwendung von raw('Mein Text') mit einer .html-Erweiterung stellt sicher, dass alle HTML-Tags innerhalb von Mein Text (wie <h1>, <p> usw.) erhalten bleiben. Dadurch kann die Datei in einem Webbrowser mit der strukturierten Formatierung der Tags geöffnet werden, was sie geeignet macht, um Inhalte als formatierte Webseite darzustellen.

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:

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.

Hinweis: Die Option encoding ist besonders geeignet, um internationale Zeichen, Sonderzeichen oder mehrsprachige Inhalte in der Datei zu erhalten.