Maestro: cómo: proceso complejo

Información general

InsurePath identificó un flujo de trabajo de procesamiento de facturas con UiPath® Process Mining. Utilizan Extracción y Procesamiento Inteligentes (IXP) y Document Understanding para procesar facturas entrantes y extraer datos de factura. Después de la extracción, los equipos de finanzas y contabilidad todavía procesan la mayoría de las facturas manualmente, incluida la resolución de disputas de proveedores.

El propietario del proceso, junto con los implementadores y administradores de procesos, decidió abordar el problema del procesamiento de facturas con UiPath Maestro™ y las capacidades de plataforma.

Proceso

Crea un proceso de procesamiento de facturas de trabajo para demostrar cómo Maestro coordina el trabajo entre robots, agentes y humanos.

Este es el diagrama BPMN para el proceso que crearemos.

Requisitos previos

Necesitamos configurar los recursos dependientes para este escenario.

Data Fabric: entidad de APInvoice

Usa el evento Registrar Evento creado para la entidad APInvoice para desencadenar el inicio de nuestro proceso.

Navega a Data Fabric.
En el menú desplegable Importar/Exportar, selecciona Importar esquema.
Importa Schema(APInvoice).json .
Marca la casilla de verificación Importar correspondiente a la entidad APInvoice.
Selecciona Importar.

Orchestrator: carpeta compartida

Usa una carpeta compartida en Orchestrator para organizar los recursos Cómo.

Navega a Orchestrator y crea una carpeta Compartida/Cómo. Más información sobre Gestión de carpetas en Orchestrator.

Automatización: coincidencia de factura con orden de compra

Usa una automatización simulada para simular la coincidencia bidireccional de factura con orden de compra. El proceso toma un argumento de entrada para número de factura y establece la variable de salida ResolutionRequired. Si el número de factura comienza con 1, el valor es Sí. De lo contrario, es No.

Navega a Studio Web y selecciona Importar de la lista desplegable Crear nuevo. Usa este archivo para importar.
Abre el proyecto en UiPath Studio Web y publícalo en la fuente de procesos del tenant de Orchestrator.
Navega a Orchestrator y ve a la carpeta Compartido/Cómo.
Abre la pestaña Automatizaciones, elige Procesos y selecciona Agregar proceso.
Selecciona Invoice.To.PO.Matching en el campo Nombre de origen del paquete y selecciona Siguiente.
En la sección Requisitos del paquete, selecciona Siguiente .
Proporciona la coincidencia de factura a PO para el nombre para mostrar y selecciona Crear.
Consulta la página Publicar un proyecto de Studio Web para obtener detalles adicionales sobre la publicación e implementación de proyectos.

Automatización: publicar factura en SAP

Usa una automatización simulada para simular la publicación de la factura en SAP. El proceso toma un argumento de entrada para el número de orden de compra y no tiene salidas. Si el número de orden de compra es igual a fail, el proceso lanza una excepción de runtime que puedes reparar en la gestión de instancias.

Navega a Studio Web y selecciona Importar de la lista desplegable Crear nuevo. Usa este archivo para importar.
Abre el proyecto en Studio Web y publícalo en la fuente de procesos del tenant de Orchestrator.
Navega a Orchestrator, ve a la carpeta Compartido/Cómo.
Selecciona la pestaña Automatizaciones, elige Procesos y selecciona Añadir proceso.
Selecciona Post.Invoice.To.SAP en el campo Nombre del origen del paquete y selecciona Siguiente.
En la sección Requisitos del paquete, selecciona Siguiente .
Proporciona Publicar factura a SAP para el nombre para mostrar y selecciona Crear.
Consulta la página Publicar un proyecto de Studio Web para obtener detalles adicionales sobre la publicación e implementación de proyectos.

Agente: agente de resolución de discrepancias

Navega a Agents y selecciona Construir tu agente ahora.
Introduce los siguientes detalles:
Nombre: Agente de resolución de discrepancias

Descripción: Agente de resolución de discrepancias

Solicitud del sistema: eres un experto en resolver discrepancias de facturas

