GetDatiPersistenti

Restituisce il valore dei dati persistenti specificato in base al nome e all'ID istanza.

Formato 

GetDatiPersistenti ( nome ; IDistanza )

Parametri 

nome - un'espressione di testo che specifica il nome della voce dati persistenti.

IDistanza - un'espressione di testo che identifica l'istanza specifica della voce. Deve corrispondere all'ID istanza utilizzato durante la memorizzazione dei dati. Può essere una stringa vuota ("").

Tipo di dati riportato 

Testo, Numero, Data, Ora, Indicatore data e ora, Contenitore

Creata nella versione 

26.0

Descrizione 

Questa funzione recupera un valore dall'archivio dati persistente per nome e ID istanza. Il tipo di dati del valore restituito corrisponde al tipo di dati che è stato memorizzato. Vedere Informazioni sull'archivio dati persistente.

Se non esiste alcuna voce con il nome e l'ID istanza specificati, questa funzione restituisce "?".

Note 

  • Utilizzare la funzione ElencoIDDatiPersistenti per trovare tutti gli ID istanza per un determinato nome.

  • Se si specifica IDistanza come stringa vuota (""), questa funzione cerca una voce con un ID istanza vuoto.

Esempio 1 

GetDatiPersistenti ( "VersioneApp" ; "" ) restituisce 2.1.0 se VersioneApp è stato impostato senza ID istanza come nell'Esempio 1 per l'istruzione di script Configura dati persistenti.

Esempio 2 

Restituisce la voce specificata o un oggetto JSON vuoto come valore predefinito quando la voce specificata non viene trovata.

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

Esempio 3 

Quando si imposta l'URL per un visualizzatore Web, recupera una libreria JavaScript dall'archivio dati persistente. Questo approccio tiene il codice JavaScript di grandi dimensioni fuori dalle formule di calcolo dell'utente e facilita l'aggiornamento.

Copia 
Imposta visualizzatore Web [ Nome oggetto: "visualizzatoreweb" ; URL: 
  "data:text/html," &
  "<html><head><script>" &
  GetDatiPersistenti ( "LibreriaGrafici" ; "LibrerieCondivise" ) &
  "</script></head>" &
  "<body><div id='chart'></div>" &
  "</body></html>" 
]

Argomenti correlati