Configurer les données persistantes

Définit ou supprime une entrée dans le stock de données persistantes.

Options 

  • Nom spécifie le nom de l'entrée de données persistantes. Le nom ne peut pas être vide.

  • ID de l'instance est une expression de texte facultative que vous pouvez utiliser pour identifier l'instance spécifique de l'entrée. Plusieurs entrées peuvent avoir le même nom avec des identifiants d'instance différents.

  • Valeur est une expression liée aux données à stocker. Le type de données est conservé lorsque la valeur est stockée.

  • Supprimer l'entrée supprime l'entrée spécifiée.

Compatibilité 

Produit Prise en charge
FileMaker Pro Oui
FileMaker Go Oui
FileMaker WebDirect Oui
FileMaker Server Oui
FileMaker Cloud Oui
FileMaker Data API Oui
Publication Web personnalisée Oui

Provient de la version 

26.0

Description 

Si une entrée avec le nom et l'ID d'instance spécifiés existe déjà, cette action de script met à jour sa valeur ou supprime l'entrée, selon si Valeur ou Supprimer l'entrée est sélectionnée. Si l'entrée n'existe pas, la spécification de Valeur crée l'entrée. Consultez la section À propos du stock de données persistantes.

Remarques 

  • Pour récupérer la valeur d'une entrée, utilisez la fonction ObtenirDonnéesPersistantes.

  • La taille d'une formule de calcul étant limitée (consultez les limites techniques de FileMaker Pro), vous ne pouvez pas spécifier une valeur de texte qui dépasse cette limite dans l'option Valeur. Pour spécifier des valeurs de texte supérieures à cette limite, référencez une rubrique ou une variable qui contient les données de l'option Valeur. Pour obtenir d'abord du texte dans une rubrique ou une variable, vous pouvez utiliser des actions de script telles que Insérer texte (pour le texte stocké dans l'action de script elle-même), Insérer depuis URL (pour le texte disponible via une URL) ou Lire depuis le fichier de données (pour le texte dans un fichier local).

  • ID de l'instance peut être non spécifié (vide) ou une chaîne vide ("").

  • Un ID de l'instance non spécifié (vide) est traité de la même manière qu'une chaîne vide ("").

  • La suppression d'une entrée qui n'existe pas renvoie le code d'erreur 10 ("Données requises manquantes").

Exemple 1 

Stocke un numéro de version simple dans une entrée nommée AppVersion (sans ID d'instance) dans le stock de données persistantes du fichier actuel.

Copier
Configurer les données persistantes [ AppVersion ; Valeur: "2.1.0" ]

Pour lire cette entrée, consultez l'exemple 1 pour la fonction ObtenirDonnéesPersistantes.

Exemple 2 

Stocke plusieurs valeurs de configuration pour une extension à l'aide de son ID d'instance.

Copier
Définir variable [ $IDInstance ; Valeur: "38EA3124-9CFD-4490-A634-A0A72A613145" ]
Configurer les données persistantes [ com.claris.myaddon.theme ; ID de l'instance: $IDInstance ; Valeur: "Foncé" ]
Configurer les données persistantes [ com.claris.myaddon.language ; ID de l'instance: $IDInstance ; Valeur: "fr" ]
Configurer les données persistantes  [ com.claris.myaddon.modificationdate ; ID de l'instance: $IDInstance ; Valeur: Obtenir ( HorodatageActuel ) ]

Exemple 3 

Supprime une entrée de données persistantes spécifique en fonction de son nom et de l'ID de l'instance.

Copier
Définir variable [ $IDInstance ; Valeur: "38EA3124-9CFD-4490-A634-A0A72A613145" ]
Configurer les données persistantes [ com.claris.myaddon.theme ; ID de l'instance: $IDInstance ; Supprimer ]