ListPersistentDataIDs

Returnerar en lista med instans-ID:n för posterna med det angivna namnet i beständig datalagring.

Format 

ListPersistentDataIDs ( namn )

Parametrar 

namn – ett textuttryck som anger namnet på en post som du vill söka efter.

Returnerad datatyp 

text

Ursprungsversion 

26.0

Beskrivning 

Den med returtecken avgränsade listan med instans-ID:n som returneras av den här funktionen kan användas för att identifiera vilka instanser som finns för ett givet namn. Mer information finns i Om beständig datalagring.

Om det inte finns några poster med det angivna namnet returnerar den här funktionen ett tomt värde.

Kommentarer 

  • Instans-ID returneras i den ordning posterna skapades.

  • Om en matchande post lagrades med ett tomt instans-ID inkluderas ett tomt värde i listan.

  • Använd med Funktionen GetPersistentData för att hämta värden för varje instans.

Exempel 1 

ListPersistentDataIDs ( "com.exempel.tillagg.script" ) listar alla instans-ID:n för poster som har det här namnet. Till exempel:

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

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

Fyra instans-ID:n returneras, men den tredje raden är tom eftersom posten har ett tomt instans-ID.

Exempel 2 

Returnerar en JSON-matris med ett objekt för varje instans-ID för ett givet postnamn. Varje objekt innehåller namn, instans-ID och värde för de matchande posterna.

Kopiera 
Ange variabel [ $postnamn ; Värde: "com.claris.tillagg.tema" ]
Ange variabel [ $postmatris ; Värde: "[]" ]
Ange variabel [ $i ; Värde: 1 ]

Ange variabel [ $instansIDLista ; Värde: ListPersistentDataIDs ( $postnamn ) ]

Ange variabel [ $instanserTotalt ; Värde: antalVärden ( $instansIDLista ) ]

Loop [ Rensa: Alltid ]
  Exit Loop If [ $i > $instanserTotalt ]
  
  Ange variabel [ $aktuellInstansID ; Värde: GetValue ( $instansIDLista ; $i ) ]
  Ange variabel [ $postvärde ; Värde: GetPersistentData ( $postnamn ; $aktuellInstansID ) ]
  
  Ange variabel [ $postobjekt ; Värde: "{}" ]
  Ange variabel [ $postobjekt ; Värde: JSONSetElement ( $postobjekt ; "namn" ; $postnamn ; JSONString ) ]
  Ange variabel [ $postobjekt ; Värde: JSONSetElement ( $postobjekt ; "instansID" ; $aktuellInstansID ; JSONString ) ]
  Ange variabel [ $postobjekt ; Värde: JSONSetElement ( $postobjekt ; "värde" ; $postvärde ; JSONString ) ]
  
  Ange variabel [ $postmatris ; Värde: JSONSetElement ( $postmatris ; "[+]" ; $postobjekt ; JSONObject ) ]
  
  Ange variabel [ $i ; Värde: $i + 1 ]
End Loop

Visa anpassad dialogruta [ JSONFormatElements ( $postmatris ) ]

Exempel på den resulterande matrisen:

Kopiera 
[
  {
    "instansID" : "38EA3124-9CFD-4490-A634-A0A72A613145",
    "namn" : "com.claris.tillagg.tema",
    "värde" : "Mörkt"
  },
  {
    "instansID" : "E53DE16C-282E-44B0-BDB8-D59B15419D1B",
    "namn" : "com.claris.tillagg.tema",
    "värde" : "Mörkt"
  },
  {
    "instansID" : "",
    "namn" : "com.claris.tillagg.tema",
    "värde" : "Ljust"
  },
  {
    "instansID" : "B2F4C8D1-5A3E-4F9B-8C7D-1E6A9B4D2F5C",
    "namn" : "com.claris.tillagg.tema",
    "värde" : "Mörkt"
  }
]

Relaterade avsnitt