Lire et examiner la documentation Automation Anywhere

Fermer les contenus

Contenus

Ouvrir les contenus

API de migration des données de Enterprise Control Room 10.x vers Enterprise Control Room 11.x

  • Mis à jour le : 5/10/2019
    • 11.3.x
    • Exploration
    • Enterprise
    • Docs API

API de migration des données de Enterprise Control Room 10.x vers Enterprise Control Room 11.x

En tant qu'administrateur de la Enterprise Control Room disposant des autorisations de rôle Afficher et gérer la migration, utilisez les API de migration pour migrer les données de la version 10.x de la Enterprise Control Room vers la versions 11.x actuelle de la Enterprise Control Room.

Les API de migration permettent d'exécuter les opérations suivantes :

  1. Enregistrer/mettre à jour la configuration de la connexion à la base de données de la Enterprise Control Room version 10.x
  2. Enregistrer/mettre à jour la configuration de la connexion à la base de données de Bot Insight version 2.x, si elle est disponible
  3. Spécifier l'option de migration des données en fonction des rôles, des utilisateurs ou des robots
  4. Récupérer la liste des données en fonction de l'option de migration spécifiée, à savoir Rôles, Utilisateurs ou Robots
  5. Afficher le résumé de l'avancement de la migration
  6. Afficher les statistiques de migration relatives au nombre d'entités ayant réussi ou échoué par migration
  7. Récupérer la liste des robots nouveaux et mis à jour auprès de la Enterprise Control Room version 10.x après la migration
  8. Migrer des fichiers en masse à partir du dossier Mes documents de la Enterprise Control Room version 10.x après la migration

Vous pouvez également utiliser l'Assistant Migration accessible dans le module Administration > Migration pour migrer les données depuis l'interface utilisateur de la Enterprise Control Room. Reportez-vous à Migration - Présentation pour plus d'informations.

Remarque : Les exemples fournis dans cet article sont présentés pour référence uniquement.

Point de terminaison d'API

Utilisez les points de terminaison suivants pour accéder à l'API :

  1. Pour le processus de migration, utilisez <Enterprise Control Room URL>/v2/migration
  2. Pour migrer des fichiers depuis le dossier Mes documents de la Enterprise Control Room source version 10.x une fois la migration terminée, utilisez <URL Enterprise Control Room>/v1/migration

Par exemple :

https://crdevenv.com:81/v2/migration

API du processus de migration

Les API de migration permettent de migrer des données de la Enterprise Control Room version 10.x à la Enterprise Control Room version 11. à l'aide du point de terminaison mentionné précédemment.

Avant d'accéder aux API de migration, vous devez utiliser l'API d'authentification et la transmettre sous forme de jeton afin d'identifier chaque API de migration.

  1. À l'aide de la méthode POST, générez un jeton au moyen du point de terminaison http(s)://<hostname:port>/v1/authentication. Pour cela, fournissez l'instance de la Enterprise Control Room à savoir Nom du serveur / Nom d'hôte / IP et numéro de port.

    Par exemple, https://crdevenv.com:81/v1/authentication

  2. Fournissez la charge utile de demande suivante dans les en-têtes :

    "X-Authorization" : "Authorization token"

    "Content-Type" : "application/json"

  3. Fournissez la charge utile des demandes suivante dans le corps :

    {

    "username": "<Nomutilisateur>",

    "password": "<Motdepasse>"

    }
    • Par exemple :

      {

      "usename": "Ellie.Brown",

      "password": "12345678"

      }

1. Se connecter à la base de données de la Enterprise Control Room source

Cette API permet d'enregistrer et de mettre à jour la configuration de la connexion à la base de données de la Enterprise Control Room source version 10.x.

  1. Indiquez les paramètres « X-Authorization » et « Content Type » dans les en-têtes.
  2. Indiquez les paramètres des informations d'identification dans le corps.
  3. Utilisez la méthode POST pour vous connecter à la base de données de la Enterprise Control Room version 10.x à l'aide du point de terminaison https ://<hostname:port>/v2/migration/connection
    • Par exemple, https://crdevenv.com:81/v2/migration/connection
  4. Entrez les paramètres de requête suivants dans le corps :

    {

    "host" : "string", "port": 0, "databaseName" : "string", "username" : "string", "password" : "string", "integratedSecurity" : true, "encrypt" : true, "privateKey" : "string", "repoPath" : "string"

    }
    • Par exemple :

      {

      "host" : "PRODUCTLT",

      "port" : 1433,

      "databaseName" : "CR104MIG",

      "username": "Ellie.Brown",

      "password": "12345678",

      "integratedSecurity" : true,

      "encrypt" : true,

      "privateKey" : "ABC123",

      "repoPath" : "D:\\Data\Automation Anywhere Server Files"

      }

  5. Cliquez sur Envoyer.

