entity.unlock( )

4D v18

entity.unlock( )

Descrição

O método entity.unlock( ) remove o trancamento pessimista(*) na compatibilidade de registro da entidade no datastore e tabela relacionada à sua classe de dados.

(*)Para saber mais, veja Trancar Entidades.

Um registro é automaticamente destrancado quando não for mais referenciado por outras entidades no processo de trancamento (por exemplo: se o trancamento for apenas em uma referência local da entidade, a entidade e assim o registro é destrancado quando o processo terminar).

Nota: Quando um registro for trancado, deve ser destrancado do processo de trancamento e na referência de entidade que pôs a fechadura. Por exemplo:

 $e1:=dataClass.all()[0]

 $e2:=dataClass.all()[0]

 $e1.lock() // o destrancamento deve ser feito em $e1. O destrancamento em $e2 vai fracassar.

Resultado

O objeto retornado por entity.unlock( ) contém a propriedade abaixo:

Propriedade		Tipo	Descrição
success		boolean	true se a ação de destrancar for sucesso, falso senão. Se o destrancamento for feito em uma entidade dropped, em um registro não trancado, ou em um registro trancado por outro processo ou outra entidade, sucess é falso.

Exemplo

 C_OBJECT($employee;$status)

 

 $employee:=ds.Employee.get(725)

 $status:=$employee.lock()

 ... //processando

 $status:=$employee.unlock()

 If($status.success)

    ALERT("The entity is now unlocked")

 End if

Ver também

entity.lock( )