Migración de carpetas clásicas a modernas

Las carpetas modernas se han presentado para mejorar y simplificar la orquestación de automatizaciones y ofrecer varias ventajas en comparación con las carpetas clásicas.

Nota: Las carpetas clásicas ya no son el estándar para administrar automatizaciones y han sido reemplazadas por carpetas modernas, una alternativa mejor y con más funciones. Por esta razón, ya hemos eliminado la opción de crear nuevas carpetas clásicas y dejaremos de usar las carpetas clásicas a partir de octubre de 2022.

Para ayudarte en la transición a carpetas modernas, puedes usar el asistente de migración moderna para recrear fácilmente tu jerarquía y entidades de carpetas clásicas en carpetas modernas, conservando todas las dependencias.

Resumen del proceso de migración

Para convertir tu implementación actual, en su totalidad o en parte, para utilizar las carpetas modernas, algunas entidades tendrán que volver a implementarse mientras que otras tendrán que recrearse por completo.

He aquí una descripción general de lo que hace el asistente de migración durante y después de la migración:

• Vuelve a crear cada carpeta clásica como carpeta moderna con un nombre de forma Migrated <folder name>.
• Para cada entorno crea una subcarpeta correspondiente en la carpeta moderna de destino. Si solo hay un entorno, no crea ninguna subcarpeta.
• Vuelve a desplegar cada proceso a la carpeta (o subcarpeta) moderna que corresponda con su carpeta o entorno anterior.
• Migra activos, colas y desencadenadores desde cada carpeta clásica a la carpeta moderna correspondiente.
• Migra cada entidad de Test Suite a la subcarpeta moderna que corresponde con el entorno de carpeta clásica al que pertenecía anteriormente.

• Migra robots y cuentas de usuario a las carpetas modernas correspondientes:

  • Asigna cada robot atendido clásico a una cuenta de usuario y configura cada cuenta de usuario con configuración de automatización personal (antes conocida como configuración de robot atendido), y acceso a las carpetas modernas y máquinas correspondientes necesarias para ejecutar las automatizaciones atendidas que ejecutaba en carpetas clásicas.En cuanto a los roles, pueden ocurrir dos escenarios:

    • Si la cuenta de usuario a la que ha sido asignado un attended robot no estaba asignada al tenant en el momento que comenzó la migración, se incluirá automáticamente en el tenant y se le otorgará el rol de tenant Permite ser Usuario de automatización.
    • Si la cuenta de usuario a la que se asigna un robot atendido clásico ya estaba asignada al tenant, sus roles no cambian, por lo que debes concederle manualmente el rol a nivel de tenant Permitir ser usuario de automatización . Esto evita que las automatizaciones se rompan.

  • Asigna cada Unattended Robot clásico a cuentas de robot (recomendado), a menos que se configure de otra manera, y configura cada cuenta de robot con acceso a las carpetas modernas y máquinas correspondientes necesarias para ejecutar las automatizaciones que el Unattended Robot ejecutó en carpetas clásicas.

    Otorga el rol de nivel de carpeta Automation User a cuentas de robot existentes que se asignan a robots desatendidos clásicos.

    Ahora, las cuentas de robot generadas automáticamente reciben el rol de nivel de carpeta Automation User y el rol de nivel de tenant Permitir ser Automation User.

• Algunas licencias de usuario que incluyen capacidad atendida pueden quedar no disponibles después de que se complete la migración. Esto se debe a que, en carpetas modernas, cada usuario solo necesita una licencia de usuario para automatizaciones personales (anteriormente atendidas). Si el mismo usuario tenía varias licencias, conserva la licencia superior y se libera la inferior.

  Por ejemplo, si uno de los robots atendidos del usuario usaba una licencia Attended y otro usaba una licencia Citizen Developer, el usuario retiene la licencia Citizen Developer y se libera la licencia Attended.

  Importante:

  Aunque el asistente puede simplificarte enormemente el proceso de migración, hay tareas posteriores a la migración que debes realizar para que tus automatizaciones puedan funcionar correctamente.

  Asegúrate de que tienes los conocimientos requeridos y de que asignas tiempo para realizar estas tareas antes de comenzar la migración.

Cambios en la configuración de tenant