Description des paramètres

Paramètre Description
host Nom d'hôte de la base de données de la Enterprise Control Room source.
port Numéro de port de la base de donnée de la Enterprise Control Room source.
databaseName Nom de la base de données de la Enterprise Control Room source.
username Nom d'utilisateur de connexion à la base de données.
password Mot de passe de connexion à la base de données.
integratedSecurity Indique s'il faut utiliser l'authentification Windows lors de la connexion à la base de données source. Attribuez la valeur true pour utiliser l'authentification Windows. La valeur par défaut est false.
encrypt Indique s'il faut utiliser une connexion sécurisée à la base de données source. Attribuez la valeur true pour utiliser une connexion sécurisée. La valeur par défaut est false.
privateKey Clé privée permettant de déchiffrer les valeurs des informations d'identification dans la base de données source. Elle peut être définie au cours de la configuration initiale de la Enterprise Control Room.
repoPath Chemin du référentiel partagé dans lequel se trouve le référentiel de la Enterprise Control Room version 10.x.

2. Obtenir les informations de connexion stockées

Cette API vous permet de récupérer les informations de connexion stockées de la base de données de la Enterprise Control Room source version 10.x à partir de laquelle il est possible de migrer les données.

  1. Indiquez les paramètres « X-Authorization » et « Content Type » dans les en-têtes.
  2. Indiquez les paramètres des informations d'identification dans le corps.
  3. Utilisez la méthode GET pour récupérer la configuration de la connexion à la base de données de la Enterprise Control Room version 10.x à l'aide du point de terminaison http(s)://<hostname:port>/v2/migration/connection
    • Par exemple,https://crdevenv.com:81/v2/migration/connection
  4. Cliquez sur Envoyer.
  5. Vous pouvez consulter le résultat dans les données du corps :

    {

    "host" : "productlt",

    "port" : 1433,

    "databaseName" : "CR104MIG",

    "username": "",

    "password": "",

    "integratedSecurity" : true,

    "encrypt" : false,

    "privateKey": "",

    "repoPath" : "D:\\DATA\AUTOMATION ANYWHERE SERVER FILES"

    }

Description des paramètres

Paramètre Description
host Hôte de la base de données source
port Port de la base de données source
databaseName Nom de la base de données source
username Nom d'utilisateur de connexion à la base de données source
password Mot de passe de connexion à la base de données source
integratedSecurity Indique s'il faut utiliser l'authentification Windows lors de la connexion à la base de données source. La valeur par défaut est Faux.
encrypt Indique s'il faut utiliser une connexion sécurisée à la base de données source. La valeur par défaut est Faux.
privateKey Clé privée permettant de déchiffrer les valeurs des informations d'identification dans la base de données source.
repoPath Chemin du référentiel partagé dans lequel se trouve le référentiel de la Enterprise Control Room version 10.x.

3. Se connecter à la base de données Bot Insight 2.x, si disponible

Cette API permet de se connecter à la base de données Bot Insight source version 2.x si elle est disponible, pour migrer les données d'analyse.

  1. Indiquez les paramètres « X-Authorization » et « Content Type » dans les en-têtes.
  2. Indiquez les paramètres des informations d'identification dans le corps.
  3. À l'aide de la méthode POST, connectez-vous à la base de données Bot Insight en utilisant le point de terminaison http(s)://<hostname:port>/v2/migration/connection /botinsight
    • Par exemple, https://crdevenv.com:81/v2/migration/connection/botinsight
  4. Entrez les paramètres de requête suivants dans le corps :

    {

    "host" : "string",

    "port" : 0,

    "databaseName" : "string",

    "username": "string",

    "password": "string",

    "integratedSecurity" : true,

    "encrypt" : true,

    "serverUrl" : "string"

    }
    • Par exemple :

      {

      "host" : "Productlt",

      "port" : 8091,

      "databaseName" : "BotInsight",

      "username": "Ellie.Brown",

      "password": "12345678",

      "integratedSecurity" : true,

      "encrypt" : true,

      "serverUrl" : "https://productlt.aae.com:82/analytics"

      }

  5. Cliquez sur Envoyer.
  6. Les paramètres de connexion sont correctement enregistrés lorsque l'état de la réponse est 200 Opération réussie .

Description des paramètres

Paramètre Description
host Nom d'hôte de la base de données de la Bot Insight source.
port Numéro de port de la base de donnée de la Bot Insight source.
databaseName Nom de la base de données Bot Insight source
username Nom d'utilisateur de connexion à la base de données.
password Mot de passe de connexion à la base de données.
integratedSecurity Indique s'il faut utiliser l'authentification Windows lors de la connexion à la base de données source. Attribuez la valeur true pour utiliser l'authentification Windows. La valeur par défaut est false.
encrypt Indique s'il faut utiliser une connexion sécurisée à la base de données source. Attribuez la valeur true pour utiliser une connexion sécurisée. La valeur par défaut est false.
serverUrl URL du serveur où se trouve le port du service de visualisation Bot Insight

