Exécute une application ou un processus externe par rapport à Analytics. Émule la commande Exécuter de Windows. Peut être utilisée pour interagir avec l'invite de commande de Windows.

Remarque

La commande EXECUTE vous donne la possibilité d'interagir avec le système d'exploitation et avec des applications externes à Analytics, c'est pourquoi des problèmes techniques qui se situent au-delà de l'étendue de la fonctionnalité native d'Analytics peuvent survenir.

L'Assistance peut vous aider à utiliser la commande EXECUTE à l'intérieur d'Analytics, mais les problèmes qui surviennent avec des processus et des applications externes à Analytics ne sont pas pris en charge dans le cadre de l'Assistance.

EXECUTE Syntaxe_commande_Exécuter_Windows <ASYNC>
Nom Description
Syntaxe_commande_Exécuter_Windows

Nom de l'application à exécuter, du dossier ou du fichier à ouvrir, ou de la commande à exécuter, suivi de tous les arguments ou interrupteurs de commande requis.

Requiert une syntaxe de commande Exécuter de Windows valide entourée de guillemets.

ASYNC

optionnel

Exécute la commande en mode asynchrone.

En mode asynchrone, le script Analytics continue de s'exécuter sans attendre la fin du processus lancé par la commande EXECUTE.

Si vous omettez ASYNC, le processus lancé par la commande EXECUTE doit s'achever avant que le script Analytics continue. Analytics est inaccessible pendant l'exécution des processus externes.

Remarque

Lors de l'exécution de la commande EXECUTE à partir de la ligne de commande d'Analytics, vous devez indiquer ASYNC.
Nom Contient
RETURN_CODE

Code renvoyé par une application externe ou une exécution de processus à l'aide de la commande EXECUTE.

Que sont les codes de retour ?

Les codes de retour sont des nombres générés par l'application ou le processus externe et ils sont renvoyés à Analytics pour indiquer l'issue du processus externe. Analytics ne génère pas le code de retour, il ne fait que le recevoir.

Codes de retour types

Les codes de retour types sont des valeurs entières qui mappent vers des notifications ou des messages d'erreur particuliers. Par exemple, le code de retour « 0 » pourrait signifier « L'opération a été effectuée avec succès ». Le code de retour « 2 » pourrait signifier « Le système ne peut pas trouver le fichier spécifié ».

Signification de certains codes de retour

Les codes de retour spécifiques et leurs significations varient en fonction de l'application ou du processus externe. Les listes des codes de retour, aussi appelés « codes d'erreur » ou « codes de sortie », et leurs significations, figurent souvent dans la documentation de l'application externe associée. Vous trouverez également les listes des codes de retour sur Internet.

Variable créée en mode par défaut uniquement

La variable RETURN_CODE est créée lorsque la commande EXECUTE est exécutée dans le mode par défaut. La variable n'est pas créée lorsque la commande est exécutée en mode asynchrone.

Ouvrir une application

Ouvre Microsoft Excel :

EXECUTE "Excel"

Ouvre Adobe Acrobat Reader :

EXECUTE "AcroRd32.exe"

Fermer une application

Ferme Microsoft Excel :

EXECUTE "TASKKILL /f /im Excel.exe"

Remarque

Utilisez le bouton /f avec prudence. Cela force la fermeture d'une application sans présentation de boîtes de dialogue, comme celles qui permettent la sauvegarde des modifications.

Ouvrir un fichier

Ouvre le classeur Excel AP_Trans.xlsx :

EXECUTE '"C:\Projets ACL\Données source\AP_Trans.xlsx"'

Créer un nouveau dossier

Crée un nouveau dossier appelé Données source :

EXECUTE 'cmd /c MD "C:\Projets ACL\Données source"'

Exécuter des scripts externes ou des fichiers de commandes non-Analytics (.bat)

Exécute le script Mon_Lot.bat :

EXECUTE '"C:\Projets ACL\Fichiers de lot\Mon_Lot.bat"'

Transmettre des paramètres vers un fichier de commandes qui n'appartient pas à Analytics

Transmet deux paramètres à Mon_Lot.bat. Les paramètres peuvent être des valeurs littérales ou des variables Analytics :

EXECUTE '"C:\Projets ACL\Fichiers de lot\Mon_Lot.bat" param1%v_param2%'

