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

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.