Después de ejecutar el asistente de migración moderna, algunos ajustes del nivel de tenant cambian automáticamente.Estos cambios son necesarios para usar carpetas modernas.

Se aplican los cambios siguientes después de que todas las carpetas clásicas se hayan migrado con éxito:

• Se aplica el inicio de sesión interactivo.

  Después de completar la migración, los usuarios deben actualizar su configuración de conexión de UiPath Studio o UiPath Assistant para cambiar de usar una clave de máquina a usar inicio de sesión interactivo para poder trabajar en carpetas modernas.

• Las carpetas clásicas y sus entidades siguen siendo utilizables.

  Puedes conservarlos hasta que se complete la validación, después de lo cual puedes eliminarlos.

• Las asignaciones de cuenta-máquina están habilitadas en el nivel de tenant.

Requisitos previos

Permisos

• Para poder ejecutar con éxito el asistente de migración moderna, debes ser administrador de organización.

• Para poder abrir el asistente de migración moderna necesitas los siguientes permisos:

  • Roles: ver, crear y editar
  • Configuración: ver y editar
  • Usuarios: ver, crear y editar
  • Robots: ver, crear, editar y eliminar
  • Carpetas: crear y editar.

Limitación de volumen

El asistente de migración moderna no es adecuado para implementaciones grandes, que requieren herramientas de migración y estrategias específicas.

Te recomendamos no usar el asistente de migración en carpetas que contengan más de 2000 robots clásicos.Esto puede ocasionar incidencias de rendimiento y causar que la migración falle.

Paso 1. Uso del asistente de migración moderna

Preparación para la migración

Importante:

Es importante que no hagas ningún cambio de configuración en los ajustes de las carpetas clásicas hasta que se complete la migración.

Please limit pre-migration checks and changes to the ones laid out below.

Problema conocido

Después de iniciar la migración no podrás editar desencadenadores de cola en carpetas clásicas. In el caso de que surjan problemas que requieran editar un desencadenador de cola, no podrás usar el desencadenador de cola defectuoso entre el tiempo en que se inicia la migración y el tiempo en el que se completa la migración con éxito.

Inclusión y exclusión de carpetas

Antes de iniciar el asistente, añádete a todas las carpetas clásicas que quieres migrar.

Las carpetas a las que no estés asignado no se migran.

Inclusión y exclusión de robots clásicos

Antes de iniciar el asistente, comprueba que todos los robots que quieres migrar están añadidos a un entorno.

Se supone que los robots clásicos que no forman parte de ningún entorno no están en uso y no son objetivo de la migración.

Importante: si no se migra un robot, los valores de robot de activo y las programaciones de proceso de dicho robot tampoco se migran, a menos que sean usados por otro robot que sí se migra.

Evitar la elevación de permiso

Después de la migración, a los usuarios atendidos y las cuentas robot se les asigna automáticamente el rol Automation Users en nivel de carpeta (en la carpeta correspondiente a la que se asignaron en el tiempo de migración). Si has personalizado los roles de nivel de servicio o la regla de asignación de licencia para este grupo, te recomendamos que elimines cualquier rol elevado o licencia extra de este grupo antes de continuar con la migración.

Comprobar que no hay trabajos en ejecución

Es importante asegurarse de que, antes de iniciar la migración, no se está ejecutando ningún trabajo.

Si existen desencadenadores que iniciarían un trabajo durante la migración, te recomendamos que los deshabilites, y que los vuelvas a habilitar después de que finalice la migración.

Antes de iniciar la migración puedes comprobar el estado del trabajo desde la página Carpeta > Monitorización de cada carpeta clásica que se va a migrar.

Importante: cuando se inicie la migración, todos los trabajos que no estén en un estado final se cancelarán. Si un trabajo cancelado no alcanza el estado detenido cuando concluya la migración, la migración falla con un error relacionado.

Uso del asistente

Para migrar carpetas clásicas a carpetas modernas para un tenant:

1. Ve a Tenant > Configuración.

   Se abre la página Configuración en la pestaña General.

2. En la sección Carpetas clásicas, haz clic en Iniciar migración.

   Se abre el asistente de migración moderna en el paso Comenzar.

