Record

Ein Record-Objekt stellt einen Datensatz einer App dar und hat folgende Attribute:

idString oder None

Der eindeutige Datensatz-Identifizierer. Wurde das Datensatz-Objekt neu angelegt (durch Aufruf des App-Objektes) so ist id noch None und wird erst beim Abspeichern (mittels save()) gesetzt.

appApp

Die App zu der dieser Datensatz gehört.

createdatDatum

Der Zeitpunkt zu dem dieser Datensatz angelegt wurde.

createdbyUser

Der Benutzer der diesen Datensatz angelegt hat.

updatedatDatum oder None

Der Zeitpunkt zu dem dieser Datensatz zuletzt geändert wurde. Wurde der Datensatz noch nie geändert, so ist updatedat None.

updatedbyUser oder None

Der Benutzer, der den Datensatz zuletzt geändert hat. Wurde der Datensatz noch nie geändert, so ist updatedby None.

fieldsDictionary(String ➝ Field)

fields beinhaltet die Feld-Werte des Datensatzes. Einträge in fields haben dieselbe Reihenfolge, wie die Einträge im controls-Attribut eines App-Objekts. Die Schlüssel sind wieder die Feld-Identifizierer und die Werte sind Field-Objekte.

f_<identifier>Field

Die Field-Objekte stehen auch über sogenannte „Shortcut“-Attribute zur Verfügung. record.fields.vorname steht auch z.B. direkt als record.f_vorname zur Verfügung.

valuesDictionary(String ➝ Objekt)

values beinhaltet statt Field-Objekten direkt die Werte der Felder. Für alle Felder x gilt:

record.fields.x.value is record.values.x

v_<identifier>Objekt

Auch Feld-Werte stehen über „Shortcut“-Attribute zur Verfügung. record.values.vorname also z.B. als record.v_vorname.

attachmentsDictionary(String ➝ Attachment)

Die Anhänge zu diesem Datensatz. Die Dictionary-Schlüssel sind die Datenbank-Identifizierer des Anhangs, die Werte sind Attachment-Objekte.

childrenDictionary(String ➝ Dictionary(String ➝ Record))

Die diesem Datensatz zugeordneten Datensätze. Der Dictionary-Schlüssel auf oberster Ebene ist dabei der Identifizierer, der dieser Zuordnung in der Konfiguration gegeben wurde. Das Dictionary auf zweiter Ebene beinhaltet die zugeordneten Datensätze. Die Schlüssel sind die Datensatz-Identifizierer und die Werte sind Record-Objekte. Als Sortierung wird die in der Konfiguration festgelegte Sortierung verwendet.

c_<identifier>Dictionary(String ➝ Record)

Auch für zugeordnete Datensätze gibt es Shortcut-Attribute. record.children.beispiel, steht auch direkt als record.c_beispiel zur Verfügung.

errorsListe(String)

Fehlermeldungen die den gesamten Datensatz betreffen als Liste von Strings. Diese werden im Augenblick nicht von System gesetzt, können aber vom Benutzer beliebig geändert werden.

add_error(error)Methode(String) ➝ None

Fügt die übergebene Fehlermeldung zur Liste der Fehlermeldungen (errors) hinzu. Diese Methode erwartet die Fehlermeldung als Argument. Das heißt, der Aufruf sieht beispielsweise so aus: record.add_error("Die Bearbeitungszeit ist abgelaufen!").

has_errors()Methode() ➝ Bool

Gibt zurück, ob dieser Datensatz oder eines seiner Felder eine Fehlermeldung hat. Diese Methode erwartet keine Argumente. Das heißt, der Aufruf sieht beispielsweise so aus: record.has_errors().

clear_errors()Methode() ➝ None

Leert die Fehlermeldungs-Liste zu diesem Datensatz aber nicht die der Felder. Diese Methode erwartet keine Argumente. Das heißt der Aufruf sieht beispielsweise so aus: record.clear_errors().

clear_all_errors()Methode() ➝ None

