Data file encryption status
Data file encryption status ( rotaEstrutura , rotaDados ) : Object
| Parâmetro | Tipo | Descrição | |
|---|---|---|---|
| rotaEstrutura | Text | → | Rota do arquivo de estrutura 4D a ser verificado |
| rotaDados | Text | → | Rota do arquivo de dados 4D a ser verificado |
| Resultado | Object | ← | Informação sobre o estado de criptografia do arquivo de dados e de cada tabela |
Descrição
O comando Data file encryption status devolve um objeto que fornece o estado de cifrado para o arquivo de dados designado pelos parâmetros rotaEstruta e rotaDados. Também se proporciona o estado de cada tabela.
rotaDados designa um arquivo de dados 4D (.4dd). Deve corresponder ao arquivo de estrutura definido pelo parâmetro rotaEstrut. Pode designar o arquivo de estrutura atual, mas o arquivo de dados não deve ser o arquivo atual (aberto).
Nota: utilize o método ds.encryptionStatus( ) para determinar o estado de cifrado do arquivo de dados atual.
Valor devolvido
O objeto devolvido contém as propriedades abaixo:
| Propriedade | Tipo | Descrição |
|---|---|---|
| isEncrypted | Booleano | True se o arquivo de dados estiver cifrado |
| keyProvided | Booleano | True se a chave de cifrado que coincidir com o arquivo de dados cifrados estiver no chaveiro 4D (*). |
| tables | Objeto | Objeto que contém tantas propriedades como tabelas criptografadas oy criptografáveis. |
| <table name> | Objeto | Tabela Encriptada ou Criptografável |
| 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 estiverem cifrados no arquivo de dados |
(*) A chave de criptografia pode ser fornecida:
- previamente:
- antes de abrir este arquivo de dados, utilizando um dispositivo conectado,
- com o comando ds.provideDataKey( ) quando se abre este arquivo de dados,
- depois de abrir o arquivo de dados, con o comando Discover data key
- utilizando o comando Register data key
Exemplo
Se quiser conhecer o estado de criptografia de um arquivo de dados que corresponda ao arquivo de estrutura atual:
var $status : Object
$status:=Data file encryption status(Structure file;"D:\\Invoices\\Data_2019\\Invoices.4dd")
Case of
:(Not($status.isEncrypted))
ALERT("O arquivo de dados não está criptografado")
:($status.isEncrypted&(Not($status.keyProvided))
ALERT("O arquivo de dados está criptografado e a chave de cifrado não está no chaveiro. Não terá acesso aos dados cifrados.")
:($status.isEncrypted&$status.keyProvided)
ALERT("O arquivo de dados está cifrado e a chave de cifrado está no chaveiro. Terá acesso aos datos cifrados.")
End case