Gestionar requisitos de paquetes

Información general

Un proceso de RPA comienza en Studio, el dominio de los flujos de trabajo y las actividades. Al diseñar los flujos de trabajo, los desarrolladores pueden utilizar varios objetos, que normalmente se gestionan de forma centralizada desde Orchestrator mediante carpetas, lo cual te permite mantener un control detallado de tus automatizaciones y de los objetos asociados.

Estos objetos son esenciales para el éxito de la ejecución de procesos. La falta de alguno de los objetos indicados impide que el proceso se ejecute correctamente.

La pestaña Requisitos del paquete te permite identificar los objetos que faltan y añadirlos manualmente al nivel de proceso. Esto contribuye a:

• formar a los usuarios en cuanto a las dependencias de los procesos,
• reducir la depuración manual del flujo de trabajo,

• identificar los objetos que faltan sin necesidad de cambiar entre Studio y la IU de Orchestrator.

  
  

  

  
  

Nota: esta característica es compatible con los procesos que se han creado utilizando la versión de Studio 2021.10 y posteriores, junto con los paquetes de actividades versión 2021.10 y posteriores.

Cómo funcionan los requisitos de los paquetes

Cuando se crea un proceso, Orchestrator inspecciona el paquete subyacente con todos los archivos .xaml que lo componen y agrega sus objetos intrínsecos como, por ejemplo:

• Depósitos de almacenamiento
• Activos
• Colas
• desencadenadores de cola, hora y eventos
• otros procesos
• Catálogos de acciones
• Conexiones
• Reglas empresariales

Dependiendo de si se detectan los objetos respectivos o no, la pestaña Requisitos del paquete muestra dos comportamientos:

• La pestaña cambia a color rojo. El flujo de trabajo tiene algunas dependencias que no están presentes en Orchestrator, por lo que es necesario añadirlas.

• La pestaña está vacía y muestra el mensaje "Esta versión del paquete no contiene requisitos". - el paquete cargado no tiene ningún requisito.

  Nota: Orchestrator no detecta automáticamente los requisitos de los paquetes almacenados en fuentes externas.

Estados de requisitos de paquetes

Estados generales

• Disponible: el objeto está presente en Orchestrator. No es necesario realizar ninguna otra acción.

• Ausente: el objeto no está presente en la carpeta actual de Orchestrator. Puedes vincularlo o añadirlo a la carpeta correspondiente de Orchestrator, siempre que tengas los permisos adecuados.

• Carpeta no encontrada: el objeto existe supuestamente en una carpeta de Orchestrator a la que se hizo referencia en el campo Ruta de la carpeta de una actividad, aunque

  • la carpeta no existe en Orchestrator. Deberás añadir la carpeta en Orchestrator, utilizar el mismo nombre indicado en la columna Ruta de la carpeta y asignar usuarios a la misma.

  • no tienes acceso a esa carpeta. Debes solicitar el acceso a la carpeta de Orchestrator indicada en la columna Ruta de la carpeta.

• Desconocido: no se ha podido determinar el nombre del objeto. No hay acciones disponibles que realizar. Hay varias situaciones que pueden dar lugar a un estado Desconocido:

  • no tienes los permisos adecuados para ese tipo de objeto;

  • una actividad de flujo de trabajo hace referencia a un elemento de cola como, por ejemplo, que no puede vincularse a su cola.

    Nota: el estado desconocido de un objeto no impide que el proceso se ejecute correctamente.

• Filtros no válidos: los filtros de una conexión no están configurados.

Nota: el estado desconocido de un objeto no impide que el proceso se ejecute correctamente.

Estados de desencadenador

Además de los estados generales, los desencadenadores muestran los siguientes estados:

• Pendiente de creación: para añadir un desencadenador es necesario asociarlo a un proceso existente. Mientras se crea el proceso, el desencadenador reside en la memoria de Orchestrator y se activa tras la creación del proceso. Puedes editar desencadenadores desde la pestaña de requisitos del paquete mientras tengan este estado. Más tarde tienes la opción de editarlos desde la página Desencadenadores.

• Configuración no válida: el tiempo de ejecución seleccionado no está disponible.

• Nombre duplicado: el nombre del desencadenador está duplicado.

Permisos

