Exportation de données vers l’application Robots dans Diligent One

Si vous utilisez l’application Robots dans Diligent One, vous pouvez exporter (charger) les données d’une table Analytics locale vers un fichier CSV compressé (*.csv.gz) dans Robots. Vous pouvez exporter vers l’onglet Données de travail dans un robot HighBond ou un robot de flux de travail, où vous pouvez utiliser la création de scripts Python/HCL pour analyser ou traiter les données. Vous ne pouvez pas exporter vers un robot ACL.

Pour les organisations qui utilisent des scripts ACL et un agent Robots sur site, cette fonctionnalité vous permet de créer des flux d’automatisation des données ACLScript-Python/HCL intégrés qui déplacent les données de votre réseau local vers votre instance Robots basée dans le cloud.

Pour plus d’informations sur la manière d’accéder au fichier CSV compressé après l’avoir exporté vers Robots, voir la méthode load_working_file(). Pour un aperçu de l’application Robots, voir Automatisation du travail avec Robots.

Automatiser le processus avec un script ou un export manuel

Vous pouvez programmer le processus d’exportation des données Analytics locales vers Robots. Vous pouvez également exporter manuellement les données à l’aide de l’interface utilisateur Analytics.

• Option 1 Télécharger (transmettre) un script vers un robot ACL dans Robots et exécuter le script à l’aide de votre agent Robots sur site.ACL robotRobotsRobots Agent

• Option 2 Exécuter un script en local dans Analytics.Analytics

• Option 3 Exporter manuellement les données à l’aide de l’interface utilisateur Analytics. Vous utilisez la procédure standard pour l’exportation manuelle de données à partir d’Analytics, à quelques petites différences près.

Pour plus d'informations sur l'automatisation du processus avec un script, consultez la rubrique Commande EXPORT.

Exigences de sécurité

Pour pouvoir télécharger un fichier CSV compressé vers l'application Robots, vous devez être doté d'un rôle Robots spécifique ou de privilèges d'administration :

• Les utilisateurs dotés d'un rôle Éditeur ou Propriétaire peuvent télécharger un fichier CSV compressé vers le robot. Les utilisateurs dotés du rôle Examinateur ne le peuvent pas.

• Les administrateurs de Robots sont automatiquement désignés comme collaborateurs pour chaque robot, avec le rôle Propriétaire.

• Un administrateur système de Diligent One qui dispose d'un abonnement professionnel est automatiquement un administrateur de Robots.

Pour plus d'informations, consultez la rubrique Permissions de l'application Robots.

Exporter manuellement des données vers Robots

Indiquer les champs à exporter

1. Ouvrez la table avec les données que vous souhaitez exporter.

2. Sélectionnez Données > Exporter.

3. Dans l'onglet Principal, sélectionnez l'une des opérations suivantes :

   • Le paramètre Champs spécifie les champs que vous souhaitez exporter

     Lorsque vous sélectionnez cette option, les champs sont exportés à l’aide des noms de champ physique dans le format de table.

     Pour plus d’informations sur les champs renommés, consultez la rubrique Renommer un champ dans un format de table.

   • L’option Vue va exporter tous les champs de la vue active

     Lorsque vous sélectionnez cette option, les champs sont exportés à l’aide des noms d’affichage des colonnes. Les champs sont exportés dans le même ordre que celui dans lequel ils apparaissent dans la vue.

     Pour plus d’informations sur les champs renommées, consultez la rubrique Renommer les colonnes d'une vue.

4. Si vous avez choisi Champs, effectuez l'une des opérations suivantes :

   • Sélectionnez les champs à exporter dans la liste Exporter les champs.

     Astuce

     Vous pouvez appuyer sur Ctrl tout en cliquant pour sélectionner plusieurs champs non adjacents et sur Maj tout en cliquant pour sélectionner plusieurs champs adjacents.

   • Cliquez sur Exporter les champs pour sélectionner les champs ou créer une expression.

   Remarque

   Les champs sont exportés dans l’ordre dans lequel vous les indiquez.

Sélectionner les options d'exportation

1. Dans la liste déroulante Exporter en tant que, sélectionnez Robots.