3. Revisa la información y, bajo la sección Resumen, haz clic en Copiar el resumen anterior y guarda dicha información para tus registros.

   El resumen enumera los tipos y número de entidades que se incluyen para la migración.

   Nota:

   • Solo se seleccionarán para la migración aquellas carpetas clásicas a las que tienes acceso. Las carpetas donde no has sido agregado no se migrarán.
   • Se supone que los robots clásicos que no se agregan a un entorno no están en uso y no se seleccionan para migración.
4. Cuando estés listo, haz clic en Siguiente para continuar con el paso Usuarios atendidos.

Uso del asistente para usuarios atendidos

Como en carpetas modernas gestionamos la relación entre usuarios y robots de forma diferente y creamos el robot del usuario automáticamente, es preciso asignar cada robot atendido clásico a la cuenta del usuario que lo utiliza.

La página Usuarios atendidos enumera todos los robots atendidos encontrados en las carpetas clásicas objetivo y sus detalles.

En la columna Cuenta de usuario destino, para cada robot atendido encontrado, debes seleccionar la cuenta del usuario que utiliza el robot atendido, basándose en la información de las demás columnas.

Importante:

• Si no configuras una cuenta para un robot, dicho robot no se migrará. Los procesos asociados con dicho robot ya no se podrán ejecutar.
• Si el nombre de usuario de un robot attended involucrado en la migración no contiene el carácter @, la migración no se realizará correctamente. Para solucionarlo, los usuarios locales deben convertirse en usuarios del directorio. Esto se hace automáticamente durante la instalación o la actualización, siempre que los usuarios afectados inicien sesión en Orchestrator al menos una vez. Si no es así, puedes utilizar este script para convertirlos:

  DECLARE @domain VARCHAR(100) = 'your-domain-name-here'
  UPDATE u
  SET
      u.[UserName] = CONCAT(u.[UserName], '@', lower(@domain)),
      u.[Type] = 2
  FROM
      [dbo].[Users] u
      JOIN [dbo].[UserLogins] l ON u.[Id] = l.[UserId]
  WHERE 
      u.[Type] = 0
      AND l.[LoginProvider] = 'Windows'
      AND u.[IsDeleted] = 0

1. Para cada cuenta destino que no sea correcta o no esté establecida, debes establecer manualmente la cuenta:
   1. Haz clic en Asignar en la columna Cuenta de usuario de destino.
   2. En el campo Buscar un usuario, comienza escribiendo para buscar, y luego selecciona el usuario de los resultados.
   3. Haz clic en Guardar en la parte inferior derecha para establecer la cuenta destino y volver a la página anterior.
      Para más información sobre cómo asignar robots a cuentas de usuario, consulta Reglas de asignación para robots atendidos.
2. Cuando estés listo, haz clic en Siguiente para moverte al paso Usuarios desatendidos.

Asignar reglas a robots atendidos

A continuación, se indican las reglas que usamos para validar la selección al intentar asignar robots atendidos clásicos a sus usuarios.

• Los robots con el mismo Nombre de usuario (mostrado en la página Usuarios atendidos) deben asignarse a la misma cuenta de usuario destino.

  Igualmente, los robots con un valor Nombre de usuario diferente deben asignarse a diferentes cuentas de usuario destino.

• Si tienes una integración con un directorio de usuario externo, al asignar robots a cuentas de usuario de directorio, el valor Nombre de usuario del robot debe coincidir con la dirección de correo electrónico o el nombre de usuario de la cuenta de usuario destino.

  Puedes ver la dirección de correo electrónico y el nombre de usuario de una cuenta de usuario en la página Tenant > Administrar acceso > Asignar Roles.

• Al asignar robots a cuentas de usuario locales:

  • Si se aplica el inicio de sesión interactivo para el tenant, podrá asignar cualquier robot clásico a cualquier usuario.
  • Si la configuración de autenticación de robot de nivel de tenant está establecida como Híbrida y la cuenta de usuario destino tiene habilitada automatización personal, el valor Nombre de usuario para el robot debe coincidir con el valor de Dominio/Nombre de usuario del usuario, como se muestra en la página Configuración de automatizaciones personales del usuario.
  • Si la autenticación de robot de nivel de tenant está establecida en Híbrida, la cuenta de usuario destino tiene habilitada automatización personal y la opción Heredar licencia del grupo de usuario está establecida en la página Configuración de automatización personal del usuario, el usuario tiene un nombre de usuario de automatización personal generado que no se muestra, pero es necesario que coincida con el nombre de usuario del robot. De lo contrario, no se permite realizar la asignación.