Para gestionar los requisitos del paquete, se necesitan los siguientes permisos:

Quiero...	Necesito...	El acceso a la carpeta que necesito...
...ver los paquetes disponibles	Permiso Ver en paquetes (ámbito de tenant)	No es aplicable, ya que los permisos de los paquetes se establecen en el ámbito de tenant.
...cargar un paquete	Crear permisos en paquetes (ámbito de tenant)	No es aplicable, ya que los permisos de los paquetes se establecen en el ámbito de tenant.
... ver los objetos disponibles	Ver permisos en el objeto especificado	Obtén acceso a la(s) carpeta(s) que contiene(n) el objeto.
... añadir un objeto	Crear permisos en el tipo de objeto específico	Obtén acceso a las carpetas a las que deseas añadir el objeto.
...importar un objeto de una carpeta distinta	Crear y ver permisos en el tipo de objeto específico	Obtener acceso a: la(s) carpeta(s) de la(s) que se importa, y la(s) carpeta(s) a las que importas el objeto.

Gestionar objetos que faltan

Para cada objeto que falte, excepto los catálogos de acciones y las conexiones, puedes añadirlo o importarlo en la carpeta actual, siempre que dispongas de los permisos necesarios.

Nota: No puedes añadir catálogos de acciones ni conexiones desde la pestaña Requisitos del paquete en Orchestrator, sino desde Action Center y Integration Service, respectivamente.

Añadir un objeto que falta

Requisitos previos: asegúrate de disponer del permiso Crear en el objeto específico y acceso a la carpeta a la que deseas añadir el objeto.

1. Para añadir un objeto que falta, haz clic en el botón Añadir correspondiente. Se abre la página Crear [objeto].
2. Configura el objeto según sea necesario.
   El campo de nombre se rellena previamente con el nombre del objeto que falta y no se puede editar. Esta restricción se aplica para respetar el nombre del objeto utilizado en el flujo de trabajo.

Importar un objeto que falta

Si sospechas que el objeto que falta existe en el tenant actual, pero en una carpeta diferente, puedes importarlo a la carpeta actual.

Requisitos previos: asegúrate de que tienes los permisos Ver y Crear en el objeto específico, y acceso tanto a la carpeta desde la que estás importando, como a la carpeta a la que estás importando el objeto.

1. Para importar un objeto de una carpeta diferente, haz clic en el botón Importar correspondiente. Se abre la página Vincular [objetos] de otras carpetas con dos pestañas:
2. Si el objeto existe en otra(s) carpeta(s), aparece en la pestaña Seleccionar [objeto]. Selecciónala.
3. Haz clic en Continuar para navegar a la pestaña Validación de la carpeta.

   Una vez seleccionado el objeto, la pestaña Validación de la carpeta muestra la(s) carpeta(s) de origen desde la(s) que se puede importar.

4. Si el objeto existe en varias carpetas y has seleccionado todas las copias en el paso anterior, ahora se te pide mantener solo una carpeta de origen.
5. Elimina las copias de objetos asociadas a las carpetas de las que no necesitas importar.
6. Haz clic en Vincular para importar el objeto a la carpeta indicada en la columna Ruta de la carpeta.
7. Tras añadir o importar un objeto, se te redirige a la pestaña Requisitos del paquete para continuar añadiendo o importando los que faltan. Fíjate en los cambios de estado de los objetos que se han añadido o importado.

Importante:

En el caso de dependencias de procesos de varios niveles, Orchestrator detecta y muestra solo la dependencia de primer nivel para un proceso determinado.

Por ejemplo, el proceso A necesita el proceso B para iniciarse, y el proceso B necesita el proceso C para iniciarse. La jerarquía de dependencia es A > B > C. En este caso, cuando se comprueban los requisitos del paquete para el proceso A, Orchestrator detecta y muestra el primer nivel de dependencia para él, esto es, el proceso B. Si falta el proceso B, puedes añadirlo desde la pestaña Requisitos del paquete, pero si falta el proceso C, deberás identificarlo como ausente y añadirlo manualmente.

Añadir catálogos de acciones

Orchestrator detecta los catálogos de acciones necesarios para ejecutar el proceso, pero no puedes añadir los que faltan desde la pestaña Requisitos del paquete, ya que los catálogos de acciones son objetos configurables a través de Action Center.