2. Facultatif. Sélectionnez Écraser si vous voulez remplacer un fichier existant portant le même nom dans le robot de destination.

   Remarque

   L’ajout de données à un fichier *.csv.gz existant n’est pas pris en charge. Si un fichier portant le même nom existe déjà dans le robot de destination, l’exportation échoue avec une erreur si Écraser n’est pas sélectionné.

Finaliser l'export

1. Si vous souhaitez exclure du traitement certains enregistrements de la vue en cours, saisissez une condition dans la zone de texte Si, ou cliquez sur Si pour créer une instruction IF à l'aide du Générateur d'expression.

   Remarque

   La condition Si est évaluée uniquement par rapport aux enregistrements restant dans une table après application des options relevant du champ d'application (Premiers, Suivants, Tant que).

   L'instruction IF prend en compte tous les enregistrements de la vue et exclue ceux qui ne correspondent pas à la condition spécifiée.

2. Cliquez sur À et, dans la boîte de dialogue Sélectionner la destination, accédez au bon robot.

   Les robots sont classés par ordre alphabétique, en commençant par les robots HighBond, suivis des robots de flux de travail.

3. Sélectionnez le robot.

   Lorsque vous sélectionnez un robot, une notification sous la liste des robots indique le type de robot.

4. Sous Environnement, sélectionnez soit Développement, soit Production pour indiquer le mode de robot dans lequel le fichier est exporté.

5. Cliquez sur OK.

   La boîte de dialogue Exporter s’affiche de nouveau et l’URL d’API HighBond pour le robot de destination est préremplie dans la zone de texte Vers.

6. Cliquez sur l'onglet Plus.

7. Dans le panneau Étendue, sélectionnez l'option appropriée :

   • Toutes
   • Premiers
   • Suivants
   • Instruction WHILE
   En savoir plus

   Option d'étendue	Détails
   Toutes	(Par défaut) Indique que tous les enregistrements de la vue sont traités.
   Premiers	Entrez un numéro dans la zone de texte. Commence le traitement au niveau du premier enregistrement de la vue et inclut uniquement le nombre d'enregistrements indiqué.
   Suivants	Entrez un numéro dans la zone de texte. Commence le traitement au niveau de l'enregistrement actuellement sélectionné de la vue et inclut uniquement le nombre d'enregistrements indiqué. Vous devez sélectionner le nombre d'enregistrements réel dans la colonne la plus à gauche de la vue, et non pas les données dans la ligne.
   Instruction WHILE	Utilisez une instruction WHILE pour limiter le traitement des enregistrements de la vue à un critère spécifique ou à un ensemble de critères. Saisissez une condition dans la zone de texte Tant que ou cliquez sur Tant que pour créer une instruction WHILE en utilisant le générateur d'expression. Une instruction WHILE permet de traiter les enregistrements de la vue uniquement tant que la condition indiquée est vraie. Dès que la condition est fausse, le traitement s'arrête et aucun autre enregistrement n'est pris en compte. Vous pouvez utiliser l'option Tant que en conjonction avec les options Tous, Premiers ou Suivants. Le traitement des enregistrements s'arrête dès qu'une limite est atteinte.

   Remarque

   Les options Premiers et Suivants font référence soit à l'ordre physique soit à l'ordre d'indexation des enregistrements d'une table. Les options Premiers ou Suivants ignorent tout filtrage ou tri express appliqué à une vue de table. Toutefois, les résultats de sortie des opérations analytiques tiennent compte de tous les filtres appliqués.

   Si un tri express est appliqué à une vue, l'option Suivant se comporte comme l'option Premier.

8. Cliquez sur OK.

   Un indicateur d’avancement s’affiche pendant l’exportation des données vers Robots. Lorsque l'opération d'exportation est terminée, le système crée une entrée dans le journal.

   Si les données ont été correctement exportées, un fichier portant le nom <nom de table Analytics>.csv.gz apparaît dans l’onglet Données de travail dans le robot de destination.

Obligation de mot de passe

Mot de passe obligatoire

Vous devez indiquer un mot de passe pour exporter vers Robots dans les situations suivantes :

• vous utilisez un script pour exporter vers Robots, et vous l'exécutez dans Robots

