dataStore.encryptionStatus( )

4D v18.4


dataStore.encryptionStatus () -> Résultat

Paramètre	Type	Description
Résultat	Objet	Informations sur le chiffrement du datastore courant et de chaque table

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.

Notes :

Utilisez la commande Statut chiffrement donnees pour déterminer le statut du chiffrement de n'importe quel autre fichier de données.
La méthode dataStore.encryptionStatus( ) ne peut pas être appelée depuis un datastore chiffré distant

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 Rechercher cle donnees.

Exemple

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

 C_OBJET($status)

 

 $status:=dataStore.encryptionStatus()

 

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

    C_ENTIER LONG($vcount)

    C_TEXTE($tabName)

    Pour chaque($tabName;$status.tables)

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

          $vcount:=$vcount+1

       Fin de si

    Fin de chaque

    ALERTE(Chaine($vcount)+" table(s) chiffrée(s) dans ce datastore.")

 Sinon 

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

 Fin de si

Voir aussi

4D Blog - New 4D commands to work with encrypted data
Statut chiffrement donnees