Data file encryption status
Data file encryption status ( cheminStructure , cheminDonnées ) : Object
| Paramètre | Type | Description | |
|---|---|---|---|
| cheminStructure | Text | → | Chemin d'accès du fichier de structure à vérifier |
| cheminDonnées | Text | → | Chemin d'accès du fichier de données 4D à vérifier |
| Résultat | Object | ← | Informations sur le chiffrement du fichier de données et de chaque table |
Description
La commande Data file encryption status retourne un objet qui fournit le statut de chiffrement du fichier de données indiqué par les paramètres cheminStructure et cheminDonnées. Le statut de chiffrement de chaque table est également fourni.
Le paramètre cheminDonnées indique un fichier de données 4D (.4dd) qui doit correspondre au fichier de structure défini par le paramètre cheminStructure. Vous pouvez indiquer le fichier de structure courant mais le fichier de données doit être différent du fichier courant (ouvert).
Note : Utilisez la méthode ds.encryptionStatus( ) pour déterminer le statut de chiffrement du fichier de données courant.
Valeur retournée
L'objet retourné contient les propriétés suivantes :
| Propriété | Type | Description |
|---|---|---|
| isEncrypted | Booléen | Vrai si le fichier de données est chiffré |
| keyProvided | Booléen | Vrai si la clé de chiffrement correspondant au fichier de données chiffré est dans le trousseau 4D(*). |
| tables | Objet | Objet contenant autant de propriétés que de tables chiffrables ou chiffrées. |
| <table name> | Objet | Table chiffrable ou chiffrée |
| name | Texte | Nom de la table |
| num | Numérique | Numéro de la table |
| isEncryptable | Booléen | Vrai si la table est dite chiffrable dans le fichier de structure |
| isEncrypted | Booléen | Vrai si les enregistrements de la table sont chiffrés dans le fichier de données |
(*) La clé de chiffrement peut avoir déjà été fournie :
- précédemment :
- avant l'ouverture de ce fichier de données, sur un appareil connecté,
- via la commande ds.provideDataKey( ) à l'ouverture de ce fichier de données,
- après l'ouverture du fichier de données, via la commande Discover data key
- via la commande Register data key
Exemple
Vous souhaitez connaitre le statut de chiffrement d'un fichier de données correspondant au fichier de structure courant :
var $status : Object
$status:=Data file encryption status(Structure file;"D:\\Invoices\\Data_2019\\Invoices.4dd")
Case of
:(Not($status.isEncrypted))
ALERT("Le fichier de données n'est pas chiffré")
:($status.isEncrypted&(Not($status.keyProvided))
ALERT("Le fichier de données est chiffré et la clé de chiffrement n'est pas dans le trousseau. Vous n'aurez pas accès aux données chiffrées.")
:($status.isEncrypted&$status.keyProvided)
ALERT("Le fichier de données est chiffré et la clé de chiffrement est dans le trousseau. Vous aurez accès aux données chiffrées.")
End case