entity.unlock( )

4D v19

entity.unlock( )

Description

La méthode entity.unlock( ) supprime le verrou pessimiste(*) posé sur l'enregistrement correspondant à l'entité.

(*)Pour plus d'informations, veuillez vous reporter à la page Verrouillage d'entités.

Un enregistrement est automatiquement déverrouillé lorsqu'il n'est plus référencé par aucune entité dans le process qui l'a verrouillé (par exemple : si le verrou est posé sur uniquement sur une référence locale d'une entité, l'entité et donc l'enregistrement sont déverrouillés lorsque le process se termine).

Note : Lorsqu'un enregistrement est verrouillé, il doit être déverrouillé depuis le process qui l'a verrouillé et via la référence d'entité sur laquelle le verrou a été posé. Par exemple :

 $e1:=ds.Emp.all()[0]

 $e2:=ds.Emp.all()[0]

 $res:=$e1.lock() //$res.success=vrai

 $res:=$e2.unlock() //$res.success=faux

 $res:=$e1.unlock() //$res.success=vrai

Résultat

L'objet retourné par entity.unlock( ) contient la propriété suivante :

Propriété	Type	Description
success	booléen	Vrai si l'action unlock a été exécutée avec succès, Faux sinon. Si le déverrouillage est effectué sur une entité qui a été supprimée, sur un enregistrement non verrouillé ou sur un enregistrement verrouillé par un autre process ou une autre entité, success vaut Faux.

Exemple

 C_OBJET($employee;$status)

 

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

 $status:=$employee.lock()

 ... //traitement

 $status:=$employee.unlock()

 Si($status.success)

    ALERTE("L'entité est déverrouillée.")

 Fin de si

Voir aussi

entity.lock( )