GetPersistentData

Retourneert de permanente gegevenswaarde die is opgegeven op naam en instantie-ID.

Opmaak 

GetPersistentData ( name ; instanceID )

Parameters 

name - een tekstexpressie die de naam van de permanente gegevensinvoer aangeeft.

instanceID - een tekstexpressie die de specifieke instantie van het item identificeert. Moet overeenkomen met de instantie-ID die wordt gebruikt bij het opslaan van de gegevens. Kan een lege tekenreeks zijn ('').

Resulterend gegevenstype 

tekst, getal, datum, tijd, tijdstempel, container

Afkomstig uit versie 

26.0

Beschrijving 

Deze functie haalt een waarde op uit de permanente gegevensopslag op basis van naam en instantie-ID. Het gegevenstype van de geretourneerde waarde komt overeen met het gegevenstype dat is opgeslagen. Zie Informatie over de permanente gegevensopslag.

Als er geen invoer bestaat met de opgegeven naam en instantie-ID, retourneert deze functie '?'.

Opmerkingen 

  • Gebruik de ListPersistentDataIDs functie om alle instantie-ID's voor een bepaalde naam te zoeken.

  • Als u instanceID opgeeft als een lege tekenreeks (''), zoekt deze functie naar een item met een lege instantie-ID.

Voorbeeld 1 

GetPersistentData ( "AppVersion" ; "" ) geeft 2.1.0 terug als AppVersion is ingesteld zonder instantie-ID zoals in voorbeeld 1 voor de Permanente gegevens configureren scriptstap.

Voorbeeld 2 

Retourneert de opgegeven invoer of een leeg JSON-object als standaardwaarde wanneer de opgegeven invoer niet wordt gevonden.

Kopiëren 
Let (
  config = GetPersistentData ( "com.claris.myaddon.settings" ; "38EA3124-9CFD-4490-A634-A0A72A613145" ) ;
  If ( config = "?" ; JSONSetElement ( "" ; "" ; "" ; JSONObject ) ; config )
)

Voorbeeld 3 

Haalt bij het instellen van de URL voor een webviewer een JavaScript-bibliotheek op uit de permanente gegevensopslag. Deze aanpak houdt grote JavaScript-code buiten uw berekeningsformules en maakt het gemakkelijker om bij te werken.

Kopiëren 
Web Viewer instellen [ Objectnaam: "webviewer" ; URL: 
  "data:text/html," &
  "<html><head><script>" &
  GetPersistentData ( "ChartLibrary" ; "SharedLibraries" ) &
  "</script></head>" &
  "<body><div id='chart'></div>" &
  "</body></html>" 
]

Verwante onderwerpen