dataStore.encryptionStatus( )

4D v18.4


dataStore.encryptionStatus () -> Resultado

Parâmetro	Tipo	Descrição
Resultado	Objeto	Informação sobre a criptografia da datastore atual e de cada tabela

Descrição

O comando dataStore.encryptionStatus( ) devolve um objeto que entrega o estado de cifrado para o arquivo de dados atual (ou seja, o arquivo de dados de armazem de dados ds). Também se proporciona o estado de cada tabela.

Nota:

utilize o comando Data file encryption status para determinar o estado de cifrado de qualquer outro arquivo de dados.
O método dataStore.encryptionStatus( ) não pode ser chamado a partir de uma datastore remota criptografada.

Valor devolvido

O objeto devolvido contém as propriedades abaixo:

Propriedade			Tipo	Descrição
isEncrypted			Booleano	True se o arquivo de dados está cifrado
keyProvided			Booleano	True se for proporcionada a chave de cifrado que coincide com o arquivo de datos cifrado(*).
tables			Objeto	Objeto que contém tantas propriedades como tabelas criptografáveis ou encriptadas.
	<table name>		Objeto	Tabla Criptografável ou Encriptada
		name	Texto	Nome da tabela
		num	Número	Número de tabela
		isEncryptable	Booleano	True se a tabela se declara criptografável no arquivo de estrutura
		isEncrypted	Booleano	True se os registros da tabela estão cifrados no arquivo de dados

(*) A chave de cifrado pode ser entregada:

com o comando dataStore.provideDataKey( ),
em um dispositivo conectado antes de abrir o armazem de dados,
com o comando Discover data key.

Exemplo

Se quiser saber o número de tabelas cifradas no arquivo de dados atual:

 C_OBJECT($status)

 

 $status:=dataStore.encryptionStatus()

 

 If($status.isEncrypted) //o banco está encriptado

    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 também

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