Analytics et Robots

Robots est une application grâce à laquelle vous pouvez automatiser des tâches répétitives en utilisant les scripts intégrés dans Analytics. Lorsque vous avez créé les scripts, vous les chargez dans Robots, où vous configurez l'automatisation des tâches nécessaires. Robots traite les tâches récurrentes en fonction de votre configuration.

Pour des informations détaillées sur l'application Robots, consultez la rubrique Aide pour Robots.

Comment automatiser à l'aide de Robots ?

Pour automatiser des tâches répétitives avec Robots, dans Analytics, vous devez d'abord créer un projet contenant au moins un script d'outil d'analyse. Un script d'outil d'analyse correspond à un script Analytics qui utilise un en-tête d'outil d'analyse pour déclarer certaines propriétés et instructions afin d'exécuter le script.

Pour obtenir plus d'informations sur les scripts d'outil d'analyse et sur les en-têtes d'outil d'analyse, consultez la rubrique Scripts d'outil d'analyse.

Transmission de scripts et création d'un robot

Une fois que vous avez rédigé le ou les scripts d'outils d'analyse, vous les chargez dans Robots. Le chargement des scripts d'Analytics vers Robots s'appelle la transmission de scripts. Lorsque des scripts sont transmis pour la première fois, un robot est créé dans l'application Robots. Un robot est un conteneur contenant les scripts d'outils d'analyse transmis, tous les scripts d'aide et les fichiers qui y sont associés. Le robot est l'objet que vous configurez pour exécuter des tâches planifiées et automatisées.

Mode développement et production

Les scripts sont transmis dans Robots en mode Développement uniquement, jamais en mode production. Cette conception protège les scripts de production, qui sont complètement séparés du mode Développement.

Une fois que vous avez transmis la version définitive d'un ou de plusieurs scripts en mode Développement, vous devez activer explicitement la version en production.

Autre méthode

Dans Robots, vous pouvez créer un robot vide, puis transmettre des scripts d'Analytics vers le robot vide. Que vous créiez manuellement le robot dans Robots ou que vous le créiez automatiquement lorsque vous transmettez des scripts pour la première fois, le résultat est le même.

Un flux d'activités 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 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, Robots s'assure que vous ne perdez aucune partie de votre travail de rédaction de scripts et vous pouvez ainsi revenir aisément, si nécessaire, à des versions plus anciennes.

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. Vous ne pouvez pas transmettre les scripts d'un projet de manière sélective.

Exemple de versions de scripts

Scénario

Vous souhaitez automatiser un ensemble de tests d'outils 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, qui effectue certaines tâches préliminaires de préparation des données, puis qui effectue tous les tests analytiques.
  • Vous transmettez le script à Robots, où vous l'exécutez en mode Développement par rapport à une copie des données réelles pour vous assurer qu'il fonctionne correctement.
  • Une fois que le script fonctionne correctement, vous allez le planifier pour qu'il s'exécute automatiquement en production 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.
  • Test 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.
  • Test 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 le nettoyage de données supplémentaire. Vous n'apportez aucune modification aux scripts 2 et 4.
  • Transmettre Vous validez les scripts dans le projet.
  • Test 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 du bon fonctionnement des trois scripts et de l'ensemble du processus. Vous activez la version 3 des scripts pour une utilisation en 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. Téléchargez 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 dans 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, il est généralement sûr 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.

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 de planification 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. 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.

Transmission des scripts aux Robots

Plusieurs possibilités existent lorsque vous transmettez des scripts à Robots.

La façon la plus simple de comprendre ces différentes possibilités est de considérer un projet Analytics et un robot comme deux conteneurs, contenant des scripts, pouvant être associés. Une fois qu'ils sont associés, vous pouvez transmettre des versions successives des scripts du projet au robot.

Remarque

Lorsque vous transmettez des scripts à Robots, tous les scripts du projet Analytics sont transmis et deviennent ensemble « une version » dans le robot associé. Vous ne pouvez pas transmettre les scripts d'un projet de manière sélective.

Pour transmettre des scripts à Robots, vous devez être affecté au rôle approprié dans l'application Robots. Pour plus d'informations, consultez la rubrique Aide de Robots.

