Aktionen
"Aktionen" ähneln Funktionen, haben aber keinen Rückgabewert und können deshalb nur in der Ereignisverarbeitung aber nicht in Formeln verwendet werden. Wie der Name schon sagt, zeichnen sie sich durch die Ausführung bestimmter Aktionen in der Datenbank oder in der Benutzeroberfäche aus.
Diese Seite listet die Aktionen alphabetisch sortiert auf:
addAttachment(alias,file), addComment(alias,text:str?,rating:num?), alert(title:str,text:str,onCancel:action,...,onOK:action,...), allowCascading(depth:num), busy(message:str,action,action,...), busyUpdate(message:str?,progress:num?), callShortcutEvent(name:str), copyToClipboard(text:str), declareBoolVariable(name), declareColorVariable(name), declareDateVariable(name), declareDocumentAlias(type,alias), declareDocumentIdArrayVariable(name), declareDocumentIdVariable(name), declareLocationVariable(name), declareNumericArrayVariable(name), declareNumericVariable(name), declareStringArrayVariable(name), declareStringVariable(name), delete(alias), deleteCommentsBeforeDate(alias,date), deleteCommentsOlderThan(alias,amount:num,unit:str), dislike(alias), emptyDict(alias), emptyDoc(type,alias), exportDocument(name:str), exportVariable(name:str), fetchUrl(url:str,method:String?,parameters:docRef?,headers:docRef?,data:String?,contentType:String?,onSuccess:action,...,onFailure:action,...), fetchUrl(url:str,onSuccess:action,...,onFailure:action,...), finally(do:action,action,...,finally:action,action,...), forEach(type,alias?,query?,sortedBy?,action,...), if(condition:bool,then:action,...,else:action,...), input(title:str,text:str,varName,defaultValue:string,onCancel:action,...,onOK:action,...), like(alias), new(type,alias), notify(title:str,text:str), openUrl(url:str), pushFilteredView(type,viewName:str,query,initialValues:alias), pushView(viewName:str), pushViewAndSearch(viewName:str,searchString:str,initialValue:alias,initialValues:alias), removeLocationNotification(alias,property), removeScheduledNotification(alias,property), runWorkflow(name:str,inputClipboard:bool,inputText:str?), save(alias,skipOnNoChange:bool?), selectFirst(type,alias?,query?,sortedBy?,action,...), selectLast(type,alias?,query?,sortedBy?,action,...), sendEmail(to:strArray,cc:strArray,bcc:strArray,subject:string,body:string,onSuccess:action,action...,onFailure:action,action,...,onCancel:action,action,...), sendMessage(recipients:strArray,body:string,onSuccess:action,action...,onFailure:action,action,...,onCancel:action,action,...), setLocationNotification(alias,property,radius:num,whenEntering:bool,whenLeaving:bool), setProperty(alias,property,value:bool), setProperty(alias,property,value:color), setProperty(alias,property,value:date), setProperty(alias,property,value:documentId), setProperty(alias,property,value:documentIdArray), setProperty(alias,property,value:location), setProperty(alias,property,value:num), setProperty(alias,property,value:str), setProperty(alias,property,value:strArray), setScheduledNotification(alias,property,offset:num,dateOnly:bool,repeatEvery:str), setValue(alias,property,value:bool), setValue(alias,property,value:color), setValue(alias,property,value:date), setValue(alias,property,value:documentId), setValue(alias,property,value:documentIdArray), setValue(alias,property,value:location), setValue(alias,property,value:num), setValue(alias,property,value:str), setValue(alias,property,value:strArray), setVariable(name,value:bool), setVariable(name,value:color), setVariable(name,value:date), setVariable(name,value:documentId), setVariable(name,value:documentIdArray), setVariable(name,value:location), setVariable(name,value:num), setVariable(name,value:numArray), setVariable(name,value:str), setVariable(name,value:strArray), showFilteredView(type,viewName:str,query,initialValue:alias), showForm(view,readOnly:bool,document:alias?,initialValues:alias?), showLog(), showView(viewName:str), showViewAndSearch(viewName:str,searchString:str,initialValue:alias), suppressNotification(), while(condition:bool,action,action,...)
addAttachment(alias,file)
Verwendbar in: Ereignisse
Rückgabewert(Aktion)
Fügt einen Dateianhang zum Dokument mit dem angegebenen Dokumenten-Alias hinzu. Die Speicherung des geänderten Datensatzes in der Datenbank erfolgt sofort.
1 | "alias" | Dokument | Vorhandener Dokumenten-Alias des Dokuments, dem ein Anhang hinzugefügt werden soll. Das Dokument muss zuvor bereits gespeichert worden sein, falls es mit new() erzeugt wurde, sollte es also vor dem Hinzufügen von Anhängen mit save() gespeichert werden. |
2 | "file" | Variable,optional | Datei-Variable, z.B. aus dem fileImport-Event. |
addComment(alias,text:str?,rating:num?)
Verwendbar in: Ereignisse
Rückgabewert(Aktion)
Fügt einen Kommentar für das angegebene Dokument hinzu. (Hinweis: Der Kommentar kann nur betrachtet werden, wenn das Formular des Typs ein Kommentarfeld hat.)
1 | "alias" | Dokument | Vorhandener Dokumenten-Alias des Dokuments, dem ein Kommentar hinzugefügt werden soll. |
2 | "text" | Text,optional | Kommentartext |
3 | "rating" | Zahl,optional | Bewertung (0-5) |
alert(title:str,text:str,onCancel:action,...,onOK:action,...)
Verwendbar in: Ereignisse
Rückgabewert(Aktion)
Zeigt eine Meldung in der Benutzeroberfläche der App an. Es wird immer ein Abbrechen-Button angezeigt, allerdings nur dann ein OK-Button, wenn dafür Aktionen konfiguriert wurden. Diese Aktion funktioniert nur bei Ausführung des Ereignisses während die App im Vordergrund ist.
1 | "title" | Text | Überschrift der Meldung |
2 | "text" | Text | Text der Meldung |
3 | "onCancel" | Aktion,1-*,optional | Aktionen, die ausgeführt werden sollen, wenn der Benutzer den Abbrechen-Button betätigt |
4 | "onOK" | Aktion,1-*,optional | Aktionen, die ausgeführt werden sollen, wenn der Benutzer den OK-Button betätigt |
allowCascading(depth:num)
Verwendbar in: Ereignisse
Rückgabewert(Aktion)
Ermöglicht die kaskadierte Ausführung von Ereignissen: Normalerweise werden innerhalb der Verarbeitung eines Ereignisses, keine weitere Ereignisverarbeitung statt (Ausnahme: Direkter Aufruf per callShortcutEvent()). Um dies bis zu einer gewissen Verschachtelungstiefe trotzdem zu erlauben, kann diese Aktion ausgeführt werden.
1 | "depth" | Zahl | Verschachtelungstiefe, bis zu der die Ausführung erlaubt wird. |
busy(message:str,action,action,...)
Verwendbar in: Ereignisse
Rückgabewert(Aktion)
Zeigt für die Laufzeit der angegebenen Aktionen eine Meldung an, dass die App beschäftigt ist.
1 | "message" | Text,optional | Meldung, die angezeigt wird. |
2 | "actions" | Aktion,1-*,optional | Aktionen, während derer die Meldung angezeigt werden soll. |
busyUpdate(message:str?,progress:num?)
Verwendbar in: Ereignisse
Rückgabewert(Aktion)
Aktualisiert die mittels busy() angezeigte Meldung oder die angezeigte Prozentzahl allerdings nur, falls die Meldung noch angezeigt wird. Über diese Funktion kann auch ein prozentualer Verlauf eingblendet werden.
1 | "message" | Text,optional | Neue Meldung, die angezeigt werden soll. |
2 | "progress" | Zahl,optional | Zahl zwischen 0 und 1, die den anteiligen Forschritt angibt |
callShortcutEvent(name:str)
Verwendbar in: Ereignisse
Rückgabewert(Aktion)
Führt ein Shortcut-Event des selben Projekts in SketShDb aus. Sämtliche gesetzten Variablen und vorhandenen Dokumeten-Alias des aufrufenden Events werden an das aufgerufene Event weitergegeben. Damit darauf zugegriffen werden kann, müssen diese im aufgerufenen Event allerdings per declare...-Aktion deklariert werden.
1 | "name" | Text | Name des Shortcut-Events, das aufgerufen werden soll. |
copyToClipboard(text:str)
Verwendbar in: Ereignisse
Rückgabewert(Aktion)
Kopiert den angegebenen Text in die Zwischenablage
1 | "text" | Text | Text, der in die Zwischenablage kopiert werden soll. |
declareBoolVariable(name)
Verwendbar in: Ereignisse
Rückgabewert(Aktion)
Deklariert eine boolesche ( = Schalter-) Variable, deren Wert von außen an die Ereignisverarbeitung übergeben wird (z.B. aus einem URL-Schema-Aufruf oder beim Aufruf eine Shortcut-Ereignisses aus einem anderen Ereignis)
1 | "name" | Variablen-Alias | Name der Variable |
declareColorVariable(name)
Verwendbar in: Ereignisse
Rückgabewert(Aktion)
Deklariert eine Variable für Farbwerte, deren Wert von außen an die Ereignisverarbeitung übergeben wird (z.B. aus einem URL-Schema-Aufruf oder beim Aufruf eine Shortcut-Ereignisses aus einem anderen Ereignis)
1 | "name" | Variablen-Alias | Name der Variable |
declareDateVariable(name)
Verwendbar in: Ereignisse
Rückgabewert(Aktion)
Deklariert eine Variable für Datum- oder Zeitwerte, deren Wert von außen an die Ereignisverarbeitung übergeben wird (z.B. aus einem URL-Schema-Aufruf oder beim Aufruf eine Shortcut-Ereignisses aus einem anderen Ereignis)
1 | "name" | Variablen-Alias | Name der Variable |
declareDocumentAlias(type,alias)
Verwendbar in: Ereignisse
Rückgabewert(Aktion)
Deklariert einen Dokumenten-Alias für ein Dokument, das von außen an die Ereignisverarbeitung übergeben wird (z.B. aus einem URL-Schema-Aufruf oder beim Aufruf eine Shortcut-Ereignisses aus einem anderen Ereignis)
1 | "type" | Typ | Name des neuen Dokumenten-Alias, der im Anschluss verwendet werden kann |
2 | "alias" | Dokumenten-Alias |
declareDocumentIdArrayVariable(name)
Verwendbar in: Ereignisse
Rückgabewert(Aktion)
Deklariert eine Variable für eine Liste von Dokumenten-IDs, deren Wert von außen an die Ereignisverarbeitung übergeben wird (z.B. aus einem URL-Schema-Aufruf oder beim Aufruf eine Shortcut-Ereignisses aus einem anderen Ereignis)
1 | "name" | Variablen-Alias | Name der Variable |
declareDocumentIdVariable(name)
Verwendbar in: Ereignisse
Rückgabewert(Aktion)
Deklariert eine Variable für eine Dokumenten-ID, deren Wert von außen an die Ereignisverarbeitung übergeben wird (z.B. aus einem URL-Schema-Aufruf oder beim Aufruf eine Shortcut-Ereignisses aus einem anderen Ereignis)
1 | "name" | Variablen-Alias | Name der Variable |
declareLocationVariable(name)
Verwendbar in: Ereignisse
Rückgabewert(Aktion)
Deklariert eine Variable für Ortswerte, deren Wert von außen an die Ereignisverarbeitung übergeben wird (z.B. aus einem URL-Schema-Aufruf oder beim Aufruf eine Shortcut-Ereignisses aus einem anderen Ereignis)
1 | "name" | Variablen-Alias | Name der Variable |
declareNumericArrayVariable(name)
Verwendbar in: Ereignisse
Rückgabewert(Aktion)
Deklariert eine Variable für eine Liste von Zahlenwerten, deren Wert von außen an die Ereignisverarbeitung übergeben wird (z.B. aus einem URL-Schema-Aufruf oder beim Aufruf eine Shortcut-Ereignisses aus einem anderen Ereignis)
1 | "name" | Variablen-Alias | Name der Variable |
declareNumericVariable(name)
Verwendbar in: Ereignisse
Rückgabewert(Aktion)
Deklariert eine numerische Variable, deren Wert von außen an die Ereignisverarbeitung übergeben wird (z.B. aus einem URL-Schema-Aufruf oder beim Aufruf eine Shortcut-Ereignisses aus einem anderen Ereignis)
1 | "name" | Variablen-Alias | Name der Variable |
declareStringArrayVariable(name)
Verwendbar in: Ereignisse
Rückgabewert(Aktion)
Deklariert eine Variable für eine Liste von Textwerten, deren Wert von außen an die Ereignisverarbeitung übergeben wird (z.B. aus einem URL-Schema-Aufruf oder beim Aufruf eine Shortcut-Ereignisses aus einem anderen Ereignis)
1 | "name" | Variablen-Alias | Name der Variable |
declareStringVariable(name)
Verwendbar in: Ereignisse
Rückgabewert(Aktion)
Deklariert eine Text-Variable, deren Wert von außen an die Ereignisverarbeitung übergeben wird (z.B. aus einem URL-Schema-Aufruf oder beim Aufruf eine Shortcut-Ereignisses aus einem anderen Ereignis)
1 | "name" | Variablen-Alias | Name der Variable |
delete(alias)
Verwendbar in: Ereignisse
Rückgabewert(Aktion)
Löscht das angegebene Dokument aus der Datenbank.
1 | "alias" | Dokument | Vorhandener Dokumenten-Alias des zu löschenden Dokuments. |
deleteCommentsBeforeDate(alias,date)
Verwendbar in: Ereignisse
Rückgabewert(Aktion)
Löscht die Kommentare des angegebenen Dokuments, die vor dem angegebenen Datum angelegt wurden.
1 | "alias" | Dokument | Vorhandener Dokumenten-Alias des Dokuments, dem ein Kommentar hinzugefügt werden soll. |
2 | "date" | Datum | Datum |
deleteCommentsOlderThan(alias,amount:num,unit:str)
Verwendbar in: Ereignisse
Rückgabewert(Aktion)
Löscht die Kommentare des angegebenen Dokuments, die vor mehr als der angegebenen Zeitspanne angelegt wurden. Die Zeitspanne wird als eine ganze Anzahl (2. Parameter) einer Zeiteinheit (3. Parameter) angegeben.
1 | "alias" | Dokument | Anzahl der Zeiteinheiten. |
2 | "amount" | Zahl | Zeiteinheit, wird als einzelner Buchstabe angegeben. (y = Jahr, m = Monat, w = Woche, d = Tag, h = Stunde, i = Minute, s = Sekunde) |
3 | "unit (y/m/w/d/h/i/s)" | Text |
dislike(alias)
Verwendbar in: Ereignisse
Rückgabewert(Aktion)
Fügt einen Dislike für das angegebene Dokument hinzu. (Hinweis: Das Ergebnis kann nur betrachtet werden, wenn das Formular des Typs ein Like/Dislike-Feld hat.)
1 | "alias" | Dokument | Vorhandener Dokumenten-Alias des Dokuments, dem das Dislike hinzugefügt werden soll. |
emptyDict(alias)
Verwendbar in: Ereignisse
Rückgabewert(Aktion)
Erzeugt einen leeres Dokument im Arbeitsspeicher
1 | "alias" | Dokumenten-Alias | Neuer Dokumenten-Alias, der durch die Aktion erzeugt wird und unter dem das Dokument zur Verfügung steht. |
emptyDoc(type,alias)
Verwendbar in: Ereignisse
Rückgabewert(Aktion)
Erzeugt einen typisiertes, leeres Dokument im Arbeitsspeicher. Die Typisierung ist wichtig, damit im Formel-/Ereigniseditor die korrekten Felder angezeigt bzw. ausgewählt werden können.
1 | "type" | Typ | Typ, mit dem das leere Dokument typisiert ist. |
2 | "alias" | Dokumenten-Alias | Neuer Dokumenten-Alias, der durch die Aktion erzeugt wird und unter dem das Dokument zur Verfügung steht. |
exportDocument(name:str)
Verwendbar in: Ereignisse
Rückgabewert(Aktion)
Exportiert ein Dokument aus dem aktuellen Shortcut-Ereignis, so dass die Variable im aufrufenden Ereignis verfügbar ist. Falls diese Variable im aufrufenden Ereignis zuvor nicht gesetzt war, muss die Variable im aufrufenden Ereignis explizit deklariert werden.
1 | "name" | Dokument | Name des vorhandenen Dokumenten-Alias, der exportiert werden soll |
exportVariable(name:str)
Verwendbar in: Ereignisse
Rückgabewert(Aktion)
Exportiert eine Variable aus dem aktuellen Shortcut-Ereignis, so dass die Variable im aufrufenden Ereignis verfügbar ist. Falls diese Variable im aufrufenden Ereignis zuvor nicht gesetzt war, muss die Variable im aufrufenden Ereignis explizit deklariert werden.
1 | "name" | Variable | Name der Variable, die exportiert werden soll |
fetchUrl(url:str,method:String?,parameters:docRef?,headers:docRef?,data:String?,contentType:String?,onSuccess:action,...,onFailure:action,...)
Verwendbar in: Ereignisse
Anmerkungen:
- deklariert die Variable statusCode (numeric): Der vom Server zurückgegebene HTTP Statuscode.
- deklariert die Variable response (string): Die Antwort des Servers. (z.B. ein JSON Dokument)
Rückgabewert(Aktion)
Ruft den Inhalt eines URL per HTTP Request ab und gibt diesen als Text in der Variablen "reponse" zurück.
1 | "url" | Text | Adresse (URL) unter der der Inhalt zu finden ist. |
2 | "method" | Text,optional | HTTP-Methode (z.B. "GET","POST","PUT","DELETE") |
3 | "parameters" | Dokument,optional | Parameter für den HTTP Request als DokumentReferenz |
4 | "headers" | Dokument,optional | Header für de HTTP Request als Dokument |
5 | "data" | Text,optional | Daten (Payload) für den HTTP Request |
6 | "contentType" | Text,optional | Content-Type für den Request. Unterstützt "multipart/form-data", "text/plain", "application/json". Falls nicht angegeben, dann wird abhängig davon ob ein Payload übergeben wurde "application/json" oder sonst "application/x-www-form-urlencoded" angenommen. Charsets werden aktuell nicht ausgewertet, es wird immer UTF-8 verwendet. |
7 | "onSuccess" | Aktion,1-*,optional | Aktionen, die ausgeführt werden, wenn der Inhalt erfolgreich abgerufen werden konnte. |
8 | "onFailure" | Aktion,1-*,optional | Aktionen, die ausgeführt werden, wenn die Aktion nicht erfolgreich war. |
fetchUrl(url:str,onSuccess:action,...,onFailure:action,...)
Verwendbar in: Ereignisse
Anmerkungen:
- deklariert die Variable statusCode (numeric): Der vom Server zurückgegebene HTTP Statuscode.
- deklariert die Variable response (string): Die Antwort des Servers. (z.B. ein JSON Dokument)
Rückgabewert(Aktion)
Ruft den Inhalt eines URL per GET Request ab und gibt diesen als Text in der Variablen "reponse" zurück.
1 | "url" | Text | Adresse (URL) unter der der Inhalt zu finden ist. |
2 | "onSuccess" | Aktion,1-*,optional | Aktionen, die ausgeführt werden, wenn der Inhalt erfolgreich abgerufen werden konnte. |
3 | "onFailure" | Aktion,1-*,optional | Aktionen, die ausgeführt werden, wenn die Aktion nicht erfolgreich war. |
finally(do:action,action,...,finally:action,action,...)
Verwendbar in: Ereignisse
Rückgabewert(Aktion)
Führt die Aktionen im "finally"-Block nach Abschluss aller (auch asynchroner) Aktionen im "do"-Block aus.
1 | "do" | Aktion,1-*,optional | Aktionen, die zuerst ausgeführt werden |
2 | "finally" | Aktion,1-*,optional | Aktionen, die nach vollständigem Abschluss der anderen Aktionen ausgeführt werden sollen |
forEach(type,alias?,query?,sortedBy?,action,...)
Verwendbar in: Ereignisse
Rückgabewert(Aktion)
FÜhrt die Aktionen für jedes den Bedingungen entsprechende Dokument in der angegebenen Sortierreihenfolge aus.
1 | "type" | Typ | Typ, dem die Dokumente entsprechen müssen |
2 | "alias" | Dokumenten-Alias,optional | Bedingung, der die Dokumente entsprechen müssen. Es können hier nur statische Bedingungen (wie bei der Filterkonfiguration für Listenansichten) angegeben werden. Sollten weitergehende dynamische Bedingungen gewünscht sein, müssen diese in einem nachgelagerten if-Statement abgefragt werden. |
3 | "query" | Abfrage,optional | Sortierkriterien |
4 | "sortedBy" | Sortierung,optional | Aktionen, die für jedes entsprechende Dokument ausgeführt werden. |
5 | "actions" | Aktion,1-*,optional |
if(condition:bool,then:action,...,else:action,...)
Verwendbar in: Ereignisse
Rückgabewert(Aktion)
Wertet die Bedingung aus und führt abhängig vom Ergebnis Aktionen aus.
1 | "condition" | Schalter | Bedingung, muss einen Booleschen Wert ergeben. |
2 | "then" | Aktion,1-*,optional | Aktionen, die ausgeführt werden, wenn die Bedingung wahr ergibt. |
3 | "else" | Aktion,1-*,optional | Aktionen, die ausgeführt werden, wenn die Bedingung falsch ergibt. |
input(title:str,text:str,varName,defaultValue:string,onCancel:action,...,onOK:action,...)
Verwendbar in: Ereignisse
Rückgabewert(Aktion)
Zeigt eine Meldung mit Eingabefeld an. Die Eingabe kann anschließend weiterverarbeitet werden.
1 | "title" | Text | Überschrift der Meldung |
2 | "text" | Text | Text der Meldung |
3 | "varName" | Variablen-Alias | Name der Text-Variable unter der der eingegebene Text zur Verfügung steht |
4 | "defaultValue" | Text,optional | Standardwert, mit dem das Eingabefeld vorbelegt wird |
5 | "onCancel" | Aktion,1-*,optional | Aktionen, die ausgeführt werden, wenn der Benutzer den Abbrechen-Button betätigt |
6 | "onOK" | Aktion,1-*,optional | Aktionen, die ausgeführt werden, wenn der Benutzer den OK-Button betätigt |
like(alias)
Verwendbar in: Ereignisse
Rückgabewert(Aktion)
Fügt einen Like für das angegebene Dokument hinzu. (Hinweis: Das Ergebnis kann nur betrachtet werden, wenn das Formular des Typs ein Like/Dislike-Feld hat.)
1 | "alias" | Dokument | Vorhandener Dokumenten-Alias des Dokuments, dem das Like hinzugefügt werden soll. |
new(type,alias)
Verwendbar in: Ereignisse
Rückgabewert(Aktion)
Erzeugt ein neues Dokument im Arbeitsspeicher des Geräts und belegt die Standardwerte vor. Damit das Dokument in die Datenbank gespeichert wird, muss anschließend noch die Aktion save() für den entsprechenden Dokumenten-Alias aufgerufen werden.
1 | "type" | Typ | Typ, für den ein neues Dokument erzeugt werden soll. |
2 | "alias" | Dokumenten-Alias | Neuer Dokumenten-Alias, der durch die Aktion erzeugt wird und unter dem das neue Dokument zur Verfügung steht. Über setProperty()-Aufrufe können anschließend weitere Werte gesetzt oder geändert werden. |
notify(title:str,text:str)
Verwendbar in: Ereignisse
Rückgabewert(Aktion)
Zeigt dem Benutzer eine Meldung an. Diese Aktion zeigt eine Meldung ähnlich alert() an, wenn die App im Vordergrund ist und eine Systembenachrichtigung, wenn die App im Hintergrund ist.
1 | "title" | Text | Überschrift der Meldung |
2 | "text" | Text,optional | Text der Meldung |
openUrl(url:str)
Verwendbar in: Ereignisse
Rückgabewert(Aktion)
Öffnet den angegebenen URL. Diese Aktion funktioniert nur, wenn die SketShDb-App im Vordergrund läuft.
1 | "url" | Text | Adresse des zu öffnenden URLs |
pushFilteredView(type,viewName:str,query,initialValues:alias)
Verwendbar in: Ereignisse
Rückgabewert(Aktion)
Zeigt die angegebene Ansicht "über" der bereits angezeigten Ansicht an, so dass aus der angegebenen Ansicht wieder in die zuvor angezeigte Ansicht zurück navigiert werden kann. Dabei kann ein zusätzlicher Filter für die anzuzeigende Ansicht definiert werden. Dieser Filter kann auch Verweise auf im Eventhandler zuvor deklarierte Variablen enthalten.
1 | "type" | Typ | Typ der Daten in der anzuzeigenden Ansicht. (Muss mit dem in der Ansicht verwendeten Typ übereinstimmen.) |
2 | "viewName" | Text | Name der anzuzeigenden Ansicht |
3 | "query" | Abfrage | Zusätzlicher Filter für die Ansicht |
4 | "initialValues" | Dokument,optional | Dokument mit Werten, die beim Erzeugen von neuen Datensätzen aus der View vorbelegt werden. Zur Erstellung des Dokuments kann die Funktion (emptyDoc(type,alias)) verwendet werden. |
pushView(viewName:str)
Verwendbar in: Ereignisse
Rückgabewert(Aktion)
Zeigt die angegebene Ansicht "über" der bereits angezeigten Ansicht an, so dass aus der angegebenen Ansicht wieder in die zuvor angezeigte Ansicht zurück navigiert werden kann.
1 | "viewName" | Text | Name der anzuzeigenden Ansicht |
pushViewAndSearch(viewName:str,searchString:str,initialValue:alias,initialValues:alias)
Verwendbar in: Ereignisse
Rückgabewert(Aktion)
Zeigt die angegebene Ansicht "über" der bereits angezeigten Ansicht an, so dass aus der angegebenen Ansicht wieder in die zuvor angezeigte Ansicht zurück navigiert werden kann. Dabei kann ein Suchbegriff definiert werden, der initial in die Suche der anzuzeigenden Ansicht eingetragen wird.
1 | "viewName" | Text | Name der anzuzeigenden Ansicht |
2 | "searchString" | Text | Suchbegriff, der initial in die Suche der Ansicht eingetragen wird |
3 | "initialValues" | Dokument,optional | Dokument mit Werten, die beim Erzeugen von neuen Datensätzen aus der View vorbelegt werden. Zur Erstellung des Dokuments kann die Funktion (emptyDoc(type,alias)) verwendet werden. |
removeLocationNotification(alias,property)
Verwendbar in: Ereignisse
Rückgabewert(Aktion)
Deaktiviert die Ortsbenachrichtigung für die angegebene Eigenschaft eines Dokuments
1 | "alias" | Dokument | Vorhandener Dokumenten-Alias des Dokuments für das die Benachrichtigung deaktiviert werden soll |
2 | "property" | Feld | Ortsfeld, dessen Benachrichtigung gelöscht werden soll. (Die Angabe ist notwendig, da es pro Dokument mehrere Ortsfelder geben kann.) |
removeScheduledNotification(alias,property)
Verwendbar in: Ereignisse
Rückgabewert(Aktion)
Löscht/Deaktiviert eine zeitgesteuerte Benachrichtigung für das Datum im angegebenen Feld des angegebenen Dokuments.
1 | "alias" | Dokument | Vorhandener Dokumenten-Alias des Dokuments für das die Benachrichtigung gelöscht werden soll. |
2 | "property" | Feld | Datumsfeld, für dessen Wert die Benachrichtigung gelöscht werden soll. |
runWorkflow(name:str,inputClipboard:bool,inputText:str?)
Verwendbar in: Ereignisse
Rückgabewert(Aktion)
Führt einen Workflow in der Shortcuts-App aus. Diese Aktion funktioniert nur, wenn SketShDb im Vordergrund aktiv ist.
1 | "name" | Text | Name des Workflows in der Shortcuts-App, der ausgeführt werden soll |
2 | "inputClipboard" | Schalter | Wenn eingeschaltet, dann wird der Shortcuts-App angezeigt, dass sich die Eingabe für den Workflow in der Zwischenablage befindet |
3 | "inputText" | Text,optional | Wenn inputClipboard nicht eingeschaltet wurde, dann kann mit diesem Parameter eine Eingabe an den Workflow übergeben werden |
save(alias,skipOnNoChange:bool?)
Verwendbar in: Ereignisse
Rückgabewert(Aktion)
Speichert ein Dokument aus dem Arbeitsspeichert in die Datenbank
1 | "alias" | Dokument | Vorhandener Dokumenten-Alias des Dokuments, das gespeichert werden soll. |
2 | "skipOnNoChange" | Schalter,optional | Wenn dieser Wert auf an/wahr gesetzt wird, dann wird das Dokument nur dann gespeichert, wenn sich Werte im Vergleich zur letzten Version in der Datenbank geändert haben. |
selectFirst(type,alias?,query?,sortedBy?,action,...)
Verwendbar in: Ereignisse
Rückgabewert(Aktion)
FÜhrt die Aktionen für das erste den Bedingungen entsprechende Dokument in der angegebenen Sortierreihenfolge aus.
1 | "type" | Typ | Typ, dem das Dokument entsprechen muss |
2 | "alias" | Dokumenten-Alias,optional | Neuer Dokumenten-Alias, der durch die Aktion erzeugt wird und unter dem auf das ausgewählte Dokument zugegriffen werden kann. |
3 | "query" | Abfrage,optional | Bedingung, der das Dokument entsprechen muss. Es können hier nur statische Bedingungen (wie bei der Filterkonfiguration für Listenansichten) angegeben werden. Sollten weitergehende dynamische Bedingungen gewünscht sein, muss dies über . |
4 | "sortedBy" | Sortierung,optional | Sortierkriterien |
5 | "actions" | Aktion,1-*,optional | Aktionen, die für das entsprechende Dokument ausgeführt werden. |
selectLast(type,alias?,query?,sortedBy?,action,...)
Verwendbar in: Ereignisse
Rückgabewert(Aktion)
FÜhrt die Aktionen für das letzte den Bedingungen entsprechende Dokument in der angegebenen Sortierreihenfolge aus.
1 | "type" | Typ | Typ, dem das Dokument entsprechen muss |
2 | "alias" | Dokumenten-Alias,optional | Neuer Dokumenten-Alias, der durch die Aktion erzeugt wird und unter dem auf das ausgewählte Dokument zugegriffen werden kann. |
3 | "query" | Abfrage,optional | Bedingung, der das Dokument entsprechen muss. Es können hier nur statische Bedingungen (wie bei der Filterkonfiguration für Listenansichten) angegeben werden. Sollten weitergehende dynamische Bedingungen gewünscht sein, muss dies über . |
4 | "sortedBy" | Sortierung,optional | Sortierkriterien |
5 | "actions" | Aktion,1-*,optional | Aktionen, die für das entsprechende Dokument ausgeführt werden. |
sendEmail(to:strArray,cc:strArray,bcc:strArray,subject:string,body:string,onSuccess:action,action...,onFailure:action,action,...,onCancel:action,action,...)
Verwendbar in: Ereignisse
Rückgabewert(Aktion)
Öffnet die Systemansicht zum E-Mail-Versand mit vorbelegten Werten.
1 | "to" | Liste von Texten,optional | Liste von Empfängern (E-Mailadressen) |
2 | "cc" | Liste von Texten,optional | Liste von CC-Empfängern (E-Mailadressen) |
3 | "bcc" | Liste von Texten,optional | Liste von BCC-Empfängern (E-Mailadressen) |
4 | "subject" | Text,optional | E-Mail Betreff |
5 | "body" | Text,optional | E-Mail Text |
6 | "onSuccess" | Aktion,1-*,optional | Aktionen, die ausgeführt werden sollen, wenn die E-Mail erfolgreich versendet wurde |
7 | "onFailure" | Aktion,1-*,optional | Aktionen, die ausgeführt werden sollen, wenn der E-Mailversand fehlgeschlagen ist |
8 | "onCancel" | Aktion,1-*,optional | Aktionen, die ausgeführt werden sollen, wenn der Benutzer den Mailversand abgebrochen hat |
sendMessage(recipients:strArray,body:string,onSuccess:action,action...,onFailure:action,action,...,onCancel:action,action,...)
Verwendbar in: Ereignisse
Rückgabewert(Aktion)
Öffnet die Systemansicht zum Versand einer Kurznachricht (iMessage/SMS) mit vorbelegten Werten.
1 | "recipients" | Liste von Texten | Liste von Empfänger (Telefonnummern oder E-Mailadressen) |
2 | "body" | Text,optional | Text der Nachricht |
3 | "onSuccess" | Aktion,1-*,optional | Aktionen, die ausgeführt werden sollen, wenn die E-Mail erfolgreich versendet wurde |
4 | "onFailure" | Aktion,1-*,optional | Aktionen, die ausgeführt werden sollen, wenn der E-Mailversand fehlgeschlagen ist |
5 | "onCancel" | Aktion,1-*,optional | Aktionen, die ausgeführt werden sollen, wenn der Benutzer den Mailversand abgebrochen hat |
setLocationNotification(alias,property,radius:num,whenEntering:bool,whenLeaving:bool)
Verwendbar in: Ereignisse
Rückgabewert(Aktion)
Aktiviert die Ortsbenachrichtigung für den Wert eines Ortsfelds eines Dokuments.
1 | "alias" | Dokument | Vorhandener Dokumenten-Alias-Referenz des betreffenden Dokuments, für das die Ortsbenachrichtigung aktiviert werden soll |
2 | "property" | Feld | Ortsfeld-Eigenschaft, für deren Wert die Benachrichtigung aktiviert werden soll |
3 | "radius (m)" | Zahl | Radius um den Ort in Metern. |
4 | "whenEntering" | Schalter | Wenn eingeschaltet, dann wird die Benachrichtigung beim Betreten der Region ausgelöst |
5 | "whenLeaving" | Schalter | Wenn eingeschaltet, dann wird die Benachrichtigung beim Verlassen der Region ausgelöst |
setProperty(alias,property,value:bool)
Verwendbar in: Ereignisse
Rückgabewert(Aktion)
Setzt ein boolesches ( = Schalter-) Feld eines Dokuments im Arbeitsspeicher.
1 | "alias" | Dokument | Vorhandener Dokumenten-Alias unter dem das Dokument im Arbeitsspeicher zu finden ist. |
2 | "property" | Feld | Name des Felds, das gesetzt werden soll |
3 | "value" | Schalter | Wert, der im angegebenen Dokument für das angegebene Feld gesetzt werden soll |
setProperty(alias,property,value:color)
Verwendbar in: Ereignisse
Rückgabewert(Aktion)
Setzt ein Farbfeld eines Dokuments im Arbeitsspeicher.
1 | "alias" | Dokument | Vorhandener Dokumenten-Alias unter dem das Dokument im Arbeitsspeicher zu finden ist. |
2 | "property" | Feld | Name des Felds, das gesetzt werden soll |
3 | "value" | Farbe | Wert, der im angegebenen Dokument für das angegebene Feld gesetzt werden soll |
setProperty(alias,property,value:date)
Verwendbar in: Ereignisse
Rückgabewert(Aktion)
Setzt ein Datums- oder Zeitfeld eines Dokuments im Arbeitsspeicher.
1 | "alias" | Dokument | Vorhandener Dokumenten-Alias unter dem das Dokument im Arbeitsspeicher zu finden ist. |
2 | "property" | Feld | Name des Felds, das gesetzt werden soll |
3 | "value" | Datum | Wert, der im angegebenen Dokument für das angegebene Feld gesetzt werden soll |
setProperty(alias,property,value:documentId)
Verwendbar in: Ereignisse
Rückgabewert(Aktion)
Setzt ein Eins-zu-Eins-Verknüpfungsfeld eines Dokuments im Arbeitsspeicher auf die übergebene Dokumenten-ID.
1 | "alias" | Dokument | Vorhandener Dokumenten-Alias unter dem das Dokument im Arbeitsspeicher zu finden ist. |
2 | "property" | Feld | Name des Felds, das gesetzt werden soll |
3 | "value" | Dokumenten-ID | Wert, der im angegebenen Dokument für das angegebene Feld gesetzt werden soll |
setProperty(alias,property,value:documentIdArray)
Verwendbar in: Ereignisse
Rückgabewert(Aktion)
Setzt ein Eins-zu-Viele-Verknüpfungsfeld eines Dokuments im Arbeitsspeicher auf die übergebene Dokumenten-ID.
1 | "alias" | Dokument | Vorhandener Dokumenten-Alias unter dem das Dokument im Arbeitsspeicher zu finden ist. |
2 | "property" | Feld | Name des Felds, das gesetzt werden soll |
3 | "value" | Liste von Dokumenten-IDs | Wert, der im angegebenen Dokument für das angegebene Feld gesetzt werden soll |
setProperty(alias,property,value:location)
Verwendbar in: Ereignisse
Rückgabewert(Aktion)
Setzt ein Ortfeld eines Dokuments im Arbeitsspeicher.
1 | "alias" | Dokument | Vorhandener Dokumenten-Alias unter dem das Dokument im Arbeitsspeicher zu finden ist. |
2 | "property" | Feld | Name des Felds, das gesetzt werden soll |
3 | "value" | Ort | Wert, der im angegebenen Dokument für das angegebene Feld gesetzt werden soll |
setProperty(alias,property,value:num)
Verwendbar in: Ereignisse
Rückgabewert(Aktion)
Setzt ein numerisches Feld eines Dokuments im Arbeitsspeicher.
1 | "alias" | Dokument | Vorhandener Dokumenten-Alias unter dem das Dokument im Arbeitsspeicher zu finden ist. |
2 | "property" | Feld | Name des Felds, das gesetzt werden soll |
3 | "value" | Zahl | Wert, der im angegebenen Dokument für das angegebene Feld gesetzt werden soll |
setProperty(alias,property,value:str)
Verwendbar in: Ereignisse
Rückgabewert(Aktion)
Setzt ein Textfeld eines Dokuments im Arbeitsspeicher.
1 | "alias" | Dokument | Vorhandener Dokumenten-Alias unter dem das Dokument im Arbeitsspeicher zu finden ist. |
2 | "property" | Feld | Name des Felds, das gesetzt werden soll |
3 | "value" | Text | Wert, der im angegebenen Dokument für das angegebene Feld gesetzt werden soll |
setProperty(alias,property,value:strArray)
Verwendbar in: Ereignisse
Rückgabewert(Aktion)
Setzt ein Textlistenfeld eines Dokuments im Arbeitsspeicher.
1 | "alias" | Dokument | Vorhandener Dokumenten-Alias unter dem das Dokument im Arbeitsspeicher zu finden ist. |
2 | "property" | Feld | Name des Felds, das gesetzt werden soll |
3 | "value" | Liste von Texten | Wert, der im angegebenen Dokument für das angegebene Feld gesetzt werden soll |
setScheduledNotification(alias,property,offset:num,dateOnly:bool,repeatEvery:str)
Verwendbar in: Ereignisse
Rückgabewert(Aktion)
Aktiviert eine zeitgesteuerte Benachrichtigung für das Datum im angegebenen Feld des angegebenen Dokuments.
1 | "alias" | Dokument | Vorhandener Dokumenten-Alias des Dokuments für das eine Benachrichtigung erzeugt werden soll. |
2 | "property" | Feld | Datumsfeld, für dessen Wert die Benachrichtigung aktiviert werden soll. |
3 | "offset (min.)" | Zahl,optional | Zeitversatz für die Benachrichtigung in Minuten. Bei negativen Werten erfolgt die Benachrichtigung vor der Zeit im Dokument, bei positiven Werten danach. |
4 | "dateOnly" | Schalter,optional | Wenn dateOnly auf an/wahr gesetzt wird, dann erfolgt die Berechnung lediglich tagesgenau um 9:00 Uhr. |
5 | "repeatEvery (y/m/w/d/h/i/s)" | Text,optional | Falls eine regelmäßige Wiederholung erfolgen soll, dann kann diese als Zeiteinheit gesetzt werden. (y = Jahr, m = Monat, w = Woche, d = Tag, h = Stunde, i = Minute, s = Sekunde) |
setValue(alias,property,value:bool)
Verwendbar in: Ereignisse
Rückgabewert(Aktion)
Setzt ein boolesches ( = Schalter-) Feld eines untypisierten (z.B. durch emptyDict erzeugten) Dokuments im Arbeitsspeicher.
1 | "alias" | Dokument | Vorhandener Dokumenten-Alias unter dem das Dokument im Arbeitsspeicher zu finden ist. |
2 | "property" | Text | Name des Felds, das gesetzt werden soll |
3 | "value" | Schalter | Wert, der im angegebenen Dokument für das angegebene Feld gesetzt werden soll |
setValue(alias,property,value:color)
Verwendbar in: Ereignisse
Rückgabewert(Aktion)
Setzt ein Farbfeld eines untypisierten (z.B. durch emptyDict erzeugten) Dokuments im Arbeitsspeicher.
1 | "alias" | Dokument | Vorhandener Dokumenten-Alias unter dem das Dokument im Arbeitsspeicher zu finden ist. |
2 | "property" | Text | Name des Felds, das gesetzt werden soll |
3 | "value" | Farbe | Wert, der im angegebenen Dokument für das angegebene Feld gesetzt werden soll |
setValue(alias,property,value:date)
Verwendbar in: Ereignisse
Rückgabewert(Aktion)
Setzt ein Datums- oder Zeitfeld eines untypisierten (z.B. durch emptyDict erzeugten) Dokuments im Arbeitsspeicher.
1 | "alias" | Dokument | Vorhandener Dokumenten-Alias unter dem das Dokument im Arbeitsspeicher zu finden ist. |
2 | "property" | Text | Name des Felds, das gesetzt werden soll |
3 | "value" | Datum | Wert, der im angegebenen Dokument für das angegebene Feld gesetzt werden soll |
setValue(alias,property,value:documentId)
Verwendbar in: Ereignisse
Rückgabewert(Aktion)
Setzt ein Eins-zu-Eins-Verknüpfungsfeld eines untypisierten (z.B. durch emptyDict erzeugten) Dokuments im Arbeitsspeicher auf die übergebene Dokumenten-ID.
1 | "alias" | Dokument | Vorhandener Dokumenten-Alias unter dem das Dokument im Arbeitsspeicher zu finden ist. |
2 | "property" | Text | Name des Felds, das gesetzt werden soll |
3 | "value" | Dokumenten-ID | Wert, der im angegebenen Dokument für das angegebene Feld gesetzt werden soll |
setValue(alias,property,value:documentIdArray)
Verwendbar in: Ereignisse
Rückgabewert(Aktion)
Setzt ein Eins-zu-Viele-Verknüpfungsfeld eines untypisierten (z.B. durch emptyDict erzeugten) Dokuments im Arbeitsspeicher auf die übergebene Dokumenten-ID.
1 | "alias" | Dokument | Vorhandener Dokumenten-Alias unter dem das Dokument im Arbeitsspeicher zu finden ist. |
2 | "property" | Text | Name des Felds, das gesetzt werden soll |
3 | "value" | Liste von Dokumenten-IDs | Wert, der im angegebenen Dokument für das angegebene Feld gesetzt werden soll |
setValue(alias,property,value:location)
Verwendbar in: Ereignisse
Rückgabewert(Aktion)
Setzt ein Ortfeld eines untypisierten (z.B. durch emptyDict erzeugten) Dokuments im Arbeitsspeicher.
1 | "alias" | Dokument | Vorhandener Dokumenten-Alias unter dem das Dokument im Arbeitsspeicher zu finden ist. |
2 | "property" | Text | Name des Felds, das gesetzt werden soll |
3 | "value" | Ort | Wert, der im angegebenen Dokument für das angegebene Feld gesetzt werden soll |
setValue(alias,property,value:num)
Verwendbar in: Ereignisse
Rückgabewert(Aktion)
Setzt ein numerisches Feld eines untypisierten (z.B. durch emptyDict erzeugten) Dokuments im Arbeitsspeicher.
1 | "alias" | Dokument | Vorhandener Dokumenten-Alias unter dem das Dokument im Arbeitsspeicher zu finden ist. |
2 | "property" | Text | Name des Felds, das gesetzt werden soll |
3 | "value" | Zahl | Wert, der im angegebenen Dokument für das angegebene Feld gesetzt werden soll |
setValue(alias,property,value:str)
Verwendbar in: Ereignisse
Rückgabewert(Aktion)
Setzt ein Textfeld eines untypisierten (z.B. durch emptyDict erzeugten) Dokuments im Arbeitsspeicher.
1 | "alias" | Dokument | Vorhandener Dokumenten-Alias unter dem das Dokument im Arbeitsspeicher zu finden ist. |
2 | "property" | Text | Name des Felds, das gesetzt werden soll |
3 | "value" | Text | Wert, der im angegebenen Dokument für das angegebene Feld gesetzt werden soll |
setValue(alias,property,value:strArray)
Verwendbar in: Ereignisse
Rückgabewert(Aktion)
Setzt ein Textlistenfeld eines untypisierten (z.B. durch emptyDict erzeugten) Dokuments im Arbeitsspeicher.
1 | "alias" | Dokument | Vorhandener Dokumenten-Alias unter dem das Dokument im Arbeitsspeicher zu finden ist. |
2 | "property" | Text | Name des Felds, das gesetzt werden soll |
3 | "value" | Liste von Texten | Wert, der im angegebenen Dokument für das angegebene Feld gesetzt werden soll |
setVariable(name,value:bool)
Verwendbar in: Ereignisse
Rückgabewert(Aktion)
Setzt oder erzeugt eine boolesche ( = Schalter-) Variable. (Die Variable muss dafür zuvor nicht deklariert worden sein.)
1 | "name" | Variablen-Alias | Variablenname |
2 | "value" | Schalter | Zu setzender Variablenwert |
setVariable(name,value:color)
Verwendbar in: Ereignisse
Rückgabewert(Aktion)
Setzt oder erzeugt eine Variable für Farbwerte. (Die Variable muss dafür zuvor nicht deklariert worden sein.)
1 | "name" | Variablen-Alias | Variablenname |
2 | "value" | Farbe | Zu setzender Variablenwert |
setVariable(name,value:date)
Verwendbar in: Ereignisse
Rückgabewert(Aktion)
Setzt oder erzeugt eine Variable für Datums- oder Zeitwerte. (Die Variable muss dafür zuvor nicht deklariert worden sein.)
1 | "name" | Variablen-Alias | Variablenname |
2 | "value" | Datum | Zu setzender Variablenwert |
setVariable(name,value:documentId)
Verwendbar in: Ereignisse
Rückgabewert(Aktion)
Setzt oder erzeugt eine Variable für eine Dokumenten-ID. (Die Variable muss dafür zuvor nicht deklariert worden sein.)
1 | "name" | Variablen-Alias | Variablenname |
2 | "value" | Dokumenten-ID | Zu setzender Variablenwert |
setVariable(name,value:documentIdArray)
Verwendbar in: Ereignisse
Rückgabewert(Aktion)
Setzt oder erzeugt eine Variable für eine Liste von Dokumenten-IDs. (Die Variable muss dafür zuvor nicht deklariert worden sein.)
1 | "name" | Variablen-Alias | Variablenname |
2 | "value" | Liste von Dokumenten-IDs | Zu setzender Variablenwert |
setVariable(name,value:location)
Verwendbar in: Ereignisse
Rückgabewert(Aktion)
Setzt oder erzeugt eine Variable für Ortswerte. (Die Variable muss dafür zuvor nicht deklariert worden sein.)
1 | "name" | Variablen-Alias | Variablenname |
2 | "value" | Ort | Zu setzender Variablenwert |
setVariable(name,value:num)
Verwendbar in: Ereignisse
Rückgabewert(Aktion)
Setzt oder erzeugt eine numerische Variable. (Die Variable muss dafür zuvor nicht deklariert worden sein.)
1 | "name" | Variablen-Alias | Variablenname |
2 | "value" | Zahl | Zu setzender Variablenwert |
setVariable(name,value:numArray)
Verwendbar in: Ereignisse
Rückgabewert(Aktion)
Setzt oder erzeugt eine Variable für eine Liste von Zahlen. (Die Variable muss dafür zuvor nicht deklariert worden sein.)
1 | "name" | Variablen-Alias | Variablenname |
2 | "value" | Liste von Zahlen | Zu setzender Variablenwert |
setVariable(name,value:str)
Verwendbar in: Ereignisse
Rückgabewert(Aktion)
Setzt oder erzeugt eine Textvariable. (Die Variable muss dafür zuvor nicht deklariert worden sein.)
1 | "name" | Variablen-Alias | Variablenname |
2 | "value" | Text | Zu setzender Variablenwert |
setVariable(name,value:strArray)
Verwendbar in: Ereignisse
Rückgabewert(Aktion)
Setzt oder erzeugt eine Variable für eine Liste von Texten. (Die Variable muss dafür zuvor nicht deklariert worden sein.)
1 | "name" | Variablen-Alias | Variablenname |
2 | "value" | Liste von Texten | Zu setzender Variablenwert |
showFilteredView(type,viewName:str,query,initialValue:alias)
Verwendbar in: Ereignisse
Rückgabewert(Aktion)
Zeigt die angegebene Ansicht an. Dabei kann ein zusätzlicher Filter für die anzuzeigende Ansicht definiert werden. Dieser Filter kann auch Verweise auf im Eventhandler zuvor deklarierte Variablen enthalten.
1 | "type" | Typ | Typ der Daten in der anzuzeigenden Ansicht. |
2 | "viewName" | Text | Name der anzuzeigenden Ansicht |
3 | "query" | Abfrage | Zusätzlicher Filter für die Ansicht |
4 | "initialValues" | Dokument,optional | Dokument mit Werten, die beim Erzeugen von neuen Datensätzen aus der View vorbelegt werden. Zur Erstellung des Dokuments kann die Funktion (emptyDoc(type,alias)) verwendet werden. |
showForm(view,readOnly:bool,document:alias?,initialValues:alias?)
Verwendbar in: Ereignisse
Rückgabewert(Aktion)
Zeigt das Eingabeformular für eine bestimmte Ansicht innerhalb des Projekts an. (Die Ansicht bestimmt dabei die Berechtigungen, die für das Eingabeformular gelten.)
1 | "view" | Text | Name oder Dokumenten-ID (falls bekannt) der Ansicht, deren Eingabeformular angezeigt werden soll |
2 | "readOnly" | Schalter | Wenn eingeschaltet, dann wird das Eingabeformular nur zum Lesen geöffnet, unabhängig von den Berechtigungen innerhalb der Ansicht |
3 | "document" | Dokument,optional | Dokument, für das das Eingabeformular angezeigt werden soll. Wenn nicht gesetzt, dann wird das Eingabeformular für einen neuen Datensatz angezeigt |
4 | "initialValues" | Dokument,optional | Vorhandener Dokumenten-Alias auf ein Dokument, dessen Werte als Standardwerte in das Formular übernommen werden sollen |
showLog()
Verwendbar in: Ereignisse
Rückgabewert(Aktion)
Zeigt die Protokoll-Ansicht an. Keiner
showView(viewName:str)
Verwendbar in: Ereignisse
Rückgabewert(Aktion)
Zeigt eine Ansicht des Projekts an.
1 | "viewName" | Text | Name oder Dokumenten-ID (falls bekannt) der Ansicht, die angezeigt werden soll |
showViewAndSearch(viewName:str,searchString:str,initialValue:alias)
Verwendbar in: Ereignisse
Rückgabewert(Aktion)
Zeigt die angegebene Ansicht an. Dabei kann ein Suchbegriff definiert werden, der initial in die Suche der anzuzeigenden Ansicht eingetragen wird.
1 | "viewName" | Text | Name der anzuzeigenden Ansicht |
2 | "searchString" | Text | Suchbegriff, der initial in die Suche der Ansicht eingetragen wird |
3 | "initialValues" | Dokument,optional | Dokument mit Werten, die beim Erzeugen von neuen Datensätzen aus der View vorbelegt werden. Zur Erstellung des Dokuments kann die Funktion (emptyDoc(type,alias)) verwendet werden. |
suppressNotification()
Verwendbar in: Ereignisse
Rückgabewert(Aktion)
Kann innerhalb eines location-Events verwendet werden, um die standardmässige Benachrichtigung zu deaktivieren. Es kann dann z.B. mit notify() eine eigene Benachrichtigung erzeugt werden. Keiner
while(condition:bool,action,action,...)
Verwendbar in: Ereignisse
Rückgabewert(Aktion)
Wiederholt die enthaltenen Aktionen so lange die Bedingung erfüllt ist. Nach maximal 1000 Iterationen bricht die Schleife von selbst ab.
1 | "condition" | Schalter | Bedingung, die erfüllt sein muss, damit die Aktionen ausgeführt werden |
2 | "actions" | Aktion,1-*,optional | Aktionen, die so lange wiederholt werden, bis die Bedingung nicht mehr erfüllt ist |