Principes de base pour la création de scripts Analytics

ACLScript est un langage de commande qui vous permet de programmer et d'automatiser les commandes Analytics. La structure et les composants d'ACLScript sont simples, mais puissants.

Remarque

Si vous êtes un vrai débutant en matière de création de scripts, pensez à visiter l'Académie pour suivre une formation de base avant de vous plonger dans le présent contenu. Pour les cours sur la création de scripts et l'utilisation d'Analytics, rendez-vous sur www.highbond.com.

Commandes

Chaque ligne d'un script exécute une commande ACLScript et commence par le nom de la commande. Une commande est une instruction permettant d'exécuter une opération dans Analytics.

Le nom de la commande est suivi d'un ou plusieurs paramètres spécifiés sous nom_paramètre valeur_paramètre.

Astuce

Selon la commande, certains paramètres sont obligatoires et d'autres sont facultatifs. Vous n'êtes pas obligé de spécifier des paramètres facultatifs. S'ils sont omis, la commande s'exécute sans eux. Toutefois, si vous omettez un paramètre obligatoire, Analytics utilise la valeur par défaut associée à ce paramètre.

Exemple à l'aide de la commande CLASSIFY

L'exemple suivant affiche la commande CLASSIFY avec les paramètres suivants :

  • ON : indique en fonction de quel champ de la table effectuer le classement
  • SUBTOTAL : indique les champs facultatifs à sous-totaliser dans la sortie
  • TO : indique la table sur laquelle écrire les résultats de la commande CLASSIFY

Remarquez comment chaque paramètre est suivi d'une ou plusieurs valeurs de paramètres :

Remarques importantes concernant la syntaxe des commandes

  • le premier mot d'une ligne de script doit être un nom de commande
  • pour la plupart des commandes, l'ordre des paramètres suivant un nom de la commande n'a pas d'importance
  • la plupart des commandes demandent à ce que vous ouvriez la table cible avant d'exécuter la commande, précédez ces commandes de OPEN nom_table

Commentaires

Comme dans tout langage de script, il est possible d'ajouter des commentaires dans ACLScript avec le mot-clé COMMENT. Les commentaires facilitent la compréhension de votre code et sa communication auprès d'utilisateurs cherchant à lire, à utiliser ou à comprendre votre script. ACLScript prend en charge deux types de commentaires :

  • commentaires d'une seule ligne l'intégralité du texte qui suit COMMENT est ignorée jusqu'à ce que la fin de la ligne soit atteinte
  • blocs de commentaires sur plusieurs lignes commencent par COMMENT et les lignes qui suivent sont ignorées tant que le mot-clé END ou une ligne vide n'est pas atteint

Pour obtenir plus d'informations et des exemples, consultez la rubrique Commentaires.

Types de données

ACLScript prend en charge quatre types de données de base :

  • logique le type de données le plus simple. Les données logiques expriment une valeur de vérité : vrai ou faux (« true or false »).
  • numériques contiennent des chiffres allant de 0 à 9 et, éventuellement, un signe négatif et une virgule décimale.
  • caractère une série d'un ou plusieurs caractères.
  • DateHeure une valeur date, DateHeure ou heure exprimée dans un format compatible.

Chaque type de données est traité différemment par Analytics et peut être utilisé dans différentes commandes et fonctions. Pour plus d'informations sur les types de données, consultez la rubrique Types de données.

Expressions

Une expression est une instruction ayant une valeur. La forme d'expression la plus simple est une valeur littérale comme 2 ou "test". Toutefois, les expressions s'affichent généralement sous forme de calculs et peuvent être aussi complexes que toutes les combinaisons valides d'opérateurs, conditions, fonctions et valeurs que vous pouvez imaginer :

((2 + (3 - 2)) * 2) > ROOT(9;0)

Les expressions sont généralement utilisées dans Analytics pour remplir des champs calculés ou sous forme de valeur d'introduction pour la logique conditionnelle. Pour plus d'informations sur les expressions, consultez la section Expressions.

Fonctions

Les fonctions sont des routines intégrées qui acceptent un certain nombre de paramètres et qui renvoient une seule valeur. Elles servent à manipuler le contenu des champs et les variables utilisés dans les commandes.

Remarque

Les fonctions ne modifient pas les données dans les champs ; elles génèrent et renvoient une nouvelle valeur à partir d'un calcul ou d'un algorithme qui utilise les données des champs ou des variables comme entrées. Utilisez la valeur renvoyée par la fonction comme entrée pour une commande.

Les fonctions commencent par un nom de fonction suivi directement d'une parenthèse ouvrante, d'une liste séparée par des virgules d'au moins 0 valeurs transmises à la fonction sous forme d'arguments, ainsi que d'une parenthèse fermante.

Exemple

La fonction BETWEEN(valeur; min; max) prend trois arguments et renvoie « vrai » si la valeur tombe dans la plage ou « faux » si elle ne tombe pas dans la plage :

  • valeur : l'expression ou le champ à tester
  • min : le minimum de la plage
  • max : le maximum de la plage
BETWEEN(montant; 500; 5000)

Pour plus d'informations sur les fonctions, consultez la rubrique Fonctions.

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.

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%

Pour obtenir plus d'informations sur les variables, consultez la rubrique Variables.

Structures des contrôles

Une structure de contrôle est un composant de script décidant de la direction à prendre compte tenu de certains paramètres. ACLScript fournit à la fois des structures de bouclage et des structures logiques conditionnelles.

Logique conditionnelle

ACLScript met en œuvre une logique conditionnelle sous la forme d'une commande IF et sous la forme d'un paramètre facultatif dans plusieurs commandes du langage.

Astuce

Utilisez la commande IF pour contrôler si une commande s'exécute ou non, mais utilisez le paramètre IF pour décider des enregistrements de la table par rapport auxquels exécuter la commande.

Commande IF

IF v_compteur > 10 CLASSIFY ON num_client

Paramètre IF

CLASSIFY ON num_client IF état = 'NY'

Boucles

La commande LOOP fournit la structure de contrôle en boucle dans ACLScript. Cette commande traite les instructions contenues à l'intérieur de la boucle tant que l'expression du test de contrôle est évaluée sur vraie :

Pour obtenir plus d'informations sur les structures des contrôles, consultez la rubrique Structures des contrôles

[ Retour au début ]

Guide de création de scripts ACL 14.1