Action Résultat à la transmission
Transmettre des scripts à un nouveau robot

Un nouveau robot contenant la version 1 des scripts transmis est créé.

Transmettre des scripts à un robot existant

Le robot existant contient les scripts transmis, dont le numéro de version dépend du fait que le robot contienne déjà des scripts ou non.

Transmettre des scripts modifiés

Une nouvelle version des scripts est transmise au robot associé au projet.

Transmettre des scripts à un autre robot

Les scripts sont transmis soit à un robot récemment créé, soit à un robot existant.

L'association entre le projet et le robot précédent est supprimée.

Transmettre des scripts à un nouveau robot

Transmettez des scripts à Robots pour la première fois afin de créer un nouveau robot qui contient des scripts transmis.

Transmettre des scripts à un robot existant

Transmettez des scripts à un robot qui existe déjà pour renseigner le robot. Le robot existant peut déjà contenir des scripts ou il peut être vide.

Remarque

Utilisez cette méthode si le projet n'est pas encore associé à un robot. Si le projet est déjà associé à un robot, consultez la rubrique Transmettre des scripts à un autre robot.

Transmettre des scripts modifiés

Transmettez des scripts modifiés pour créer une nouvelle version des scripts dans le robot associé.

Deux méthodes existent pour modifier des scripts avant de le transmettre. Vous pouvez modifier les scripts dans le projet associé ou vous pouvez télécharger les scripts depuis Robots vers un nouveau projet Analytics, puis les modifier dans le nouveau projet.

Transmettre des scripts à un autre robot

Transmettez des scripts à un robot différent pour ajouter une version des scripts au robot et pour changer le robot associé au projet. Les scripts peuvent être modifiés ou non.

Deux possibilités existent lorsque vous transmettez des scripts à un robot différent :

  • transmettre des scripts à un nouveau robot ;
  • transmettre des scripts à un robot existant.

Voir des tables, des journaux et des fichiers Robots

À partir de Robots, vous pouvez télécharger des tables ou des journaux Analytics, ou des fichiers non Analytics, et les visualiser sur votre ordinateur local. Il existe différntes options en fonction du type de table ou de fichier.

Type de table ou de fichier Téléchargement dans le package Résultats ou le projet Analytics Téléchargement individuel Vue dans Robots
Tables de résultat Analytics
Tables de données Analytics
Journal de résultat Analytics
Fichiers de résultat non-Analytics
Fichier lié non-Analytics

Voir une table dans Analytics

Le contenu du package de résultat téléchargé ou d'un projet Analytics, et la manière dont vous visualisez les tables Analytics téléchargées dépendent de l'édition d'Agent Robots que vous utilisez.

Pour plus d'informations sur l'Agent Robots, consultez la rubrique Aide pour Robots.

Type d'agent Télécharger et voir les détails
Agent Robots sur site
  • Télécharger Le package téléchargé ou le projet contient uniquement le format de table. Les données de table demeurent dans le réseau de votre organisation mais pouvez utiliser les données pour analyse dans Analytics.
  • Voir Un profil de serveur vous permet de vous connecter d'Analytics aux données de la table dans l'agent Robots de votre organisation.
  • Tables prises en charge Tables de résultat Analytics et tables de données Analytics.
Agent Robots basé dans le cloud
  • Télécharger Le package de téléchargement ou le projet contient le format de table et les données de table.
  • Voir Vous accédez aux données de table en local via Analytics uniquement.
  • Tables prises en charge Tables de résultat Analytics uniquement.

Télécharger les résultats des tâches

Les résultats de la tâche peuvent inclure des tables de résultats Analytics, d'autres types de fichiers et un fichier journal.

