ListePersistenteDatenIDs

Gibt eine Liste der Instanz-IDs für die Einträge mit dem angegebenen Namen im persistenten Datenspeicher zurück.

Format 

ListePersistenteDatenIDs ( Name )

Parameter 

Name - ein Textausdruck, der den Namen eines Eintrags angibt, nach dem gesucht werden soll.

Zurückgegebener Datentyp 

Text

Ursprung in Version 

26.0

Beschreibung 

Die durch Absatzende-Zeichen begrenzte Liste der Instanz-IDs, die von dieser Funktion zurückgegeben wird, ist nützlich, um herauszufinden, welche Instanzen für einen bestimmten Namen existieren. Weitere Informationen finden Sie unter Über den persistenten Datenspeicher.

Wenn keine Einträge mit dem angegebenen Namen existieren, gibt diese Funktion einen leeren Wert zurück.

Hinweise 

  • Instanz-IDs werden in der Reihenfolge zurückgegeben, in der die Einträge erstellt wurden.

  • Wenn ein übereinstimmender Eintrag mit einer leeren Instanz-ID gespeichert wurde, wird ein leerer Wert in die Liste aufgenommen.

  • Verwenden Sie die Funktion „HolePersistenteDaten“, um Werte für jede Instanz abzurufen.

Beispiel 1 

ListePersistenteDatenIDs ( "com.beispiel.addon.script" ) listet alle Instanz-IDs für Einträge auf, die diesen Namen aufweisen. Beispiel:

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

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

Es werden vier Instanz-IDs zurückgegeben, aber die dritte Zeile ist leer, weil dieser Eintrag eine leere Instanz-ID hat.

Beispiel 2 

Gibt für einen gegebenen Eintragsnamen ein JSON-Array zurück, das ein Objekt für jede Instanz-ID enthält. Jedes Objekt enthält den Namen, die Instanz-ID und den Wert der passenden Einträge.

Kopieren 
Variable setzen [ $eintragName ; Wert: "com.claris.meinaddon.design" ]
Variable setzen [ $eintragArray ; Wert: "[]" ]
Variable setzen [ $i ; Wert: 1 ]

Variable setzen [ $instanzIDListe ; Wert: ListePersistenteDatenIDs ( $eintragName ) ]

Variable setzen [ $gesamtzahlInstanzen ; Wert: WertAnzahl ( $instanzIDListe ) ]

Schleife (Anfang) [ Sichern: Immer ]
  Verlasse Schleife wenn [ $i > $gesamtzahlInstanzen ]
  
  Variable setzen [ $aktuelleInstanzID ; Wert: HoleWert ( $instanzIDListe ; $i ) ]
  Variable setzen [ $eintragWert ; Wert: HolePersistenteDaten ( $eintragName ; $aktuelleInstanzID ) ]
  
  Variable setzen [ $eintragObjekt ; Wert: "{}" ]
  Variable setzen [ $eintragObjekt ; Wert: JSONSetElement ( $eintragObjekt ; "name" ; $eintragName ; JSONString ) ]
  Variable setzen [ $eintragObjekt ; Wert: JSONSetElement ( $eintragObjekt ; "instanzID" ; $aktuelleInstanzID ; JSONString ) ]
  Variable setzen [ $eintragObjekt ; Wert: JSONSetElement ( $eintragObjekt ; "Wert" ; $eintragWert ; JSONString ) ]
  
  Variable setzen [ $eintragArray ; Wert: JSONSetElement ( $eintragArray ; "[+]" ; $eintragObjekt ; JSONObject ) ]
  
  Variable setzen [ $i ; Wert: $i + 1 ]
Schleife (Ende)

Eigenes Dialogfeld anzeigen [ JSONFormatElements ( $eintragArray ) ]

Beispiel für das resultierende Array:

Kopieren 
[
  {
    "instanzID" : "38EA3124-9CFD-4490-A634-A0A72A613145",
    "name" : "com.claris.meinaddon.design",
    "wert" : "Dunkel"
  },
  {
    "instanzID" : "E53DE16C-282E-44B0-BDB8-D59B15419D1B",
    "name" : "com.claris.meinaddon.design",
    "wert" : "Dunkel"
  },
  {
    "instanzID" : "",
    "name" : "com.claris.meinaddon.design",
    "wert" : "Hell"
  },
  {
    "instanzID" : "B2F4C8D1-5A3E-4F9B-8C7D-1E6A9B4D2F5C",
    "name" : "com.claris.meinaddon.design",
    "wert" : "Dunkel"
  }
]

Weiterführende Themen