4. Obtenir les informations de connexion stockées

Cette API vous permet de récupérer les informations de connexion stockées de la base de données Bot Insight source version 2.x à partir de laquelle il est possible de migrer les données.

  1. Indiquez les paramètres « X-Authorization » et « Content Type » dans les en-têtes.
  2. Indiquez les paramètres des informations d'identification dans le corps.
  3. Utilisez la méthode GET pour récupérer la configuration de la connexion à la base de données de la Enterprise Control Room version 10.x à l'aide du point de terminaison http(s)://<hostname:port>/v2/migration/connection/botinsight
    • Par exemple,https://crdevenv.com:81/v2/migration/connection/botinsight
  4. Cliquez sur Envoyer.
  5. Les paramètres de connexion sont correctement enregistrés lorsque l'état de la réponse est 200 Configuration de la migration.
  6. Vous pouvez consulter le résultat dans les données du corps :

    {

    "host" : "Productlt",

    "port" : 8091,

    "databaseName" : "BotInsight",

    "username": "Ellie.Brown",

    "password": "12345678",

    "integratedSecurity" : true,

    "encrypt" : true,

    "serverUrl" : "https://productlt.aae.com:82/analytics"

    }

Description des paramètres

Paramètre Description
host Nom d'hôte de la base de données de la Bot Insight source.
port Numéro de port de la base de donnée de la Bot Insight source.
databaseName Nom de la base de données de la Bot Insight source.
username Nom d'utilisateur de connexion à la base de données.
password Mot de passe de connexion à la base de données.
integratedSecurity Indique s'il faut utiliser l'authentification Windows lors de la connexion à la base de données source. Attribuez la valeur true pour utiliser l'authentification Windows. La valeur par défaut est false.
encrypt Indique s'il faut utiliser une connexion sécurisée à la base de données source. Attribuez la valeur true pour utiliser une connexion sécurisée. La valeur par défaut est false.
serverUrl URL du serveur où se trouve le port du service de visualisation Bot Insight

5. Liste des entités du TYPE disponibles pour la migration dans la base de données source

Cette API renvoie la liste des entités disponibles pour la migration dans la base de données source en fonction du paramètre TYPE. Les options Rôle, Utilisateur, Robot ou Planification permettent de migrer toutes les données associées au paramètre sélectionné.

Remarque : Pour procéder à une migration sélective de données, c'est-à-dire sélectionner certaines données en fonction d'un paramètre spécifié, exécutez l'Assistant Migration disponible dans la Enterprise Control Room.
  1. Indiquez le paramètre X-Authorization dans les en-têtes.
  2. À l'aide de la méthode GET, connectez-vous à la base de données de la Enterprise Control Room en utilisant le point de terminaison http(s)://<hostname:port>/v2/migration/connection/entities suivi du paramètre TYPE pouvant inclure l'une des options : Rôle, Utilisateur, Robot ou Planification.
    • Par exemple, https://crdevenv.com:81/v2/migration/connection/entities?Type=ROLE
  3. Cliquez sur Envoyer.
  4. Les données sont retournées lorsque l'état de la réponse est 200
  5. La liste des entités disponibles en fonction du paramètre TYPE est affichée dans le corps.

    {

    "entities":

    [

    { "id": "0", "type": "ROLE", "sourceId": "1", "targetId": "0", "name": "Admin", "status": "SUCCESS", "reason": "" },

    { "id": "0", "type": "ROLE", "sourceId": "2", "targetId": "0", "name": "Basic", "status": "SUCCESS", "reason": "" },

    { "id": "0", "type": "ROLE", "sourceId": "3", "targetId": "0", "name": "IQBotValidator", "status": "SUCCESS", "reason": "" },

    { "id": "0", "type": "ROLE", "sourceId": "4", "targetId": "0", "name": "AnalyticsExperts", "status": "SUCCESS", "reason": "" },

    { "id": "0", "type": "ROLE", "sourceId": "5", "targetId": "0", "name": "AnalyticsConsumers", "status": "SUCCESS", "reason": "" },

    { "id": "0", "type": "ROLE", "sourceId": "6", "targetId": "0", "name": "BotAgentUser", "status": "SUCCESS", "reason": "" },

    { "id": "0", "type": "ROLE", "sourceId": "7", "targetId": "0", "name": "BotFarmAdmin", "status": "SUCCESS", "reason": "" },

    { "id": "0", "type": "ROLE", "sourceId": "8", "targetId": "0", "name": "IQBotServices", "status": "SUCCESS", "reason": "" },

    { "id": "0", "type": "ROLE", "sourceId": "9", "targetId": "0", "name": "Bot Creator 10x", "status": "SUCCESS", "reason": "" },

    { "id": "0", "type": "ROLE", "sourceId": "10", "targetId": "0", "name": "Bot Runner 10x", "status": "SUCCESS", "reason": "" },

    { "id": "0", "type": "ROLE", "sourceId": "11", "targetId": "0", "name": "Bot Scheduler 10x", "status": "SUCCESS", "reason": "" }

    ]

    }