• vous avez utilisé l'activation hors ligne pour activer votre copie d'Analytics

La valeur du mot de passe obligatoire est un jeton d’accès à Diligent One.

Mot de passe non obligatoire

Il est inutile d'indiquer un mot de passe pour exporter vers Robots si vous avez utilisé l'activation en ligne pour activer votre copie d'Analytics. Le mot de passe est créé et envoyé automatiquement à Robots en fonction des informations d'activation stockées sur votre ordinateur.

Obtenir un jeton d’accès Diligent One

Utilisez un jeton d'accès existant sauf si vous avez une bonne raison d'en créer un nouveau. Si le jeton existant ne fonctionne pas, créez-en un nouveau. L'utilisation d'un jeton existant réduit le nombre de jetons que vous devez gérer.

1. Effectuez l'une des actions suivantes :

   • Dans le menu principal d’Analytics, sélectionnez Outils > Jeton d’accès à Diligent One.

   • Dans l’Éditeur de script, cliquez avec le bouton droit de la souris, puis sélectionnez Insérer > Jeton Diligent One.

   La page Gérer des jetons API s'ouvre dans votre navigateur. Il est possible que vous deviez d'abord vous connecter à Diligent One.

   L'accès à la page Gérer des jetons API via Analytics est une fonctionnalité d'ordre pratique. Vous pouvez également vous connecter à Diligent One et accéder à la page via votre profil utilisateur sans passer par Analytics.

2. Effectuez l'une des actions suivantes :

   • Utiliser un jeton existant

     1. Dans la colonne Jeton, cliquez sur le jeton en partie masqué que vous voulez utiliser.

     2. Saisissez le mot de passe de votre compte Diligent One et cliquez sur Confirmer.Diligent One

        Le jeton démasqué s'affiche.

     3. Cliquez sur Copier pour copier le jeton.

        Astuce

        Ne fermez pas la boîte de dialogue contenant le jeton tant que vous n'avez pas fini de copier-coller le jeton.

   • Créer un nouveau jeton

     1. Cliquez sur Ajouter un jeton > Analytics.

     2. Dans le panneau latéral Nouveau jeton Analytics, indiquez les informations suivantes :

        Champ ou option	Description
        Description	Saisissez une description qui fournit des informations utiles, telles que : L'objet du jeton L'emplacement d'utilisation du jeton : par exemple, le nom et l'emplacement du script Analytics, ou le nom et l'emplacement des tâches du robot
        Expiration du jeton	Activée le jeton expire au bout du nombre de jours que vous avez spécifié Désactivée le jeton n'expire pas Remarque Votre organisation dispose peut-être d'une politique de sécurité qui demande à ce que les jetons expirent au bout d'un certain temps. Créer des jetons avec une date d'expiration est une bonne pratique. Diligent One vous envoie une notification automatique par e-mail quelques jours avant la date d'expiration.
        Expire dans	Indiquez le nombre de jours avant l'expiration du jeton (de 1 à 365)
        Mot de passe	Saisissez le mot de passe de votre compte Diligent One.

     3. Cliquez sur Générer un jeton.

     4. Cliquez sur Copier pour copier le jeton.

        Astuce

        Ne fermez pas le panneau latéral contenant le jeton tant que vous n'avez pas fini de copier-coller le jeton.

3. Selon la méthode d’accès aux données et la méthode de définition de mot de passe utilisée, effectuez l’une des actions suivantes :

   Interface utilisateur Analytics

   Collez le jeton copié dans l’invite de mot de passe qui apparaît lorsque vous accédez à Diligent One manuellement.

   Script d’analyse de données

   • Commande PASSWORD Collez le jeton copié dans l’invite de mot de passe qui apparaît lors de l’exécution du script.

   • Commande SET PASSWORD Collez le jeton copié à l’endroit approprié dans la syntaxe de la commande SET PASSWORD dans un script.

4. Dans la barre de lancement, fermez la boîte de dialogue ou le panneau latéral contenant le jeton.

   Si vous avez créé un nouveau jeton, une version partiellement masquée du jeton est ajoutée en haut de votre liste de jetons.

   Pour plus d’informations, consultez la rubrique Créer et gérer des jetons d’accès Diligent One.