Leert die Fehlermeldungs-Listen zu diesem Datensatz und zu den dazugehörigen Feldern. Diese Methode erwartet keine Argumente. Das heißt der Aufruf sieht beispielsweise so aus: record.clear_all_errors().

is_dirty()Methode() ➝ Bool

Gibt an, ob Feld-Werte geändert wurden. Ist der Datensatz noch gar nicht gespeichert, gibt is_dirty() immer True zurück.

update(**values)Methode(**Objekt) ➝ None

Mithilfe von update() kann der Datensatz verändert werden. Die Parameter müssen per Schlüsselwort übergeben werden. Der Parametername ist dabei jeweils der Feld-Identifizierer des zu setzenden Feldes.

D.h. ein Aufruf sieht z.B. so aus:

record.update(vorname="Max", nachname="Mustermann")

delete()Methode() ➝ None

Mithilfe von delete kann der Datensatz gelöscht werden. Diese Methode benötigt keine Parameter.

save(force, sync)Methode(Bool, Bool) ➝ Bool

Mit der Methode save kann ein Datensatzobjekt abgespeichert werden. Ist dieses Datensatzobjekt neu angelegt (d.h. id ist None) wird beim Aufruf von save() ein neuer Datensatz angelegt und beim Datensatzobjekt der eindeutige Datensatz-Identifizierer (id) vergeben, sowie die Attribute createdby auf globals.user (eingeloggter Benutzer) und createdat auf das aktuelle Datum gesetzt. Ist das Datensatzobjekt nicht neu, werden beim Aufruf von save() nur die geänderten Felder gespeichert, sowie das Attribut updatedby auf globals.user und updatedat auf das aktuelle Datum gesetzt.

Ist force False, so wird der Datensatz nicht gespeichert, wenn er oder einer seiner Felder eine Fehlermeldung hat (d.h. wenn has_errors() True zurückgibt), oder wenn Felder von Typ applookup, multipleapplookup oder file auf noch nicht gespeicherte Datensätze oder Dateien verweisen. Statt dessen wird ein Ausnahme-Fehler erzeugt, der die Ausführung des Anzeige-Templates abbricht. Dieser Ausnahme-Fehler kann dann unter Konfiguration ‣ Erweitert ‣ Anzeige-Templates ‣ (Template) ‣ Meldungen in aktueller Version angesehen werden.

Ist force True so werden Fehlermeldungen am Datensatz oder seinen Feldern ignoriert, für noch nicht gespeicherte Datensätze oder Dateien wird stattdessen None als Wert verwendet und der Datensatz wird trotzdem gespeichert.

Wenn für sync False übergeben wird (der Default) ist das Verhalten wie oben beschrieben, wird True übergeben, so wird nach dem Speichern das Record-Objekt mit dem Datenbank-Inhalt aktualisiert. Das heißt insbesondere, daß Änderungen die durch Datenaktionen an dem Datensatz durchgeführt wurden, im Record-Objekt auftauchen.

Der Rückgabewert von save() gibt an, ob der Datensatz tatsächlich in der Datenbank gespeichert wurde, oder ob dabei ein Fehler aufgetreten ist. Die entsprechende Fehlermeldung wird dabei an den Datensatz gehängt.

Bemerkung

Für noch nicht gespeicherte Datensätze oder Dateien wird beim Speichern mit force=True zusätzlich eine Fehlermeldung an das Feld-Objekt gehängt (dies kann erst zum Speicherzeitpunkt gemacht werden, nicht zum Zeitpunkt der Zuweisung des Feld-Wertes, da es ja möglich ist, daß ein referenziertes Objekt erst gespeichert wird, nachdem es dem Feld zugewiesen wurde).

Noch nicht gespeicherte Dateien können dabei bei der Verwendung innerhalb von Anzeige-Templates nicht auftreten, jedoch bei der Verwendung über das Python-SDK.

executeaction(identifier)Methode(String) ➝ None