Description des paramètres

Paramètre Description
id Identifiant de la migration
type Type d'entité sélectionné pour la migration : Rôle, Utilisateur ou Robot
sourceId Identifiant de l'entité dans la base de données source
targetId Identifiant de l'entité après la migration dans la base de données cible
name Nom de l'entité dans la base de données source
status État de la migration d'une entité en particulier
reason Cause de l'échec de la migration d'une entité en particulier

6. Préparer les données de migration en fonction des entrées de l'utilisateur

Cette API permet de migrer des entités associées à des données en fonction de la sous-section du type d'entité spécifié pour la migration.

  1. Indiquez les paramètres « X-Authorization » et « Content Type » dans les en-têtes.
  2. À l'aide de la méthode POST, migrez les données en utilisant le point de terminaison http(s)://<hostname:port>/v2/migration/prepare.
    • Par exemple, https://crdevenv.com:81/v2/migration/prepare
  3. Fournissez la charge utile des demandes suivante dans le corps :

    {

    "selected":

    [

    { "type": "<enitity type>",

    "sourceId": "string" }

    ],

    "excludes": [ "<entity type>"

    ]

    }
    • Par exemple :

      { "selected": [ { "type": "ROLE", "sourceId": "12" } ], "excludes": [ "BOT" ] }

  4. Cliquez sur Envoyer.
  5. Les données sont répertoriées avec succès pour la migration lorsque l'état de la réponse est 200.
  6. Le résultat est affiché dans le corps.

    { "selected":

    [

    { "type": "ROLE", "sourceId": "12" } ],

    "excludes": [ "BOT" ]

    }

Description des paramètres

Paramètre Description
type Type de l'entité sélectionnée pour la migration : Rôle, Utilisateur ou Robots et planifications.
sourceId Identifiant de l'entité dans la base de données source.
excludes

Nom de l'entité exclue de la migration. Les options sont disponibles en fonction du type d'entité sélectionné.

Par conséquent, lorsque vous sélectionnez Rôle ou Utilisateur, vous pouvez Exclure les robots et les planifications et quand vous sélectionnez Robots et planifications, vous pouvez Exclure les Méta robots) et/ou Écraser les robots existants.

7. Démarrer la migration

Cette API permet de lancer le processus de migration.

  1. Indiquez le paramètre X-Authorization dans les en-têtes.
  2. À l'aide de la méthode POST, migrez les données en utilisant le point de terminaison http(s)://<hostname:port>/v2/migration/start/async.
    • Par exemple, https://crdevenv.com:81/v2/migration/start/async

  3. Cliquez sur Envoyer.
  4. La migration des données démarre correctement lorsque l'état de la réponse est 200 Opération réussie.
  5. Le résultat est affiché dans les données du corps.

    {

    "id": 1,

    "name": "2018.07.17.16.13.48.ellie.brown",

    "createdBy": 1,

    "migrationType": "ROLE_EXCLUDE_BOT_SCHEDULE"

    }

Description des paramètres

Paramètre Description
id Identifiant de la migration
name Nom de l'utilisateur qui a initié la migration.
createdBy Identifiant de l'entité qui a lancé la migration, c'est-à-dire l'administrateur de la Enterprise Control Room.
migrationType Type de migration choisi : Rôle, Utilisateur ou Robots et planifications.

8. Objet de migration par identifiant

Cette API répertorie les détails d'un objet de migration en fonction de l'identifiant généré à l'aide de l'API Démarrer la migration.

  1. Indiquez le paramètre X-Authorization dans les en-têtes.
  2. Utilisez la méthode GET pour récupérer les détails d'un objet par son identifiant à l'aide du point de terminaison http(s)://<hostname:port>/v2/migration/<id>.
    • Par exemple, https://crdevenv.com:81/v2/migration/9

  3. Cliquez sur Envoyer.
  4. Les détails de l'objet sont correctement répertoriés lorsque l'état de la réponse est 200.
  5. Les détails sont affichés dans les données du corps :

    {

    "id": "9",

    "name": "2018.07.17.16.13.48.ellie.brown",

    "startTime": "2018-07-17T10:43:48.127Z",

    "endTime": "2018-07-17T10:43:49.833Z",

    "createdBy": "1",

    "migrationType": "ROLE_EXCLUDE_BOT_SCHEDULE",

    "entities": []

    }

