Consumir modelos de diferentes entornos

Al utilizar proyectos modernos de Document Understanding^TM , debes configurar una aplicación externa para acceder a los modelos en varios tenants y organizaciones.

Este procedimiento ofrece una descripción general completa sobre cómo acceder a los modelos implementados en diferentes entornos utilizando aplicaciones externas. Incluye instrucciones paso a paso sobre la configuración de una aplicación externa para los derechos de acceso, la configuración del flujo de trabajo de Studio para consumir estos modelos y el establecimiento de flujos de trabajo de producción.

Esta funcionalidad también te permite utilizar modelos en entornos de implementación híbridos. En este caso, los proyectos de Document Understanding se configuran en Automation Cloud^TM, mientras que Orchestrator y Robots se implementan en las instalaciones.

1. Configurar una aplicación externa
2. Configurar el flujo de trabajo de UiPath Studio
3. Configurar versiones del modelo como parámetros
4. Plantilla de proceso de Document Understanding

Configurar una aplicación externa

1. Dirígete a tu tenant de Automation Cloud.
2. Ve a la página Administración y selecciona tu organización.
3. Ve a la página Aplicaciones externas .
   
   

   

   
   
4. Selecciona Añadir aplicación en la página Aplicaciones externas .
   Consejo: para obtener más información sobre cómo añadir una aplicación externa, consulta la página Gestionar aplicaciones OAuth externas de la guía de administración de Automation Cloud.
5. Escribe un nombre único para la aplicación en el campo Nombre de la aplicación .
6. Selecciona un tipo de aplicación en la sección Tipo de aplicación :
   • Aplicación confidencial: adecuada para almacenar el secreto de la aplicación de forma segura. Utilízalo para requisitos de alta seguridad.
   • Aplicación no confidencial: utiliza esta opción solo cuando no se requiera un almacenamiento seguro para el secreto de la aplicación .
   
   

   

   
   
7. Define los ámbitos de acceso para tu aplicación externa.
   1. Selecciona Añadir ámbitos en la sección Recursos .
   2. Selecciona Document Understanding en la lista desplegable Recurso .
   3. Configura los ámbitos de usuario para conceder permisos dentro de un contexto de usuario.

      Selecciona las casillas de verificación correspondientes a los permisos lógicos de la API que quieres conceder según tus requisitos en la pestaña Ámbito(s) de usuario . Si concedes permisos en el ámbito de usuario, se da a entender que la aplicación externa puede acceder a esos recursos dentro de un contexto de usuario. Por lo tanto, debe iniciar sesión un usuario con los permisos correspondientes.

   4. Configure los ámbitos de aplicación para proporcionar acceso a nivel de aplicación para necesidades de automatización más amplias.

      Si utilizas una aplicación confidencial, ve a la pestaña Ámbito(s) de la aplicación para asignar permisos a nivel de aplicación para el recurso elegido según sea necesario. Al delegar permisos en el ámbito de la aplicación, la aplicación externa puede acceder a los datos en los ámbitos seleccionados sin ninguna interacción del usuario.

      Las aplicaciones no confidenciales no pueden acceder al ámbito de la aplicación.

      
      

      

      
      
   5. Selecciona Guardar.
      Nota: Si has registrado la aplicación externa con ámbitos de usuario, añade una URL de redirección. Esta URL recibirá la respuesta de autorización. Sin embargo, si seleccionaste solo ámbitos de aplicación, proporcionar una URL de redirección es opcional.
8. Selecciona Añadir para crear el registro.

   Se mostrará un mensaje de confirmación. Para las aplicaciones confidenciales, este mensaje incluye el secreto de la aplicación. La aplicación externa registrada puede utilizar este secreto para solicitar autorización. Asegúrate de guardar el secreto de la aplicación en una ubicación segura, ya que no podrás volver a verlo.

   
   

   

   
   

Configurar el flujo de trabajo de UiPath Studio

Antes de comenzar, asegúrate de que se cumplen los siguientes requisitos previos:

• Utiliza una versión de Windows Project compatible.
• Asegúrate de que el paquete de actividades IntelligentOCR está instalado. El paquete IntelligentOCR.Activities admite el consumo de proyectos modernos de Document Understanding a partir de la versión 6.22.1.

Consejo:

Para obtener una comprensión más detallada de las diferencias entre los paquetes DocumentUnderstanding.Activities e IntelligentOCR.Activities , así como orientación sobre cuándo utilizar cada uno de ellos, consulta la página Automatizaciones en Document Understanding .

1. Abre tu proyecto de UiPath Studio .
2. Define la taxonomía.
   1. Abre el Gestor de taxonomía para definir los tipos de documentos y campos relevantes para tu automatización.

      La taxonomía de tu proyecto debe abarcar cada tipo de documento y los campos necesarios. La taxonomía que creas en Studio puede contener tipos de documentos y campos adicionales que no forman parte de los proyectos modernos de Document Understanding. Si deseas utilizar extractores adicionales como el Extractor de formularios o el Extractor de expresiones regulares para varios tipos de documentos, este paso será necesario.

      
      

      

      
      
