Lea y revise la documentación de Automation Anywhere

Cerrar contenidos

Contenidos

Abrir contenidos

API para la migración de datos desde Enterprise Control Room 10.x a Enterprise Control Room 11.x

  • Actualizado: 5/10/2019
    • 11.3.x
    • Explorar
    • Enterprise
    • Documentos de API

API para la migración de datos desde Enterprise Control Room 10.x a Enterprise Control Room 11.x

Como administrador de Enterprise Control Room con permisos de rol de Ver y administrar migración, use las API de migración para migrar datos de la versión de Enterprise Control Room 10.x a la versión de Enterprise Control Room 11.x actual.

Las API de migración le permiten hacer lo siguiente:

  1. Guardar o actualizar la configuración de la conexión a la base de datos de Enterprise Control Room 10.x
  2. Guardar o actualizar la configuración de la conexión a la base de datos de Bot Insight 2.x, de estar disponible
  3. Especificar la opción para migrar datos en función de roles, usuarios o bots
  4. Obtener una lista de datos según la opción especificada para la migración, es decir, Roles, Usuarios o Bots
  5. Ver el resumen del progreso de la migración
  6. Ver estadísticas de migración de la cantidad de entidades que se migraron correctamente o presentaron errores
  7. Obtener la lista de bots nuevos y actualizados de Enterprise Control Room 10.x posteriores a la migración
  8. Migrar archivos en forma masiva desde la carpeta Mis documentos de Enterprise Control Room 10.x después de la migración

Alternativamente, puede usar el Asistente de migración que se proporciona en Administración> Módulo de migración para migrar los datos de la interfaz de usuario de Enterprise Control Room. Consulte la descripción general de la migración para obtener detalles.

Nota: Los ejemplos que se incluyen en este artículo se presentan únicamente como referencia.

Extremo de API

Use los siguientes extremos para acceder a la API:

  1. Para el proceso de migración, utilice <la dirección URL de Enterprise Control Room>/v2/migration
  2. Para migrar archivos desde la carpeta Mis documentos de la instancia de Enterprise Control Room 10.x de origen una vez finalizado el proceso de migración, use <la dirección URL de Enterprise Control Room>/v1/migration

Por ejemplo:

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

API de proceso de migración

Las API de migración le permiten migrar datos de Enterprise Control Room 10.x a Enterprise Control Room de 11.x utilizando el extremo mencionado anteriormente.

Antes de acceder a las API de migración, primero debe usar la API de autenticación y pasarla como un token para utilizar una API de migración en particular.

  1. Utilice el método POST para generar un token con el extremo http(s)://<hostname:port>/v1/authentication. Para esto, ingrese la instancia de Enterprise Control Room como Nombre del servidor/Nombre del host/Dirección IP y el número de Puerto.

    Por ejemplo, https://crdevenv.com:81/v1/authentication

  2. Ingrese la siguiente solicitud de carga útil en los encabezados

    “X-Authorization”: “token de autorización”

    "Content-Type": “aplicación/json”

  3. Proporcione la siguiente solicitud de carga útil en el cuerpo:

    {

    "username": "<Nombre de usuario>",

    "password": "<Contraseña>"

    }
    • Por ejemplo:

      {

      "usename": "Elsa.Diaz",

      "password": "12345678"

      }

1. Conectarse a la base de datos de Enterprise Control Room de origen

Esta API le permite guardar y actualizar la configuración de la conexión a la base de datos de Enterprise Control Room 10.x de origen.

  1. Incluya los parámetros "X-Authorization" y "Tipo de contenido" en los encabezados.
  2. Proporcione los parámetros de las credenciales en el cuerpo.
  3. Utilice el método POST para conectarse a la base de datos de Enterprise Control Room 10.x utilizando el extremo http(s)://<nombre del host:puerto>/v2/migration/connection.
    • Por ejemplo, https://crdevenv.com:81/v2/migration/connection
  4. Proporcione los siguientes parámetros de la solicitud en el cuerpo:

    {

    "host": "cadena", "port": 0, "databaseName": "cadena", "username": "cadena", "password": "cadena", "integratedSecurity": verdadero, "encrypt": verdadero, "privateKey": "cadena", "repoPath": "cadena"

    }
    • Por ejemplo:

      {

      "host": "PRODUCTLT",

      "port": 1433,

      "databaseName": "CR104MIG",

      "username": "Elsa.Diaz",

      "password": "12345678",

      "integratedSecurity": verdadero,

      "encrypt": verdadero,

      "privateKey": "ABC123",

      "repoPath": "D:\\Data\Archivos del servidor de Automation Anywhere"

      }

  5. Haga clic en Enviar.