Description des paramètres

Paramètre Description
id Identifiant de la migration
name Nom de l'utilisateur qui a initié la migration.
startTime Heure de début de la migration
endTime Heure de fin de la migration
createdBy Identifiant de l'entité qui a lancé la migration, c'est-à-dire l'administrateur de la Enterprise Control Room.
entities Liste des entités migrées pendant le processus de migration
migrationType Type de migration choisi : Rôle, Utilisateur ou Robots et planifications.

9. Progression de la migration

Cette API permet d'afficher l'avancement du processus de migration en cours.

  1. Indiquez les paramètres « X-Authorization » et « Content Type » dans les en-têtes.
  2. Indiquez les paramètres des informations d'identification dans le corps.
  3. Utilisez la méthode GET pour récupérer les détails d'un objet par son identifiant à l'aide du point de terminaison http(s)://<hostname:port>/v2/migration/pogress.
    • Par exemple, https://crdevenv.com:81/v2/migration/progress

  4. Cliquez sur Envoyer.
  5. Les détails de l'objet sont correctement répertoriés lorsque l'état de la réponse est 200.
  6. Les détails sont affichés dans les données du corps :

    {

    "migration":

    { "id": "10", "name": "2018.07.17.16.55.59.ellie.brown", "startTime": "2018-07-17T11:25:59.800Z", "endTime": "2018-07-17T11:26:16.002Z", "createdBy": "1", "migrationType": "BOT_EXCLUDE_Méta robot", "entities": [] },

    "current": "SCHEDULE",

    "progress":

    {

    "BOT": { "total": "10", "successful": "7", "failed": "0", "skipped": "3" },

    "SCHEDULE": { "total": "8", "successful": "8", "failed": "0", "skipped": "0" }

    }

    }

Description des paramètres

Paramètre Description
id Identifiant de la migration
name Nom de la migration affiché
startTime Horodatage correspondant au début du processus de migration
endTime Horodatage correspondant à la fin du processus de migration. Il a une valeur nulle lorsque la migration est en cours.
createdBy Identifiant de l'utilisateur qui a créé/démarré le processus de migration.
current Type de l'entité en cours de migration : Rôle, Utilisateur, Information d'identification, Robot ou Planification.
progress

État d'avancement de la migration des entités :

  • total - nombre total d'entités d'un type donné à migrer
  • successful - nombre d'entités dont la migration a réussi
  • failed - nombre d'entités dont la migration a échoué
  • skipped - nombre d'entités ignorées lors de la migration

10. Statistiques de migration : nombre d'entités dont la migration a réussi ou échoué par opération

Cette API permet d'afficher le nombre d'entités dont la migration a réussi ou échoué.

  1. Indiquez le paramètre X-Authorization dans les en-têtes.
  2. Utilisez la méthode GET pour récupérer les détails d'un objet par son identifiant à l'aide du point de terminaison http(s)://<hostname:port>/v2/migration/statistics.
    • Par exemple, https://crdevenv.com:81/v2/migration/statistics

  3. Cliquez sur Envoyer.
  4. Les détails de l'objet sont correctement répertoriés lorsque l'état de la réponse est 200.
  5. Les détails sont affichés dans les données du corps :

    {

    "items": [

    { "id": "1", "name": "2018.07.13.11.14.59.ellie.brown", "startTime": "2018-07-13T05:44:59.787Z", "endTime": "2018-07-13T06:56:25.537Z", "createdBy": "1", "duration": "4285s", "numSuccess": 0, "numFailed": 0, "numSkipped": 0 },

    { "id": "2", "name": "2018.07.13.12.28.08.ellie.brown", "startTime": "2018-07-13T06:58:09.283Z", "endTime": "2018-07-13T06:58:12.910Z", "createdBy": "1", "duration": "3s", "numSuccess": 1, "numFailed": 1, "numSkipped": 0 },

    { "id": "3", "name": "2018.07.13.12.40.34.ellie.brown", "startTime": "2018-07-13T07:10:34.470Z", "endTime": "2018-07-13T07:10:40.060Z", "createdBy": "1", "duration": "5s", "numSuccess": 10, "numFailed": 0, "numSkipped": 0 },

    { "id": "4", "name": "2018.07.13.12.42.19.ellie.brown", "startTime": "2018-07-13T07:12:20.007Z", "endTime": "2018-07-13T07:12:23.107Z", "createdBy": "1", "duration": "3s", "numSuccess": 0, "numFailed": 0, "numSkipped": 6 },

    { "id": "5", "name": "2018.07.13.13.39.53.ellie.brown", "startTime": "2018-07-13T08:09:53.113Z", "endTime": "2018-07-13T08:10:02.673Z", "createdBy": "1", "duration": "9s", "numSuccess": 4, "numFailed": 0, "numSkipped": 0 }

    ]

    }

