Flux de travail de développement de script ACL dans Analytics et dans Robots

La création de script d'outil d'analyse (script ACL) se déroule dans l'application Analytics. Vous créez des scripts d'outil d'analyse dans Analytics, et, comme requis, vous les mettez à jour dans Analytics.

Lorsque vous êtes prêt à télécharger les scripts d'outil d'analyse d'Analytics dans l'application Robots, vous transmettez les scripts à un robot ACL spécifique. Pour des informations détaillées, consultez la section Transmettre (charger) des scripts ACL vers Robots.

Lorsque vous transmettez des scripts, une nouvelle version des scripts est ajoutée au robot ACL et la version est accessible en mode développement. La nouvelle version contient le contenu exact des scripts que vous transmettez. La version est autonome et ne fusionne pas avec une version précédente des scripts. Si vous avez supprimé un script dans Analytics, il n'est plus disponible dans la nouvelle version des scripts dans Robots.

Lorsque vous estimez que la version d'un script fonctionne correctement en mode développement, vous pouvez l'activer pour l'utiliser en mode production.

Un flux de travail itératif

Vous pouvez modifier un ou plusieurs scripts et les transmettre à nouveau dans Robots. Chaque fois que vous transmettez à nouveau des scripts, vous créez une version des scripts. Vous pouvez utiliser l'une ou l'autre de ces deux méthodes pour modifier et transmettre à nouveau des scripts :

Modifier un ou plusieurs scripts existants dans un projet Analytics associé à un robot et transmettre à nouveau les scripts.
Télécharger des scripts d'un robot vers Analytics, modifier un ou plusieurs scripts, et transmettre les scripts.

Fonctionnement des versions de script

La numérotation des versions s'effectue de manière séquentielle.
Chaque fois que vous transmettez un ou plusieurs scripts au même robot, vous créez une nouvelle version des scripts, numérotée consécutivement : version 1, version 2, etc.

En enregistrant les versions successives des scripts, l'application Robots s'assure que vous ne perdez aucune partie de votre travail de rédaction de scripts et vous permet ainsi de revenir facilement à des versions antérieures, si nécessaire.
Les versions sont autonomes
Chaque version transmise est complètement autonome. Les versions antérieures des scripts ne sont jamais écrasées et les scripts ne sont jamais fusionnés entre les versions.

Si vous retirez un script d'un projet, toutes les versions ultérieures que vous transmettez ne contiennent pas le script.
Les versions contiennent tous les scripts
Une version contient tous les scripts qui figurent dans un projet lorsque vous transmettez les scripts à Robots : tous les scripts d'analyse des données et les éventuels scripts auxiliaires. Vous ne pouvez pas transmettre les scripts d'un projet de manière sélective.
Les changements de version sont enregistrés
Sous l'onglet Versions du script du mode développement, vous pouvez sélectionner une version du script pour voir les noms et les catégories de chaque script de la version. Le nom des scripts nouvellement ajoutés, supprimés ou modifiés apparaît en surbrillance.

Exemple de versions de scripts

Scénario

Vous souhaitez automatiser un ensemble de tests d'analyse que votre service effectue actuellement à la main sur le fichier de paie bimensuel. Ces tests permettent de vérifier que les employés sont payés correctement, que les prélèvements salariaux appropriés sont effectués, qu'aucun employé fictif n'est payé, etc.

Le flux de développement des scripts

Dans Analytics, vous développez un script qui importe le fichier de paie, effectue certaines tâches préliminaires de préparation des données, puis réalise tous les tests analytiques.
Vous transmettez le script à Robots, où vous l'exécutez en mode développement sur une copie des données réelles pour vous assurer qu'il fonctionne correctement.
Une fois que le script fonctionne correctement, vous l'activez pour qu'il soit utilisé en production et le planifiez pour qu'il s'exécute automatiquement toutes les deux semaines.

