L'Éditeur de script Analytics inclut plusieurs fonctionnalités vous aidant à tester ou à déboguer des scripts Analytics :

  • Exécuter des scripts à partir de la position du curseur dans un script
  • Définir des points d'arrêt pour interrompre l'exécution d'un script sur une ligne spécifique
  • Suivre les scripts en exécutant une ligne à la fois
  • Isoler les erreurs de script
  • Dans l'onglet Variables associé, suivre la création des variables et l'affectation des valeurs aux variables en temps réel

Ces fonctionnalités sont disponibles à chaque fois qu'un script est ouvert dans l'Éditeur de script. Si le script ouvert appelle un ou plusieurs indices, ces derniers s'ouvrent automatiquement dès leur appel.

Pendant que le script s'exécute en mode d'étape ou en mode du point d'arrêt, il est en lecture seule et la plupart des autres fonctionnalités d'Analytics sont désactivées, y compris la ligne de commande. Si une erreur de script se produit, le script devient modifiable, ce qui vous permet de corriger l'erreur.

Lorsque vous exécutez un script, peu importe comment, tous les scripts ouverts sont enregistrés automatiquement.

Remarque

Si une table reste ouverte à la fin de l'exécution ou du suivi du script par étape, la zone d'affichage Analytics bascule automatiquement de l'Éditeur de script vers l'affichage de la table ouverte dans l'onglet Vue. Pour que l'Éditeur de script reste affiché en continu pendant le test ou le débogage de scripts, vous pouvez ajouter temporairement la commande CLOSE à la fin du script.

Si vous ne souhaitez pas exécuter ou suivre un script à partir du début du script, vous pouvez placer le curseur sur la ligne sur laquelle vous souhaitez démarrer l'exécution du script et cliquer sur le bouton droit de la souris, puis sélectionner Exécuter à partir du curseur ou Pas à partir du curseur. L'exécution de scripts ou le suivi de scripts à partir du curseur vous permet de tester des parties spécifiques d'un script et d'éviter de perdre du temps ainsi que de l'énergie à exécuter inutilement des scripts entiers.

Il est impossible d'utiliser Exécuter à partir du curseur ou Pas à partir du curseur une fois que le script s'exécute. Vous pouvez uniquement utiliser ces options pour lancer l'exécution d'un script ou redémarrer un script après avoir détecté ou corrigé une erreur de script.

Remarque

Si vous utilisez l'exécution du script à partir du curseur pour ignorer une section du script contenant des opérations préalablement requises par une section ultérieure du script, il est peu probable que cette dernière s'exécute correctement.

Dans un script Analytics, vous pouvez définir un ou plusieurs points d'arrêt pour interrompre son exécution sur une ligne spécifique. Les points d'arrêt vous permettent de tester une partie d'un script sans devoir exécuter l'intégralité du script. Ils vous permettent aussi d'examiner l'état d'un projet Analytics à un endroit précis d'un script. Les points d'arrêt peuvent s'avérer utiles lorsque vous développez et testez des parties plus complexes ou plus critiques des scripts.

Redémarrage d'un script à partir d'un point d'arrêt

Lorsque vous redémarrez un script à partir d'un point d'arrêt, les possibilités suivantes s'offrent à vous :

  • suivre le script par étape à partir du point d'arrêt
  • exécuter le script jusqu'au point d'arrêt suivant, si vous en avez inséré un
  • exécuter le script jusqu'à la fin
  • quitter le script

Lignes vides et commentaires

Si vous placez un point d'arrêt sur une ligne vide ou sur une ligne de commentaire, le script s'interrompt à la première ligne du script suivant la ou les lignes vides ou bien suivant le commentaire.

Persistance des points d'arrêt

  • Les points d'arrêt persistent dans un script même si vous le fermez.
  • À tout moment, vous pouvez supprimer tous les points d'arrêt de tous les scripts d'un projet Analytics en cliquant avec le bouton droit de la souris dans l'Éditeur de script et en sélectionnant Effacer tous les points d'arrêt.
  • Tous les points d'arrêt sont automatiquement supprimés de l'ensemble des scripts d'un projet lorsque vous fermez Analytics.

Étapes

Vous pouvez suivre un script Analytics étape par étape en exécutant une ligne à la fois Suivre un script par étape vous permet de tester l'exécution d'un script de façon contrôlée et de détecter toutes ses éventuelles erreurs exactement à la ligne où elles se produisent.

La flèche d'étape

