AppParameter

Ein AppParameter-Objekt beinhaltet Informationen über einen Parameter einer App. Es besitzt folgende Attribute:

idString

Der eindeutige Datenbank-Identifizierer der App.

appApp oder None

Die App zu der dieser Parameter gehört (oder None wenn dieser Parameter zur Template-Library gehört).

ownerApp

Die App zu der dieser Parameter gehört.

parentAppParameter oder None

Der übergeordnete Parameter vom Typ list oder dict (oder None falls dieser Parameter kein Element eines übergeordneten Parameters ist).

typeString

Der Parameter-Typ. Mögliche Werte sind:

Wert	Beschreibung
"bool"	Ein Wahrheitswert: True oder False
"int"	Eine ganze Zahl
"number"	Eine Zahl mit Nachkommastellen
"str"	Text
"html"	HTML-Text
"color"	Eine Farbe
"date"	Ein Datum
"datetime"	Datum + Uhrzeit
"datedelta"	Ein Zeitraum von Tagen
"datetimedelta"	Ein Zeitraum von Tagen, Stunden, Minuten und Sekunden
"monthdelta"	Ein Zeitraum von Monaten
"upload"	Eine hochgeladene Datei
"app"	Ein Verweis auf eine App
"control"	Ein Verweis auf ein Feld der App zu der dieser Parameter gehört
"list"	Eine Liste (bestehend aus Unterparametern)
"dict"	Eine Menge an Unterparametern mit Namen (Identifizierer)

Bei allen Typen außer "list" und "dict" kann der Wert auch None sein.

Dieses Attribut kann auch gesetzt werden. Wenn der alte Wert nicht zum neu gesetzten Typ passt, wird der Wert auf None gesetzt.

orderInteger oder None

Die Reihenfolge in der dieser Parameter als Kind eines übergeordneten Parameters aufgeführt ist, wenn der übergeordnete Parameter vom Typ list ist (oder None sonst). Dieses Attribut kann auch gesetzt werden.

identifierString oder None

Der Name des Parameters (oder None wenn dieser Parameter einen übergeordneten Parameter vom Typ list hat). Dieses Attribut kann auch gesetzt werden.

descriptionString

Die Beschreibung des Parameters. Dieses Attribut kann auch gesetzt werden.

valueObjekt

Der Wert des Objekts. Dabei hängt der Typ des Wertes vom Typ des Parameters ab. Dieser Attribut kann auch gesetzt werden. Je nach dem Typ des gesetzten Wertes ändert sich dadurch auch der Parameter-Typ.

createdatDatum

Zeitpunkt, zu dem der Parameter angelegt wurde.

createdbyUser

Benutzer, der den Parameter angelegt hat.

updatedatDatum oder None

Der Zeitpunkt, zu dem der Parameter das letzte Mal geändert wurde. (Wurde der Parameter noch nicht geändert, so ist updatedat None.)

updatedbyUser oder None

Der Benutzer, der den Parameter zuletzt geändert hat. (Wurde der Parameter noch nicht geändert, so ist updatedby None.)

append_param(type, description, value)Methode(String, String oder None, Objekt) ➝ AppParameter

Erzeugt einen neuen Parameter vom Typ type mit der Beschreibung description und dem Wert value und fügt ihn an diesen Parameter vom Typ list an. Der neu angelegte Parameter wird zurückgegeben. Diese Methode ist nur bei Parametern vom Typ list vorhanden.

add_param(type, identifier, description, value)Methode(String, String, String oder None, Objekt) ➝ AppParameter

Erzeugt einen neuen Parameter vom Typ type, mit dem Identifizierer identifier, der Beschreibung description und dem Wert value und fügt ihn an diesen Parameter vom Typ dict an. Der neu angelegte Parameter wird zurückgegeben. Diese Methode ist nur bei Parametern vom Typ dict vorhanden.

save(sync)Methode(Bool) ➝ None

Speichert einen neuen oder geänderten Parameter in der Datenbank ab.

Wenn für sync True übergeben, so wird nach dem Speichern das AppParameter-Objekt mit dem Datenbank-Inhalt aktualisiert.

delete()Methode() ➝ None

Löscht den Parameter aus der Datenbank.

stateString

Der Zustand des Parameters. Mögliche Werte sind:

Wert	Beschreibung
"new"	Das Parameter-Objekt wurde neu angelegt, ist aber noch nicht gespeichert.
"saved"	Das Parameter-Objekt wurde aus der Datenbank geladen und noch nicht verändert.
"changed"	Das Parameter-Objekt wurde verändert.
"deleted"	Der Parameter wurde bereits in der Datenbank gelöscht.

is_dirty()Methode() ➝ Bool

Git True zurück, wenn das Parameter-Objekt neu ist oder geändert wurde (d.h. wenn state "new" oder "changed" ist).

is_deleted()Methode() ➝ Bool

Git True zurück, wenn das Parameter-Objekt in der Datenbank gelöscht wude (d.h. wenn state "deleted" ist).