Migrer les scripts d'AX vers Robots

Important

Ne procédez à la migration des scripts que si vous avez terminé l'étape précédente de la migration. Pour plus d'informations, consultez la section Recréer la structure de votre répertoire AX dans Robots.

Pour chaque processus automatisé dans AX que vous avez l'intention de recréer dans Robots, vous devez migrer les scripts associés. Vous devez migrer tous les scripts d'outils d'analyse et tous les scripts d'aide ou secondaires.

Vous ne pouvez pas migrer des scripts directement d'AX vers Robots. Vous devez exporter les scripts d'AX vers un emplacement intermédiaire où Analytics est installé, par exemple votre propre ordinateur. Après avoir effectué les travaux préparatoires nécessaires, vous validez (téléchargez) les scripts de l'emplacement intermédiaire vers Robots.

Rétrocompatibilité de Robots

En général, Robots est conçu pour être aussi rétrocompatible que possible avec AX. La plupart des scripts AX doivent fonctionner dans Robots sans nécessiter aucune modification.

Tous les scripts qui dépendent d'une conception propre à AX devront être adaptés. Par exemple :

  • des scripts qui accèdent à la base de données opérationnelle d'AX pour lire les planifications ou les journaux
  • des scripts comprenant des chemins d'accès absolus aux ressources du serveur qui ne sont plus valables sur le serveur Agent Robots

Si vous avez besoin d'aide pour ajuster les scripts d'outils d'analyse à utiliser dans Robots, contactez l'assistance Diligent.

Exporter les scripts d'AX

Pour commencer la migration, utilisez l'option Exporter pour exporter les scripts depuis AX. Les scripts sont exportés dans l'App Analyse qui les contient. Chaque App Analyse exportée devient un projet Analytics distinct dans la destination de l'exportation.

Cette procédure suppose que vous utilisez votre propre ordinateur comme emplacement intermédiaire.

  1. Créez un dossier sur votre ordinateur pour stocker les scripts exportés.
  2. Dans l'Explorateur de serveur AX, sélectionnez l'App Analyse contenant les scripts que vous souhaitez exporter.

    Vous pouvez cliquer en appuyant sur Ctrl pour sélectionner plusieurs Apps Analyse dans le même dossier parent Apps Analyse ou sélectionner le dossier parent pour exporter toutes les Apps Analyse du dossier.

  3. Sélectionnez Fichier > Exporter.
  4. Dans la boîte de dialogue Exporter, assurez-vous que les deux options ne sont pas sélectionnées :
    • Travailler avec le(s) fichier(s) exporté(s) ?
    • Exporter les fichiers de données avec les définitions sélectionnées
  5. Cliquez sur Parcourir, sélectionnez le dossier que vous avez créé pour le stockage des scripts, puis cliquez sur OK.
  6. Cliquez sur OK pour exporter l'App ou les Apps Analyse.

    Les scripts sont exportés dans leur App Analyse à l'emplacement indiqué. Chaque App Analyse est convertie en un projet Analytics.

  7. Répétez le processus pour tout autre script que vous êtes prêt à migrer.

Scripts d'outils d'analyse liés

Contrairement à AX, Robots ne prend pas en charge les scripts d'outils d'analyse liés. Si vous utilisez des scripts d'outils d'analyse liés dans AX, exportez le script analytique principal, puis envoyez-le à chaque robot pour lequel il est nécessaire.

Effectuer les travaux préparatoires nécessaires

Suite à l'exportation d'AX, les scripts sont prêts à être transmis à Robots si :

  • tous les scripts associés à un processus automatisé se trouvent dans un seul projet Analytics
  • tous les scripts d'outils d'analyse qui doivent s'exécuter de manière séquentielle dans un processus automatisé :
    • utiliser un système de dénomination alphanumérique approprié
    • si elle est mise en œuvre, avoir un type d'outil d'analyse approprié

Chaînes d'outils d'analyse

Contrairement à AX, Robots ne prend pas en charge les chaînes d'outils d'analyse. Si vous utilisez des chaînes d'outils d'analyse, vous devrez peut-être effectuer un travail préparatoire avant que les scripts ne soient prêts à s'engager dans Robots. Pour plus d'informations, consultez la section Reproduction des chaînes d'outils d'analyse dans Robots.

Transmettre (charger) les scripts à Robots

Une fois que tous les scripts associés à un processus automatisé sont contenus dans un seul projet Analytics, et qu'ils sont correctement nommés, vous pouvez les confier à Robots.