Solicitud de usuario: si {{InvNum}}comienza con 11, resolverás la factura. De lo contrario, rechazarás la factura y darás el {{Reason}}de rechazo como Needs human review since the PO Number doesn't match the Invoice.

Cuando rechazas el conjunto de factura {{Decision}}como Rejected y si apruebas el conjunto de factura {{Decision}}como Resolved.

Selecciona Argumentos e introduce lo siguiente utilizando la opción Editor:
Entradas
```
{
  "type": "object",
  "properties": {
    "InvNum": {
      "type": "string"
    },
    "PONum": {
      "type": "string"
    }
  },
  "required": [
    "InvNum"
  ]
}{
  "type": "object",
  "properties": {
    "InvNum": {
      "type": "string"
    },
    "PONum": {
      "type": "string"
    }
  },
  "required": [
    "InvNum"
  ]
}
```
Salidas
```
{
  "type": "object",
  "properties": {
    "Decision": {
      "type": "string"
    },
    "Reason": {
      "type": "string"
    }
  },
  "required": []
}{
  "type": "object",
  "properties": {
    "Decision": {
      "type": "string"
    },
    "Reason": {
      "type": "string"
    }
  },
  "required": []
}
```
Publicar en la fuente de procesos del tenant de Orchestrator.

Aplicación de acción: aplicación para la aprobación de facturas

Navega a Studio Web y selecciona Importar en la lista desplegable Crear nuevo. Usa este archivo para importar.
Abre el proyecto en Studio Web y publícalo en la fuente de procesos del tenant de Orchestrator.
Nota: es posible que debas navegar a las entidades MainForm_MainForm_load.xamly actualizarlas. Desde Gestor de datos, ve a Entidades y selecciona Actualizar entidades antes de poder publicar.
Navega a Orchestrator, ve a la carpeta Compartido/Cómo, abre la pestaña Automatizaciones, selecciona Apps y elige Implementar aplicación.

Modelar un proceso agéntico

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.

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.

Navega a tu tenant de Automation Cloud™.
En la barra de la izquierda, de la lista de productos, selecciona Maestro.
En la página de destino de Maestro, selecciona Iniciar modelado. Se abre tu nuevo proceso agéntico.
Consejo: también puedes empezar creando un nuevo proceso agéntico en Studio Web.
Haz clic con el botón derecho para cambiar el nombre del proyecto a {tus iniciales} Proceso de factura, y el proceso a Proceso de factura.
Tu proceso agéntico es, de forma predeterminada, parte de una solución. Consulta las soluciones en la guía del usuario de Studio Web.
Selecciona el elemento de inicio y escribe Factura recibida en el campo nombre.
Selecciona Añadir: anotación de texto desde el cuadro de herramientas. Escribe Desencadenador de Data Fabric en la anotación.
Selecciona el elemento de inicio y elige Añadir tarea en el cuadro de herramientas y escribe Coincidencia de factura con PO para el nombre de la tarea.
Selecciona la tarea Coincidencia de factura con PO y elige Añadir: Anotación de texto en el cuadro de herramientas y escribe Automatización para indicar que queremos que esta sea una tarea de automatización.

Rutas de salida de coincidencia de factura con PO

Configurar dos rutas salientes para la puerta de enlace, de las cuales solo se seguirá una en función del resultado de la automatización de coincidencia de factura con PO.

Selecciona la tarea de coincidencia de factura con PO, elige Añadir: puerta de enlace exclusiva desde el cuadro de herramientas y escribe ¿Se requiere resolución? para el nombre.
Selecciona la puerta de enlace y elige Añadir: Tarea en el cuadro de herramientas y escribe Aprobación de factura para el nombre. Añade la aplicación de acción Action Center como una anotación para indicar que queremos que esta sea una tarea HITL.
Selecciona la línea que se acaba de crear entre la puerta de enlace y la tarea y pulsa el botón Abrir panel de propiedades en la parte superior derecha del diseñador para cambiar el nombre a No.
Selecciona la puerta de enlace de nuevo y elige Añadir: tarea en el cuadro de herramientas y escribe Resolver discrepancias para el nombre. Arrastra y posiciona la tarea debajo de la puerta de enlace. Añade Agente como una anotación para indicar que esta será una tarea de agente.
Selecciona la línea que acabas de crear entre la puerta de enlace y la tarea y abre el panel de propiedades para cambiar el nombre a Sí.

