ListPersistentDataIDs

Geeft als resultaat een lijst met instantie-ID's voor de invoeren waarvan de naam is opgegeven in de permanente gegevensopslag.

Opmaak 

ListPersistentDataIDs ( name )

Parameters 

name - een tekstexpressie die de naam aangeeft van een invoer waarnaar moet worden gezocht.

Resulterend gegevenstype 

tekst

Afkomstig uit versie 

26.0

Beschrijving 

De lijst met door deze functie gescheiden instantie-ID's met terugloop-scheidingstekens is handig om te ontdekken welke instanties er bestaan voor een bepaalde naam. Zie Informatie over de permanente gegevensopslag voor meer informatie.

Als er geen invoeren bestaan met de opgegeven naam, retourneert deze functie een lege waarde.

Opmerkingen 

  • Instantioe-ID's worden geretourneerd in de volgorde waarin de invoeren zijn gemaakt.

  • Als een overeenkomende invoer is opgeslagen met een lege instantie-ID, wordt een lege waarde in de lijst opgenomen.

  • Gebruik met de GetPersistentData functie om waarden voor elke instantie op te halen.

Voorbeeld 1 

ListPersistentDataIDs ( "com.example.addon.script" ) toont alle instantie-ID's voor items die deze naam hebben. Bijvoorbeeld:

Kopiëren 
38EA3124-9CFD-4490-A634-A0A72A613145
E53DE16C-282E-44B0-BDB8-D59B15419D1B

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

Er worden vier instantie-ID's geretourneerd, maar de derde regel is leeg omdat die vermelding een lege instantie-ID heeft.

Voorbeeld 2 

Retourneert voor een gegeven invoernaam een JSON-array met een object voor elke instantie-ID. Elk object bevat de naam, instantie-ID en waarde van de overeenkomende invoeren.

Kopiëren 
Variabele instellen [ $entryName ; Waarde: "com.claris.myaddon.theme" ]
Variabele instellen [ $entryArray ; Waarde: "[]" ]
Variabele instellen [ $i ; Waarde: 1 ]

Variabele instellen [ $instanceIDList ; Waarde: ListPersistentDataIDs ( $entryName ) ]

Variabele instellen [ $totalInstances ; Waarde: ValueCount ( $instanceIDList ) ]

Loop [ Wissen: Altijd ]
  Exit Loop If [ $i > $totalInstances ]
  
  Variabele instellen [ $currentInstanceID ; Waarde: GetValue ( $instanceIDList ; $i ) ]
  Variabele instellen [ $entryValue ; Waarde: GetPersistentData ( $entryName ; $currentInstanceID ) ]
  
  Variabele instellen [ $entryObject ; Waarde: "{}" ]
  Variabele instellen [ $entryObject ; Waarde: JSONSetElement ( $entryObject ; "name" ; $entryName ; JSONString ) ]
  Variabele instellen [ $entryObject ; Waarde: JSONSetElement ( $entryObject ; "instanceID" ; $currentInstanceID ; JSONString ) ]
  Variabele instellen [ $entryObject ; Waarde: JSONSetElement ( $entryObject ; "value" ; $entryValue ; JSONString ) ]
  
  Variabele instellen [ $entryArray ; Waarde: JSONSetElement ( $entryArray ; "[+]" ; $entryObject ; JSONObject ) ]
  
  Variabele instellen [ $i ; Waarde: $i + 1 ]
End Loop

Aangepast dialoogvenster tonen [ JSONFormatElements ( $entryArray ) ]

Voorbeeld van de resulterende array:

Kopiëren 
[
  {
    "instanceID" : "38EA3124-9CFD-4490-A634-A0A72A613145",
    "name" : "com.claris.myaddon.theme",
    "value" : "Dark"
  },
  {
    "instanceID" : "E53DE16C-282E-44B0-BDB8-D59B15419D1B",
    "name" : "com.claris.myaddon.theme",
    "value" : "Dark"
  },
  {
    "instanceID" : "",
    "name" : "com.claris.myaddon.theme",
    "value" : "Light"
  },
  {
    "instanceID" : "B2F4C8D1-5A3E-4F9B-8C7D-1E6A9B4D2F5C",
    "name" : "com.claris.myaddon.theme",
    "value" : "Dark"
  }
]

Verwante onderwerpen