ListeIDDonnéesPersistantes

Renvoie une liste d'ID d'instance pour les entrées avec le nom spécifié dans le stock de données persistantes.

Format 

ListeIDDonnéesPersistantes ( nom )

Paramètres 

nom : expression textuelle qui spécifie le nom d'une entrée à rechercher.

Résultat 

Texte

Provient de la version 

26.0

Description 

La liste de valeurs délimitées par un retour chariot pour les ID d'instances qui a été renvoyée par cette fonction permet de savoir quelles instances existent pour un nom donné. Consultez la section À propos du stock de données persistantes pour obtenir des informations supplémentaires.

Si aucune entrée n'existe avec le nom spécifié, cette fonction renvoie une valeur vide.

Remarques 

  • Les ID d'instance sont renvoyés dans l'ordre dans lequel les entrées ont été créées.

  • Si une entrée correspondante a été stockée avec un ID d'instance vide, une valeur vide est incluse dans la liste.

  • Utilisez la fonction ObtenirDonnéesPersistantes pour récupérer des valeurs pour chaque instance.

Exemple 1 

ListeIDDonnéesPersistantes ( "com.exemple.addon.script" ) répertorie tous les ID d'instance pour les entrées qui portent ce nom. Par exemple :

Copier 
38EA3124-9CFD-4490-A634-A0A72A613145
E53DE16C-282E-44B0-BDB8-D59B15419D1B

B2F4C8D1-5A3E-4F9B-8C7D-1E6A9B4D2F5C

Quatre ID d'instance sont renvoyés, mais la troisième ligne est vide car cette entrée a un ID d'instance vide.

Exemple 2 

Pour un nom d'entrée donné, renvoie un tableau JSON contenant un objet pour chaque ID d'instance. Chaque objet inclut le nom, l'ID de l'instance et la valeur des entrées correspondantes.

Copier 
Définir variable [ $nomEntrée ; Valeur: "com.claris.myaddon.theme" ]
Définir variable [ $tableauEntrée ; Valeur: "[]" ]
Définir variable [ $i ; Valeur: 1 ]

Définir variable [ $listIDInstance ; Valeur: ListeIDDonnéesPersistantes ( $nomEntrée ) ]

Définir variable [ $instancesTotales ; Valeur: DecompteValeurs ( $listIDInstance ) ]

Boucle [ Purge: Systématique ]
  Fin de boucle si [ $i > $instancesTotales ]
  
  Définir variable [ $IDInstanceActuelle ; Valeur: ObtenirValeur ( $listIDInstance ; $i ) ]
  Définir variable [ $valeurEntrée ; Valeur: ObtenirDonnéesPersistantes ( $nomEntrée ; $IDInstanceActuelle ) ]
  
  Définir variable [ $objetEntrée ; Valeur: "{}" ]
  Définir variable [ $objetEntrée ; Valeur: JSONSetElement ( $objetEntrée ; "nom" ; $nomEntrée ; JSONString ) ]
  Définir variable [ $objetEntrée ; Valeur: JSONSetElement ( $objetEntrée ; "IDInstance" ; $IDInstanceActuelle ; JSONString ) ]
  Définir variable [ $objetEntrée ; Valeur: JSONSetElement ( $objetEntrée ; "valeur" ; $valeurEntrée ; JSONString ) ]
  
  Définir variable [ $tableauEntrée ; Valeur: JSONSetElement ( $tableauEntrée ; "[+]" ; $objetEntrée ; JSONObject ) ]
  
  Définir variable [ $i ; Valeur: $i + 1 ]
Fin de boucle

Ouvrir boîte dial. person. [ JSONFormatElements ( $tableauEntrée ) ]

Exemple de tableau résultant :

Copier 
[
  {
    "IDInstance" : "38EA3124-9CFD-4490-A634-A0A72A613145",
    "nom" : "com.claris.myaddon.theme",
    "valeur" : "Foncé"
  },
  {
    "IDInstance" : "E53DE16C-282E-44B0-BDB8-D59B15419D1B",
    "nom" : "com.claris.myaddon.theme",
    "valeur" : "Foncé"
  },
  {
    "IDInstance" : "",
    "nom" : "com.claris.myaddon.theme",
    "valeur" : "Clair"
  },
  {
    "IDInstance" : "B2F4C8D1-5A3E-4F9B-8C7D-1E6A9B4D2F5C",
    "nom" : "com.claris.myaddon.theme",
    "valeur" : "Foncé"
  }
]

Rubriques connexes