entity.reload( )

Home

4D v18

entity.reload( )

Description

The entity.reload( ) method reloads the content of the entity in memory, according to information stored in the table related to the dataclass in the datastore. The reload is done only if the entity still exists with the same primary key.

Result

The object returned by entity.reload( ) contains the following properties:

Property	Type	Description
success	boolean	True if the reload action is successful, False otherwise.
		*Available only in case of error:*
status(*)	number	Error code, see below
statusText(*)	text	Description of the error, see below

(*) The following values can be returned in the status and statusText properties of Result object in case of error:

Constant

Value

Comment

dk status entity does not exist anymore

The entity no longer exists in the data. This error can occur in the following cases:

the entity has been dropped (the stamp has changed and the memory space is now free)
the entity has been dropped and replaced by another one with another primary key (the stamp has changed and a new entity now uses the memory space). When using entity.drop( ), this error can be returned when dk force drop if stamp changed option is used. When using entity.lock( ), this error can be returned when dk reload if stamp changed option is used

Associated statusText: "Entity does not exist anymore"

dk status serious error

A serious error is a low-level database error (e.g. duplicated key), a hardware error, etc.
Associated statusText: "Other error"

Example

 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("The entity has been dropped")

 End case