Description des paramètres

Paramètre Description
id Identifiant de la migration
name Nom de la migration affiché
startTime Horodatage correspondant au début du processus de migration
endTime Horodatage correspondant à la fin du processus de migration. Il a une valeur nulle lorsque la migration est en cours.
createdBy Identifiant de l'utilisateur qui a créé l'objet
duration Durée de la migration - en secondes ou nanosecondes
numSuccess Nombre d'éléments dont la migration a réussi
numFailed Nombre d'éléments dont la migration a échoué
numSkipped Nombre d'éléments ignorés lors de la migration

API utilisées après le processus de migration

Une fois le processus terminé, les API de migration permettent d'effectuer les opérations suivantes :

  1. Importer des fichiers à partir du dossier Mes documents de la Enterprise Control Room version 10.x
  2. Récupérer la liste des robots nouveaux ou modifiés à partir de la Enterprise Control Room 10.x depuis l'exécution de la dernière migration
    Remarque : Avant d'accéder aux API, vous devez utiliser l'API d'authentification et la transmettre comme jeton afin d'utiliser une API de migration spécifique.
  3. À l'aide de la méthode POST, générez un jeton au moyen du point de terminaison http(s)://<hostname:port>/v1/authentication. Pour cela, fournissez l'instance de la Enterprise Control Room à savoir Nom du serveur / Nom d'hôte / IP et numéro de port.

    Par exemple, https://crdevenv.com:81/v1/authentication

  4. Fournissez la charge utile de demande suivante dans les en-têtes :

    "X-Authorization" : "Authorization token"

    "Content-Type" : "application/json"

  5. Fournissez la charge utile des demandes suivante dans le corps :

    {

    "username": "<Nomutilisateur>",

    "password": "<Motdepasse>"

    }

  • Par exemple :

    {

    "usename": "Ellie.Brown",

    "password": "12345678"

    }

Important : Si le code d'erreur 404 s'affiche lorsque vous utilisez une ou l'ensemble des API de post-migration, ré-exécutez l'API pour extraire la liste des dossiers racine à partir de la Enterprise Control Room version 10.x, c'est-à-dire http(s)://<hostname:port>/v1/migration/legacyrepository/rootDirectories.

A. Importer les fichiers du dossier Mes documents

Utilisez certaines API pour migrer les fichiers du dossier Mes documents de la Enterprise Control Room version 10.x. Ces API permettent d'importer un grand nombre de fichiers pouvant être utilisés dans des robots en tant que dépendances ou de manière autonome. Elles sont utiles à l'automatisation.

1. Récupérer la liste des dossiers racine à partir de la Enterprise Control Room version 10.x

Cette API permet de récupérer la liste des dossiers disponibles dans le référentiel de la Enterprise Control Room version 10.x. Elle permet de comprendre la structure des dossiers disponible dans la Enterprise Control Room source.

  1. Indiquez le paramètre X-Authorization dans les en-têtes.
  2. Utilisez la méthode GET pour récupérer les détails d'un objet par son identifiant à l'aide du point de terminaison http(s)://<hostname:port>/v1/migration/legacyrepository/rootDirectories suivi du paramètre excludeMéta robot).
    • Par exemple, https://crdevenv.com:81/v1/migration/legacyrepository/rootDirectories?excludeMéta robot=true

  3. Cliquez sur Envoyer.
  4. Les détails de l'objet sont correctement répertoriés lorsque l'état de la réponse est 200.
  5. Les détails sont affichés dans les données du corps :

    [

    { "name": "My Docs", "path": "Automation Anywhere\\My Docs" },

    { "name": "My Exes", "path": "Automation Anywhere\\My Exes" },

    { "name": "My Reports", "path": "Automation Anywhere\\My Reports" },

    { "name": "My Scripts", "path": "Automation Anywhere\\My Scripts" },

    { "name": "My Tasks", "path": "Automation Anywhere\\My Tasks" },

    { "name": "My Workflow", "path": "Automation Anywhere\\My Workflow" }

    ]

Description des paramètres

Paramètre Description
name Nom du répertoire ou dossier
path Chemin du répertoire ou dossier

2. Récupérer la liste des sous-dossiers d'un dossier racine dans la Salle de contrôle version 10.x.

Cette API permet d'extraire la liste des sous-dossiers d'un dossier racine donné disponible dans le référentiel de la Enterprise Control Room version 10.x. Elle permet de comprendre la structure des dossiers de la Enterprise Control Room source.

  1. Indiquez le paramètre X-Authorization dans les en-têtes.
  2. Utilisez la méthode GET pour récupérer les détails d'un objet par son identifiant à l'aide du point de terminaison http(s)://<hostname:port>/v1/migration/legacyrepository/childDirectories suivi du paramètre path.
    • Par exemple, https://crdevenv.com:81/v1/migration/legacyrepository/childDirectories?path=Automation Anywhere\My Docs

  3. Cliquez sur Envoyer.
  4. Les détails de l'objet sont correctement répertoriés lorsque l'état de la réponse est 200.
  5. Les détails sont affichés dans les données du corps :

    {

    "folders":

    [

    { "name": "Log-Files", "path": "Automation Anywhere\\My Docs\\Log-Files" }

    ]

    }