Requisitos previos: asegúrate de disponer del permiso Crear en el objeto específico y acceso a la carpeta a la que deseas añadir el objeto.

Continúa realizando los siguientes pasos:

1. Dirígete a la instancia de Action Center correspondiente.
2. Accede a la página Configuración de administrador.
3. Selecciona la carpeta de procesos.
4. Haz clic en Añadir nuevo catálogo. Asegúrate de utilizar el nombre detectado como ausente en la pestaña Requisitos del paquete.
5. Haz clic en Crear.

Agregar desencadenadores de tiempo y cola

Al añadir un desencadenador conectado, se rellenan automáticamente los campos de la página Crear desencadenador los valores establecidos por el RPA Developer en la actividad de desencadenador asociada durante el tiempo de diseño. Puedes editar estos valores mientras el desencadenador tenga el estado Pendiente de creación o más tarde, desde la página Editar desencadenador. El estado Pendiente de creación significa que el desencadenador está almacenado en una memoria temporal hasta que se cree el proceso que necesita.

1. Ve a Automatizaciones> Procesos y haz clic en Añadir proceso.
2. Selecciona el paquete que contiene la actividad de desencadenador de tiempo.
3. Introduce los argumentos de runtime requeridos y haz clic en Siguiente.
4. La página de requisitos del paquete muestra el desencadenador de tiempo con el estado Falta . Haz clic en el botón Añadir desencadenador para configurar el desencadenador por tiempo.
5. Configura las propiedades del desencadenador como se indica en la página Crear desencadenadores de tiempo/Crear desencadenadores de cola . El estado del desencadenador de tiempo / cola cambia a Creación pendiente.
6. Haz clic en Siguiente para continuar configurando el proceso y luego haz clic en Crear.
   Una vez creado el proceso, el desencadenador de tiempo / cola aparece en la cuadrícula Desencadenadores de tiempo / cola de Orchestrator.
   Agregar colas desde la página de creación de desencadenadores de colas

   Tienes la opción de añadir una cola durante la creación de un desencadenador de cola faltante. Ten en cuenta que de hacerlo así te impedirá añadir SLA a la cola hasta que el desencadenador se cree.

   
   

   

   
   

Configurar desencadenadores de eventos conectados

1. En el contexto de la carpeta, navega a Automatizaciones y selecciona Procesos y, a continuación, Añadir proceso.
2. Selecciona el paquete que contiene la actividad desencadenador de eventos.
3. Selecciona el punto de entrada e introduce los argumentos de runtime necesarios y, a continuación, selecciona Siguiente.
4. La página Requisitos del paquete muestra la conexión de eventos identificada en el paquete. Selecciona una conexión o añade una nueva. Para obtener más información, consulta Configurar conexiones.
5. El desencadenador de eventos aparece en la conexión correspondiente y tiene el estado Pendiente de creación. Para editar el desencadenador de eventos, selecciona el icono del lápiz. Se abre la página Editar desencadenador de eventos.
   Nota: este paso es opcional. Si lo omites, se aplican las selecciones predeterminadas.