Rutas salientes de aprobación de facturas

Configura dos rutas salientes para la puerta de enlace, de las que solo se seguirá una en función del resultado de la tarea de aprobación de factura realizada por el humano.

Selecciona la tarea Aprobación de factura y añade otra puerta de enlace exclusiva.
Selecciona la puerta de enlace, elige Añadir: Tarea en el cuadro de herramientas y escribe Enviar factura a SAP como nombre. Añade Automatización como una anotación para indicar que quieres que esta sea una tarea de automatización.
Selecciona la línea que acabas de crear entre la puerta de enlace y la tarea y abre el panel de propiedades para cambiar el nombre a Aprobar.
Selecciona la puerta de enlace de nuevo, elige Añadir: Tarea en el cuadro de herramientas y escribe Notificar al proveedor como nombre. Arrastra y posiciona la tarea debajo de la puerta de enlace. Añade el conector de Outlook de Integration Service como una anotación para indicar que esta será una llamada a la API indicada como tarea de Envío.
Selecciona la línea que acabas de crear entre la puerta de enlace y la tarea y abre el panel de propiedades para cambiar el nombre a Rechazar.

Resolver discrepancias de rutas salientes

Configura dos rutas salientes para la puerta de enlace. Solo se seguirá uno en función del resultado de la tarea Resolver discrepancias realizada por el humano.

Selecciona la tarea Resolver discrepancias y añade otra Puerta de enlace exclusiva.
Selecciona la puerta de enlace y elige la flecha Conectar en el cuadro de herramientas.
Selecciona la tarea Notificar al proveedor para dibujar una línea desde la puerta de enlace a la tarea.
Selecciona la línea que acabas de crear entre la puerta de enlace y la tarea y abre el panel de propiedades para cambiar el nombre a Rechazado.
Usa la herramienta Conectar de nuevo para dibujar una línea desde la puerta de enlace a la tarea Aprobación de factura.
Selecciona la línea que acabas de crear entre la puerta de enlace y la tarea y abre el panel de propiedades para cambiar el nombre a Resuelto.

Evento de límite de error para resolver discrepancias

Si el agente no puede resolver la discrepancia, devolverá un error empresarial, enrutando la tarea de nuevo a un humano para obtener más entradas. Modela esto añadiendo un evento de límite de error a la tarea.

Selecciona el Evento intermedio en el cuadro de herramientas completo en el lado izquierdo y arrástralo y suéltalo en la tarea Resolver discrepancias.
Selecciona el evento intermedio y elige Cambiar elemento en el cuadro de herramientas y selecciona Evento de límite de error.
Selecciona el evento de límite de error, elige Añadir: tarea en el cuadro de herramientas y escribe Resolver discrepancias para el nombre de la tarea. Añade la aplicación de acción Action Center como una anotación para indicar que queremos que esta sea una tarea de intervención humana.
Selecciona la nueva tarea Resolver discrepancias. Usa la herramienta Conectar de nuevo para dibujar una línea de esta nueva tarea a la puerta de enlace del agente.

Eventos de fin

Es una práctica recomendada crear un final explícito para tu proceso. Es importante saber rápidamente qué ruta ha seguido tu proceso para poder crear un final explícito para cada uno.

