dataStore.encryptionStatus( )

Home

4D v18.4


dataStore.encryptionStatus () -> Funktionsergebnis

Parameter	Typ	Beschreibung
Funktionsergebnis	Objekt	Angaben über die Verschlüsselung des aktuellen Datastore und jeder Tabelle

Beschreibung

Die Methode dataStore.encryptionStatus( ) gibt ein Objekt mit dem Verschlüsselungsstatus für die aktuelle Datendatei zurück (z.B. die Datendatei des ds Datastore). Auch der Status für jede Tabelle wird geliefert.

Hinweise:

Verwenden Sie den Befehl Data file encryption status zur Bestimmung des Verschlüsselungsstatus für andere Dateien.
dataStore.encryptionStatus( ) lässt sich nicht von einem verschlüsselten remote Datastore aufrufen.

Zurückgegebener Wert

Das zurückgegebene Objekt enthält folgende Eigenschaften:

Eigenschaft			Typ	Beschreibung
isEncrypted			Boolean	Wahr wenn die Datendatei verschlüsselt ist
keyProvided			Boolean	Wahr wenn der passende Schlüssel zur verschlüsselten Datendatei geliefert wurde (*).
tables			Objekt	Objekt mit so vielen Eigenschaften wie es verschlüsselbare oder verschlüsselte Tabellen gibt
	<table name>		Objekt	Verschlüsselbar oder verschlüsselte Tabelle
		name	Text	Name der Tabelle
		num	Zahl	Nummer der Tabelle
		isEncryptable	Boolean	Wahr wenn die Tabelle in der Strukturdatei verschlüsselbar deklariert ist
		isEncrypted	Boolean	Wahr wenn die Datensätze der Tabelle in der Datendatei verschlüsselt sind

(*) Der Verschlüsselungscode kann wie folgt geliefert werden:

mit dem Befehl dataStore.provideDataKey( )
über ein angeschlossenes Gerät vor dem Öffnen des Datastore
mit dem Befehl Discover data key

Beispiel

Die Anzahl der verschlüsselten Tabellen in der aktuellen Datendatei erfahren:

 C_OBJECT($status)

 

 $status:=dataStore.encryptionStatus()

 

 If($status.isEncrypted) //Anwendung ist verschlüsselt

    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

Siehe auch

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