Exécuter des scripts Analytics dans d'autres projets Analytics

Exécute "AP_Trans_script" dans AP Trans Tests.acl"

EXECUTE 'aclwin.exe "C:\ACL Projects\AP Trans Tests.acl" /b AP_Trans_script'

Remarque

L'exécution d'un script Analytics dans un autre projet lance une seconde instance d'Analytics. Le script dans le second projet devrait se terminer par la commande QUIT de sorte que la seconde instance d'Analytics se ferme et que le contrôle soit renvoyé à l'instance initiale d'Analytics.

Incorporer un délai d'attente dans un script Analytics

Les deux exemples créent un délai d'attente de 30 secondes :

EXECUTE "TIMEOUT /t 30"
EXECUTE "cmd /c PING -n 31 127,0,0,1 > nul"

Utiliser EXECUTE pour exécuter des tâches utiles

La commande EXECUTE vous permet d'exécuter des commandes Windows et DOS depuis la ligne de commande d'Analytics ou à partir d'un script Analytics.

Vous pouvez utiliser cette capacité pour augmenter l'automatisation des scripts Analytics en réalisant une variété de tâches utiles qui ne peuvent pas être réalisées en utilisant la syntaxe ACLScript seule.

Exemples de tâches pouvant être commencées à l'aide d'EXECUTE

Ouverture des autres programmes et applications et exécution des tâches requises par le script d'Analytics Paramètres de passage vers un fichier de lot Accès aux données à partir d'emplacements réseau Incorporation de listes de comptes Active Directory
Ouverture de n'importe quel fichier dans son application par défaut Exécuter des scripts Analytics dans d'autres projets Analytics Utilisation du FTP pour accéder aux données à partir d'emplacements distants Intégration avec VBScript
Exécution de tâches d'administration relatives aux fichiers et aux dossiers comme la copie, le déplacement, la création, la suppression ou la comparaison de fichiers ou de dossiers qui existent en dehors d'Analytics Incorporation de délais d'attente dans les scripts Analytics Compression ou décompression Zip de données Intégration avec des bases de données SQL
Exécuter des scripts externes ou des fichiers de commandes non-Analytics (.bat) Incorporation de la planification des tâches de Windows dans les scripts Analytics Chiffrement ou déchiffrement de données Ouverture de pages Web

Remarque

Les informations spécifiques concernant la manière d'effectuer ces tâches sortent du champ d'application de la documentation d'aide de Galvanize. Pour obtenir de l'aide, veuillez consulter la documentation du système d'exploitation Windows qui convient, ou toute autre documentation de tiers.

Mode par défaut et mode asynchrone

Vous pouvez exécuter la commande EXECUTE dans le mode par défaut ou dans le mode asynchrone :

  • Mode par défaut le processus commencé par la commande EXECUTE doit être terminé avant que le script Analytics puisse continuer.

    Analytics est inaccessible pendant l'exécution des processus externes.

  • Mode asynchrone le script Analytics continue de s'exécuter sans attendre la fin du processus lancé par la commande EXECUTE.

    Analytics reste accessible pendant l'exécution des processus externes.

    Si vous spécifiez ASYNC, la commande EXECUTE s'exécute en mode asynchrone.

Quel mode dois-je utiliser ?

Lorsque vous créez des scripts Analytics qui utilisent la commande EXECUTE vous devez prendre en compte le mode d'exécution le plus adapté.

Utiliser le mode par défaut Utiliser le mode asynchrone / ASYNC
  • tâches d'administration par fichier et par dossier
  • spécifier des périodes d'attente
  • toute tâche dont les tâches suivantes dépendent
  • l'exécution d'un script qui suit dépend du résultat dans la variable RETURN_CODE.
  • les tâches externes entraînent l'ouverture d'une interface d'application ou d'une boîte de dialogue contextuelle

Scripts Analytics s'exécutant sans assistance

Si vous souhaitez qu'un script Analytics contenant la commande EXECUTE s'exécute sans assistance, utilisez l'une des méthodes suivantes :

  • utiliser le mode asynchrone pour des tâches qui entraînent l'ouverture d'une interface d'application ou d'une boîte de dialogue contextuelle
  • éviter d'ouvrir des éléments de l'interface dans des scripts s'exécutant sans assistance

Remarque