Description des paramètres

Paramètre Description
folders Liste des sous-répertoires
name Nom du répertoire ou dossier
path Chemin du répertoire ou dossier

3. Récupérer la liste des fichiers dans un dossier donné

Cette API permet d'extraire la liste des fichiers disponibles dans un dossier donné du référentiel de la Enterprise Control Room source.

  1. Indiquez le paramètre X-Authorization dans les en-têtes.
  2. Utilisez la méthode GET pour récupérer les détails d'un objet par son identifiant à l'aide du point de terminaison http(s)://<hostname:port>/v1/migration/legacyrepository/childFiles suivi des paramètres path et excludeMéta robot.
    • Par exemple, https://crdevenv.com:81/v1/migration/legacyrepository/childFiles?path=Automation Anywhere\My Docs\Log-Files&excludeMéta robot=false

  3. Cliquez sur Envoyer.
  4. Les détails de l'objet sont correctement répertoriés lorsque l'état de la réponse est 200.
  5. Les détails sont affichés dans les données du corps :

    {

    "files":

    [

    { "id": "280", "name": "ActiveMQServer-2018-Jul-17-2.log.zip", "path": "Automation Anywhere\\My Docs\\Log-Files\\ActiveMQServer-2018-Jul-17-2.log.zip" },

    { "id": "281", "name": "IgniteServer-2018-Jul-17-4.log.zip", "path": "Automation Anywhere\\My Docs\\Log-Files\\IgniteServer-2018-Jul-17-4.log.zip" },

    { "id": "283", "name": "WebCR_Ignite-2018-Jul-17-4.log.zip", "path": "Automation Anywhere\\My Docs\\Log-Files\\WebCR_Ignite-2018-Jul-17-4.log.zip" },

    { "id": "284", "name": "WebCR_License-2018-Jul-17-4.log.zip", "path": "Automation Anywhere\\My Docs\\Log-Files\\WebCR_License-2018-Jul-17-4.log.zip" },

    { "id": "292", "name": "WebCR_Migration-2018-Jul-17-4.log", "path": "Automation Anywhere\\My Docs\\Log-Files\\WebCR_Migration-2018-Jul-17-4.log" },

    { "id": "285", "name": "WebCR_Migration-2018-Jul-17-4.log.zip", "path": "Automation Anywhere\\My Docs\\Log-Files\\WebCR_Migration-2018-Jul-17-4.log.zip" },

    { "id": "293", "name": "WebCR_Migration-2018-Jul-17-4.txt", "path": "Automation Anywhere\\My Docs\\Log-Files\\WebCR_Migration-2018-Jul-17-4.txt" }

    ]

    }

Description des paramètres

Paramètre Description
files Liste des sous-fichiers
id Identifiant de fichier du robot
name Nom du répertoire ou dossier
path Chemin du répertoire ou dossier

4. Rechercher un dossier par son nom dans la Enterprise Control Room version 10.x

Cette API permet de rechercher un dossier par son nom dans le référentiel Mes documents de la Enterprise Control Room source.

  1. Indiquez le paramètre X-Authorization dans les en-têtes.
  2. Utilisez la méthode GET pour récupérer les détails d'un objet par son identifiant à l'aide du point de terminaison http(s)://<hostname:port>/v1/migration/legacyrepository/folders suivi du paramètre taskName.
    • Par exemple, https://crdevenv.com:81/v1/migration/legacyrepository/folders?taskName=Import-Table

  3. Cliquez sur Envoyer.
  4. Les détails de l'objet sont correctement répertoriés lorsque l'état de la réponse est 200.
  5. Les détails sont affichés dans les données du corps :

    {

    "paths":

    [ "Automation Anywhere\\My Docs\\Import-Table" ]

    }

Description des paramètres

Paramètre Description
paths Liste de chemins de répertoire/dossier

5. Récupérer la liste des fichiers pour un dossier donné dans la Enterprise Control Room version 10.x