Descripción de los parámetros

Parámetro Descripción
host Nombre del host de la base de datos de Enterprise Control Room de origen.
port Número del puerto de la base de datos de Enterprise Control Room de origen.
databaseName Nombre de la base de datos de Enterprise Control Room de origen.
username Nombre de usuario para conectarse a la base de datos.
password Contraseña para conectarse a la base de datos.
integratedSecurity Un indicador de si se debe usar la autenticación de Windows al conectarse a la base de datos de origen. Establezca esto en verdadero si desea utilizar la autenticación de Windows. El valor predeterminado es falso.
encrypt Un indicador de si se debe utilizar una conexión segura a la base de datos de origen. Establezca esto en verdadero si desea utilizar una conexión segura. El valor predeterminado es falso.
privateKey La clave privada para descifrar los valores de las credenciales en la base de datos de origen. Puede definirla durante la configuración inicial de Enterprise Control Room.
repoPath La ruta del repositorio compartido donde se almacena el repositorio de Enterprise Control Room 10.x

2. Obtener los detalles de conexión almacenados

Esta API le permite obtener los detalles de conexión almacenados de la base de datos de Enterprise Control Room 10.x de origen desde donde se pueden migrar los datos.

  1. Incluya los parámetros "X-Authorization" y "Tipo de contenido" en los encabezados.
  2. Proporcione los parámetros de las credenciales en el cuerpo.
  3. Utilice el método GET para obtener la configuración de la conexión de la base de datos de Enterprise Control Room 10.x utilizando el extremo http(s)://<nombre del host:puerto>/v2/migration/connection.
    • Por ejemplo, https://crdevenv.com:81/v2/migration/connection
  4. Haga clic en Enviar.
  5. Puede ver el resultado en los datos del cuerpo:

    {

    "host": "productlt",

    "port": 1433,

    "databaseName": "CR104MIG",

    "username": "",

    "password": "",

    "integratedSecurity": verdadero,

    "encrypt": falso,

    "privateKey": "",

    "repoPath": "D:\\DATA\ARCHIVOS DEL SERVIDOR DE AUTOMATION ANYWHERE"

    }

Descripción de los parámetros

Parámetro Descripción
host Host de la base de datos de origen.
port Puerto de base de datos de origen.
databaseName Nombre de la base de datos de origen.
username Nombre de usuario para conectarse a la base de datos de origen.
password Contraseña para conectarse a la base de datos de origen.
integratedSecurity Un indicador de si se debe usar la autenticación de Windows al conectarse a la base de datos de origen. El valor predeterminado es falso.
encrypt Un indicador de si se debe usar la conexión segura a la base de datos de origen. El valor predeterminado es falso.
privateKey La clave privada para descifrar los valores de las credenciales en la base de datos de origen.
repoPath La ruta del repositorio compartido donde se almacena el repositorio de Enterprise Control Room 10.x

3. Conectarse a la base de datos de Bot Insight 2.x si está disponible

Esta API le permite conectarse a la base de datos de Bot Insight 2.x de origen, si está disponible, para migrar datos analíticos.

  1. Incluya los parámetros "X-Authorization" y "Tipo de contenido" en los encabezados.
  2. Proporcione los parámetros de las credenciales en el cuerpo.
  3. Utilice el método POST para conectarse a la base de datos de Bot Insight utilizando el extremo http(s)://<nombre del host:puerto>/v2/migration/connection /botinsight
    • Por ejemplo, https://crdevenv.com:81/v2/migration/connection/botinsight
  4. Proporcione los siguientes parámetros de la solicitud en el cuerpo:

    {

    "host": "cadena",

    "port": 0,

    "databaseName": "cadena",

    "username": "cadena",

    "password": "cadena",

    "integratedSecurity": verdadero,

    "encrypt": verdadero,

    "serverUrl": "cadena"

    }
    • Por ejemplo:

      {

      "host": "Productlt",

      "port": 8091,

      "databaseName": "BotInsight",

      "username": "Elsa.Diaz",

      "password": "12345678",

      "integratedSecurity": verdadero,

      "encrypt": verdadero,

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

      }

  5. Haga clic en Enviar.
  6. Los parámetros de la conexión se guardan correctamente cuando el estado de respuesta es 200 Operación exitosa.

