entity.reload( )

4D v19

entity.reload( )

Descrição

O método entity.reload( ) recarrega o conteúdo da entidade na memória, de acordo com a informação armazenada na tabela relacionada à classe de dados na datastore. O recarregamento é feito só se a entidade ainda existir com a mesma chave primária.

Resultado

O objeto retornado por entity.reload( ) contém as propriedades abaixo:

Propriedade	Tipo	Descrição
success	boolean	true se a ação reload for sucesso, senão false.
		*Disponível só em caso de erro:*
status(*)	number	Código de erro, ver abaixo
statusText(*)	text	Descrição do erro, ver abaixo

(*) Os valores a seguir podem ser retornados nas propriedades status e statusText do objeto Resultado no caso de erro:

Constante

Valor

Comentário

dk status entity does not exist anymore

A entidade não existe mais nos dados. Esse erro pode ocorrer nos casos abaixo:

a entidade foi suprimida (a stamp - carimbo - foi mudada e o espaço de memória agora está livre)
a entidade foi suprimida e substituída por outra com outra chave primária (a stamp - carimbo - foi mudada e a nova entidade agora usa o espaço de memória). Quando usar entity.drop( ), este erro pode ser retornado quando a opção dk force drop if stamp changed for usada. Quando usar entity.lock( ), este erro pode ser retornado quando a opção dk reload if stamp changed for usada

Texto de estado associado: "Entity does not exist anymore" - (a entidade não existe mais)

dk status serious error

Um erro sério é um erro de baixo nível de banco de dados (por exemplo, chave duplicada), um erro de hardware, etc
Texto associado de estado: "Other error" - outro erro

Exemplo

 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

Ver também

entitySelection[index]