Variables

Une variable est un emplacement de stockage temporaire utilisé pour conserver une valeur. Un identificateur lui est associé, ce qui vous permet de faire référence à la valeur stockée en mémoire dans votre ordinateur et de l'utiliser.

Fonctionnement des variables dans ACLScript

Création d'une variable et affectation d'une valeur

ACLScript utilise la commande ASSIGN pour créer une variable et pour lui attribuer une valeur en même temps :

ASSIGN v_age_in_years = 3

Pour simplifier, vous pouvez omettre le mot-clé ASSIGN ; toutefois, ASSIGN est utilisé implicitement et la même commande s'exécute :

v_age_in_years = 3

Remarque

ACLScript ne prend pas en charge les valeurs null. Toutes les variables doivent être associées à une valeur d'un des types de données pris en charge. L'interpréteur de script évalue le type de données à l'aide du format de date et du qualificateur que vous utilisez pour attribuer la valeur. Pour plus d'informations, consultez la section Types de données.

Utilisation de variables

Une fois qu'une variable est créée, vous pouvez y faire référence à n'importe quel endroit où vous renvoyez à des noms de champs ou à des variables. Vous pouvez aussi lui réattribuer une nouvelle valeur à l'aide de la commande ASSIGN.

EXTRACT RECORD TO 'result.fil' IF age > v_age_in_years
v_age_in_years = 5

Vous pouvez aussi utiliser l'interpolation des chaînes ou la substitution de variable pour inclure une variable dans un littéral de chaîne en entourant le nom de la variable avec des caractères %. Lorsqu'Analytics trouve la variable de substitution, il remplace l'espace réservé par la valeur correspondante :

ASSIGN v_table = erp_data
OPEN %v_table%

Types de variables

Analytics utilise les types de variables suivants :

  • les variables générées par le système créées automatiquement après l'exécution d'une commande
  • les variables permanentes restent dans la mémoire de votre ordinateur jusqu'à ce que vous les supprimiez et continuent d'exister après la fermeture du projet Analytics

    Remarque

    Pour définir une variable permanente, ajoutez le préfixe '_' devant l'identificateur : _v_nom_société = 'Acme'.

  • les variables de session restent en mémoire dans votre ordinateur jusqu'à ce que vous les supprimiez ou jusqu'à ce que le projet Analytics soit fermé

Identificateurs de variables

Les identificateurs de variables ne respectent pas la casse et suivent certaines conventions associées au type de variable :

  • les identificateurs des variables générées par le système utilisent des noms tout en majuscules : OUTPUTFOLDER
  • les identificateurs des variables permanentes présentent le préfixe « _ » : _v_permanent
  • les identificateurs de variables de session utilisent le format v_nomvar par convention, mais vous n'êtes pas tenu de respecter cette convention de nom

Affichage des valeurs des variables

Pendant le développement du script ou pendant le débogage, il peut s'avérer utile de suivre les valeurs des variables à mesure que le script s'exécute. Pour capturer les valeurs des variables dans le fichier trace du script, utilisez la commande DISPLAY :

DISPLAY v_age_en_années

À chaque fois que le script tombe sur cette commande, il l'écrit dans le fichier trace. Pour afficher la valeur de la variable à ce stade de l'exécution du script, cliquez sur son entrée dans la trace.

Astuce

Vous pouvez aussi utiliser des variables pour aider au débogage en insérant des points d'arrêt dans votre script et en contrôlant les valeurs des variables dans l'onglet Variables du Navigateur.