GetPersistentData

Returnerar det beständiga datavärdet som anges med namn och instans-ID.

Format 

GetPersistentData ( namn ; instansID )

Parametrar 

namn – ett textuttryck som anger namnet på den beständiga dataposten.

instansID – ett textuttryck som identifierar den specifika instansen av posten. Måste matcha det instans-ID som används när data lagras. Kan vara en tom sträng ("").

Returnerad datatyp 

Text, numeriskt, datum, tid, tidsstämpel, container

Ursprungsversion 

26.0

Beskrivning 

Den här funktionen hämtar ett värde från den beständiga datalagringen utifrån namn och instans-ID. Datatypen på det returnerade värdet matchar datatypen som lagrades. Mer information finns i Om beständig datalagring.

Om det inte finns någon post med angivet namn och instans-ID returneras "?".

Kommentarer 

  • Använd Funktionen ListPersistentDataIDs för att hitta alla instans-ID för ett givet namn.

  • Om du anger instansID som en tom sträng ("") söker den här funktionen efter en post med ett tomt instans-ID.

Exempel 1 

GetPersistentData ( "AppVersion" ; "" ) returnerar 2.1.0 om AppVersion angetts utan instans-ID som i exempel 1 under Scriptsteget Konfigurera beständiga data.

Exempel 2 

Returnerar den angivna posten eller ett tomt JSON-objekt som standardvärde när den angivna posten inte hittas.

Kopiera 
Let (
  config = GetPersistentData ( "com.claris.tillagg.installningar" ; "38EA3124-9CFD-4490-A634-A0A72A613145" ) ;
  If ( config = "?" ; JSONSetElement ( "" ; "" ; "" ; JSONObject ) ; config )
)

Exempel 3 

När du anger URL-adressen för en webbvisare hämtas ett JavaScript-bibliotek från den beständiga datalagringen. Med den här metoden hålls stora mängder JavaScript-kod utanför beräkningsformlerna och gör det lättare att uppdatera.

Kopiera 
Ställ in webbvisaren [ Objektnamn: "webbvisare" ; URL: 
  "data:text/html," &
  "<html><head><script>" &
  GetPersistentData ( "Diagrambibliotek" ; "DeladeBibliotek" ) &
  "</script></head>" &
  "<body><div id='diagram'></div>" &
  "</body></html>" 
]

Relaterade avsnitt