System, Ablaufsteuerung und Ninox AI
Lerne, wie du Skripte pausierst und den Ausführungskontext der App prüfst.
Funktionen für System und Ablaufsteuerung helfen dir, Timing und umgebungsspezifisches Verhalten zu steuern. Du kannst ein Skript pausieren, Rohwerte prüfen und den App-Kontext erkennen.
In diesem Kapitel lernst du, wie du:
Timing in einem laufenden Skript steuerst.
die aktuelle App-Umgebung und den Datenbankstatus prüfst.
eval()
Führt einen Text als Skript aus
generateObject()
Ruft JSON-Objektdaten mit Ninox AI ab
generateText()
Ruft Textdaten mit Ninox AI ab
ninoxApp()
Gibt den aktuellen Client- oder App-Kontext zurück
raw()
Gibt die interne Textdarstellung zurück
sleep()
Pausiert ein Skript kurz
Timing und Ausführungsreihenfolge steuern
Nutze diese Funktionen, wenn eine Aktion erst nach einer anderen ausgeführt werden soll.
Ein Skript kurz pausieren
Nutze sleep(), damit Ninox eine angegebene Anzahl an Millisekunden wartet, bevor das Skript weiterläuft.
Nutze es, wenn du:
eine kurze Verzögerung vor einer Folgeaktion einbauen willst.
Timing-Probleme in einem UI-Ablauf vermeiden willst.
kurz warten willst, bis sich ein anderer Prozess stabilisiert.
einen Hinweis oder eine Warnung anzeigen willst, bevor der nächste Schritt läuft.
sleep(number)
numberdie Verzögerung in Millisekunden
sleep() gibt keinen Wert zurück.
Schauen wir uns einige Beispiele an:
Pausiert das Skript für 2 Sekunden.
Tipps:
Halte Verzögerungen so kurz wie möglich.
Nutze eine Verzögerung nur, wenn der Ablauf sie wirklich braucht.
Rohwerte und Bereichsgrenzen prüfen
Nutze diese Funktionen, wenn du den zugrunde liegenden Wert oder die Startgrenze eines Dauer- oder Bereichskontexts brauchst.
Den Rohwert prüfen
Nutze raw(), um die interne rohe Textdarstellung eines Werts zurückzugeben.
Nutze es, wenn du:
formatierten Text in seine rohe Textform umwandeln willst.
den internen Wert hinter einem Farbfeld lesen willst.
formatierte Inhalte in Dialogen oder E-Mails wiederverwenden willst.
die Rohform mit der angezeigten Form vergleichen willst.
raw(any)
anyder Wert, den du in Rohform zurückgeben willst
raw() gibt einen String zurück.
Schauen wir uns einige Beispiele an:
Gibt den Inhalt eines formatierten Textwerts als unformatierten Text mit HTML-Tags zurück.
Zeigt einen Dialog mit dem Inhalt des formatierten Textfelds Dialog text.
Gibt den internen Farbwert zurück, zum Beispiel #EC87E2.
Tipps:
Nutze
raw(), wenn du die interne Textdarstellung des Systems brauchst.Das ist nützlich für formatierte Textfelder, Dialoge und E-Mails.
Du kannst das Ergebnis später wieder mit
html()formatieren.
Text als Logik ausführen und Daten mit eval() prüfen
Nutze eval(), um Text als Ninox Skript auszuführen.
Damit erstellst du dynamische Ausdrücke. Verwende zum Beispiel Namen von Tabellen, Feldern und Variablen, die sich zur Laufzeit ändern.
eval(string, nid)
stringText mit Berechnungen oder einem Ninox SkriptnidDatensatz, auf den das Skript angewendet wird
Schauen wir uns einige Beispiele an:
Gibt 20 zurück, wenn das Feld "Manuelle Formel" im aktuellen Datensatz 14 + 6 \* 0.5 \* 2 enthält.
Gibt die Summe aller Beträge in der Tabelle "Rechnungen" zurück.
Zeigt eine Meldung mit dem Text "Das ist ein Test." an.
Gibt den Wert "Toni Kim" aus dem Feld "Vollständiger Name" zurück. Bei einem Auswahlfeld gibt die Funktion den Index des Werts zurück.
Gibt den Textwert der gewählten Option eines Auswahlfelds zurück.
Gibt die Anzahl der Datensätze in der Tabelle "Kontakte" zurück, deren Feld "Vollständiger Name" dem gewählten Feldwert im aktuellen Datensatz entspricht. Nutze diesen Ansatz für dynamische Duplikatsuchen, wenn myFeld aus einem Auswahlfeld stammt.
App-Kontext und Datenbankstatus erkennen
Nutze diese Funktionen, wenn dein Skript auf den aktuellen Client oder den Schutzstatus der Datenbank reagieren soll.
Mit ninoxApp() die aktuelle App erkennen
Nutze ninoxApp(), um zu prüfen, wo dein Skript ausgeführt wird.
Nutze es, wenn du:
Verhalten je nach Client anpassen willst.
client-spezifische Workflows diagnostizieren willst.
ninoxApp()
ninoxApp() gibt einen String zurück, der die aktuelle Umgebung kennzeichnet.
Mögliche Rückgabewerte sind:
clientserver
Schauen wir uns einige Beispiele an:
Gibt einen String zurück, der zeigt, wo das Skript läuft.
Tipps:
Nutze
ninoxApp(), um zu prüfen, ob UI-Funktionen ausgeführt werden können. Das ist nicht der Fall, wenn das Ergebnisserverist.
Mit generateObject() und generateText() Aufgaben mit Ninox AI ausführen
Nutze diese beiden Funktionen, um Daten und Anweisungen an Ninox AI zu senden und Text oder ein JSON-Objekt zu erhalten. Nutze sie, um Texte zu klassifizieren, Werte zu extrahieren oder Felder automatisch auszufüllen.
generateObject(prompt, format) gibt ein JSON-Objekt mit den von format angeforderten Feldern zurück.
generateObject(prompt, format, model)
generateText(prompt) gibt Text zurück.
generateText(prompt, model)
promptein Textwert oder ein Array aus Texten. Es enthält die Daten, die Ninox AI prüfen soll, sowie den Prompt für Ninox AI.formatJSON-Werte, die die zurückgegebenen Felder und ihre Typen definieren:"string","number","boolean","date"oder eine Liste von Textwerten, wenn Ninox AI eine Option wählen soll. Übergebe sie in geschwungenen Klammern an die Funktion.modelein JSON-Wert, um ein AI-Modell auszuwählen:"haiku"(Standard),"sonnet","opus"oder"luna". Übergebe ihn in geschwungenen Klammern.
Wenn du Ninox-Felder verwendest, werden ihre Rohwerte übernommen. Bei einem Auswahlfeld ist das beispielsweise die Options-ID statt der Bezeichnung. Nutze die Funktion text(), um stattdessen den Textwert zu erhalten.
Lies die Felder des Ergebnisses mit r.field, item(r, "field") oder for key, value in r do … end.
Ein Datum wird als Text im Format YYYY-MM-DD zurückgegeben. Nutze date(), um es in einen Datumswert umzuwandeln.
Beachte die folgenden Limits:
format-Felder: maximal 20. Verwende nach Möglichkeit 1-7.Optionen pro Liste: 2-50. Verwende nach Möglichkeit bis zu 10.
Feldnamen: nur Buchstaben, Ziffern und
_. Beginne mit einem Buchstaben.errorist reserviert.Größe von
prompt: maximal 20.000 ZeichenTimeout: 25 Sekunden
AI-Calls pro Skriptausführung: maximal 50
4 gleichzeitige Calls pro Arbeitsbereich
Schauen wir uns einige Beispiele an:
Klassifiziert ein Support-Ticket und füllt die Felder für Kategorie und Priorität aus.
Extrahiert eine Zahl und ein Datum aus einer E-Mail. Die zurückgegebene Zahl kannst du in Berechnungen verwenden.
Gibt eine Zusammenfassung der E-Mail, unter Berücksichtigung von Betreff und Nachricht, in einer Pop-up-Nachricht aus.
Mehrere Datensätze verarbeiten
Du kannst die Funktionen einmal pro Datensatz oder einmal für eine Gruppe von Datensätzen aufrufen. Wähle den Ansatz anhand des benötigten Ergebnisses.
Nutze einen AI-Call pro Datensatz, wenn du für jeden Datensatz ein Feld ausfüllen musst. Dieses Beispiel klassifiziert jeden Datensatz in der Tabelle "Tickets":
Fünf Datensätze führen zu fünf AI-Calls. Jeder Datensatz erhält eine eigene Kategorie.
Nutze einen AI-Call für alle Datensätze, wenn du eine Übersicht oder einen Bericht für mehrere Datensätze benötigst. Dieses Beispiel sendet alle Titel und Nachrichten der Tickets in einem AI-Call:
Fünf Datensätze führen zu einem AI-Call. Dieser Ansatz ist schneller und benötigt weniger AI-Credits.
Tipps:
Jeder AI-Call verbraucht AI-Credits.
Sende nur notwendige Daten an Ninox AI.
Inhalte von Prompts, Nachrichten oder Antworten werden nicht protokolliert.
Das Ergebnis enthält die in
formatdefinierten Felder. Unbekannte Werte sindnull.Bei einem Fehler geben beide Funktionen
{error: "message"}zurück. Prüfer.error, bevor du das Ergebnis verwendest.
Zuletzt aktualisiert
War das hilfreich?