dataStore.encryptionStatus( )

4D v18

Description

La commande dataStore.encryptionStatus( ) retourne un objet qui fournit le statut de chiffrement du fichier de données courant (i.e., le fichier de données du datastore ds). Le statut de chiffrement pour chaque table est également fourni.

Note : Utilisez la commande Data file encryption status pour déterminer le statut du chiffrement de n'importe quel autre fichier de données.

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 fournie(*).
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 être fournie :

via la commande dataStore.provideDataKey( ),
sur un appareil connecté avant l'ouverture du datastore,
via la commande Discover data key.

Exemple

Vous souhaitez connaitre le nombre de tables chiffrées dans le fichier de données courant :

 C_OBJECT($status)

 

 $status:=dataStore.encryptionStatus()

 

 If($status.isEncrypted) //la base est chiffrée

    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)+" table(s) chiffrée(s) dans ce datastore.")

 Else 

    ALERT("Cette base n'est pas chiffrée.")

 End if

Voir aussi

Data file encryption status