UiPath Documentation
maestro
latest
false
Importante :
La localización de contenidos recién publicados puede tardar entre una y dos semanas en estar disponible.

Guía del usuario de Maestro

Implementar un proceso simple

Información general

Comenzar a utilizar Maestro puede ser tan simple o tan avanzado como lo requiera tu caso de uso. Un proceso simple puede implicar algunos pasos conectados, como recibir una entrada, ejecutar una automatización y devolver un resultado, ideal para pruebas de concepto rápidas o flujos empresariales directos. Esta sección te presenta un flujo simple para que puedas acostumbrarte a lo básico.

Esta guía demuestra cómo implementar un proceso simple que resalta las capacidades principales de orquestación agéntica: modelado, implementación, depuración, publicar, implementación y gestión. El proceso no cubre la integración con otros productos UiPath. Para obtener instrucciones sobre cómo configurar e implementar dependencias como Data Fabric, Integration Service, Studio Web, Agents y Apps de acción de Action Center, consulta Cómo: proceso complejo.

El objetivo es crear el proceso de enrutamiento simple similar al de la siguiente imagen:

Modelar un proceso

Nota:
  • La configuración del proyecto de proceso agéntico está actualmente vinculada al tenant. Asegúrate de permanecer en el mismo tenant entre las sesiones de edición.
  • La configuración del proyecto de proceso agéntico actualmente solo admite un archivo de proceso empresarial (.bpmn). Aunque puedes añadir varios archivos al proyecto, esto conduce a incidencias inesperadas tanto para la depuración como para la publicación.

Comienza modelando el proceso de extremo a extremo y luego configura los componentes.

Crea un proceso agéntico como un nuevo tipo de proyecto de Studio.

  1. Navega a tu tenant de Automation Cloud™.

  2. En la barra de la izquierda, de la lista de productos, selecciona Maestro.

  3. En la página de destino de Maestro, selecciona Iniciar modelado. Se abre tu nuevo proceso agéntico.

    También puedes empezar creando un nuevo Proceso agéntico en Studio Web.

  4. Abre el menú contextual para cambiar el nombre del proyecto a Proceso simple, y el proceso a Proceso simple. Tu proceso agéntico es, de forma predeterminada, parte de una solución. Más información sobre soluciones en la Guía del usuario de Studio Web.

  5. Selecciona el elemento de inicio y haz clic Añadir: anotación de texto en el cuadro de herramientas, e introduce Ruta de la variable de entrada.

  6. Selecciona el elemento de inicio y Añadir: evento intermedio en el cuadro de herramientas.

  7. Selecciona Cambiar elemento en la barra de herramientas y Evento de captura intermedio del temporizador, e introduce Retraso como nombre del evento intermedio.

  8. Selecciona el elemento de temporizador, haz clic en Añadir: puerta de enlace exclusiva en el cuadro de herramientas y escribe ¿Qué ruta? como nombre de la puerta de enlace.

  9. Selecciona la puerta de enlace y Añadir: tarea, e introduce Una tarea como nombre.

    Los errores de validación se muestran en la esquina inferior izquierda del lienzo.

  10. Selecciona de nuevo la puerta de enlace y Añadir: tarea e introduce Tarea B como nombre.

  11. Selecciona la puerta de enlace y expande la primera condición, tendrá un nombre generado que comenzará con edge_Gateway_{randomcharacters} y escribe A en la etiqueta. Expande la segunda condición e introduce B en la etiqueta.

  12. Es una práctica recomendada crear un final explícito para tu proceso. Para identificar rápidamente qué ruta siguió el proceso, crea un final explícito para cada uno.Selecciona la tarea A, haz clic en Añadir: evento de fin en el cuadro de herramientas, e introduce Fin A como nombre.

  13. Selecciona la tarea B, haz clic en Añadir: evento de fin en el cuadro de herramientas y escribe Fin B como nombre.

Resultado

El proceso BPMN se modela con un evento de inicio, un evento de captura intermedio del temporizador, una puerta de enlace exclusiva con dos condiciones etiquetadas, dos tareas y dos eventos finales con nombre. La estructura del proceso es visible en el lienzo y está lista para implementarse.

¡Felicidades! ¡Ahora has creado tu primer proceso BPMN de extremo a extremo!

Ahora añade algunas capacidades al proceso.

Implementar un proceso

Iniciar evento

  1. Selecciona el elemento de inicio y, en el panel de propiedades, escribe Inicio manual como Nombre y, en la sección Argumentos, selecciona Añadir nueva para añadir una variable que podamos utilizar cuando iniciemos el proceso.

  2. Configura la variable con estos valores y selecciona Guardar. Se creará automáticamente una variable de salida.

    • Nombre: ruta
    • Type: String
    • Valor: A

  3. Selecciona el evento Retraso y abre el panel de propiedades y en la sección Temporizador selecciona Tipo=Duración y 5 segundos en la configuración de valor.

  4. Selecciona la puerta de enlace y expande Condiciones para introducir la condición para las rutas No y Sí, y selecciona el selector de entrada de texto para abrir el editor de expresiones para introducir las condiciones.

  5. Utiliza Insertar variable para encontrar e insertar la variable de salida Inicio manual path.

    Establece el valor igual a "A" y selecciona Guardar.

  6. Abre el editor de expresiones para la condición B, inserta la ruta de la variable de salida de inicio manual, establece el valor igual a "B" y selecciona Guardar.