Descripción de los parámetros

Parámetro Descripción
host Nombre del host de la base de datos de Bot Insight de origen.
port Número del puerto de la base de datos de Bot Insight de origen.
databaseName Nombre de la base de datos de Bot Insight de origen
nombre de usuario Nombre de usuario para conectarse a la base de datos.
contraseña Contraseña para conectarse a la base de datos.
integratedSecurity Un indicador de si se debe usar la autenticación de Windows al conectarse a la base de datos de origen. Establezca esto en verdadero si desea utilizar la autenticación de Windows. El valor predeterminado es falso.
encrypt Un indicador de si se debe utilizar una conexión segura a la base de datos de origen. Establezca esto en verdadero si desea utilizar una conexión segura. El valor predeterminado es falso.
serverUrl Dirección URL del servidor donde se encuentra Bot Insight Visualization ServerPort

4. Obtener los detalles de conexión almacenados

Esta API le permite recuperar los detalles de conexión almacenados de la base de datos de Bot Insight 2.x de origen desde donde se pueden migrar los datos.

  1. Incluya los parámetros "X-Authorization" y "Tipo de contenido" en los encabezados.
  2. Proporcione los parámetros de las credenciales en el cuerpo.
  3. Utilice el método GET para obtener la configuración de la conexión de la base de datos de Enterprise Control Room 10.x utilizando el extremo http(s)://<nombre del host:puerto>/v2/migration/connection/botinsight.
    • Por ejemplo, https://crdevenv.com:81/v2/migration/connection/botinsight
  4. Haga clic en Enviar.
  5. Los parámetros de la conexión se guardan correctamente cuando el estado de respuesta es 200 Configuración de migración.
  6. Puede ver el resultado en los datos del cuerpo:

    {

    "host": "Productlt",

    "port": 8091,

    "databaseName": "BotInsight",

    "username": "Elsa.Diaz",

    "password": "12345678",

    "integratedSecurity": verdadero,

    "encrypt": verdadero,

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

    }

Descripción de los parámetros

Parámetro Descripción
host Nombre del host de la base de datos de Bot Insight de origen.
port Número del puerto de la base de datos de Bot Insight de origen.
databaseName Nombre de la base de datos de Bot Insight de origen.
username Nombre de usuario para conectarse a la base de datos.
password Contraseña para conectarse a la base de datos.
integratedSecurity Un indicador de si se debe usar la autenticación de Windows al conectarse a la base de datos de origen. Establezca esto en verdadero si desea utilizar la autenticación de Windows. El valor predeterminado es falso.
encrypt Un indicador de si se debe utilizar una conexión segura a la base de datos de origen. Establezca esto en verdadero si desea utilizar una conexión segura. El valor predeterminado es falso.
serverUrl Dirección URL del servidor donde se encuentra Bot Insight Visualization ServerPort

5. Lista de las entidades de TYPE disponibles para la migración en la base de datos de origen

Esta API devuelve la lista de entidades disponibles para la migración en la base de datos de origen por el parámetro TYPE. Usando cualquiera de las opciones: Rol, Usuario, Bot o Programa, puede migrar todos los datos asociados con el parámetro elegido.

Nota: Para la migración selectiva de datos, es decir, seleccionando solo ciertos datos según un parámetro específico, use el Asistente de migración proporcionado en Enterprise Control Room.
  1. Ingrese los parámetros "X-Authorization" en los encabezados.
  2. Utilice el método GET para conectarse a la base de datos de Enterprise Control Room utilizando el extremo http(s)://<nombre del host:puerto>/v2/migration/connection /entities seguido de un parámetro TYPE que podría incluir cualquiera de las opciones: Roles, Usuarios, Bots o Programas.
    • Por ejemplo, https://crdevenv.com:81/v2/migration/connection/entities?Type=ROL
  3. Haga clic en Enviar.
  4. Los datos se devuelven cuando el estado de respuesta es 200.
  5. La lista de entidades basadas en el parámetro TYPE se muestra en el cuerpo.

    {

    "entidades":

    [

    {"id": "0", "type": "ROL", "sourceId": "1", "targetId": "0", "name": "Admin", "status": "LISTO", "reason": ""},

    { "id": "0", "type": "ROL", "sourceId": "2", "targetId": "0", "name": "Básico", "status": "LISTO", "reason": ""},

    { "id": "0", "type": "ROL", "sourceId": "3", "targetId": "0", "name": "IQBotValidator", "status": "LISTO", "reason": ""},

    { "id": "0", "type": "ROL", "sourceId": "4", "targetId": "0", "name": "AnalyticsExperts", "status": "LISTO", "reason": ""},

    { "id": "0", "type": "ROL", "sourceId": "5", "targetId": "0", "name": "AnalyticsConsumers", "status": "LISTO", "reason": ""},

    { "id": "0", "type": "ROL", "sourceId": "6", "targetId": "0", "name": "BotAgentUser", "status": "LISTO", "reason": ""},

    { "id": "0", "type": "ROL", "sourceId": "7", "targetId": "0", "name": "BotFarmAdmin", "status": "LISTO", "reason": ""},

    { "id": "0", "type": "ROL", "sourceId": "8", "targetId": "0", "name": "IQBotServices", "status": "LISTO", "reason": ""},

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

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

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

    ]

    }

