Commande ASSIGN

Crée une variable et lui affecte une valeur.

Syntaxe

ASSIGN nom_variable = valeur <IF test>

Astuce

Vous pouvez ignorer le mot-clé ASSIGN, car Analytics interprète automatiquement la syntaxe suivante comme une opération d'attribution :

nom_variable = valeur

Paramètres

Nom	Description
nom_variable	Nom de la variable à laquelle la valeur doit être attribuée. Si la variable n'existe pas, elle est créée. Si la variable existe déjà, elle est mise à jour avec la nouvelle valeur. N'utilisez pas de caractères n'existant pas en anglais, comme « é », dans les noms des variables. Les noms de variables contenant des caractères n'existant pas en anglais provoqueront l'échec des scripts. Remarque La longueur des noms de variables est limitée à 31 caractères alphanumériques. Le nom peut inclure le caractère de soulignement ( _ ), mais aucun autre caractère spécial ni espace. Le nom ne peut pas commencer par un chiffre.
valeur	Valeur à attribuer à la variable. Si une nouvelle variable est créée, le type de variable est basé sur le type de données dans valeur.
IF test Optionnel	Une expression conditionnelle qui doit être vraie pour créer la variable ou attribuer la valeur à la variable.

Nom

Description

nom_variable

Nom de la variable à laquelle la valeur doit être attribuée. Si la variable n'existe pas, elle est créée. Si la variable existe déjà, elle est mise à jour avec la nouvelle valeur.

N'utilisez pas de caractères n'existant pas en anglais, comme « é », dans les noms des variables. Les noms de variables contenant des caractères n'existant pas en anglais provoqueront l'échec des scripts.

Remarque

La longueur des noms de variables est limitée à 31 caractères alphanumériques. Le nom peut inclure le caractère de soulignement ( _ ), mais aucun autre caractère spécial ni espace. Le nom ne peut pas commencer par un chiffre.

valeur

Valeur à attribuer à la variable. Si une nouvelle variable est créée, le type de variable est basé sur le type de données dans valeur.

IF test

Optionnel

Une expression conditionnelle qui doit être vraie pour créer la variable ou attribuer la valeur à la variable.

Exemples

Attribution d'une valeur à une variable

Vous attribuez la valeur du champ Montant de l'enregistrement actuel à une variable appelée v_montant_actuel. v_montant_actuel étant une variable, sa valeur n'est pas modifiée, sauf si une autre commande ASSIGN la modifie explicitement :

ASSIGN v_montant_actuel = Montant

Attribution conditionnelle d'une valeur à une variable

Vous souhaitez actualiser la valeur d'une variable nommée v_quantité sur 1, mais uniquement si la valeur d'une autre variable appelée v_compteur est inférieure à 10.

Si v_compteur est supérieur ou égal à 10, aucune valeur n'est attribuée et la valeur de v_quantité reste inchangée.

Remarquez que le mot-clé ASSIGN facultatif est ignoré :

v_quantité = 1 IF v_compteur < 10

Remarques

Durée des variables

Les variables dont le nom n'est pas précédé d'un trait de soulignement sont conservées uniquement pour la durée de la session Analytics active.

Pour enregistrer de manière définitive la variable avec un projet Analytics, faites précéder son nom d'un trait de soulignement :

ASSIGN valeur = _nom_variable

Réattribution des variables utilisées dans un champ calculé ou dans GROUP

Si vous affectez une valeur à une variable existante dans les situations suivantes, la nouvelle valeur est affectée mais la longueur et le nombre de décimales de la valeur précédente sont conservés :

variables utilisées dans des champs calculés
variables réaffectées à l'intérieur d'un GROUP

La longueur de la nouvelle valeur est tronquée ou complétée, et les décimales sont ajustées si nécessaire.

Si vous réaffectez une variable dans tout autre contexte, la valeur précédente ainsi que sa longueur et ses spécifications décimales sont écrasées.

Variables créées via des commandes Analytics

Lorsque certaines commandes sont exécutées, via la saisie d'informations dans les boîtes de dialogue Analytics ou via l'exécution de scripts, des variables système sont automatiquement créées par Analytics. Vous pouvez utiliser ces variables, et les valeurs qu'elles contiennent, lors de l'exécution des commandes Analytics subséquentes.

La valeur d'une variable système est remplacée par une valeur mise à jour si vous exécutez à nouveau la même commande.

Pour plus d'informations, consultez la section Variables créées via des commandes Analytics.