Exécuter des scripts

Lorsque vous exécutez un script dans Analytics, chaque commande de ce script est traitée dans l'ordre, jusqu'à la fin du script.

Cependant, vous ne pouvez pas continuer à utiliser Analytics lorsque le script est en cours d'exécution. Qui plus est, vous ne pouvez lancer qu'un seul script à la fois. Il est cependant possible de créer des scripts appelant et exécutant d'autres scripts, via la commande DO SCRIPT.

État du script

Lorsqu'un script est en cours d'exécution, Analytics affiche l'état du traitement et le nom du script, ou du sous-script, dans la barre d'état.

À la fin de l'exécution du script, une icône s'affiche dans la barre d'état pour indiquer si le script s'est exécuté correctement jusqu'à la fin ou s'il a échoué . En cas d'échec du script, la ligne dans laquelle l'erreur survient est automatiquement surlignée dans l'Éditeur de script.

Le cas échéant, vous pouvez arrêter le traitement d'un script via la touche Échap ou en fermant Analytics.

Exécuter un script depuis le menu principal

Il existe deux façons différentes d'exécuter un script à partir du menu principal :

  • Menu Applications choisissez un nom de script spécifique dans un menu personnalisé

    Pour plus d'informations, voir Ajout d'éléments personnalisés au menu principal Analytics.

  • L'option Outils permet d'accéder à une liste de sélection de tous les scripts d'un projet
    1. Sélectionnez Outils > Exécuter le Script.
    2. Dans la boîte de dialogue Exécuter le script, sélectionnez le script à exécuter à partir de la liste de scripts disponibles dans le projet.
    3. Si vous voulez spécifier une condition qui doit être évaluée comme étant vraie pour que le script s'exécute, effectuez l'une des opérations suivantes :
      • saisissez une expression logique dans la zone de texte Si.
      • cliquez sur Si pour créer une expression logique à l'aide du Générateur d'expression

        .L'expression logique est vérifiée une seule fois, pour permettre au système de déterminer si le script doit être exécuté. Si l'expression a la valeur « false », le script ne s'exécute pas.

    4. Cliquez sur OK.

Exécuter un script à partir de l'onglet Vue globale

Dans l'onglet Vue globale du Navigateur, cliquez avec le bouton droit de la souris sur ce dernier dans l'arborescence et sélectionnez Exécuter.

Exécuter un script à partir de l’Éditeur de script

Ouvrez le script dans l'Éditeur de script, cliquez sur Exécuter  dans la barre d'outils Éditeur de script.

Si vous avez apporté des modifications à un script dans l'Éditeur de script, les modifications sont enregistrées automatiquement lors de l'exécution du script.

Exécuter un script depuis la ligne de commande Windows

Vous pouvez exécuter un script à partir de la ligne de commande Windows ou d'un fichier batch (*.bat), ce qui vous permet de planifier le script à l'aide d'un utilitaire tel que le Planificateur de tâches de Windows et de le lancer en toute autonomie.

La syntaxe de la ligne de commande utilise cette forme de base :

chemin_exécutable_acl chemin_projet_acl /vVarName=value> /bNom_script </min>

Exemple

La syntaxe de la ligne de commande ci-dessous ouvre Exemple de projet.ACL et exécute un script appelé Calculer_valeur_médiane.

"C:\Program Files (x86)\ACL Software\ACL for Windows 14\ACLWin.exe" "C:\Users\username\Documents\ACL Data\Exemples de fichiers de données\Exemple de projet.ACL" /vv_nom_table="Trans_Cf" /vv_nom_champ="Montant_Facture" /bCalculer_valeur_médiane

Syntaxe de la ligne de commande

Remarque

Spécifiez les chemins complets permettant d'accéder à l'exécutable Analytics et au projet Analytics, avec le nom et l'extension du fichier. Placez le chemin d'accès entre guillemets si celui-ci contient des espaces.

Paramètre Détails Exemple
"ACL_chemin_exe_et_nom_de_fichier"

Spécifie le chemin d'accès au fichier exécutable Analytics (ACLWin.exe).

 
"C:\Program Files (x86)\ACL Software\ACL for Windows 14\ACLWin.exe"
"ACL_chemin_projet_et_nom_de_fichier"

Spécifie le chemin d'accès au fichier de projet Analytics (*.acl) contenant le script.

 
"C:\Users\username\Documents\ACL Data\Exemples de fichiers de données\Exemple de projet.ACL"

/v

optionnel

Spécifie les noms de variables et attribue des valeurs. Les variables sont automatiquement initialisées lorsque le projet Analytics s'ouvre.

Ne saisissez pas d'espace entre le commutateur /v et le nom de la variable. Par exemple, pour la variable v_nom_table :

/vv_nom_table="Trans_Cf"

Remarque

Le type de données d'une valeur affectée doit correspondre au type de données de la variable dans le script. Si les types de données ne correspondent pas, une erreur "Non-concordance des types d'expression" se produit et le script échoue.

Utilisez les guillemets pour identifier les valeurs de type caractère et les guillemets inversés pour identifier les valeurs DateHeure.

Variables de type caractère 

/vvv_nom_table="Trans_Cf" /vvv_nom_champ="Montant_facture"

Variable numérique 

/vv_seuil_signification=10000

Variables de type DateHeure 

/vv_date_début=`201801010101` /vvv_date_fin=``20180331`

 
/b

Indique le nom du script à exécuter.

Ne saisissez pas d'espace entre le commutateur /b et le nom du script.

 
/bCalculer_valeur_médiane

/min

optionnel

 Indique que la fenêtre Analytics est réduite au minimum lorsqu'elle s'ouvre.  

Instructions pour la création d'un script qui s'exécute de manière autonome

Éviter les interactions avec l'utilisateur

N'incluez aucune des commandes d'interaction utilisateur suivantes :

  • DIALOG
  • ACCEPT
  • PASSWORD
  • PAUSE

À la place, spécifiez toutes les variables requises et attribuez des valeurs à l'aide de la syntaxe de la ligne de commande expliquée ci-dessus.
Supprimer les boîtes de dialogue de confirmation

Ajoutez la commande SET SAFETY OFF au début de votre script pour que les fichiers puissent être, au besoin, écrasés sans afficher de boîte de dialogue de confirmation. Ajoutez la commande SET SAFETY ON à la fin du script pour restaurer le comportement par défaut.

Ajoutez le paramètre OK après toutes les commandes, comme RENAME et DELETE, qui affichent normalement une boîte de dialogue de confirmation.
Quitter Analytics Terminez le script avec la commande QUIT pour quitter Analytics.

Exécuter un script à partir d'un raccourci Windows

Vous pouvez exécuter un script à partir d'un raccourci Windows.

  1. Créez un raccourci pour Analytics.
  2. Cliquez avec le bouton droit de la souris sur le raccourci et sélectionnez Propriétés.
  3. Dans le champ Cible, saisissez la syntaxe de ligne de commande appropriée (voir ci-dessus).
  4. Cliquez sur OK.
  5. Double-cliquez sur le raccourci pour exécuter le script.

[ Retour au début ]

Aide d'Analytics 14.1