Utilisation de variables
Les variables fournissent un emplacement temporaire pour stocker les données, accessibles à partir de n'importe quel contexte du fichier. Vous pouvez définir des variables dans :
- les calculs à l'aide des fonctions Definir et TantQue ;
- les scripts à l'aide des actions de script telles que Définir variable, Obtenir le chemin du dossier, Ouvrir boîte dial. person., Lire depuis le fichier de données et certaines actions de script Insérer.
Les variables ne sont pas disponibles en dehors du fichier dans lequel elles sont définies, et les variables d'un utilisateur ne sont pas accessibles aux autres utilisateurs. Si vous souhaitez que vos données soient accessibles à d'autres fichiers ou plusieurs utilisateurs, utilisez une rubrique (sans stockage global) au lieu d'une variable.
Lorsque vous définissez une variable, vous pouvez spécifier sa portée en ajoutant un préfixe avant le nom de la variable.
Portée |
Préfixe |
Exemple |
Disponibilité |
fonction |
Aucun |
|
Uniquement au sein de la fonction lorsque la variable est définie |
locale |
$ |
|
Uniquement au sein du script lorsque la variable est définie (non disponible pour les sous-scripts) ; effacée lorsque le script se termine |
globale |
$$ |
|
N'importe où au sein du fichier lorsque la variable est définie ; effacée lorsque le fichier est fermé |
Si des variables locales et globales (ou même deux variables locales dans des scripts différents) portent le même nom, elles sont traitées comme des variables distinctes et peuvent stocker différentes valeurs.
Vous pouvez utiliser des variables dans :
- les calculs ;
- les scripts ;
- les chemins d'accès au fichier (consultez la section Création de chemins d'accès) ;
- les requêtes de recherche que vous créez ou modifiez dans la boîte de dialogue Modifier une requête de recherche (consultez la section Boîtes de dialogue Requêtes de recherche et Modifier une requête de recherche) ;
- les variables de fusion (consultez la section Insertion de variables de fusion dans un modèle).
Répétitions dans les variables
Les variables locales et globales peuvent inclure un nombre de répétitions facultatif qui apparaît entre crochets [ ] immédiatement après le nom de la variable. Par exemple, la formule suivante renvoie 111 :
Definir ( [
$var[1] = 1;
$var[2] = 10;
$var[3] = 100
];
$var[1] + $var[2] + $var[3] )
Les répétitions dans les variables ne sont pas prises en charge dans :
-
les variables de fonction ;
-
les variables de fusion ;
-
les requêtes de recherche.
Remarques
- Les noms de variables doivent respecter les mêmes restrictions de nom que les noms de rubriques. Consultez la section À propos de l'attribution de noms aux rubriques.
- Les variables ne sont pas prises en charge dans les chemins d'accès stockés dans des rubriques Conteneur.
- Le type de donnée d'une variable est déterminé de façon dynamique en fonction des données affectées. Les variables contiennent les mêmes types de données que les rubriques, excepté les rubriques de type Calcul ou Statistique. Consultez la section À propos du choix d'un type de rubrique.
- Pour plus d'informations sur l'utilisation de variables, consultez la Base de connaissances.