Descripción de los parámetros

Parámetro Descripción
id ID de migración
type Tipo de entidad seleccionada para la migración: Rol, Usuario o Bot
sourceId ID de la entidad en la base de datos de origen
targetId ID de la entidad después de la migración en la base de datos de destino
name Nombre de la entidad en la base de datos de origen
status El estado de migración para esa entidad en particular
reason El motivo por el cual se produjo un error en la migración para esa entidad en particular

6. Preparar los datos de migración basados en la entrada del usuario

Esta API le permite migrar entidades con datos asociados en función de la subsección del tipo de entidad especificado para la migración.

  1. Incluya los parámetros "X-Authorization" y "Tipo de contenido" en los encabezados.
  2. Utilice el método POST para migrar los datos utilizando el extremottp(s)://<nombre del host:puerto>/v2/migration/prepare
    • Por ejemplo, https://crdevenv.com:81/v2/migration/prepare
  3. Proporcione la siguiente solicitud de carga útil en el cuerpo:

    {

    "seleccionado":

    [

    {"type": "<tipo de entidad>",

    "sourceId": "cadena"}

    ],

    "excludes": ["<tipo de entidad>"

    ]

    }
    • Por ejemplo:

      {"seleccionado": [{"type": "ROL", "sourceId": "12"}], "excludes": ["BOT"]}

  4. Haga clic Enviar
  5. Los datos se enumeran correctamente para la migración cuando el estado de respuesta es 200.
  6. El resultado se muestra en el cuerpo.

    {"seleccionado":

    [

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

    "excludes": ["BOT"]

    }

Descripción de los parámetros

Parámetro Descripción
type Tipo de entidad seleccionada para la migración: Rol, Usuario o Bots y Programas.
sourceId ID de la entidad en la base de datos de origen.
excludes

El nombre de la entidad que se excluye de la migración. Las opciones están disponibles según el tipo de entidad seleccionada.

Por lo tanto, cuando selecciona Rol o Usuario, puede Excluir bots y programas; cuando selecciona Bots y Programas, puede Excluir MetaBots o Sobrescribir bots existentes.

7. Iniciar la migración

Esta API le permite iniciar el proceso de migración.

  1. Ingrese los parámetros "X-Authorization" en los encabezados.
  2. Utilice el método POST para migrar los datos utilizando el extremo ttp(s)://<nombre del host:puerto>/v2/migration/start/async
    • Por ejemplo, https://crdevenv.com:81/v2/migration/start/async

  3. Haga clic en Enviar.
  4. La migración de datos se inicia correctamente cuando el estado de respuesta es 200 Operación correctamente realizada.
  5. El resultado se muestra en los datos del cuerpo.

    {

    "id": 1,

    "name": "2018.07.17.16.13.48.elsa.diaz",

    "createdBy": 1,

    "migrationType": "ROLE_EXCLUDE_BOT_SCHEDULE"

    }

Descripción de los parámetros

Parámetro Descripción
id ID de migración
nombre Nombre del usuario que inició la migración
createdBy ID de la entidad que inició la migración, es decir, el administrador de Enterprise Control Room
migrationType El tipo de migración elegido: Rol, Usuario o Bots y Programas

8. Objeto de migración por ID

Esta API enumera los detalles del objeto de migración en función del ID que se genera utilizando la API Iniciar migración.

  1. Ingrese los parámetros "X-Authorization" en los encabezados.
  2. Utilice el método GET para obtener los detalles del objeto por ID utilizando el extremo http(s)://<nombre del host:puerto>/v2/migration/<id>
    • Por ejemplo, https://crdevenv.com:81/v2/migration/9

  3. Haga clic en Enviar.
  4. Los detalles del objeto se muestran correctamente cuando el estado de la respuesta es 200.
  5. Los detalles se muestran en los datos del cuerpo:

    {

    "id": "9",

    "name": "2018.07.17.16.13.48.elsa.diaz",

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

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

    "createdBy": "1",

    "migrationType": "ROLE_EXCLUDE_BOT_SCHEDULE",

    "entidades": []

    }

Descripción de los parámetros

Parámetro Descripción
id ID de migración
nombre Nombre del usuario que inició la migración
startTime El momento en que se inició la migración
endTime El momento en que se completó la migración
createdBy ID de la entidad que inició la migración, es decir, el administrador de Enterprise Control Room
entities Lista de entidades migradas durante el proceso de migración
migrationType El tipo de migración elegido: Rol, Usuario o Bots y Programas

9. Progreso de migración

Esta API le permite ver el proceso de migración en proceso.

  1. Incluya los parámetros "X-Authorization" y "Tipo de contenido" en los encabezados.
  2. Proporcione los parámetros de las credenciales en el cuerpo.
  3. Utilice el método GET para obtener los detalles del objeto por ID utilizando el extremo http(s)://<nombre del host:puerto>/v2/migration/pogress
    • Por ejemplo, https://crdevenv.com:81/v2/migration/progress

  4. Haga clic en Enviar.
  5. Los detalles del objeto se muestran correctamente cuando el estado de la respuesta es 200.
  6. Los detalles se muestran en los datos del cuerpo:

    {

    "migración":

    { "id": "10", "name": "2018.07.17.16.55.59.elsa.diaz", "startTime": "2018-07-17T11:25:59.800Z", "endTime": "2018-07-17T11:26:16.002Z", "createdBy": "1", "migrationType": "BOT_EXCLUDE_MetaBot", "entidades": [] },

    "current": "PROGRAMA",

    "progress":

    {

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

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

    }

    }

Descripción de los parámetros

Parámetro Descripción
id ID de migración
nombre Se muestra el nombre de la migración
startTime Marca de tiempo de cuando se inició el proceso de migración
endTime Marca de tiempo de cuando se completó el proceso de migración. Nulo cuando la migración está en proceso
createdBy ID del usuario que creó/inició el proceso de migración
current Tipo de entidad que se está migrando actualmente: ROL, USUARIO, CREDENCIAL, BOT o PROGRAMA
progress

Progreso de las entidades:

  • total: número total de entidades del tipo específico que se migrarán
  • successful: número de entidades del total migrado correctamente
  • failed: número de entidades del total que no se pudieron migrar
  • skipped: número de entidades del total omitido durante la migración

10. Estadísticas de migración: cantidad de entidades que se migraron correctamente o presentaron error por migración

Esta API le permite ver el número de entidades que se migraron correctamente o presentaron error por migración.

  1. Ingrese los parámetros "X-Authorization" en los encabezados.
  2. Utilice el método GET para obtener los detalles del objeto por ID utilizando el extremo http(s)://<nombre del host:puerto>/v2/migration/statistics
    • Por ejemplo, https://crdevenv.com:81/v2/migration/statistics

  3. Haga clic en Enviar.
  4. Los detalles del objeto se muestran correctamente cuando el estado de la respuesta es 200.
  5. Los detalles se muestran en los datos del cuerpo:

    {

    "elementos": [

    { "id": "1", "name": "2018.07.13.11.14.59.elsa.diaz", "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.elsa.diaz", "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.elsa.diaz", "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.elsa.diaz", "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.elsa.diaz", "startTime": "2018-07-13T08:09:53.113Z", "endTime": "2018-07-13T08:10:02.673Z", "createdBy": "1", "duration": "9s", "numSuccess": 4, "numFailed": 0, "numSkipped": 0}

    ]

    }

Descripción de los parámetros

Parámetro Descripción
id migration id
nombre Se muestra el nombre de la migración
startTime Marca de tiempo de cuando se inició el proceso de migración
endTime Marca de tiempo de cuando se completó el proceso de migración. Nulo cuando la migración está en proceso
createdBy ID del usuario que creó el objeto
duration Duración de la migración: segundos o nanosegundos
numSuccess Número de elementos migrados correctamente
numFailed Número de elementos que no se pudieron migrar
numSkipped Número de elementos que se omitieron durante la migración

API de proceso posterior a la migración

Utilice las API de migración una vez que el proceso se haya completado para:

  1. Importar archivos desde la carpeta Mis documentos de Enterprise Control Room 10.x
  2. Obtener la lista de bots nuevos o modificados de Enterprise Control Room 10.x desde la última migración ejecutada
    Nota: Antes de acceder a las API, primero debe usar la API de autenticación y pasarla como un token para usar una API de migración en particular.
  3. Utilice el método POST para generar un token con el extremo http(s)://<hostname:port>/v1/authentication. Para esto, ingrese la instancia de Enterprise Control Room como Nombre del servidor/Nombre del host/Dirección IP y el número de Puerto.

    Por ejemplo, https://crdevenv.com:81/v1/authentication

  4. Ingrese la siguiente solicitud de carga útil en los encabezados

    “X-Authorization”: “token de autorización”

    "Content-Type": “aplicación/json”

  5. Proporcione la siguiente solicitud de carga útil en el cuerpo:

    {

    "username": "<Nombre de usuario>",

    "password": "<Contraseña>"

    }

  • Por ejemplo:

    {

    "usename": "Elsa.Diaz",

    "password": "12345678"

    }

Importante: Si aparece el código de error 404 al usar cualquiera de las API posteriores a la migración, reutilice la API para obtener la lista de carpetas raíz de Enterprise Control Room 10.x; es decir, http(s)://<nombre del host:puerto>/v1/migration/legacyrepository/rootDirectories.

A. Importar archivos desde la carpeta Mis documentos

Use cierto conjunto de API para migrar archivos de la carpeta Mis documentos de Enterprise Control Room 10.x. Estas API le permiten importar una gran cantidad de archivos que pueden usarse en los bots como dependencias o que son útiles por sí solos para la automatización.

1. Obtener la lista de carpetas raíz de Enterprise Control Room 10.x

Esta API le permite obtener la lista de carpetas disponibles en el repositorio de Enterprise Control Room 10.x. Esto le ayudará a comprender la estructura de carpetas que estaba disponible en Enterprise Control Room de origen.

  1. Ingrese los parámetros "X-Authorization" en los encabezados.
  2. Utilice el método GET para obtener los detalles del objeto por ID empleando el extremo http(s)://<nombre del host:puerto>/v1/migration/legacyrepository/rootDirectories seguido por el parámetro excludeMetaBot).
    • Por ejemplo, https://crdevenv.com:81/v1/migration/legacyrepository/rootDirectories?excludeMetaBot=verdadero

  3. Haga clic Enviar
  4. Los detalles del objeto se muestran correctamente cuando el estado de la respuesta es 200.
  5. Los detalles se muestran en los datos del cuerpo:

    [

    {"name": "Mis documentos", "path": "Automation Anywhere\\Mis documentos"},

    {"name": "Mis ejecutables", "path": "Automation Anywhere\\Mis ejecutables"},

    {"name": "Mis informes", "path": "Automation Anywhere\\Mis informes"},

    {"name": "Mis secuencias de comandos", "path": "Automation Anywhere\\Mis secuencias de comandos"},

    {"name": "Mis tareas", "path": "Automation Anywhere\\Mis tareas"},

    {"name": "Mi flujo de trabajo", "path": "Automation Anywhere\\Mi flujo de trabajo"}

    ]

Descripción de los parámetros

Parámetro Descripción
nombre Nombre del directorio/carpeta
path Ruta del directorio/carpeta

2. Obtener la lista de subcarpetas de una carpeta raíz desde Control Room 10.x

Esta API le permite obtener la lista de subcarpetas para una carpeta raíz dada disponible en el repositorio de Enterprise Control Room 10.x. Esto le ayudará a comprender la estructura de carpetas de Enterprise Control Room de origen.

  1. Ingrese los parámetros "X-Authorization" en los encabezados.
  2. Utilice el método GET para obtener los detalles del objeto por ID empleando el extremo http(s)://<nombre del host:puerto>/v1/migration/legacyrepository/childDirectories seguido por el parámetro path.
    • Por ejemplo, https://crdevenv.com:81/v1/migration/legacyrepository/childDirectories?path=Automation Anywhere\Mis documentos

  3. Haga clic en Enviar.
  4. Los detalles del objeto se muestran correctamente cuando el estado de la respuesta es 200.
  5. Los detalles se muestran en los datos del cuerpo:

    {

    "folders":

    [

    {"name": "Archivos de registro", "path": "Automation Anywhere\\Mis documentos\\Archivos de registro"}

    ]

    }

Descripción de los parámetros

Parámetro Descripción
folders Lista de subdirectorios
nombre Nombre del directorio/carpeta
path Directorio/ruta de la carpeta

3. Obtener la lista de archivos en la carpeta determinada

Esta API le permite obtener la lista de archivos disponibles en una carpeta determinada en el repositorio de Enterprise Control Room de origen.

  1. Ingrese los parámetros "X-Authorization" en los encabezados.
  2. Utilice el método GET para obtener los detalles del objeto por ID empleando el extremo http(s)://<nombre del host:puerto>/v1/migration/legacyrepository/childFiles seguido por los parámetros path) y exclude MetaBot).
    • Por ejemplo, https://crdevenv.com:81/v1/migration/legacyrepository/childFiles?path=Automation Anywhere\My Docs\Log-Files&excludeMetaBot=falso

  3. Haga clic Enviar
  4. Los detalles del objeto se muestran correctamente cuando el estado de la respuesta es 200.
  5. Los detalles se muestran en los datos del cuerpo:

    {

    "files":

    [

    { "id": "280", "name": "ActiveMQServer-2018-Jul-17-2.log.zip", "path": "Automation Anywhere\\Mis documentos\\Archivos de registro\\ActiveMQServer-2018-Jul-17-2.log.zip"},

    { "id": "281", "name": "IgniteServer-2018-Jul-17-4.log.zip", "path": "Automation Anywhere\\Mis documentos\\Archivos de registro\\IgniteServer-2018-Jul-17-4.log.zip"},

    { "id": "283", "name": "WebCR_Ignite-2018-Jul-17-4.log.zip", "path": "Automation Anywhere\\Mis documentos\\Archivos de registro\\WebCR_Ignite-2018-Jul-17-4.log.zip"},

    { "id": "284", "name": "WebCR_License-2018-Jul-17-4.log.zip", "path": "Automation Anywhere\\Mis documentos\\Archivos de registro\\WebCR_License-2018-Jul-17-4.log.zip"},

    { "id": "292", "name": "WebCR_Migration-2018-Jul-17-4.log", "path": "Automation Anywhere\\Mis documentos\\Archivos de registro\\WebCR_Migration-2018-Jul-17-4.log"},

    { "id": "285", "name": "WebCR_Migration-2018-Jul-17-4.log.zip", "path": "Automation Anywhere\\Mis documentos\\Archivos de registro\\WebCR_Migration-2018-Jul-17-4.log.zip"},

    { "id": "293", "name": "WebCR_Migration-2018-Jul-17-4.txt", "path": "Automation Anywhere\\\\Mis documentos\\Archivos de registro\\WebCR_Migration-2018-Jul-17-4.txt"}

    ]

    }

Descripción de los parámetros

Parámetro Descripción
files Lista de subarchivos
id ID de archivo del bot
nombre Nombre del directorio/carpeta
path Directorio/ruta de la carpeta

4. Buscar una carpeta por nombre en Enterprise Control Room 10.x

Esta API le permite buscar una carpeta por el nombre dado desde el repositorio Mis documentos de Enterprise Control Room de origen.

  1. Ingrese los parámetros "X-Authorization" en los encabezados.
  2. Utilice el método GET para obtener los detalles del objeto por ID empleando el extremo http(s)://<nombre del host:puerto>/v1/migration/legacyrepository/folders seguido por el parámetro taskName.
    • Por ejemplo, https://crdevenv.com:81/v1/migration/legacyrepository/folders?taskName=Import-Table

  3. Haga clic Enviar
  4. Los detalles del objeto se muestran correctamente cuando el estado de la respuesta es 200.
  5. Los detalles se muestran en los datos del cuerpo:

    {

    "paths":

    ["Automation Anywhere\\Mis documentos\\Import-Table"]

    }

Descripción de los parámetros

Parámetro Descripción
paths Lista de directorio/ruta de la carpeta

5. Obtener la lista de archivos para una carpeta dada en Enterprise Control Room 10.x

Esta API le permite recuperar una lista de archivos desde una carpeta determinada en el repositorio Mis documentos de Enterprise Control Room de origen.

  1. Ingrese los parámetros "X-Authorization" en los encabezados.
  2. Utilice el método POST para obtener una lista de archivos para una carpeta determinada utilizando el extremo http(s)://<nombre del host:puerto>/v1/legacyrepository/files
    • Por ejemplo, https://crdevenv.com:81/v1/legacyrepository/files

  3. Proporcione la lista de rutas de carpeta como solicitud de carga útil en el cuerpo.

    [

    "cadena"

    ]
    • Por ejemplo, lo siguiente enumera los archivos disponibles:

      [

      "Automation Anywhere\\Mis documentos\\Import-Table"

      ]

  4. Haga clic Enviar
  5. Los detalles del objeto se muestran correctamente cuando el estado de la respuesta es 200.
  6. Los detalles de la respuesta se muestran en los datos del cuerpo:

    {

    "files":

    [

    { "id": 1281, "type": "BOT", "sourceId": "1281", "targetId": 0, "name": "Automation Anywhere\\Mis documentos\\Import-Table\\Import-Table.txt", "status": "LISTO", "reason": ""},

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

    ]

    }

Descripción de los parámetros

Parámetro Descripción
archivos Lista de subarchivos
type El tipo de archivo
sourceId ID de la entidad en la base de datos de origen
targetId ID de la entidad después de la migración en la base de datos de destino
nombre Nombre del directorio/carpeta
estado Estado de la respuesta: SUCCESS, SKIPPED o FAILED
reason Descripción de la razón del estado FAILED o SKIPPED

B. Migrar bots nuevos o modificados desde 10.x desde la última migración en 11.x

Esta API le permite obtener una lista de los bots nuevos o modificados en Enterprise Control Room versión 10.x de origen después de que los datos se hayan migrado a Enterprise Control Room versión 11.x de destino. Esencialmente, esta API le permite seguir usando su entorno 10.x mientras se prepara el entorno 11.x para entrar en producción.

  1. Ingrese los parámetros "X-Authorization" en los encabezados.
  2. Utilice el método POST para obtener los detalles del objeto por ID utilizando el extremo http(s)://<nombre del host:puerto>/v1/legacyrepository/changedfiles
    • Por ejemplo, https://crdevenv.com:81/v1/legacyrepository/changedfiles
  3. Proporcione la lista de rutas de carpeta como solicitud de carga útil en el cuerpo.

    {

    "changeSince": "<fecha y hora de la última migración>"

    }

    • Por ejemplo, a continuación se enumeran los nombres de los bots que se actualizaron después de la migración.

      {

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

      }

    Consejo: No especifique el parámetro changeSince para considerar el delta para la última fecha y hora de migración.
  4. Haga clic en Enviar.
  5. Los detalles del objeto se muestran correctamente cuando el estado de la respuesta es 200.
  6. Los detalles de la respuesta se muestran en los datos del cuerpo:

    {

    "changedfiles":

    [

    {"type": "BOT", "sourceId": "6", "name": "Automation Anywhere\\Mis tareas\\Tareas de muestra\\Import-Table.atmx"},

    {"type": "BOT", "sourceId": "7", "name": "Automation Anywhere\\Mis tareas\\Tareas de muestra\\List-Variable.atmx"}

    ]

    }

Descripción de los parámetros

Parámetro Descripción
changedFiles Lista de entidades que se modificaron o son nuevas desde la última ejecución de la migración
type El tipo de entidad
sourceId ID de la entidad en la base de datos de origen
nombre Nombre del directorio/carpeta

Códigos de respuesta de API

Código de estado HTTP(s) Respuesta - Descripción Acción correctiva
200 Operación correctamente realizada No corresponde
400 Solicitud incorrecta Vuelva a intentarlo con parámetros válidos
401 Requiere autenticación Vuelva a intentar proporcionando parámetros de autenticación
403 Acceso no autorizado Asegúrese de tener los permisos adecuados para realizar esta operación
404 No se encontró Asegúrese de que los datos solicitados estén presentes en Enterprise Control Room
409 Conflicto Asegúrese de que los parámetros proporcionados sean correctos
500 Error de servidor interno Asegúrese de que el servidor esté en funcionamiento
501 Error de permisos Asegúrese de tener los permisos necesarios

Registros de auditoría

El Registro de auditoría muestra la entrada individual para cada entidad que se migra.

Registro de auditoría que muestra los detalles de cada entidad que se migra

Cuando se inicia el proceso de migración, se registra una entrada Migración iniciada en el Registro de auditoría. Del mismo modo, cuando se completa el proceso de migración, se registra una entrada Migración finalizada. Entre estas dos entradas, se registran las entradas de migración para cada entidad que se migra, como las operaciones Crear, Actualizar o Cargar.

Haga clic en para ver los detalles del proceso.
Enviar comentarios