Resultado

El evento de inicio, el temporizador, las condiciones de la puerta de enlace y las tareas están completamente configurados con variables y expresiones de enrutamiento. El proceso está listo para depurarse.

Como alternativa, puedes simplemente copiar y pegar las expresiones siguientes en el editor de expresiones:

  • A

    vars.path == "A"
    vars.path == "A"
    
  • B

    vars.path == "B"
    vars.path == "B"
    

¡Felicidades! Ahora has configurado completamente tu primer proceso.

Nota:

Puedes descargar el BPMN para usarlo en otros proyectos abriendo el menú contextual con el nombre del archivo .bpmn.

Depurar un proceso

Puedes configurar puntos de interrupción manteniendo el puntero sobre la parte superior izquierda de un elemento y seleccionando el icono del punto de interrupción. Actualmente, los puntos de interrupción solo se pueden establecer una vez que empiezas a depurar un proceso. Sin embargo, se conservan entre ejecuciones. Consulta sobre la depuración y los puntos de interrupción.

Depurar directamente

Primero, ejecuta tu proceso directamente para asegurarte de haberlo configurado correctamente. Establece el valor predeterminado para tu variable pathcomo A para que fluya a través de Tarea A y Fin A.

  1. Selecciona Debug para probar tu proceso.

  2. Observa cómo se ejecuta cada paso. Navega por las secciones Seguimiento de ejecución y Variables globales/Incidentes para ver detalles adicionales.

  3. Selecciona Volver al modo de diseño para salir de la depuración.

Resultado

El proceso se ejecuta directamente y cada paso es visible en el registro de ejecución. El flujo llega a La tarea A y al Final A como se espera, lo que confirma que el proceso está configurado correctamente.

Depurar paso a paso

Ejecuta tu proceso paso a paso para poder manipular la path variable para probar la ruta B

  1. Selecciona Depurar paso a paso.

  2. Selecciona Siguiente paso para mover la ejecución al temporizador

  3. Actualiza la variable pathglobal para el origen del evento de inicio manual a B. Selecciona Intro o pulsa la tecla Tab para confirmar el cambio.

  4. Selecciona Actualizar 1 variable y Actualizar variables en el siguiente cuadro de diálogo para confirmar los cambios.

  5. Selecciona Continuar para finalizar la ejecución.

  6. Observa cómo se ejecuta cada paso. Navega por las secciones Seguimiento de ejecución y Variables globales/incidentes para ver detalles adicionales. Esta vez, el proceso sigue la ruta B.

  7. Selecciona Volver al modo de diseño para salir de la depuración.

Resultado

El proceso completa la ruta B después de que la variable de ruta se actualice a B durante la ejecución paso a paso. Los paneles Seguimiento de ejecución y Variables globales confirman que el cambio de enrutamiento surtió efecto.

.

Publicación e implementación de un proceso simple

  1. Selecciona Publicar.

  2. Elige la Ubicación y selecciona Publicar.

  3. Consulta Publicación e implementación de procesos de agentes para ver los pasos para publicar en Orchestrator.

Resultado

El proceso se publica en la ubicación seleccionada y se implementa. El proceso está disponible en Orchestrator y listo para la gestión de instancias de runtime.

¡Felicidades! Ahora has publicado, implementado e iniciado tu primer proceso completo.

Ahora es hora de hacer la gestión de instancias de runtime.

Gestionar un proceso empresarial

  1. Desde el portal de Automation Cloud, ve al servicio Maestro.

  2. Selecciona Proceso simple en la lista de procesos para abrir la vista Todas las instancias de tu proceso. Puedes utilizar la búsqueda para filtrar la lista si es necesario.

  3. Selecciona la última instancia para abrir el visor de instancias. Verás el proceso ejecutarse en vivo a través de cada paso (suponiendo que el temporizador de retraso de 5 segundos todavía se esté ejecutando).

Resultado

El visor de instancias se abre y muestra el proceso que se ejecuta en vivo, incluidas las variables globales, el historial de acciones y el seguimiento de ejecución. Puedes inspeccionar los pasos individuales para obtener detalles y valores de variables.

Selecciona el fondo del modelo para ver las variables globales y el Historial de acciones, así como el Seguimiento de ejecución. Selecciona un nodo en el modelo o el Seguimiento de ejecución para inspeccionar los Detalles y las Variables para ese paso de ejecución. ¡Enhorabuena! Has gestionado completamente tu primer proceso. ¡Ahora, interrumpe nuestro proceso para poder arreglarlo!

Interrumpir y arreglar un proceso