Analytics	Action/Résultat	Robots
Transmettre les scripts >>	Transmettre Vous transmettez le script 1, qui importe, prépare et analyse les données de paie bimensuelles. Tester Vous testez le script 1 en mode développement Robots ; il semble fonctionner correctement. Problème Vous vous apercevez que le script 1 contient tellement de fonctionnalités qu'il pourrait poser des difficultés de compréhension ou de modification pour un autre utilisateur.	>> Version 1
Transmettre les scripts >>	Modifier Vous divisez le script 1 en trois scripts distincts (2, 3, 4) : un pour chacune des phases d'importation, de préparation et d'analyse. Vous supprimez le script 1. Transmettre Vous validez les scripts dans le projet. Tester Vous testez les trois scripts et vous vous rendez compte que certains résultats qui devraient se trouver dans la sortie n'y figurent pas. Problème Le nettoyage des données effectué par le script 3 n'est pas assez complet et vous perdez des résultats.	>> Version 2
Transmettre les scripts >>	Modifier Dans le script 3, vous utilisez des fonctions Analytics pour créer des champs calculés qui effectuent un nettoyage de données supplémentaire. Vous n'apportez aucune modification aux scripts 2 et 4. Transmettre Vous validez les scripts dans le projet. Tester Vous testez les trois scripts et tous les résultats qui devraient figurer dans la sortie sont désormais inclus. Réussite Vous êtes satisfait(e) du bon fonctionnement des trois scripts et de l'ensemble du processus. Vous activez la version 3 des scripts pour une utilisation en mode production.	>> Version 3
script modifié script non modifié

Meilleures pratiques lors de l'édition et de la transmission des scripts

Traitez les scripts dans Robots comme les versions de base.

Une fois que les scripts sont transmis à Robots, ils sont protégés de toute modification. Une des meilleures pratiques recommande de traiter les scripts dans Robots comme des versions de base. Si vous voulez modifier les scripts, vous devez commencer par télécharger les scripts de Robots plutôt que d'utiliser des copies sauvegardées en local.

Vous n'êtes pas limité(e) au téléchargement de la version la plus récente des scripts sur Robots. Vous pouvez télécharger la version des scripts que vous voulez utiliser.

Risque de commencer à utiliser une version locale

Le risque de commencer votre modification avec une version locale des scripts réside dans le fait qu'il est possible que la copie ne corresponde à la version disponible dans Robots :

Vous pouvez avoir modifié par inadvertance la copie locale ou oublié que vous l'avez modifiée.
Une autre personne peut avoir transmis une version des scripts à Robots après votre dernière transmission des scripts

Quand est-il sûr d'ignorer le téléchargement ?

Après le téléchargement d'une version du script, le fait de transmettre des versions itératives du script directement depuis le projet Analytics, sans téléchargement entre les itérations, lors d'une seule session d'écriture de script, ne présente généralement aucun danger.

S'il est possible qu'une autre personne travaille sur les scripts en même temps que vous, procédez alors au téléchargement entre les itérations. Nous conseillons qu'une seule personne à la fois travaille sur une version du script.

Tester les scripts modifiés qui font partie des tâches planifiées

Vous devez toujours tester un ou des scripts modifiés qui font partie d'une tâche planifiée dans Robots afin d'être sûr que les modifications n'ont pas rompu la tâche.

Par exemple, apporter une des modifications suivantes à un en-tête d'outil d'analyse dans un script peut rompre la tâche impliquant alors sa recréation :

ajout ou suppression d'un paramètre d'entrée ;
ajout ou suppression d'un champ, d'une table ou d'un fichier d'entrée ;
modification d'un nom de champ, de table ou de fichier d'entrée codé en dur.

Validation de la syntaxe

Chaque fois que vous transmettez des scripts à Robots, Analytics effectue automatiquement deux types de validation ou de vérification syntaxique :

Validation de l'en-tête d'outil d'analyse
Vérification de la syntaxe des scripts

Si un script échoue à la validation ou au contrôle, les scripts ne sont pas transmis, et un message apparaît en identifiant l'emplacement du problème.

Validation de l'en-tête d'outil d'analyse

L'en-tête d'outil d'analyse d'un script doit respecter certaines conditions. S'il n'est pas conforme à ces exigences, le script d'outil d'analyse échoue lors de son exécution.

La validation de l'en-tête d'outil d'analyse ne peut pas être désactivée.

Pour plus d'informations, consultez la rubrique Utilisation des en-têtes des outils d'analyse.

Vérification de la syntaxe des scripts

Certains éléments des scripts d'analyse, tels que les commandes d'interaction utilisateur lors de l'exécution et les chemins de fichier absolus, ne sont pas pris en charge ni recommandés.

La vérification de la syntaxe des scripts est activée par défaut. Si vous voulez la désactiver, sélectionnez Désactiver la vérification de la syntaxe des scripts avant de transmettre des scripts dans la boîte de dialogue Options (Outils > Options > Interface).

Pour plus d'informations, consultez la rubrique Bonnes pratiques en matière de développement d'analyses.