Les résultats de la tâche sont spécifiés à l'aide de la balise d'analyse //RESULT. Pour plus d'informations, consultez la section RESULT.

  1. Dans le tableau de bord Robots, cliquez sur le robot qui contient les résultats.
  2. Dans le coin supérieur droit du robot, utilisez le bouton Mode Dév pour choisir l'environnement à utiliser.
  3. Sélectionnez l'onglet Exécutions de tâche.
  4. Sélectionnez l'exécution de tâche avec les résultats à télécharger.
  5. Dans le panneau Détails de l'exécution de la tâche, effectuez l'une des actions suivantes :
    Téléchargez un fichier de résultats individuellement

    Cliquez sur Télécharger à côté d'un fichier de résultat non Analytics ou d'un fichier journal Analytics.

    Résultat Le fichier est téléchargé sur votre système de fichiers local et peut être ouvert dans son application native. Un fichier journal Analytics peut être ouvert dans n'importe quel éditeur de texte. Vous pouvez aussi cliquer sur Voir à côté du nom d'un fichier journal pour afficher directement le journal.

    Télécharger tous les fichiers de résultats dans un package

    Cliquez sur Télécharger le package obtenu.

    Résultat Un fichier compressé nommé <nom_robot>.zip, qui inclut un projet Analytics, est téléchargé sur votre système de fichiers local.

    Vous pouvez ouvrir le contenu du fichier compressé, ouvrir le projet Analytics dans Analytics et afficher les tables de résultats Analytics. Vous pouvez ouvrir tous les autres types de fichiers de résultats, comme des fichiers Excel, dans leurs applications natives.

    Si l'exécution de la tâche a échoué, cliquez sur Télécharger le package ayant échoué pour télécharger le fichier journal. Vous pouvez aussi cliquer sur Voir à côté du nom du fichier journal pour afficher directement le journal. Le fichier journal peut vous aider à identifier la raison pour laquelle la tâche a échoué.

Télécharger une table de données Analytics

Remarque

Les tables de données Analytics ne sont pas prises en charge par l'Agent Robots Cloud.

Les tables de données sont spécifiées à l'aide de la balise d'analyse //DATA. Pour obtenir plus d'informations, consultez la rubrique DATA.

  1. Dans le tableau de bord Robots, cliquez sur le robot qui contient la ou les tables de données.
  2. Dans le coin supérieur droit du robot, utilisez le bouton Mode Dév pour choisir l'environnement à utiliser.
  3. Sélectionnez l'onglet Entrée/Sortie.
  4. Dans la liste Autres tables ou Tables source, sélectionnez la table de données à télécharger.
  5. Dans le panneau Détails de la table, cliquez sur Afficher la table dans AN.

    Astuce

    Pour supprimer la table, cliquez sur Supprimer la table > Supprimer.

    Résultat Un projet Analytics nommé <nom_robot>.acl est téléchargé sur votre système de fichiers local. Le projet contient toutes les tables de données de l'onglet Entrée/Sortie et pas seulement la table que vous avez sélectionnée.

    Vous pouvez ouvrir le projet dans Analytics et afficher la table de données.

Ouvrir une table Analytics téléchargée (Agent Robots local)

Avant de commencer

Pour créer une connexion aux données d'un agent Robots, vous devez avoir un profil de serveur configuré dans Analytics.

Ouvrez la table

Remarque

Pour ouvrir une table Robots dans Analytics, l'option Activer l'intégration de serveur doit être sélectionnée (Outils > Options > Interface).

Pour vous connecter à l'Agent Robots, l'édition d'Analytics (Unicode ou non-Unicode) doit correspondre à l'édition de l'agent.

  1. Accédez au projet Analytics (*.acl) téléchargé ou décompressé, puis double-cliquez dessus.

    Le projet s'ouvre dans Analytics.

  2. Double-cliquez sur une table Robots pour l'ouvrir.
  3. Saisissez votre mot de passe réseau, puis cliquez sur OK.

Astuce

Si vous ne pouvez pas vous connecter à l'Agent Robots, supprimez le RobotsProfile et fermez, puis rouvrez le projet Analytics afin de créer automatiquement un profil rafraîchi. Pour supprimer le RobotsProfile, dans le menu principal Analytics, allez dans Serveur > Profils de serveur.

Ouvrir une table Analytics téléchargée (Agent Robots Cloud)

  1. Accédez au projet Analytics (*.acl) décompressé et double-cliquez dessus.

    Le projet s'ouvre dans Analytics.

  2. Double-cliquez sur une table pour l'ouvrir.
Aide d'Analytics 14.1