Configura dati persistenti

Imposta o elimina una voce nell'archivio dati persistente.

Opzioni 

  • Nome è un testo che specifica il nome della voce dati persistenti. Il nome non può essere vuoto.

  • ID istanza è un'espressione di testo opzionale che è possibile usare per identificare l'istanza specifica della voce. Più voci possono avere lo stesso nome con diversi ID istanza.

  • Valore è un'espressione per i dati da memorizzare. Il tipo di dati viene conservato quando il valore viene memorizzato.

  • Elimina voce elimina la voce specificata.

Compatibilità 

Prodotto Supportata
FileMaker Pro
FileMaker Go
FileMaker WebDirect
FileMaker Server
FileMaker Cloud
FileMaker Data API
Pubblicazione Web personalizzata

Creata nella versione 

26.0

Descrizione 

Se esiste già una voce con il nome e l'ID istanza specificati, questa istruzione di script aggiorna il suo valore o elimina la voce, a seconda che sia selezionato Valore o Elimina voce. Se la voce non esiste, specificando Valore la voce viene creata. Vedere Informazioni sull'archivio dati persistente.

Note 

  • Per recuperare il valore di una voce, utilizzare la funzione GetDatiPersistenti.

  • Poiché la dimensione di una formula di calcolo ha un limite (vedere Limiti tecnici di FileMaker Pro), non è possibile inserire un valore di testo che supera tale limite nell'opzione Valore. Per specificare valori di testo superiori a questo limite, fare riferimento a un campo o a una variabile contenente i dati per l'opzione Valore. Per inserire prima di tutto il testo in un campo o in una variabile, è possibile utilizzare istruzioni di script come Inserisci testo (per testo memorizzato nell'istruzione di script stessa), Inserisci da URL (per testo disponibile tramite un URL) o Leggi da file dati (per il testo in un file locale).

  • ID istanza può essere non specificato (vuoto) o una stringa vuota ("").

  • Un ID istanza non specificato (vuoto) viene trattato allo stesso modo di una stringa vuota ("").

  • L'eliminazione di una voce che non esiste restituisce il codice di errore 10 ("Dati richiesti non disponibili").

Esempio 1 

Memorizza un semplice numero di versione in una voce denominata VersioneApp (senza ID istanza) nell'archivio dati persistente del file corrente.

Copia
Configura dati persistenti [ VersioneApp ; Valore: "2.1.0" ]

Per leggere questa voce, vedere l'Esempio 1 per la funzione GetDatiPersistenti.

Esempio 2 

Memorizza più valori di configurazione per un componente aggiuntivo utilizzando l'ID istanza del componente aggiuntivo.

Copia
Imposta variabile [ $instanceID ; Valore: "38EA3124-9CFD-4490-A634-A0A72A613145" ]
Configura dati persistenti [ com.claris.myaddon.theme ; ID istanza: $instanceID ; Valore: "Scuro" ]
Configura dati persistenti [ com.claris.myaddon.language ; ID istanza: $instanceID ; Valore: "it" ]
Configura dati persistenti [ com.claris.myaddon.modificationdate ; ID istanza: $instanceID ; Valore: Get ( IndicatoreDataOraCorrente ) ]

Esempio 3 

Elimina una specifica voce dati persistenti per nome e ID istanza.

Copia
Imposta variabile [ $instanceID ; Valore: "38EA3124-9CFD-4490-A634-A0A72A613145" ]
Configura dati persistenti [ com.claris.myaddon.theme ; ID istanza: $instanceID ; Elimina ]