La transmission de scripts permet de les télécharger depuis un environnement local vers l'application Cloud Robots. Nous utilisons le mot « transmettre » plutôt que « charger » car chaque fois que vous transmettez des scripts au même robot, vous créez une nouvelle version des scripts dans l'historique des scripts.

Pour des informations détaillées, consultez la section Transmettre (charger) des scripts ACL vers Robots.

  1. Ouvrez le projet Analytics avec les scripts que vous souhaitez transmettre.
  2. Dans le menu principal d'Analytics, sélectionnez Fichier > Transmettre les scripts.

    Si un message d'erreur s'affiche, il peut y avoir un problème au niveau de l'en-tête de l'outil d'analyse, de la syntaxe de script, dans un ou plusieurs des scripts du projet.

    Pour plus d'informations, consultez la section Flux de travail de développement de script ACL dans Analytics et dans Robots.

  3. Si nécessaire, dans la boîte de dialogue Sélectionner la destination, double-cliquez sur l'instance Diligent One appropriée.

    La collection Robot s’affiche avec la liste des robots existants.

  4. Dans la liste des robots, sélectionnez le robot auquel vous souhaitez transmettre les scripts, puis cliquez sur OK.

    Le robot existant et le projet Analytics qui contient les scripts sont désormais associés de sorte que les transmissions suivantes ne nécessitent pas la localisation manuelle du robot.

  5. Saisissez un court message de transmission qui décrit les scripts transmis, puis cliquez sur OK.

    Les scripts sont transmis au robot en mode développement.

  6. Dans la boîte de dialogue Transmission des scripts réussie, cliquez sur le deuxième lien pour inspecter les scripts récemment transmis dans l'application Robots.

    L'onglet Versions des scripts s'ouvre avec la version transmise des scripts.

  7. Sélectionnez la version de script (vn).

    Le panneau latéral Détails sur version s'affiche. Les noms des scripts d'outils d'analyse individuels et des scripts auxiliaires sont indiqués sous Modifications de la version de script.

  8. Dans Analytics, cliquez sur OK pour quitter la boîte de dialogue Transmission des scripts réussie.

Reproduction des chaînes d'outils d'analyse dans Robots

Remarque

Cette section ne s'applique que si vous utilisez des chaînes d'outils d'analyse dans AX.

Contrairement à AX, Robots ne permet pas actuellement d'assembler des scripts d'outils d'analyse provenant de n'importe quel endroit du répertoire en une chaîne d'outil d'analyse qui s'exécute de manière séquentielle. Pour mettre en œuvre l'exécution séquentielle d'une série de scripts d'outils d'analyse dans Robots, vous devez faire deux choses :

  • contenir les scripts analytiques dans un seul robot et créer une seule tâche pour exécuter les scripts
  • utiliser des noms de script et le type d'outil d'analyse pour créer une séquence de script

Contenir les scripts d'outils d'analyse dans un seul robot

Contenir les scripts d'outils d'analyse que vous souhaitez exécuter de manière séquentielle dans un seul robot.

Pour contenir les scripts dans un seul robot, vous devez d'abord contenir tous les scripts liés dans un seul projet Analytics. Vous transmettez les scripts au robot sous la forme d'un package unique appelé version de script à partir du projet Analytics.

Une fois que les scripts sont dans un seul robot, vous créez une seule tâche pour exécuter la série de scripts d'outils d'analyse.

Contenir les scripts associés dans un seul projet Analytics

Si les scripts associés à un seul processus automatisé sont répartis entre deux ou plusieurs projets Analytics, vous devez réunir les scripts dans un seul projet avant de les transmettre à Robots. Cette situation pourrait se produire si les scripts d'outils d'analyse faisaient partie d'une chaîne d'outils d'analyse dans AX.

  1. Ouvrez le projet Analytics que vous souhaitez utiliser pour contenir tous les scripts associés à un processus automatisé.
  2. Dans l'onglet Vue globale du Navigateur, cliquez avec le bouton droit de la souris sur le nom du projet en haut de l'arborescence, puis sélectionnez Copier à partir d'un autre projet > Script.
  3. Dans la boîte de dialogue Localisation du fichier Projet, localisez et sélectionnez le projet Analytics à partir duquel importer le ou les scripts, puis cliquez sur Ouvrir.
  4. Dans la boîte de dialogue Importer, effectuez l'une des tâches suivantes pour ajouter un ou plusieurs scripts à la liste À nom_projet :
    • Double-cliquez sur un script.
    • Appuyez sur Ctrl tout en cliquant sur plusieurs scripts, puis cliquez sur le bouton flèche droite.
    • Cliquez sur Tout inclure pour ajouter tous les scripts.
  5. Cliquez sur OK pour copier le(s) script(s) dans le projet de destination.

    Si un script portant le même nom existe déjà dans le projet, un suffixe numérique incrémentant est ajouté au script copié.

  6. Répétez le processus pour tous les scripts d'autres projets qui doivent être inclus dans le projet de destination.

