HolePersistenteDaten

Gibt den durch Name und Instanz-ID angegebenen Wert der persistenten Daten zurück.

Format

HolePersistenteDaten ( Name ; InstanzID )

Parameter

Name – ein Textausdruck, der den Namen des persistenten Dateneintrags angibt.

InstanzID - ein Textausdruck, der die spezifische Instanz des Eintrags identifiziert. Muss mit der beim Speichern der Daten verwendeten Instanz-ID übereinstimmen. Kann ein leerer String ("") sein.

Zurückgegebener Datentyp

Text, Zahl, Datum, Zeit, Zeitstempel, Container

Ursprung in Version

26.0

Beschreibung

Diese Funktion ruft einen Wert aus dem persistenten Datenspeicher nach Name und Instanz-ID ab. Der Datentyp des zurückgegebenen Wertes stimmt mit dem gespeicherten Datentyp überein. Siehe Über den persistenten Datenspeicher.

Wenn kein Eintrag mit dem angegebenen Namen und der Instanz-ID existiert, gibt diese Funktion „?“ zurück.

Hinweise

Verwenden Sie die Funktion „ListePersistenteDatenIDs“, um alle Instanz-IDs für einen bestimmten Namen zu finden.
Wenn Sie InstanzID als leeren String ("") angeben, sucht diese Funktion nach einem Eintrag mit einer leeren Instanz-ID.

Beispiel 1

HolePersistenteDaten ( "AppVersion" ; "" ) gibt 2.1.0 zurück, wenn AppVersion ohne Instanz-ID gesetzt wurde – wie in Beispiel 1 für den Scriptschritt „Persistente Daten konfigurieren“.

Beispiel 2

Gibt den angegebenen Eintrag oder ein leeres JSON-Objekt als Standardwert zurück, wenn der angegebene Eintrag nicht gefunden wird.

Kopieren

SetzeVar (
  config = HolePersistenteDaten ( "com.claris.meinaddon.einstellungen" ; "38EA3124-9CFD-4490-A634-A0A72A613145" ) ;
  Wenn ( config = "?" ; JSONSetElement ( "" ; "" ; "" ; JSONObject ) ; config )
)

Beispiel 3

Beim Festlegen der URL für einen Web Viewer wird eine JavaScript-Bibliothek aus dem persistenten Datenspeicher abgerufen. Auf diese Weise wird großer JavaScript-Code aus Ihren Formeln herausgehalten und die Aktualisierung erleichtert.