GetPersistentData

Devuelve el valor de datos persistentes especificado según el nombre y el ID de instancia.

Formato 

GetPersistentData ( name ; instanceID )

Parámetros 

name: una expresión de texto que especifica el nombre de la entrada de datos persistentes.

instanceID: una expresión de texto que identifica la instancia específica de la entrada. Debe coincidir con el ID de instancia utilizado al almacenar los datos. Puede ser una cadena vacía ("").

Tipo de datos devuelto 

texto, número, fecha, hora, fecha y hora, contenedor

Se origina en 

26.0

Descripción 

Esta función recupera un valor del almacén de datos persistentes por nombre e ID de instancia. El tipo de datos del valor devuelto coincide con el tipo de datos que se almacenó. Consulte Acerca del almacén de datos persistentes.

Si no existe ninguna entrada con el nombre y el ID de instancia especificados, esta función devuelve "?".

Notas 

  • Utilice la función ListPersistentDataIDs para encontrar todos los ID de instancia de un nombre dado.

  • Si especifica instanceID como una cadena vacía (""), esta función busca una entrada con un ID de instancia vacío.

Ejemplo 1 

GetPersistentData ( "AppVersion" ; "" ) devuelve 2.1.0 si AppVersion se estableció sin ID de instancia, como en el Ejemplo 1 del paso de guión Configurar datos persistentes.

Ejemplo 2 

Devuelve la entrada especificada o un objeto JSON vacío como valor predeterminado cuando no se encuentra la entrada especificada.

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

Ejemplo 3 

Al establecer la URL para un visualizador web, recupera una biblioteca de JavaScript del almacén de datos persistentes. Este enfoque mantiene el código de JavaScript de gran tamaño fuera de sus fórmulas de cálculo y facilita su actualización.

Copiar 
Establecer visualizador Web [ Nombre de objeto: "webviewer" ; URL: 
  "data:text/html," &
  "<html><head><script>" &
  GetPersistentData ( "ChartLibrary" ; "SharedLibraries" ) &
  "</script></head>" &
  "<body><div id='chart'></div>" &
  "</body></html>" 
]

Temas relacionados