Importante: cuando se asignan varios robots atendidos a la misma cuenta de destino, el nombre de usuario del robot en la carpeta moderna será uno de los nombres de usuario delos robots migrados, de forma aleatoria.Esto puede dar lugar a problemas de acceso al intentar conectar a máquinas.

Uso del asistente para usuarios no atendidos

Para robots desatendidos, debes asignarlos a cuentas de robot nuevas o existentes. Las cuentas de robot están diseñadas para ejecutar automatizaciones desatendidas y te recomendamos usarlas en lugar de cuentas de usuario.

La página Usuarios desatendidos enumera todos los robots desatendidos que se han encontrado en carpetas clásicas.

1. En la parte superior derecha, bajo Acciones por lotes, selecciona cómo quieres que maneje el asistente los robots clásicos desatendidos que no tengan asignada una cuenta de robot destino:

   • Recomendado: selecciona Generar cuentas robot automáticamente si quieres migrar todos los robots desatendidos enumerados y quieres permitir que el asistente cree nuevas cuentas robot para ellos. Detalles...

   • No recomendado: selecciona Ignorarlos si quieres que solo se migren algunos de los robots clásicos que se hayan encontrado.

2. Revisa la columna Cuenta robot destino para asegurarte de que cualquier asignación existente es correcta.
   • Si seleccionaste Generar automáticamente cuentas robot, omite este paso.

   • Si seleccionaste Ignorarlos, debes asignar a una cuenta robot destino manualmente solo aquellos robots clásicos desatendidos que quieres migrar, haciendo clic en Asignar en la columna Cuenta robot destino. También puedes crear nuevas cuentas de robot en este momento, si es necesario.

     Importante: cualquier robot clásico que no se asigne a una cuenta de robot destino no se migrará a carpetas modernas.
3. Cuando estés listo, haz clic en Siguiente para continuar con el paso final.

   Se abre la página Finalización.

Qué hace Generar robots automáticamente

Con esta opción seleccionada, en el momento de la migración, el asistente intenta asignar automáticamente cada robot clásico de la siguiente manera:

1. Busca una cuenta de usuario o robot existente con un nombre de usuario desatendido que coincida.

   Si se encuentra, asigna el robot desatendido a dicha cuenta existente. Si no hay coincidencias, continúa con el siguiente paso.

2. Busca otros robots desatendidos clásicos con el mismo Nombre de usuario que ya se asignaron a una cuenta.

   Si se encuentran, asigna este robot a la misma cuenta. Si no hay coincidencias, crea una nueva cuenta de robot para el robot clásico.

Las nuevas cuentas de robot creadas por el asistente tienen un nombre del tipo: Migrated folderName_robotName.

Reglas de asignación para robots desatendidos

Se aplican las siguientes reglas cuando intentas asignar robots desatendidos clásicos a cuentas de robot o de usuario.

Si eliges asignar de forma manual robots a cuentas de robot (no se recomienda) en lugar de permitir que el asistente cree nuevas cuentas de robot, debes seguir estas reglas.

1. Busca una cuenta de robot existente que utilice las mismas credenciales que el robot desatendido clásico.

   Si se encuentra una coincidencia, el asistente requiere que asignes el robot desatendido clásico a la cuenta de robot existente. Si no, continúa con el paso siguiente.

2. Busca otro robot clásico no atendido que tenga las mismas credenciales que el robot clásico a mapear. Si se encuentra y ya está asignado a una cuenta destino, el asistente requiere que asignes el robot actual a la misma cuenta destino.

Importante: si asignas varios robots con diferentes credenciales a la misma cuenta de robot, tras la migración la cuenta de robot usa las credenciales de uno de los robots clásicos, aleatoriamente. Existe el riesgo de que estas credenciales no funcionen en todas las máquinas de destino y, tras la migración, puede darse un fallo de conexión con las máquinas.

Iniciar la migración

1. Cuando estés listo, haz clic en Ejecutar migración para iniciar el proceso.

   Se abre un diálogo de confirmación.

2. Haz clic en Ejecutar para iniciar la migración.

   La página se actualiza para mostrar el proceso de migración para cada carpeta.

   Nota: si se produce algún error, comprueba los mensajes de error mostrados. Después de resolver el problema en cada carpeta clásica, puedes reiniciar o volver a intentar la migración.