6. Introduce un nombre único para tu desencadenador en el campo Nombre. Si el nombre del desencadenador ya existe, recibes un mensaje de error y debes cambiar el nombre.
7. En el menú desplegable Prioridad del trabajo, selecciona la prioridad del trabajo. El valor predeterminado será Heredada, lo que significa que la prioridad del trabajo es la misma que la definida para el proceso seleccionado.
8. En el menú desplegable Tipo de runtime, selecciona el runtime para ejecutar los trabajos que inicia el desencadenador. Si deseas utilizar un runtime unattended, recomendamos no establecer la conexión como Configurable por los usuarios.
9. En la sección Destino de ejecución, para seleccionar una estrategia de finalización de trabajos, habilita la alternancia Programar finalización de la ejecución de trabajos.
   Nota:

   La cantidad de tiempo que especificas transcurre según las especificaciones, incluso si el trabajo está en cola. Por ejemplo, si programa un trabajo para que se ejecute a las 13:00 y lo estableces para que se detenga después de 20 minutos, el trabajo se detendrá a las 13:20, incluso aunque haya permanecido en cola hasta las 13:15 y luego se haya iniciado.

   Además, si optas por detener un trabajo pendiente o en ejecución después de dos horas y eliminar el mismo trabajo después de tres horas, el trabajo se elimina después de cinco horas. Esto sucede porque, en primer lugar, Orchestrator recibe la señal de que el trabajo se detuvo después de dos horas. Al recibir la señal, Orchestrator hace que la acción de cancelación se produzca en tres horas, lo que resulta en un total de cinco horas.

   Tienes las siguientes opciones:

   • Selecciona Detener en el menú desplegable: esta opción inicia un intento de finalizar la ejecución del trabajo de forma adecuada cuando el trabajo ha estado en estado pendiente o en ejecución durante el tiempo que hayas establecido. Puedes establecer un intervalo mínimo de un minuto y un intervalo máximo de 10 días, 23 horas y 59 minutos.
   • Selecciona Cancelar en el menú desplegable: esta opción inicia un intento de finalizar de forma forzada la ejecución del trabajo cuando el trabajo ha estado en estado pendiente o en ejecución durante el tiempo que hayas establecido. Puedes establecer un intervalo mínimo de un minuto y un intervalo máximo de 10 días, 23 horas y 59 minutos.
   • Selecciona Detener en el menú desplegable y habilita la opción Si el trabajo no se detiene, cancelarlo. Esta opción inicia un intento de finalizar la ejecución del trabajo de forma adecuada cuando el trabajo ha estado en estado pendiente o en ejecución durante el tiempo que hayas establecido para la acción de detención. Si el intento da como resultado que el trabajo permanezca en estado de detención, Orchestrator intenta cancelar el trabajo una vez transcurrida la cantidad de tiempo establecida para la acción de eliminación. Puedes establecer un intervalo mínimo de un minuto y un intervalo máximo de 10 días, 23 horas y 59 minutos.
10. Para recibir una alerta si un trabajo ha permanecido en estado pendiente o reanudado durante un cierto período de tiempo, habilita la alternancia Generar una alerta si el trabajo está atascado en estado pendiente o reanudado y establece la duración permitida para que el trabajo permanezca en estado pendiente o reanudado. La duración mínima configurable es de un minuto y la duración máxima es de once días. Si el trabajo supera la duración configurada, aparece una ventana emergente de alerta de gravedad del error, con el siguiente texto: "N trabajos para #process {process_number} han estado pendientes o reanudados durante más de X horas e Y minutos", donde:
    • N es el número de trabajos que desencadenaron la alerta.
    • {process_number} es el identificador del proceso.
    • X es el número configurado de horas que superó el trabajo mientras se encontraba en estado pendiente o reanudado. Los días se convierten a horas.
    • Y es el número de minutos configurado que superó el trabajo mientras se encontraba en estado pendiente o reanudado.
11. Para recibir una alerta si un trabajo no se ha completado dentro de un intervalo establecido, habilita el conmutador Generar una alerta si el trabajo inició y no se ha completado y establece la duración aceptable para que se complete el trabajo. La duración mínima configurable es de un minuto y la duración máxima es de once días. Si el trabajo supera la duración configurada, aparece una ventana emergente de alerta de gravedad del error, con el siguiente texto: "El trabajo para #process {process_number} se ha ejecutado durante más de X horas y Y minutos", donde:
    • {process_number} es el identificador del proceso.
    • X es el número configurado de horas que superó el trabajo sin completarse. Los días se convierten a horas.
    • Y es el número de minutos configurado que superó el trabajo sin completarse.
12. Para mantener el mismo contexto cuenta-máquina configurado para iniciar el trabajo, selecciona Mantener la asignación de cuenta/máquina al reanudar el trabajo. Al seleccionar esta opción se optimiza el uso de licencias y recursos.
13. En la sección Argumentos de runtime, selecciona un punto de entrada en el menú desplegable y proporciona los valores adecuados para los argumentos del proceso y, a continuación, selecciona Actualizar para guardar la configuración del desencadenador de evento.
14. Para continuar configurando el proceso, selecciona Siguiente. Cuando hayas terminado, selecciona Crear.

Nota:

La deshabilitación de desencadenadores basada en la ejecución solo se aplica a desencadenadores de eventos publicados desde Studio Web a espacios de trabajo personales.

