ElencoIDDatiPersistenti

Restituisce un elenco di ID di istanza per le voci con il nome specificato nell'archivio dati persistente.

Formato 

ElencoIDDatiPersistenti ( nome )

Parametri 

nome - un'espressione di testo che specifica il nome di una voce da cercare.

Tipo di dati riportato 

Testo

Creata nella versione 

26.0

Descrizione 

L'elenco delimitato da ritorni a capo degli ID di istanza restituiti da questa funzione è utile per scoprire quali istanze esistono per un determinato nome. Vedere Informazioni sull'archivio dati persistente per ulteriori informazioni.

Se non esistono voci con il nome specificato, questa funzione restituisce un valore vuoto.

Note 

  • Gli ID di istanza vengono restituiti nell'ordine in cui sono state create le voci.

  • Se una voce corrispondente era stata memorizzata con un ID di istanza vuoto, nell'elenco viene incluso un valore vuoto.

  • Utilizzare con la funzione GetDatiPersistenti per recuperare i valori per ogni istanza.

Esempio 1 

ElencoIDDatiPersistenti ( "com.example.addon.script" ) elenca tutti gli ID di istanza per le voci che hanno questo nome. Ad esempio:

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

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

Sono restituiti quattro ID di istanza, ma la terza riga è vuota perché quella voce ha un ID di istanza vuoto.

Esempio 2 

Per un determinato nome di voce, restituisce un array JSON contenente un oggetto per ogni ID di istanza. Ogni oggetto include il nome, l'ID di istanza e il valore delle voci corrispondenti.

Copia 
Imposta variabile [ $nomeVoce ; Valore: "com.claris.myaddon.theme" ]
Imposta variabile [ $arrayVoci ; Valore: "[]" ]
Imposta variabile [ $i ; Valore: 1 ]

Imposta variabile [ $elencoIDistanza ; Valore: ElencoIDDatiPersistenti ( $nomeVoce ) ]

Imposta variabile [ $totaleIstanze ; Valore: ConteggioValore ( $elencoIDistanza ) ]

Loop [ Scarica: Sempre ]
  Exit Loop If [ $i > $totaleIstanze ]
  
  Imposta variabile [ $IDIstanzaCorrente ; Valore: RicavaValore ( $ElencoIDistanza ; $i ) ]
  Imposta variabile [ $valoreVoce ; Valore: GetDatiPersistenti ( $nomeVoce ; $IDIstanzaCorrente ) ]
  
  Imposta variabile [ $oggettoVoce ; Valore: "{}" ]
  Imposta variabile [ $oggettoVoce ; Valore: JSONSetElement ( $oggettoVoce ; "nome" ; $nomeVoce ; JSONString ) ]
  Imposta variabile [ $oggettoVoce ; Valore: JSONSetElement ( $oggettoVoce ; "IDistanza" ; $IDIstanzaCorrente ; JSONString ) ]
  Imposta variabile [ $oggettoVoce ; Valore: JSONSetElement ( $oggettoVoce ; "valore" ; $valoreVoce ; JSONString ) ]
  
  Imposta variabile [ $arrayVoci ; Valore: JSONSetElement ( $arrayVoci ; "[+]" ; $oggettoVoce ; JSONObject ) ]
  
  Imposta variabile [ $i ; Valore: $i + 1 ]
End Loop

Mostra finestra personalizz. [ JSONFormatElements ( $arrayVoci ) ]

Esempio dell'array risultante:

Copia 
[
  {
    "IDistanza" : "38EA3124-9CFD-4490-A634-A0A72A613145",
    "nome" : "com.claris.myaddon.theme",
    "valore" : "Scuro"
  },
  {
    "IDistanza" : "E53DE16C-282E-44B0-BDB8-D59B15419D1B",
    "nome" : "com.claris.myaddon.theme",
    "valore" : "Scuro"
  },
  {
    "IDistanza" : "",
    "nome" : "com.claris.myaddon.theme",
    "valore" : "Chiaro"
  },
  {
    "IDistanza" : "B2F4C8D1-5A3E-4F9B-8C7D-1E6A9B4D2F5C",
    "nome" : "com.claris.myaddon.theme",
    "valore" : "Scuro"
  }
]

Argomenti correlati