Utilisez des noms de script et le type d'outil d'analyse pour créer une séquence de script

Noms des scripts

Les scripts d'outils d'analyse sont triés par nom dans l'ordre alphanumérique dans une tâche de robot et s'exécutent dans l'ordre. Vous devez donc nommez les scripts d'outils d'analyse de manière à créer la séquence d'exécution que vous souhaitez.

Par exemple, le premier script de la séquence pourrait utiliser le préfixe A_01, le deuxième script pourrait utiliser A_02 ou B_01, et ainsi de suite. Un système de préfixation facilite l'insertion ultérieure de scripts supplémentaires. Les sous-scripts ou les scripts d'aide ne sont pas soumis à l'obligation de dénomination séquentielle.

Remarque

Vous ne pouvez pas renommer les scripts dans Robots, aussi assurez-vous que tous les scripts sont correctement nommés dans Analytics avant de les transmettre à Robots.

Type d'outil d'analyse

Comme aide supplémentaire pour le séquençage, vous pouvez éventuellement spécifier un type pour les scripts d'outils d'analyse. La spécification d'un type regroupe les scripts dans des zones distinctes d'une tâche. Les zones sont classées comme suit et s'exécutent dans l'ordre :

  • Importation
  • Préparation
  • Analyse

Dans chaque zone, les scripts sont triés dans l'ordre alphanumérique. Quel que soit le nom du script, une tâche exécute tous les scripts d'une zone avant de passer à la zone suivante.

Pour plus d'informations, consultez la section Balise ANALYTIC.

Renommer les scripts d'outils d'analyse pour créer une séquence d'exécution

Si vous souhaitez qu'au moins deux scripts d'outils d'analyse s'exécutent de manière séquentielle, ils doivent être nommés de manière à créer la séquence d'exécution souhaitée. Pour plus d'informations, consultez la section Reproduction des chaînes d'outils d'analyse dans Robots.

Remarque

Le nom du script d'outil d'analyse spécifié dans l'en-tête de l'outil d'analyse est le nom utilisé dans Robots. Le nom du script dans l'onglet Aperçu du Navigateur n'est pas utilisé.

  1. Dans Analytics, ouvrez le script d'outil d'analyse à renommer.
  2. Dans la balise //ANALYTIC de l'en-tête de l'outil d'analyse, mettez à jour le nom de l'outil d'analyse et cliquez sur Enregistrer le projet ouvert .

    Pour plus d'informations, consultez la section Balise ANALYTIC.

  3. Répétez le processus pour tous les scripts d'outils d'analyse qui doivent être renommés.

Spécifier un type d'outil d'analyse pour regrouper les scripts d'outils d'analyse

Si vous souhaitez regrouper les scripts d'outils d'analyse dans des zones Importation, Préparation et Analyse distinctes dans une tâche, vous devez spécifier un type d'outil d'analyse correspondant pour chaque script. Le regroupement des scripts d'outils d'analyse vous offre une option supplémentaire pour créer une séquence de script, mais elle n'est pas obligatoire. Pour plus d'informations, consultez la section Reproduction des chaînes d'outils d'analyse dans Robots.

  1. Dans Analytics, ouvrez le script d'outil d'analyse pour lequel vous souhaitez spécifier un type.
  2. Dans la balise //ANALYTIC de l'en-tête de l'outil d'analyse, spécifiez un type d'outil d'analyse et cliquez sur Enregistrer le projet ouvert .

    Pour plus d'informations, consultez la section Balise ANALYTIC.

  3. Répétez le processus pour tous les scripts d'outils d'analyse qui nécessitent un type d'outil d'analyse.

Et ensuite

Une fois que vous avez migré les scripts pour un ou plusieurs processus automatisés, vous voilà prêt à commencer la migration des données : Migrer des données d'AX vers Robots.