Exécute un script secondaire, ou un script externe, depuis un script Analytics.
Syntaxe
DO <SCRIPT> nom_script {<IF test>|<WHILE test>}
Paramètres
| Nom | Description |
|---|---|
| SCRIPT nom_script |
Nom du script à exécuter. Vous pouvez exécuter des scripts secondaires dans le projet Analytics ou des scripts externes stockés dans des fichiers texte portant des extensions comme .aclscript, .txt ou .bat. Vous pouvez spécifier un chemin d'accès au fichier d'un script externe. Vous devez entourer le chemin de guillemets s'il contient des espaces. Remarque Vous ne pouvez pas appeler un script qui est en cours d'exécution. Par exemple, si le ScriptA appelle le ScriptB, le ScriptB ne peut pas appeler le ScriptA. Le ScriptA est en cours d'exécution alors qu'il attend la fin du ScriptB. |
| IF test optionnel |
Expression conditionnelle qui est évaluée une fois afin de déterminer si le script doit être exécuté. Si la condition évaluée est vraie, le script est exécuté. Dans le cas contraire, il ne l'est pas. Ne peut pas être utilisé avec WHILE dans la même commande. Si les deux sont utilisés, WHILE est ignoré lors du traitement du script. Un commentaire est saisi dans la trace, mais l'exécution du script n'est pas arrêtée. |
| WHILE test optionnel |
Expression conditionnelle évaluée après l'exécution du script afin de déterminer si le script doit être de nouveau exécuté. Si la condition est vraie, le script est exécuté. Dans le cas contraire, il ne l'est pas. Remarque Si vous utilisez WHILE, assurez-vous que votre test finit par être évalué sur faux. Si cela n'est pas le cas, le script entre dans une boucle infinie. En cas de boucle infinie, appuyez sur la touche Échap pour annuler le traitement du script. Ne peut pas être utilisé avec IF dans la même commande. Si les deux sont utilisés, WHILE est ignoré lors du traitement du script. Un commentaire est saisi dans la trace, mais l'exécution du script n'est pas arrêtée. |
Exemples
Exécution d'un sous-script de manière répétée jusqu'à la validation de l'entrée
Vous avez un sous-script qui recueille les saisies de l'utilisateur à l'aide d'une boîte de dialogue. Il fait ce qui suit :
- Invite l'utilisateur à saisir les valeurs requises.
- Vérifie la saisie de l'utilisateur.
- Définit la variable v_validée sur vrai lorsque les valeurs de saisie sont validées.
Pour vous assurer que l'utilisateur saisisse une entrée valide, vous utilisez DO SCRIPT et vous incluez une condition WHILE pour que le script répète cette commande jusqu'à la validation de la saisie. Une fois la valeur de la variable modifiée, le script principal passe à la commande suivante :
DO SCRIPT ObtenirEntréeUtilisateur WHILE v_validée = F
Exécution d'un sous-script à partir d'un emplacement partagé
Vous conservez les sous-scripts des utilitaires dans un emplacement partagé. Lorsque vous avez besoin de l'un d'entre eux pendant une analyse, vous y faites référence à l'aide du chemin complet vers l'emplacement partagé :
DO SCRIPT "C:\Mes scripts utilitaires\ObtenirEntréeUtilisateur.aclscript" WHILE v_validée = F
Remarques
Commandes associées
DO SCRIPT est équivalente à la commande DO BATCH figurant dans les scripts créés avec les versions antérieures d'Analytics.
Vous ne pouvez pas inclure la commande DO SCRIPT dans une commande GROUP.
Utilité d'un script externe
Il peut être utile de stocker un script en externe et de l'appeler depuis un script Analytics si vous souhaitez réutiliser le même sous-script dans différents scripts et projets Analytics.
Vous pouvez stocker une seule copie du script à un seul emplacement et y apporter des mises à jour à un endroit, plutôt que de le conserver à plusieurs emplacements.