De forma predeterminada, los desencadenadores se deshabilitan tras 5 ejecuciones fallidas consecutivas. Puedes actualizar la configuración editando los siguientes ajustes de ejecución en el nivel de tenant:

• Desencadenadores - Desencadenadores conectados: deshabilitar cuando la ejecución del trabajo falla en el recuento

• Desencadenadores - Desencadenadores conectados: período de gracia cuando la ejecución del trabajo sigue fallando en el recuento (días)

Una vez creado el proceso, el desencadenador de eventos aparece en la cuadrícula de Desencadenadores de eventos, con el valor Conectado en la columna Tipo.

Configurar conexiones

Nota: esta funcionalidad solo está disponible en los espacios de trabajo personales.

Orchestrator permite especificar la cuenta utilizada en una conexión a la hora de crear un nuevo proceso o editar uno existente.

Como administrador, puedes configurar la conexión para tus usuarios en su propio espacio de trabajo personal, siempre que tengas el siguiente conjunto de permisos:

• Ver permisos en Conexiones

• Very editar permisos en espacios de trabajo personales

• Ver, editar permisos en recursos sobrescritos

1. Ve a Automatizaciones > Procesos en tu espacio de trabajo personal. Se muestra la página Procesos.
2. Haz clic en Más acciones > Editar junto a un proceso para editarlo. Se mostrará la ventana Editar proceso.
3. En la pestaña Configuración del proceso, configura los detalles generales del proceso según sea necesario.
4. Ve a la pestaña Requisitos de paquetes para ver los objetos utilizados por el proyecto de automatización subyacente. Aquí debería ver todas las conexiones que se han añadido en el proyecto de automatización en el tiempo de diseño. Una conexión agrupa todas las actividades que se configuraron para usarla. Se muestra una de las siguientes opciones:
   Gráfico 1.

   Opción de conexión	Comportamiento	Notas
   Conexión existente	La actividad se ejecuta para la conexión compartida seleccionada.	Las conexiones disponibles están organizadas en sus carpetas contenedores.
   Configurable por los usuarios	Permite a los usuarios seleccionar su propia conexión en runtime en UiPath Assistant.	No seleccione esta opción para tiempos de ejecución desatendidos.
   Sin permisos o falta conexión	Compruebe los permisos de Visualización en la carpeta que contiene la conexión que necesita.	Puede agregar las conexiones que faltan en la carpeta actual haciendo clic en el icono de engranaje> Agregar conexión. Al hacer clic en el icono de engranaje> Administrar conexiones , se te redirige a la interfaz del servicio de integración, donde puedes crear nuevos conectores y conexiones.

5. Haz clic en el botón para gestionar tus conexiones o añadir otras nuevas a través del Servicio de integración.
   
   

   

   
   

   La opción Configurable por usuarios

   La opción Configurable por usuarios se muestra por defecto en las siguientes situaciones:

   • El paquete se publica en un espacio de trabajo personal

   • La conexión no se comparte (reside en una carpeta a la que no puede acceder)

   • La conexión no existe

   • Permisos insuficientes

   Si configura manualmente la opción Configurable por los usuarios , permite que los usuarios seleccionen su propia conexión en tiempo de ejecución, en UiPath Assistant.

   Filtros de actividad de Integration Service

   Una actividad de Integration Service puede contener filtros. Los valores de filtro dependen de la conexión utilizada y pueden sobrescribirse en runtime en UiPath Assistant. Solo las actividades con filtros que se pueden sobrescribir se muestran como requisitos de paquete. Si los usuarios establecen la conexión como Configurable, no se muestra ningún filtro.

   Nota:

   Cambiar una conexión existente a Configurable por los usuarios restablece los filtros de actividad. De esta manera, los usuarios pueden configurar sus propios filtros.

   Usar una conexión distinta a la existente restablece los filtros de actividad. De esta manera, puede establecer nuevos filtros para la nueva conexión.

   Para ejecutar automatizaciones desatendidas, se debe establecer una conexión para una cuenta de servicio. No debe establecer la opción Configurable por usuarios .

Personalizar las configuraciones de usuario

Cuando un desencadenador de eventos tiene seleccionada la opción Configurable por los usuarios, estos pueden establecer sus propias conexiones en tiempo de ejecución, en UiPath Assistant.

