GetPersistentData

Retorna o valor de dados persistentes especificado por nome e ID de instância.

Formato 

GetPersistentData (nome; instanceID)

Parâmetros

nome - uma expressão de texto que especifica o nome da entrada de dados persistentes.

instanceID - uma expressão de texto que identifica a instância específica da entrada. Deve corresponder ao ID de instância usado ao armazenar os dados. Pode ser uma string vazia ("").

Tipo de dados retornado

texto, número, data, hora, carimbo de data/hora, container

Originada na versão

26.0

Descrição

Esta função recupera um valor do armazenamento de dados persistente pelo nome e ID da instância. O tipo de dados do valor retornado corresponde ao tipo de dados que foi armazenado. Consulte Sobre o armazenamento de dados persistente.

Se não existir nenhuma entrada com o nome especificado e o ID de instância, esta função retornará "?".

Notas

  • Use a função Função ListPersistentDataIDs para encontrar todos os IDs de instância para um determinado nome.

  • Se você especificar instanceID como uma string vazia (""), esta função procurará por uma entrada com um ID de instância vazio.

Exemplo 1

GetPersistentData ( "AppVersion" ; "" ) retorna 2.1.0 se AppVersion foi definido sem ID de instância como no Exemplo 1 para a etapa de script Etapa de script Configurar dados persistentes.

Exemplo 2

Retorna a entrada especificada ou um objeto JSON vazio como um valor padrão quando a entrada especificada não é encontrada.

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

Exemplo 3

Ao definir o URL para um visualizador da Web, recupera uma biblioteca JavaScript do armazenamento de dados persistente. Essa abordagem mantém o grande código JavaScript fora de suas fórmulas de cálculo e facilita a atualização.

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

Tópicos relacionados