dataStore.encryptionStatus( )

4D v18.4


dataStore.encryptionStatus () -> Resultado

Parámetro	Tipo	Descripción
Resultado	Objeto	Información sobre el cifrado del almacén de datos actual y de cada tabla

Descripción

El comando dataStore.encryptionStatus( ) devuelve un objeto que entrega el estado de cifrado para el archivo de datos actual (es decir, el archivo de datos del almacén de datos ds). También se proporciona el estado de cada tabla.

Notas:

Utilice el comando Data file encryption status para determinar el estado de cifrado de cualquier otro archivo de datos.
No se puede llamar al método dataStore.encryptionStatus( ) desde un almacén de datos remoto encriptado.

Valor devuelto

El objeto devuelto contiene las siguientes propiedades:

Propiedad			Tipo	Descripción
isEncrypted			Booleano	True si el archivo de datos está cifrado
keyProvided			Booleano	True si se proporciona la llave de cifrado que coincide con el archivo de datos cifrado(*).
tables			Objeto	Objeto que contiene tantas propiedades como tablas encriptables o encriptadas.
	<table name>		Objeto	Tabla Encriptable o Encriptada
		name	Texto	Nombre de la tabla
		num	Número	Número de tabla
		isEncryptable	Booleano	True si la tabla se declara encriptable en el archivo de estructura
		isEncrypted	Booleano	True si los registros de la tabla están cifrados en el archivo de datos

(*) La llave de cifrado se puede entregar:

con el comando dataStore.provideDataKey( ),
en un dispositivo conectado antes de abrir el almacén de datos,
con el comando Discover data key.

Ejemplo

Desea saber el número de tablas cifradas en el archivo de datos actual:

 C_OBJECT($status)

 

 $status:=dataStore.encryptionStatus()

 

 If($status.isEncrypted) //la base está encriptada

    C_LONGINT($vcount)

    C_TEXT($tabName)

    For each($tabName;$status.tables)

       If($status.tables[$tabName].isEncrypted)

          $vcount:=$vcount+1

       End if

    End for each

    ALERT(String($vcount)+" encrypted table(s) in this datastore.")

 Else

    ALERT("This database is not encrypted.")

 End if

Ver también

4D Blog - New 4D commands to work with encrypted data
Data file encryption status