entity.drop( )

4D v18

entity.drop( )

Descripción

El método entity.drop( ) elimina del datastore los datos contenidos en la entidad, en la tabla relacionada con su dataClass. Tenga en cuenta que la entidad permanece en la memoria.

En una aplicación multiusuario o multiproceso, el método entity.drop( ) se ejecuta bajo un mecanismo "bloqueo optimista", mientras que un sello de bloqueo interno se incrementa automáticamente cada vez que se guarda el registro. Para más información, consulte la página Bloquear entidades.

Por defecto, si se omite el parámetro modo, el método devolverá un error (ver abajo) si la misma entidad fue modificada (es decir, el sello ha cambiado) por otro proceso o usuario mientras tanto.
De lo contrario, puede pasar la opción dk force drop if stamp changed en el parámetro modo: en este caso, la entidad se suelta incluso si el sello ha cambiado (y la llave principal sigue siendo la misma).

Resultado

El objeto devuelto por entity.drop( ) contiene las siguientes propiedades:

Propiedad		Tipo	Descripción
success		booleano	true si la acción de guardar es exitosa, de lo contrario es false.
			*Disponible solo si se utiliza la opción dk auto merge:*
autoMerged		booleano	true si se realizó una fusión automática, en caso contrario, false.
			*Disponible solo en caso de error:*
status(*)		número	Código de error, ver a continuación
statusText(*)		texto	Descripción del error, ver a continuación
			*Disponible solo en caso de error de bloqueo pesimista:*
LockKindText		texto	"Bloqueado por registro"
lockInfo		objeto	Información sobre el origen del bloqueo
	task_id	número	ID del proceso
	user_name	texto	Nombre de usuario de sesión en la máquina
	user4d_id	texto	Nombre de usuario en el directorio de la base de datos 4D
	host_name	texto	Nombre del equipo
	task_name	texto	Nombre del proceso
	client_version	texto
			Disponible solo en caso de error grave (error grave al tratar de duplicar una llave primaria, disco lleno...):
errors		colección de objetos
	message	texto	Mensaje de error
	component signature	texto	Firma del componente interno (por ejemplo, "dmbg" representa el componente de la base)
	errCode	número	Código de error

(*) Los siguientes valores pueden devolverse en las propiedades status y statusText del objeto Resultado en caso de error:

Constante	Valor	Comentario
dk status entity does not exist anymore	5	La entidad ya no existe en los datos. Este error puede ocurrir en los siguientes casos: la entidad ha sido suprimida (el stamp ha cambiado y el espacio de memoria ahora está liberado) la entidad ha sido suprimida y reemplazada por otra con una llave primaria diferente (el stamp ha cambiado y una nueva entidad ahora ocupa el espacio de memoria). Cuando se usa entity.drop( ), este error puede devolverse cuando se usa la opción dk force drop if stamp changed. Al usar entity.lock( ), este error puede devolverse cuando se usa la opción dk reload if stamp changed statusText asociado: "La entidad ya no existe"
dk status locked	3	La entidad está bloqueada por un bloqueo pesimista. statusText asociado: "Ya bloqueado" ("Already locked")
dk status serious error	4	Un error grave es un error de bajo nivel de la base de datos (por ejemplo, llave duplicada), un error de hardware, etc. statusText asociado: "Otro error" ("Other error")
dk status stamp has changed	2	El valor de stamp interno de la entidad no coincide con el de la entidad almacenada en los datos (bloqueo optimista). con entity.save( ): error solo si no se utiliza la opción dk auto merge con entity.drop( ): error solo si no se usa la opción dk force drop if stamp changed con entity.lock( ): error solo si no se usa la opción dk reload if stamp changed statusText asociado: "El stamp ha cambiado" ("Stamp has changed")

Ejemplo 1

Ejemplo sin la opción dk force drop if stamp changed:

 C_OBJECT($employees;$employee;$status)

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

 $employee:=$employees.first()

 $status:=$employee.drop()

 Case of

    :($status.success)

       ALERT("You have dropped "+$employee.firstName+" "+$employee.lastName) //La entidad soltada permanece en la memoria

    :($status.status=dk status stamp has changed)

       ALERT($status.statusText)

 End case

Ejemplo 2

Ejemplo con la opción dk force drop if stamp changed:

 C_OBJECT($employees;$employee;$status)

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

 $employee:=$employees.first()

 $status:=$employee.drop(dk force drop if stamp changed)

 Case of

    :($status.success)

       ALERT("You have dropped "+$employee.firstName+" "+$employee.lastName) //La entidad soltada permanece en memoria

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

       ALERT($status.statusText)

 End case

Ver también

entity.save( )