entity.reload()

Home

4D v19.8

entity.reload()


entity.reload() () -> Funktionsergebnis

Parameter	Typ	Beschreibung
Funktionsergebnis	Objekt	Status object

Beschreibung

Die Methode entity.reload() lädt erneut den Inhalt der Entity im Speicher. Das passiert nur, wenn die Entity mit demselben Primärschlüssel noch existiert.

Ergebnis

Das von entity.reload() zurückgegebene Objekt enthält folgende Eigenschaften:

Eigenschaft	Typ	Beschreibung
success	Boolean	wahr, wenn erneutes Laden erfolgreich ist, sonst falsch
		*Nur verfügbar bei Auftreten eines Fehlers:*
status(*)	Zahl	Fehlercode, siehe unten
statusText(*)	Text	Fehlerbeschreibung, siehe unten

(*) Bei einem Fehler sind in den Eigenschaften status und statusText des Objekts Result folgende Werte möglich:

Konstante

Wert

Kommentar

dk status entity does not exist anymore

Die Entity existiert nicht mehr in den Daten. Dieser Fehler kann in folgenden Fällen auftreten:

Die Entity wurde gelöscht (der Stempel hat sich geändert und der Speicherplatz ist jetzt frei)
Die Entity wurde gelöscht und durch eine andere mit einem anderen Primärschlüssel ersetzt (der Stempel hat sich geändert und eine neue Entity verwendet jetzt den Speicherplatz). Mit entity.drop() wird dieser Fehler beim Verwenden der Option dk force drop if stamp changed zurückgegeben. Mit entity.lock() wird dieser Fehler beim Verwenden der Option dk reload if stamp changed zurückgegeben.

Zugewiesener Statustext: "Entity does not exist anymore"

dk status serious error

Ein ernsthafter Fehler ist ein low-level Fehler in der Anwendung, wie z.B. duplizierter Schlüssel, Hardware Fehler, etc.
Zugewiesener Statustext: "Other error"

Beispiel

 C_OBJECT($employee;$employees;$result)

 

 $employees:=ds.Employee.query("lastName=:1";"Hollis")

 $employee:=$employees[0]

 $employee.firstName:="Mary"

 $result:=$employee.reload()

 Case of

    :($result.success)

       ALERT("Reload has been done")

    :($result.status=dk status entity does not exist anymore)

       ALERT("Die Entity wurde gelöscht")

 End case

Siehe auch

entitySelection[index]