Mithilfe von executeaction kann eine Daten-Aktion auf dem Datensatz ausgeführt werden. Diese Daten-Aktionen können unter Konfiguration ‣ Erweitert in der Aktionen-Maske definiert werden. Als Parameter muß der Identifizierer der Daten-Aktion übergeben werden.

Gibt es z.B. eine Datenaktion mit dem Identifizierer freigeben, so kann für den Datensatz record diese Datenaktion folgendermaßen aufgerufen werden:

<?code record.executeaction("freigeben")?>

edit_embedded_url(**params)Methode(**Objekt) ➝ String

Gibt die absolute URL zurück für das Eingabe-Formular zum Bearbeiten dieses Datensatzes. Bei dieser URL ist das Formular in den üblichen LivingApps-Rahmen eingebettet und der Benutzer muß eingeloggt sein um es benutzen zu können.

Mittels params können der URL zusätzliche Parameter übergeben werden. Als Werte werden sowohl Strings unterstützt als auch Listen von Strings (in diesem Fall wird der Parameter mehrmals an die URL angefügt). Außerdem wird beim Wert None der Parameter ignoriert.

Beispiel 1:

<?print record.edit_embedded_url()?>

erzeugt:

https://my.living-apps.de/dateneingabe/1234567890abcdef12345678/10293848576afbecd12345678/edit

Beispiel 2:

<?print record.edit_embedded_url(view="abcdef12345678901234")?>

erzeugt:

https://my.living-apps.de/dateneingabe/1234567890abcdef12345678/10293848576afbecd12345678/edit?view=abcdef12345678901234

Beispiel 3:

<?print record.edit_embedded_url(a=["17", 23], b=None, c=[today(), None])?>

erzeugt:

https://my.living-apps.de/dateneingabe/1234567890abcdef12345678/10293848576afbecd12345678/edit?a=17&a=23&c=2022-11-10

edit_standalone_url(**params)Methode(**Objekt) ➝ String

Gibt die absolute URL zurück für das Eingabe-Formular zum Bearbeiten dieses Datensatzes. Bei dieser URL ist das Formular nicht in den üblichen LivingApps-Rahmen eingebettet sondern unabhängig und kann auch von nicht eingeloggten Benutzern ausgefüllt werden.

Mittels params können der URL zusätzliche Parameter übergeben werden.

Beispiel 1:

<?print record.edit_standalone_url()?>

erzeugt:

https://my.living-apps.de/gateway/apps/1234567890abcdef12345678/10293848576afbecd12345678/edit

Beispiel 2:

<?print record.edit_standalone_url(view="abcdef12345678901234")?>

erzeugt:

https://my.living-apps.de/gateway/apps/1234567890abcdef12345678/10293848576afbecd12345678/edit?view=abcdef12345678901234

Beispiel 3:

<?print record.edit_standalone_url(a=["17", 23], b=None, c=[today(), None])?>

erzeugt:

https://my.living-apps.de/gateway/apps/1234567890abcdef12345678/10293848576afbecd12345678/edit?a=17&a=23&c=2022-11-10

template_url(identifier, /, **params)Methode(String, **Objekt) ➝ String

Gibt die absolute URL zurück für ein Detail-Anzeige-Template mit dem Identifizierer identifier. Die verlinkte App ist dabei die App zu der Datensatz gehört).

Mittels params können der URL zusätzliche Parameter übergeben werden.

Beispiel 1:

<?print record.template_url("beispiel")?>

erzeugt:

https://my.living-apps.de/gateway/apps/1234567890abcdef12345678/10293848576afbecd12345678?template=beispiel

Beispiel 2:

<?print record.template_url("beispiel", x=17, y=23)?>

erzeugt:

https://my.living-apps.de/gateway/apps/1234567890abcdef12345678/10293848576afbecd12345678?template=beispiel&x=17&y=23

customObjekt

Dieses Attribut kann vom Benutzer für beliebige zusätzliche Informationen gesetzt werden.

x_<identifier>Objekt

Es werden beliebige zusätzliche Attribute unterstützt deren Namen mit x_ beginnt.