3. Instala el paquete IntelligentOCR.Activities para utilizar actividades como el Extractor de proyectos de Document Understanding y el Clasificador de proyectos de Document Understanding.
   1. Añade la actividad Ámbito de extracción de datos para configurar los modelos de extracción e incluye la actividad Extractor de proyectos de Document Understanding.
      
      

      

      
      
   2. Añade la actividad Clasificar ámbito de documento para configurar modelos de clasificación e incluye la actividad Clasificador de proyectos de Document Understanding.
4. Configura las credenciales en tiempo de diseño.
   1. Abre el asistente Obtener capacidades desde el ámbito de la actividad.
      El asistente se muestra cuando se incluyen las actividades del proyecto Document Understanding dentro de ese ámbito. Este asistente te permite configurar las credenciales en tiempo de diseño necesarias para asignar los campos de taxonomía de un proyecto moderno.
   2. Rellena la siguiente información:
      • App ID y App Secret de la aplicación externa.
      • URL del tenant para el entorno de destino.
   3. Selecciona Obtener proyectos y elige el proyecto y la versión necesarios.
   4. Cierra el asistente.
   
   

   

   
   
5. Asignar la taxonomía.
   1. Selecciona Configurar extractores dentro de la actividad Ámbito de extracción de datos .
   2. Crea una asignación de la taxonomía del proyecto a la taxonomía del modelo para cada tipo de documento.
      Para ejecutar este paso, elige un Tipo de documento de la taxonomía y alinea cada campo de este Tipo de documento con un campo correspondiente en el modelo diseñado para el Proyecto Document Understanding.
   
   

   

   
   
6. Guarda la credencial de tiempo de ejecución como un activo de Orchestrator.
   1. Dirígete a tu tenant de Automation Cloud.
   2. Ve a Orchestrator.
   3. Elija su carpeta de automatización.
   4. Ve a la pestaña Activos .
   5. Selecciona Añadir activo y elige Crear un nuevo activo en la lista desplegable.
   6. Escribe un nombre en el campo Nombre del activo .
   7. Selecciona Credencial en la lista desplegable Tipo .
   8. Utiliza el ID de la aplicación y el Secreto de la aplicación creados anteriormente como Nombre de usuario y Contraseña.
   
   

   

   
   
7. Configura las credenciales de tiempo de ejecución en Studio.
   1. Ve a tu proyecto de Studio.
   2. Ve a la actividad Ámbito de extracción de datos.
   3. Configura la propiedad Activo de credenciales de tiempo de ejecución .
      Utiliza este campo para acceder a los recursos del proyecto moderno de Document Understanding mientras el robot está conectado a un Orchestrator local o desde un tenant diferente. Puedes elegir introducir un activo de credenciales, con fines de autenticación, de una de las siguientes maneras:

      • Selecciona el activo de credenciales deseado del Orchestrator al que está conectado el robot en la lista desplegable.
      • Introduce la ruta al activo de credenciales de Orchestrator donde almacenas las credenciales de la aplicación externa para acceder al proyecto. El formato de la ruta debe ser el siguiente: <OrchestratorFolderName>/<AssetName>.
   4. Configura la propiedad URL del tenant de tiempo de ejecución .
      Utiliza este campo junto con la propiedad Activo de credenciales de tiempo de ejecución . Introduce la URL del tenant al que se conectará el robot para ejecutar la extracción. La URL debe tener el siguiente formato: https://<baseURL>/<OrganizationName>/<TenantName>.

La aplicación externa proporciona acceso a todos los proyectos de Document Understanding dentro del tenant. No es necesario configurar el acceso para cada proyecto de forma individual.

Configurar versiones del modelo como parámetros

Si configuras las versiones del proyecto como parámetros, puedes actualizar los flujos de trabajo de automatización para las nuevas versiones del proyecto sin ajustar el código del flujo de trabajo.

1. Dirígete a tu tenant de Automation Cloud.
2. Ve a Orchestrator.
3. Elija su carpeta de automatización.
4. Ve a la pestaña Activos .
5. Selecciona Añadir activo y elige Crear un nuevo activo en la lista desplegable.
6. Escribe un nombre en el campo Nombre del activo .
7. Selecciona Texto en la lista desplegable Tipo .
8. Escribe un nombre en el campo Texto para definir un activo específico de la versión.
   
   

   

   
   
9. Selecciona Crear.
   Esto te permite actualizar los flujos de trabajo de automatización para las nuevas versiones del proyecto sin cambiar el código del flujo de trabajo. Cuando la automatización se implementa en una carpeta especificada, la versión del modelo se establece según el activo en Orchestrator. Este proceso es similar a guardar las credenciales de la aplicación externa como activos.
10. Ve a tu proyecto de Studio.
11. Añade una actividad Obtener activo en tu flujo de trabajo para recuperar el activo de la versión.
12. Pasa el valor recuperado como variable de entrada a las actividades del proyecto Document Understanding .
    
    

    

    
    

Plantilla de proceso de Document Understanding

El proceso de Document Understanding es una plantilla de proyecto de UiPath® Studio totalmente funcional basada en un diagrama de flujo de procesamiento de documentos. Puedes utilizarlo para empezar a trabajar en una demostración o una implementación a gran escala de Document Understanding^TM.

El proceso proporciona registro, manejo de excepciones, mecanismos de reintento, y todos los métodos que deben utilizarse en un flujo de trabajo de Document Understanding de manera inmediata.

Para obtener más información, consulta la página de la plantilla Proceso de Document Understanding .