Selecciona la tarea Publicar factura en SAP, elige Añadir: evento de fin y escribe Factura procesada como el nombre.
Selecciona la tarea Notificar al proveedor, elige Añadir: evento de fin y escribe Factura rechazada para el nombre.`

¡Felicidades! Has creado tu primer proceso empresarial BPMN de extremo a extremo. Es hora de añadir algunas capacidades de UiPath al proceso.

Implementar un proceso agéntico

Evento de inicio de mensaje

Selecciona el elemento de inicio, elige Cambiar elemento en el cuadro de herramientas y selecciona Evento de inicio de mensaje.
Abre el panel de propiedades y en la sección Implementación configura lo siguiente:
- Acción: esperar el evento de conector.
- Conector: Data Fabric
- Conexión de Data Fabric: Data Fabric.
  Nota: elige Conectar a Data Fabric para crear una conexión si aún no tienes una.
- Desencadenador: registro creado.
- Objeto: APInvoice.
Nota: todas las salidas estarán disponibles automáticamente como variables en la configuración del proceso.

Nota: si estás en un entorno compartido, puedes cambiar el desencadenador a Registro actualizado y configurar el filtro para establecer Creado por correo electrónico igual a tu correo electrónico.

Automatización de coincidencia de factura con PO

Selecciona la tarea Coincidencia de factura con PO, elige Cambiar elemento en el cuadro de herramientas. y selecciona Tarea de servicio.
Abre el panel de propiedades y en la sección Implementación configura lo siguiente:
- Acción: iniciar y esperar el flujo de trabajo de RPA.
- Automatización: coincidencia de factura con PO.
Configura las entradas asignando la salida del evento de inicio de mensaje de factura recibido como entradas a la automatización. Usa el cuadro de diálogo Buscar variable para buscar las variables.
- InvNum: factura recibida > respuesta > Número de factura.
- PoNum: factura recibida > respuesta > Número de PO

¿Se requiere resolución? puerta de enlace

Selecciona la puerta de enlace ¿Se requiere resolución? amplía Condiciones para introducir la condición para las rutas No y Sí y utiliza el editor de Expresión para introducir las condiciones.
Usa Insertar variable para buscar e insertar la variable de salida Coincidencia de factura con PO, ResoluciónRequerida, establece el valor como "No" y selecciona Guardar.
Como alternativa, puedes simplemente copiar y pegar las expresiones siguientes en el editor de expresiones:
1. No: vars.ResolutionRequired == "No"
2. Sí: vars.ResolutionRequired == "Yes"

Tarea Aprobar factura

Selecciona la tarea Aprobar factura, elige Cambiar elemento en el cuadro de herramientas y selecciona Tarea de Usuario.
Abre el panel de propiedades y en la sección Implementación y configura lo siguiente:
- Acción: Create action app task
- Acción*: Invoice.Approval action app
- Título de la tarea: {your initials} Invoice approval.
Configura las entradas asignando la salida del evento de inicio de mensaje recibido de factura como entradas a la tarea de aplicación. Usa el cuadro de diálogo Buscar variable para buscar las variables para el ID de registro de Data Fabric.

Tarea Resolver discrepancias

Selecciona Resolver discrepancias, elige Cambiar elemento en el cuadro de herramientas y selecciona Tarea de servicio.
Abre el panel de propiedades y, en la sección Implementación, configura lo siguiente:
- Acción: Start and wait for agent.
- Automatización: 2-way matching agent.
Configura las entradas asignando la salida del evento de inicio de mensaje de factura recibido como entradas a la automatización. Usa el cuadro de diálogo Buscar variable para buscar las variables.
- InvNum: factura recibida > respuesta > Número de factura.
- PoNum: coincidencia de factura con PO > número de PO

Resolver discrepancias de puerta de enlace saliente de agente

Selecciona la puerta de enlace y expande Condiciones para introducir la condición para las rutas Resuelto y Rechazado, y selecciona el selector de entrada de texto para abrir el editor de expresiones para introducir las condiciones.
Copia/pega las expresiones a continuación en el editor de expresiones.
1. Resuelto: vars.Decision == "Resolved"
2. Rechazado: vars.Decision == "Rejected"

Tarea de envío de notificación al proveedor

Selecciona la tarea Notificar al proveedor, elige Cambiar elemento en herramientas, y selecciona Tarea.
Abre el panel de propiedades y, en la sección Implementación, configura lo siguiente:
- Acción: Integration Servies - API execution
- Conectores: Microsoft Outlook 365
- Conexión: {your outlook connection}
  Nota: selecciona Connect to Microsoft Outlook 365 si aún no tienes una conexión disponible.
- Actividades: Send email
- Desencadenador: Email sent
En la sección Filtro, configura las entradas principales para la actividad Enviar correo electrónico:
- Para: {Invoice received > response > Invoice email}
- Asunto: Invoice rejected
- Cuerpo: factura rechazada porque {Resolve discrepancies > message}

Puerta de enlace saliente de aprobación de facturas

Selecciona la puerta de enlace y expande las Condiciones para introducir la condición para las rutas Aprobar y Rechazar y selecciona el selector de entrada de texto para abrir el editor de expresiones y escribir las condiciones.
Copia/pega las expresiones a continuación en el editor de expresiones:
- Aprobar: vars.Action == "Approve"
- Rechazar: vars.Action == "Reject"

Publicar factura en automatización de SAP

Selecciona Publicar factura en SAP, elige Cambiar elemento en el cuadro de herramientas y selecciona Tarea de servicio.
Abre el panel de propiedades y en la sección Implementación configura lo siguiente:
- Acción: Start and wait for RPA workflow
- Automatización: Post Invoice to SAP.
- Configura las entradas asignando la salida de la tarea Coincidencia de factura con PO como entradas a la automatización.
  - PurchaseOrderId: error
  Nota: queremos que esta automatización falle para poder corregir el runtime más tarde.

¡Felicidades! Ahora has configurado completamente tu primer proceso agéntico.

Es hora de depurar un poco.

Depurar un proceso empresarial

Escenarios de depuración

El número de factura comienza con x > No se requiere resolución, ir a Aprobación de factura con intervención humana.
El número de factura comienza con 1x > Se requiere resolución, ir a Agente de resolución de discrepancias, Rechazo de agente.
El número de factura comienza con 11 > Se requiere resolución, ir a Agente de resolución de discrepancias, Resolución de agente.

En la parte superior izquierda de la página, selecciona Depurar paso a paso.

Nota: puedes seleccionar Configuración de prueba para confirmar las variables de entrada y conexiones utilizadas en el proyecto.
Mantén el puntero a la izquierda de la tarea Coincidencia de factura con PO y selecciona para añadir un punto de interrupción.

Nota: configura puntos de interrupción para tus eventos de fin. Esto te ofrece tiempo suficiente para inspeccionar todas las variables antes de finalizar la sesión de depuración.
Selecciona Siguiente paso para mover la ejecución más allá del evento de inicio de mensaje.

Actualiza la variable global de respuesta para el evento de inicio de mensaje de factura recibido con el siguiente objeto de respuesta y luego selecciona intro pulsa tab para confirmar el cambio:

{
    "Currency": "USD",
    "DueDate": "2025-02-14",
    "InvoiceDate": "2025-02-14",
    "InvoiceEmail": "petrodev71@gmail.com",
    "InvoiceNumber": "12345",
    "PONumber": "4551232",
    "TotalAmount": 10000,
    "VendorName": "Acme",
    "Source": 1,
    "Status": 6,
    "Id": "6F92ECF6-D1EA-EF11-90CB-6045BD93BF30",
    "UpdateTime": "2025-02-14T18:22:40.6233376Z",
    "CreateTime": "2025-02-14T12:48:19.3578548Z",
    "UpdatedBy": {
        "Email": "anthony.petro@uipath.com"
    },
    "CreatedBy": {
        "Email": "anthony.petro@uipath.com"
    }
}{
    "Currency": "USD",
    "DueDate": "2025-02-14",
    "InvoiceDate": "2025-02-14",
    "InvoiceEmail": "petrodev71@gmail.com",
    "InvoiceNumber": "12345",
    "PONumber": "4551232",
    "TotalAmount": 10000,
    "VendorName": "Acme",
    "Source": 1,
    "Status": 6,
    "Id": "6F92ECF6-D1EA-EF11-90CB-6045BD93BF30",
    "UpdateTime": "2025-02-14T18:22:40.6233376Z",
    "CreateTime": "2025-02-14T12:48:19.3578548Z",
    "UpdatedBy": {
        "Email": "anthony.petro@uipath.com"
    },
    "CreatedBy": {
        "Email": "anthony.petro@uipath.com"
    }
}

Selecciona el expansor para inspeccionar y/o modificar más los valores.
Selecciona Actualizar 1 variables y Actualizar variables en el cuadro de diálogo para confirmar los cambios.
Selecciona Siguiente paso o Continuar para mover la ejecución al final con los nuevos valores.

¡Felicidades! Has depurado completamente tu primer proceso agéntico.

Es hora de publicar e implementar tu proceso.

Publicar e implementar un proceso complejo

Selecciona Publicar para publicar el proceso.
Esto requiere publicar toda la solución de la que forma parte el proceso.
Consulta Publicar e implementar soluciones para conocer los pasos para publicar en Orchestrator.
Navega a Orchestrator, en la pestaña Automatizaciones y selecciona Añadir proceso.
En la pantalla Conectar a Microsoft Outlook 365, selecciona Conectar.
Usa tus credenciales de correo electrónico para completar la conexión. La nueva conexión se seleccionará automáticamente.,
Selecciona Siguiente.
Introduce {your initials} Invoice Processing como nombre para mostrar y elige Crear.

¡Felicidades! Ahora has implementado completamente tu primer proceso agéntico.

Es hora de gestionar las instancias de runtime.

Gestionar un proceso empresarial

Navega a la página de inicio de Maestro.
En la Ver Instancias de proceso, elige {your initials} Invoice Processing para abrir la vista Todas las instancias para tu proceso.
Puedes seleccionar el fondo del modelo para ver Variables globales, Incidentes, Historial de acciones, así como el seguimiento de ejecución.Puedes seleccionar un nodo en el modelo o el Seguimiento de ejecución para inspeccionar los Detalles y Variables para ese paso de ejecución.
Nota: debes insertar acciones para cualquier paso de intervención humana en Action Center si la ejecución se detiene allí.

p

¡Felicidades! Has gestionado completamente tu primer proceso agéntico,

Es hora de corregir tu proceso roto.

Corregir un proceso empresarial

Para este ejercicio, causa un error en la ejecución para poder utilizar la gestión de instancias para recuperarse.

Preparar instancia fallida

Abre una nueva pestaña y ve a Data Fabric > APInvoice > Datos y añade un registro que tenga un número de factura que comience con 2xxxx para asegurarte de llegar al paso Enviar factura en SAP.
Nota: si estás en un entorno compartido, puedes utilizar un registro existente que tenga CreadoPor correo electrónico que coincida con el filtro que has configurado.
Navega a tu página Todas las instancias de proceso, selecciona el botón Actualizar para la lista y elige la última instancia.
Cuando la ejecución se detiene en un paso de intervención humana, debes abrir Actions (anteriormente Action Center) para asignar y completar la tarea.
Abre una nueva pestaña del explorador y selecciona Acciones en el menú de navegación de la izquierda.
Selecciona Bandeja de entrada y luego ve a No asignado.
Busca y selecciona tu tarea y elige Asignar a mí mismo.
Busca tu tarea en Pendiente y selecciona Aprobar una vez que se cargue el formulario.

Corregir instancia fallida

Vuelve a tu pestaña de proceso, espera a que falle el paso Publicar factura en SAP y selecciona en el nodo o el paso de ejecución. Ten en cuenta Errores y variables.
Actualiza la variable para corregir la entrada cambiando 'Error' a '1234' y selecciona Guardar.
Selecciona Actualizar 1 variable para actualizar la variable y añadir un comentario.
En la pestaña Historial de acciones, selecciona Reintentar, añade un comentario y elige Reintentar instancia para reintentar el paso con la nueva variable. Ver la instancia completa.

¡Enhorabuena! Has corregido correctamente una instancia rota.

Migrar a una nueva versión de un proceso empresarial

Corrige la incidencia creada en la sección anterior para que no vuelva a ocurrir.