Flèche verte À mesure que vous suivez un script par étape, la flèche d'étape verte précède la ligne du script sur le point d'être exécutée. Lorsque la flèche avance d'un pas au-delà de la ligne, c'est que la ligne a été exécutée.

Flèche rouge Si la ligne contient une syntaxe de commande incorrecte ou tout autre type d'erreur, le script s'arrête et la flèche d'étape devient rouge et n'avance plus, en surlignant l'emplacement de l'erreur. Le script est en lecture seule lorsque vous le suivez, mais si une erreur se produit, le script devient modifiable, ce qui vous permet de corriger l'erreur.

Étapes

Chaque fois que vous exécutez un script dans Analytics qui détecte une erreur entraînant l'échec du script, la ligne à laquelle l'erreur se produit est surlignée automatiquement dans l'Éditeur de script. Si l'Éditeur de script n'est pas ouvert, il s'ouvre automatiquement. Cette identification des erreurs de script se produit que vous exécutiez un script directement dans l'Éditeur de script, à partir du menu Outils, à partir de la ligne de commande ou en cliquant avec le bouton droit de la souris sur un script dans le Navigateur.

Cette identification automatique des erreurs est une fonctionnalité de dépannage puissante, notamment pour les erreurs se produisant loin dans les indices imbriqués. Les utilisateurs d'Analytics dotés de la fonctionnalité de création de scripts peuvent corriger les erreurs dès leur détection. Les utilisateurs qui ne sont pas familiarisés avec la création de scripts peuvent enregistrer le nom du script et le numéro de ligne où l'erreur s'est produite, ce qui facilite l'obtention d'une assistance relative aux problèmes de script.

L'onglet Variables, dans le Navigateur, vous permet de suivre la création des variables et l'affectation des valeurs aux variables en temps réel. L'onglet affiche les noms, les valeurs et les catégories des données de toutes les variables dans le projet Analytics. Les noms sont indiqués par ordre alphabétique.

Si vous suivez un script par étape, au moment de leur création, les variables définies par l'utilisateur ou générées par le système dans le script apparaissent dans l'onglet Variables ou bien leur valeur est mise à jour si elles existent déjà. Pouvoir observer exactement les changements se produisant avec les variables des scripts, et ce, au fur et à mesure, est un outil de diagnostic important vous permettant de repérer les erreurs de script qui pourraient être difficiles à localiser par le seul examen de la syntaxe du script.

Si vous exécutez un script, toutes les modifications associées aux variables s'affichent lorsqu'un point d'arrêt est atteint ou lorsqu'un script se termine.

Vous ne pouvez pas suivre par étape le contenu des commandes multilignes comme GROUP, LOOP, ou DEFINE FIELD . . . COMPUTED. Si vous exécutez un script en mode d'étape et que vous détectez une commande multiligne, c'est l'intégralité du contenu de la commande qui est exécutée et la flèche d'étape est placée sur la ligne suivant immédiatement la commande multiligne.

Les points d'arrêt ne sont pas reconnus à l'intérieur de commandes multilignes. Si vous définissez un point d'arrêt à l'intérieur d'une commande multiligne, le script est interrompu sur la ligne suivant immédiatement la commande multiligne.

Astuce

Il se peut que vous puissiez tester des parties du contenu d'une commande multiligne en copiant le contenu, sans la syntaxe de la commande qui l'entoure, dans un script distinct.

Si vous testez un script d'outil d'analyse en l'exécutant dans Analytics et que le script contient une balise PASSWORD dans l'en-tête d'outil d'analyse, Analytics génère automatiquement une commande PASSWORD et vous invite à saisir le mot de passe approprié. Cette commande générée automatiquement vous permet d'éviter le travail d'insertion d'une commande PASSWORD dans la partie script du script d'outil d'analyse à des fins de test, puis de devoir la supprimer à nouveau avant de charger le script d'outil d'analyse sur Robots ou AX Serveur. La commande PASSWORD générée automatiquement est enregistrée dans la trace, sans la valeur du mot de passe.

La valeur du mot de passe n'est pas enregistrée lorsque vous exécutez le script d'outil d'analyse dans Analytics. Vous devez donc spécifiez le mot de passe à chaque fois que vous exécutez le script d'outil d'analyse, y compris lors de l'exécution ou de l'exécution pas à pas du script à partir de la position du curseur.

Un script d'analyse est un script ordinaire comportant un en-tête d'outil d'analyse lui permettant de s'exécuter dans l'application Robots sur la plateforme HighBond ou dans Analytics Exchange. Vous pouvez aussi exécuter des scripts d'outil d'analyse dans la fenêtre App Analyse, un composant amovible d'Analytics.