ObtenirDonnéesPersistantes

Renvoie la valeur de données persistantes spécifiée par le nom et l'ID de l'instance.

Format

ObtenirDonnéesPersistantes (nom ; IDInstance)

Paramètres

nom : une expression textuelle qui spécifie le nom de l'entrée de données persistantes.

IDInstance : une expression de texte qui identifie l'instance spécifique de l'entrée. Doit correspondre à l'ID de l'instance utilisé lors du stockage des données. Peut être une chaîne vide ("").

Résultat

Texte, nombre, date, heure, horodatage, conteneur

Provient de la version

26.0

Description

Cette fonction récupère une valeur du stock de données persistantes par nom et ID d'instance. Le type de données de la valeur renvoyée correspond au type de données qui a été stocké. Consultez la section À propos du stock de données persistantes.

Si aucune entrée n'existe avec le nom et l'ID de l'instance spécifiés, cette fonction renvoie "?".

Remarques

Utilisez la fonction ListeIDDonnéesPersistantes pour trouver tous les ID d'instance pour un nom donné.
Si vous spécifiez IDInstance comme une chaîne vide (""), cette fonction recherche une entrée avec un identifiant d'instance vide.

Exemple 1

ObtenirDonnéesPersistantes ( "AppVersion" ; "" ) renvoie 2.1.0 si AppVersion a été définie sans ID d'instance comme dans l'exemple 1 pour l'action de script Configurer les données persistantes.

Exemple 2

Renvoie l'entrée spécifiée ou un objet JSON vide comme valeur par défaut lorsque l'entrée spécifiée n'est pas trouvée.

Copier

Definir (
  config = ObtenirDonnéesPersistantes ( "com.claris.myaddon.settings" ; "38EA3124-9CFD-4490-A634-A0A72A613145" ) ;
  Si ( config = "?" ; JSONSetElement ( "" ; "" ; "" ; JSONObject ) ; config )
)

Exemple 3

Lors de la définition de l'URL pour un Web Viewer, récupère une bibliothèque JavaScript à partir du stock de données persistantes. Cette approche évite d'utiliser tout code JavaScript volumineux avec vos formules de calcul et facilite la mise à jour.