3. Haz clic en Cerrar para salir del asistente.

Próximos pasos: si la migración tuvo éxito, sigue con Configuración tras la migración.

Solución de problemas

Los trabajos no están aún en estado final

Cuando se inicia la migración, el asistente finaliza automáticamente cualquier trabajo en ejecución para poder ejecutarse. Si, en el momento en que finalice la migración, un trabajo finalizado permanece en el estado Terminando y no llega al estado Detenido, la migración falla.

Si esto sucede, tras 24 horas estableceremos el estado de los trabajos Terminando como estado Detenido. En este punto puedes reiniciar la migración.

Reiniciar o volver a intentar la migración

Si la migración falló para algunas o todas las carpetas, puedes volver a intentarlo después de solucionar las configuraciones erróneas que causaron los errores.

Para reiniciar o reintentar una migración que haya fallado:

1. Revisa los mensajes de error para cada carpeta y luego comprueba la configuración de la carpeta clásica para resolver los errores.
2. Después de resolver todos los errores, ve a Tenant > Configuración > Iniciar migración.

   Se abre el asistente en la página final.

3. Para volver a ejecutar la migración:

   • Si quieres volver a ejecutar la migración con los ajustes anteriores, haz clic en el icono Reintentar a la derecha de la fila de una carpeta para la que haya fallado la migración. Esta opción reinicia la migración tal como se había configurado anteriormente, sin darte la opción de cambiar las asignaciones.

     (Opcional) Marca la casilla de verificación Limpiar antes de reintentar si quieres eliminar cualesquiera datos parcialmente migrados para la carpeta cuya migración haya fallado. Si no marcas esta casilla, la migración se realiza solo para aquellas entidades que no han podido migrarse previamente.

     Sugerencia: si la migración falla con un error para artículos Colas de datos de prueba o Cola de datos de prueba, marca la casilla de verificación Limpiar antes de reintentar antes de reiniciar la migración. Esto impide artículos duplicados Cola de datos de prueba en carpetas modernas.

   • Si quieres volver a hacer las asignaciones para robots atendidos y desatendidos, haz clic en Reiniciar en la parte inferior derecha. Esta opción te lleva de vuelta al primer paso del asistente. Sigue las instrucciones de Uso del asistente para completar la configuración una vez más.

Paso 2. Configuración tras la migración

Una vez finalizada la migración, debes realizar los pasos manuales siguientes para abordar incidencias de compatibilidad con versiones anteriores:

1. Recompila los flujos de trabajo existentes que usan actividades de Orchestrator o que hacen llamadas directas HTTP a la API de Orchestrator para usar la versión 2019.10 o posterior para UiPath.System.Activities.
2. Vuelve a aprovisionar todas las demás entidades existentes, como catálogos de acción, en la carpeta moderna correspondiente.

   No necesitas volver a aprovisionar robots atendidos y desatendidos (se aprovisionan automáticamente para los usuarios con acceso a la nueva carpeta moderna) ni entornos (no se usan en el contexto de una carpeta moderna).

3. Desvincula los Conjuntos de prueba de las carpetas clásicas, eliminándolos de los proyectos correspondientes de Test Manager.
   
   

   

   
   
4. Enlaza nuevamente los Conjuntos de prueba seleccionando los Conjuntos de prueba que tengan [Migrado] como descripción.
   
   

   

   
   
5. Actualice el proceso de carpeta clásica usado en UiPath Apps para poder utilizar el proceso de la carpeta moderna recién migrada.
6. Actualiza cualquier flujo de trabajo que:
   • tenga una dependencia en la ruta de la carpeta antigua
   • use la actividad Iniciar trabajo. En carpetas clásicas, donde tenías processName_envName, ahora debes cambiar a processName para carpetas modernas.
7. Si aún no lo habilitaste, habilita el inicio de sesión interactivo para el tenant. Esto es obligatorio para trabajar en carpetas modernas.
8. Ejecuta los procesos desatendidos desde Orchestrator usando Iniciar trabajo para probarlos en la configuración moderna.
   Nota: deja pasar 10 minutos después de que se complete la migración para que el asistente desactive los robots de las carpetas clásicas migradas. Esto es necesario para que las licencias se liberen y se puedan usar en carpetas modernas.