La página Configuraciones de usuario personalizadas enumera las configuraciones de desencadenador de eventos establecidas por tus usuarios.

Como administrador de carpetas, puedes anular las configuraciones existentes de los usuarios o añadir otras nuevas a nivel de proceso o de desencadenador.

Explorar el espacio de trabajo personal de un usuario

• Establecer una configuración para tus usuarios implica explorar el espacio de trabajo personal del usuario seleccionado.

• Para añadir conexiones en nombre de tus usuarios, debes ver sus conexiones personales, que residen en su carpeta Espacio de trabajo personal.

• Los usuarios reciben una alerta cada vez que comienzas o terminas de explorar su espacio de trabajo personal.

Estados de configuración del usuario

Estos estados te ayudan a identificar qué usuarios tienen una configuración defectuosa:

Configurado: el usuario dispone de una configuración de trabajo.

Parcialmente configurado: el usuario tiene una configuración defectuosa, lo que puede implicar que faltan conexiones.

Acceder a la página de configuraciones personalizadas de usuario

Puedes acceder a la página Configuraciones de usuario personalizadas tanto desde la página Procesos como desde la página Desencadenadores de eventos.

1. En la carpeta seleccionada, ve a:

   Opción	Descripción
   Automatizaciones > Desencadenadores > Desencadenadores de eventos	Se muestra una lista de todos los desencadenadores de eventos disponibles.
   Automatizaciones > Procesos	Se muestra una lista de todos los procesos disponibles.

2. Para el desencadenador de proceso/evento deseado, haz clic en el botón Más acciones y luego selecciona Configuraciones de usuario personalizadas. Esto te redirecciona a la página Configuraciones de usuario personalizadas.

Añadir una nueva configuración de usuario

1. Para el desencadenador de proceso o evento deseado, accede a la página Configuraciones de usuario de Cliente.
2. En la sección Configuraciones de requisitos del paquete por cuenta de usuario, haz clic en Añadir configuración de usuario. Se abre el asistente Configurar requisitos de proceso para la cuenta de usuario.
3. En el menú desplegable Cuenta de usuario, selecciona el usuario para el que quieres configurar el proceso o el desencadenador de eventos y haz clic en Añadir usuario.
   Nota:

   • El usuario seleccionado debe estar en la misma carpeta que el desencadenador de proceso/evento. De lo contrario, se te pedirá que asignes al usuario en la carpeta.
   • Si, mientras tanto, eliminas a los usuarios de la carpeta, su configuración de usuario seguirá apareciendo en la lista.
   • Un mensaje emergente te informa de la necesidad de explorar el espacio de trabajo personal del usuario seleccionado.
4. Proporciona los detalles necesarios, como las conexiones o los filtros de actividad.
5. Guarda la configuración.

Anular una configuración de usuario existente

1. Para el desencadenador de proceso o evento deseado, accede a la página Configuraciones de usuario de Cliente.
2. Para la cuenta de usuario deseada, haz clic en Editar configuración.
3. Modifica los detalles necesarios, como las conexiones o los filtros de datos.
4. Actualiza la configuración haciendo clic en Guardar.

   En Assistant, los usuarios con los permisos de Sobrescritura de recursos adecuados siempre pueden actualizar la configuración que hayas configurado.

Eliminar la configuración del desencadenador de eventos de un usuario

Para eliminar las configuraciones de desencadenador de eventos de tus usuarios:

1. Para el desencadenador de proceso o evento deseado, accede a la página Configuraciones de usuario de Cliente.
2. Para la cuenta de usuario deseada, haz clic en Borrar configuración. Esta operación borra las configuraciones del usuario seleccionado.
   Si se eliminan las configuraciones de un usuario, es posible que el proceso no se ejecute como se espera.
   Nota:

   Para realizar cambios en la página de configuraciones de usuario del cliente, se requieren los siguientes permisos:

   • En el nivel de desencadenador de eventos, esta operación requiere permisos de Editar en Sobrescritura de recursos, y permisos de Ver en los Desencadenadores.
   • A nivel de proceso, esta operación requiere permisos de Edición en Sobrescritura de recursos y permisos de Ver y Editar en Procesos.