Cette API permet de récupérer une liste de fichiers dans un dossier donné depuis le référentiel Mes documents de la Enterprise Control Room source.

  1. Indiquez le paramètre X-Authorization dans les en-têtes.
  2. Utilisez la méthode POST pour récupérer la liste des fichiers d'un dossier donné à l'aide du point de terminaison http(s)://<hostname:port>/v1/legacyrepository/files.
    • Par exemple, https://crdevenv.com:81/v1/legacyrepository/files

  3. Fournissez la liste des chemins de dossier sous forme de charge utile des demandes dans le corps.

    [

    "string"

    ]
    • Par exemple, la ligne suivante répertorie les fichiers disponibles.

      [

      "Automation Anywhere\\My Docs\\Import-Table"

      ]

  4. Cliquez sur Envoyer.
  5. Les détails de l'objet sont correctement répertoriés lorsque l'état de la réponse est 200.
  6. Les détails de la réponse sont affichés dans les données du corps :

    {

    "files":

    [

    { "id": 1281, "type": "BOT", "sourceId": "1281", "targetId": 0, "name": "Automation Anywhere\\My Docs\\Import-Table\\Import-Table.txt", "status": "SUCCESS", "reason": "" },

    { "id": 293, "type": "BOT", "sourceId": "293", "targetId": 0, "name": "Automation Anywhere\\My Docs\\Import-Table\\WebCR_Migration-2018-Jul-17-4.txt", "status": "SUCCESS", "reason": "" }

    ]

    }

Description des paramètres

Paramètre Description
files Liste des sous-fichiers
type Type du fichier
sourceId Identifiant de l'entité dans la base de données source
targetId Identifiant de l'entité après la migration dans la base de données cible
name Nom du répertoire ou dossier
status État de la réponse - Opération réussie, ignorée ou échouée
reason Description de la raison d'une migration échouée ou ignorée

B. Migrer des robots nouveaux ou modifiés à partir de la version 10.x depuis la dernière migration vers la version 11.x

Cette API permet de récupérer la liste des robots nouveaux ou modifiés dans la Enterprise Control Room source version 10.x après que les données ont été migrées dans la Enterprise Control Room de destination version 11.x. Fondamentalement, cette API vous donne la possibilité de continuer à employer votre environnement 10.x alors que l'environnement 11.x est prêt à passer en production.

  1. Indiquez le paramètre X-Authorization dans les en-têtes.
  2. Utilisez la méthode POST pour récupérer les détails d'un objet par son identifiant à l'aide du point de terminaison http(s)://<hostname:port>/v1/legacyrepository/changedfiles.
    • For example, https://crdevenv.com:81/v1/legacyrepository/changedfiles
  3. Fournissez la liste des chemins de dossier sous forme de charge utile des demandes dans le corps.

    {

    "changeSince": "<date et heure de la dernière migration>"

    }

    • Par exemple, la liste suivante répertorie les noms de robot qui ont été mis à jour après la migration.

      {

      "changeSince":"2018-06-25T12:05:00+05:30"

      }

    Conseil : Ne spécifiez pas le paramètre changeSince pour prendre en compte le delta de date et d'heure de la dernière migration.
  4. Cliquez sur Envoyer.
  5. Les détails de l'objet sont correctement répertoriés lorsque l'état de la réponse est 200.
  6. Les détails de la réponse sont affichés dans les données du corps :

    {

    "changedfiles":

    [

    { "type": "BOT", "sourceId": "6", "name": "Automation Anywhere\\My Tasks\\Sample Tasks\\Import-Table.atmx" },

    { "type": "BOT", "sourceId": "7", "name": "Automation Anywhere\\My Tasks\\Sample Tasks\\List-Variable.atmx" }

    ]

    }

Description des paramètres

Paramètre Description
changedFiles Liste des entités modifiées ou créées depuis la dernière migration
type Type d'entité
sourceId Identifiant de l'entité dans la base de données source
name Nom du répertoire ou dossier

Codes de réponse de l'API

Code d'état Http(s) Réponse - Description Action corrective
200 Opération réussie NA
400 Erreur de requête Réessayer avec des paramètres valides
401 Authentification requise Réessayer en fournissant des paramètres d'authentification
403 Accès non autorisé Vérifier que l'utilisateur dispose des autorisations appropriées pour effectuer cette opération
404 Introuvable Vérifier que les données demandées se trouvent dans la Enterprise Control Room
409 Conflit S'assurer que les paramètres fournis sont corrects.
500 Erreur de serveur interne Vérifiez que le serveur est opérationnel.
501 Erreur d'autorisation Assurez-vous de disposer de l'autorisation requise

Journaux d'audit

Le journal d'audit affiche une entrée individuelle pour chaque entité migrée.

Journal d'audit montrant les détails de chaque entité migrée

Lorsque le processus de migration est lancé, une entrée Migration démarrée est enregistrée dans le journal d'audit. De même, lorsque le processus de migration est terminé, une entrée Migration terminée est enregistrée. Entre ces deux entrées, des entrées de migration sont enregistrées pour chaque entité migrée, par exemple les opérations Créer, Mettre à jour ou Télécharger.

Cliquez sur pour afficher les détails du processus.
Envoyer le commentaire