9. Actualice las estaciones de trabajo de usuario final para que usen UiPath Robot versión 2019.10 o posterior.
10. Elimina las carpetas clásicas ahora no usadas.

Revertir a carpetas clásicas

Si ejecutaste el asistente de migración, pero tus automatizaciones no se ejecutan correctamente en carpetas modernas, puedes volver a habilitar de forma temporal tu configuración de carpetas clásicas para poder seguir ejecutando automatizaciones hasta que soluciones las incidencias de migración y migres con éxito a carpetas modernas.

Para volver a usar temporalmente carpetas clásicas después de ejecutar la migración:

1. Vuelve a establecer la configuración de autenticación de robot para el tenant como Híbrida.
2. Habilita todos los robots clásicos.
3. Habilita desencadenadores en carpetas clásicas.
4. Elimine las carpetas modernas.
5. Elimina las nuevas cuentas de robot.
6. Investiga qué es lo que, en la configuración de carpetas clásicas, ha causado que las automatizaciones fallen y limpia potencialmente tus carpetas clásicas.
7. Vuelve a ejecutar la migración.

Migración manual

Para aprovechar las características proporcionadas por las carpetas modernas, debes volver a compilar los flujos de trabajo existentes que usan actividades de Orchestrator o realizan llamadas HTTP directas a la API de Orchestrator, usando UiPath.System.Activities v19.10.1 o superior. También debe volver a aprovisionar todas las demás entidades existentes en una estructura de carpetas moderna, excepto: Robots, ya que se aprovisionan automáticamente para los usuarios con acceso a la nueva carpeta moderna; y entornos, ya que no se utilizan en el contexto de una carpeta moderna.

Importante:

Actualizar las entidades existentes al modelo moderno elimina la compatibilidad con cualquier versión anterior. Los flujos de trabajo recopilados solo son ejecutables en los robots 2019.10+.

Migrar a Carpetas modernas

Para convertir tu implementación actual, en su totalidad o en parte, para utilizar las carpetas modernas, algunas entidades tendrán que volver a implementarse mientras que otras tendrán que recrearse por completo. Una descripción general del proceso de migración podría considerarse de la siguiente manera:

• Cada Entorno se convierte en una subcarpeta separada o, alternativamente, en su propia Carpeta de primer nivel si deseas mantener los usuarios y procesos de cada uno completamente segregados.

• El flujo de trabajo de cada paquete debe recopilarse mediante las actividades actuales y luego volver a publicarse o cargarse en Orchestrator.

• Utilizando los Paquetes recién compilados, cada Proceso debe volver a implementarse en la carpeta (o subcarpeta) que corresponda a su Entorno anterior.

• Cada usuario debe añadirse a las Carpetas correspondientes con los Procesos a los que necesitan tener acceso.

Esta migración puede realizarse sin problemas para el usuario. El administrador de Orchestrator crea y añade toda la estructura de carpetas modernas y las entidades necesarias, mientras que los usuarios siguen utilizando las entidades existentes en las carpetas clásicas a las que están asignados. Durante este tiempo puedes crear dos Robots con el mismo domain\username, uno en una carpeta clásica y otro en una moderna, y los usuarios solo podrán ver y ejecutar los procesos clásicos disponibles para ellos. Si se elimina el Robot clásico, el Robot moderno tomará las riendas y ejecutará las versiones modernas recién creadas y añadidas de esos mismos procesos, sin alterar la experiencia del usuario.

Importante:

Si existe un robot clásico con el mismo domain/username que un usuario en una carpeta moderna, el usuario solo tendrá acceso al robot clásico y a los procesos relacionados. Para que el robot atendido funcione en un contexto moderno, debe desactivarse el clásico robot flotante. Una vez que la migración se haya probado y verificado con éxito, el robot clásico puede eliminarse con seguridad.

Migración atendida mediante Orchestrator Manager

Para simplificar el proceso de migrar a las carpetas modernas, puedes utilizar el UiPath Orchestration Manager. Este es un proyecto de Studio que utiliza la API de Orchestrator para manejar entidades basadas en los libros de trabajo de Microsoft Excel. Para obtener instrucciones sobre cómo utilizarlo para la migración, consulta la documentación del producto.