En este procedimiento, causaremos un fallo en la ejecución para utilizar la gestión de instancias para recuperarla.

  1. Ve a Orchestrator, a la pestaña Automatizaciones de la carpeta Mi espacio de trabajo y busca Simple.Process en la lista Procesos.

  2. Selecciona Iniciar un trabajo para la entrada Simple.Process, pero esta vez edita los Argumentos antes de comenzar a romperla.

  3. Selecciona la pestaña Argumentos y edita la variable path. Establece el valor como C y selecciona Guardar.

  4. Selecciona Inicio.

  5. Navega a Maestro, y selecciona Proceso simple en la lista de Procesos para abrir la vista Todas las instancias para tu proceso.

  6. Selecciona el paso de la puerta de enlace ¿Qué ruta? para ver el error No hay flujo saliente para puerta de enlace, que es de esperar ya que no tenemos configuración para path==”C”.

  7. Selecciona el contenedor del primer paso o el fondo del modelo para ver las variables globales.

  8. Asegúrate de que el flujo siga una condición configurada actualizando la path variable Salida de inicio manual (la segunda) a A.

  9. Selecciona Actualizar 1 variable para actualizar la variable y añadir un comentario con fines de auditoría.

  10. Selecciona Reintentar, añade un Comentario y elige Reintentar instancia para reintentar el paso con la nueva variable y ver cómo se completa la instancia.

    :::note
    You might need to refresh the page to see the instance complete.
    :::
    
    ![Retry instance dialog with comment field](https://dev-assets.cms.uipath.com/assets/images/maestro/maestro-retry-instance-597470-64bdf93f.webp)
    :::note
    You might need to refresh the page to see the instance complete.
    :::
    
    ![Retry instance dialog with comment field](https://dev-assets.cms.uipath.com/assets/images/maestro/maestro-retry-instance-597470-64bdf93f.webp)
    
  11. Consulta el Historial de acciones para ver el seguimiento de auditoría de nuestros cambios.

Resultado

Para recuperar la instancia rota, actualiza la variable de ruta y vuelve a intentar el paso de la puerta de enlace fallida. El Historial de acciones registra el cambio de variable y el reintento como registro de auditoría.

¡Enhorabuena! Has corregido correctamente una instancia rota.

Migrar entre versiones de un proceso

La lógica de flujo de proceso actual no es bastante robusta para gestionar todos los escenarios de ruta.Esta incidencia la solucionas publicando una nueva versión del proceso. Esta versión actualizada acomodará de forma efectiva no solo nuevas instancias de proceso, sino que también rectificará las instancias problemáticas existentes. Para garantizar que se gestionan de forma efectiva todos los escenarios en los que path no es igual a A, modifica la ruta B a una ruta No A.

En este procedimiento, causarás un fallo en la ejecución para solucionarlo con una nueva versión.

  1. Navega a Orchestrator.
  2. Ve a Mi espacio de trabajo.
  3. Ve a la pestaña Automatizaciones y busca Simple.Process en la lista de Procesos.
  4. Selecciona Iniciar un trabajo para la entrada Simple.Process y elige Iniciar.
  5. Selecciona la pestaña Argumentos y edita la variable path.
  6. Establece el Valor como C y elige Guardar.
  7. Selecciona Inicio.

Ahora corrige tu proceso para poder migrar esta instancia rota.

  1. Abre tu proceso simple en UiPath Studio.

  2. Selecciona el paso de la puerta de enlace exclusiva ¿Qué ruta? puerta de enlace y abre el panel de propiedades.

  3. Cambia la etiqueta B a No A y cambia la condición a vars.path != A

  4. Cambia el Nombre de la tarea B a No tarea A.

  5. Cambia el nombre del evento de finalización Fin B a No fin A.

  6. Selecciona Publicar, elige Fuente de espacio de trabajo personal de Orchestrator y selecciona Publicar.

Ahora migra tu instancia rota a la nueva versión.

  1. Navega a Maestro, selecciona Instancias de proceso y elige Proceso simple en la lista de Procesos para abrir la vista Todas las instancias para tu proceso.

  2. Selecciona la última instancia para abrir el visor de instancias. Verás que el proceso está en un estado de error en ¿Qué ruta? puerta de enlace.

    Nota:

    Nota: es posible que tengas que seleccionar el botón Actualizar para que la lista muestre la instancia más reciente.

  3. Selecciona Migrar, elige la versión de destino para el proceso que acabas de publicar (debe ser 1.0.1, pero puede ser diferente para ti), proporciona un comentario y selecciona Migrar instancia.

  4. Selecciona Reintentar, añade un comentario y selecciona Reintentar instancia para volver a intentar el paso con la nueva variable y observar cómo se completa la instancia.

    Nota:

    Es posible que debas actualizar la página para ver la instancia completa.

  5. Consulta el Historial de acciones para ver el seguimiento de auditoría de tus cambios.

Resultado

La instancia rota se migra a la versión del proceso actualizada y se vuelve a intentar con éxito, siguiendo la ruta No A. El Historial de acciones registra las acciones de migración y reintento con fines de auditoría.

¡Enhorabuena! ¡Has migrado correctamente una instancia rota a una nueva versión del proceso!

Proceso final

Así es como se ve el proceso final:

¿Te ha resultado útil esta página?

Conectar

¿Necesita ayuda? Soporte

¿Quiere aprender? UiPath Academy

¿Tiene alguna pregunta? Foro de UiPath

Manténgase actualizado