Data file encryption status

Home

4D v20 R7


Data file encryption status ( structurePath , dataPath ) -> Funktionsergebnis

Parameter	Typ	Beschreibung
structurePath	Text	Pfadname der zu prüfenden 4D Strukturdatei
dataPath	Text	Pfadname der zu prüfenden 4D Datendatei
Funktionsergebnis	Objekt	Angaben zur Verschlüsselung der Datendatei und jeder Tabelle

Beschreibung

Der Befehl Data file encryption status enthält ein Objekt mit dem Verschlüsselungsstatus für die Datendatei, angegeben in den Parametern structurePath und dataPath. Auch der Status für jede Tabelle wird geliefert.

dataPath bezeichnet eine 4D Datendatei (.4dd). Sie muss zur Strukturdatei passen, die im Parameter structurePath definiert ist. Sie können die aktuelle Strukturdatei bestimmen, dagegen darf die Datendatei nicht die aktuelle (geöffnete) sein.

Hinweis: Zum Bestimmen des Verschlüsselungsstatus für die aktuelle Datendatei verwenden Sie die Methode ds.encryptionStatus( ).

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 im 4D Schlüsselbund geliefert wird (*)
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	Nummer	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 Schlüssel kann wie folgt geliefert werden:

im voraus:
- über ein angeschlossenes Gerät vor dem Öffnen dieser Datendatei
- mit dem Befehl ds.provideDataKey( ), wenn diese Datendatei geöffnet wurde
- nach dem Öffnen der Datendatei mit dem Befehl Discover data key
Über den Befehl Register data key

Beispiel

Den Verschlüsselungsstatus der Datendatei erfahren, die zur aktuellen Strukturdatei gehört:

 C_OBJECT($status)

 

 $status:=Data file encryption status(Structure file;"D:\\Invoices\\Data_2019\\Invoices.4dd")

 Case of

    :(Not($status.isEncrypted))

       ALERT("The data file is not encrypted")

    :($status.isEncrypted&(Not($status.keyProvided))

       ALERT("The data file is encrypted and the encryption key is not in the keychain. You will not have access to encrypted data.")

    :($status.isEncrypted&$status.keyProvided)

       ALERT("The data file is encrypted and the encryption key is in the keychain. You will have access to encrypted data.")

 End case

Siehe auch

4D Blog - New 4D commands to work with encrypted data
Encrypt data file