Tant que les éléments de l'interface ne sont pas fermés, ils représentent des processus qui sont toujours en cours d'exécution. Si ces éléments d'interface sont ouverts avec EXECUTE dans le mode par défaut, ils évitent l'exécution des lignes suivantes dans un script Analytics et entraînent le blocage du script.

Commande EXECUTE dans les scripts d'outils d'analyse

Si vous souhaitez utiliser la commande EXECUTE dans les scripts d'outils d'analyse de Robots ou d'AX Serveur, vous devez observer une configuration spécifique pour permettre l'exécution de la commande. Pour plus d'informations, consultez :

Guillemets

La syntaxe de la commande Exécuter de Windows que vous utilisez avec la commande EXECUTE doit être entourée de guillemets simples ou doubles.

L'exemple ci-dessous utilise la commande MD de Windows pour créer un nouveau répertoire :

EXECUTE 'cmd /c md C:\Nouveau_Répertoire_Données'

Guillemets imbriqués

Si des chemins de fichiers dans la syntaxe de la commande Exécuter contiennent des espaces, alors les chemins de fichiers doivent également être entre guillemets.

Pour mettre des chemins entre guillemets, vous avez deux possibilités :

  • Guillemets doubles à l'intérieur de guillemets simples Entourez la chaîne de la commande d'exécution avec des guillemets simples et encadrez les chemins internes avec des guillemets doubles :
    EXECUTE 'cmd /c md "C:\Nouveau Répertoire Données"'

    Vous trouverez peut-être cette méthode plus facile à lire que la seconde méthode.

    Remarque

    L'inversion de l'ordre de l'imbrication – l'utilisation de guillemets doubles pour entourer la totalité de la chaîne, et de guillemets simples pour entourer les chemins de fichiers – ne fonctionne pas.

  • Deux guillemets doubles Entourez la chaîne de la commande d'exécution avec des guillemets doubles et encadrez les chemins internes avec deux guillemets doubles :
    EXECUTE "cmd /c md ""C:\Nouveau Répertoire Données"""

    Si vous utilisez cette deuxième méthode, les deux guillemets doubles utilisés en interne doivent être directement adjacents et il ne doit pas y avoir d'espace entre eux.

Commandes internes et externes

Les commandes Windows peuvent être internes ou externes.

  • Les commandes internes peuvent être exécutées à partir de l'invite de commande uniquement, ce qui signifie que vous devez ouvrir la session de commandes à l'aide de cmd /c ou de cmd /k avant d'indiquer la commande.
  • Les commandes externes peuvent être exécutées à partir de l'invite de commande ou directement à l'aide de la commande EXECUTE, ce qui signifie que l'ouverture de la session de commandes est une option, mais qu'elle n'est pas requise.

L'exemple ci-dessous utilise la commande Windows DIR interne (affichage du contenu d'un répertoire), et la commande Windows COMP externe (comparaison de deux fichiers), pour illustrer la différence :

EXECUTE 'cmd /k dir "C:\ACL DATA\Exemples de fichiers de données"' 
EXECUTE 'comp C:\Fichier_1.txt C:\Fichier_2.txt'

Vous pouvez éviter cette complication en créant des scripts externes ou des fichiers de lot pour contenir les commandes Windows, et en utilisant la commande EXECUTE uniquement pour démarrer le fichier de lot. Par exemple :

EXECUTE 'C:\Mon_Lot.bat'

Syntaxe de commande à exécution multi-lignes

La commande EXECUTE ne prend pas en charge la commande Exécuter multi-ligne. Pour intégrer des commandes Exécuter multi-lignes dans un script Analytics, utilisez l'une des méthodes suivantes :

Méthode Exemple
Répétez la commande EXECUTE pour chaque commande Exécuter. 
EXECUTE 'cmd /c md "C:\Nouveau Répertoire Données"' EXECUTE 'cmd /c copy C:\Fichier_1.txt "C:\Nouveau Répertoire Données"'
Combinez des commandes d'exécution avec &. 
EXECUTE 'cmd /c md "C:\Nouveau Répertoire Données" & copy C:\Fichier_1.txt "C:\Nouveau Répertoire Données"'
Créez un script externe ou un fichier de commandes qui contient des commandes d'exécution sur plusieurs lignes, puis utilisez la commande EXECUTE uniquement pour lancer le fichier de commandes. 
EXECUTE 'C:\Mon_Lot.bat'