Commande ASSIGN

Crée une variable et lui affecte une valeur.

Syntaxe

ASSIGN nom_variable = valeur <IF test>

Remarque

Il est recommandé d'indiquer explicitement le mot-clé ASSIGN pour faciliter la lecture et la compréhension des scripts. Toutefois, vous pouvez omettre ASSIGN et indiquer simplement :

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 qui seront utilisées pour la substitution de variables. Les noms de variables contenant des caractères n'existant pas en anglais provoqueront l'échec de la substitution de variables. 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 qui seront utilisées pour la substitution de variables. Les noms de variables contenant des caractères n'existant pas en anglais provoqueront l'échec de la substitution de variables.

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 :

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

Pour obtenir des informations détaillées sur l'utilisation des variables, consultez la rubrique Utilisation de variables dans ACLScript.

Durée des variables

Les variables sont conservées uniquement pour la durée de la session Analytics active. Normalement, lorsque vous fermez un projet Analytics, toutes les variables du projet sont supprimées automatiquement.

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 _nom_variable = valeur

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 système créées via des commandes Analytics.