Votre premier script Analytics

Ce petit tutoriel simple présente les principes de base d'ACLScript. Ce tutoriel traite uniquement de l'ouverture d'une table et de l'extraction d'un sous-ensemble d'enregistrements, mais ACLScript regorge de nombreuses autres fonctionnalités.

De quels éléments avez-vous besoin ?

Dans ce tutoriel, nous supposons que vous avez installé et activé Analytics et que vous avez accès aux exemples de données fournis avec l'application.

Remarque

Par défaut, les exemples de projets de données sont installés sous C:\Utilisateurs\nomutilisateur\Documents\ACL Data\Exemples de fichiers de données dans votre système de fichiers locaux.

Configuration

Ouvrir l'exemple de projet Analytics

  1. Ouvrez ACL pour Windows.
  2. Cliquez sur Ouvrir un projet d'outil d'analyse, puis, dans le dossier ACL Data\Exemples de fichiers de données, sélectionnez Exemple de projet.ACL.

Créer votre premier script

  1. Dans le Navigateur, à partir de l'onglet Vue globale, cliquez avec le bouton droit de la souris sur le dossier Scripts et sélectionnez Nouveau > Script.

    Nouveau_script est ajouté au Navigateur et s'ouvre dans l'éditeur de script.

  2. Cliquez avec le bouton droit de la souris sur Nouveau_script, sélectionnez Renommer, puis saisissez extraire_factures.

Logique du script

Dans ce script, nous allons utiliser ACLScript pour :

  1. Ouvrir la table Trans_Cf.
  2. Copier tous les enregistrements de la table présentant un montant de facture supérieur à 1000,00 et les stocker dans une nouvelle table appelée Trans_Cf_Elevé.
  3. Ouvrir la nouvelle table pour contrôler les résultats.

Ouvrir la table Trans_Cf.

Les données sont stockées dans des tables ; ainsi, pour utiliser les données dont nous avons besoin, nous devons d'abord ouvrir une table. La commande OPEN signale vous travaillez avec la table spécifiée et met les données de la table à la disposition des commandes de votre script :

OPEN Trans_Cf

Copiez cette ligne, collez-la dans l'éditeur de script, puis cliquez sur Exécuter dans la barre d'outils de l'éditeur.

Si la table Trans_Cf s'ouvre, c'est que votre script fonctionne. Fermez la table et continuez.

Extraire tous les enregistrements vers Trans_Cf_Elevé et fermer Trans_Cf

Maintenant que le script fonctionne avec la table Trans_Cf, nous pouvons utiliser la commande EXTRACT pour copier les enregistrements de Trans_Cf vers une nouvelle table appelée Trans_Cf_Elevé :

EXTRACT RECORD TO 'Trans_Cf_Elevé'
CLOSE Trans_Cf

Copiez cette ligne, collez-la dans l'éditeur de script sur une ligne après la commande OPEN, puis cliquez sur Exécuter dans la barre d'outils de l'éditeur.

La table Trans_Cf_Elevé devrait apparaître dans le Navigateur sous Tables > Comptes fournisseurs. Cette nouvelle table contient les enregistrements copiés de Trans_Cf.

Extraire le sous-ensemble d'enregistrements vers Trans_Cf_Elevé et fermer Trans_Cf

À ce stade, nous pouvons ajouter un paramètre IF conditionnel à la commande EXTRACT pour copier uniquement les enregistrements de factures ayant des montants supérieurs à 1000,00.

Remarquez comment nous utilisons le paramètre IF pour tester si la valeur du champ Montant_facture est supérieure à 1000,00. Si ce test n'est pas évalué sur « true », l'enregistrement n'est pas extrait :

EXTRACT RECORD TO 'Trans_Cf_Elevé' IF Montant_facture > 1000,00
CLOSE Trans_Cf

Copiez cette ligne que vous utiliserez pour remplacer l'actuelle commande EXTRACT de l'éditeur de script, puis cliquez sur Exécuter dans la barre d'outils de l'éditeur.

Lorsque vous y êtes invité, cliquez sur Oui pour écraser la table Trans_Cf_Elevé. La table Trans_Cf_Elevé contient maintenant les enregistrements copiés avec les montants supérieurs à 1000,00 depuis la table Trans_Cf.

Ouverture de la table Trans_Cf_Elevé

Nous terminerons le script en ouvrant la nouvelle table Trans_Cf_Elevé pour que vous puissiez contrôler les résultats de la commande EXTRACT. Comme il s'agit de la dernière action du script, la table s'ouvre et vous pouvez examiner les enregistrements :

OPEN Trans_Cf_Elevé

Copiez cette ligne, collez-la dans l'éditeur de script sur une ligne après la commande EXTRACT, puis cliquez sur Exécuter dans la barre d'outils de l'éditeur.

La table Trans_Cf_Elevé s'ouvre maintenant lorsque le script se termine et vous pouvez examiner les enregistrements extraits depuis la table Trans_Cf.

Le script complet

OPEN Trans_Cf

EXTRACT RECORD TO 'Trans_Cf_Elevé' IF Montant_facture > 1000,00
CLOSE Trans_Cf

OPEN Trans_Cf_Elevé

Et ensuite ?