Consumir modelos de diferentes entornos

Cuando se utilizan proyectos modernos de Document Understanding^TM, es necesario configurar una aplicación externa para acceder a modelos en varios tenants y organizaciones.

Este procedimiento ofrece una descripción general sobre cómo acceder a los modelos implementados en diferentes entornos utilizando aplicaciones externas. Incluye instrucciones paso a paso sobre cómo configurar una aplicación externa para los derechos de acceso, configurar el flujo de trabajo de Studio para utilizar estos modelos y establecer 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 los Robots se implementan localmente.

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

Configurar una aplicación externa

1. Navega 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 de aplicaciones externas.
   
   

   

   
   
4. Selecciona Añadir aplicación en la página de aplicaciones externas.
   Consejo: para obtener más información sobre la adición de una aplicación externa, consulta la página Gestionar aplicaciones OAuth externas en 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 de la sección Tipo de aplicación:
   • Aplicación confidencial: adecuada para almacenar el secreto de la aplicación de forma segura. Utiliza esto para requisitos de alta seguridad.
   • Aplicación no confidencial: utiliza esta opción solo cuando no se requiere 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. Configurar ámbitos de usuario para conceder permisos dentro de un contexto de usuario.

      Selecciona las casillas de verificación correspondientes a los permisos de API lógicos que quieres conceder según tu requisito en la pestaña Ámbitos de usuario. Si concedes permisos en el ámbito de usuario, está implícito 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. Configura los ámbitos de la aplicación para proporcionar acceso en el nivel de la aplicación para necesidades de automatización más amplias.

      Si estás utilizando una aplicación confidencial, ve a la pestaña Ámbitos de la aplicación para asignar permisos en el 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 muestra 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 cumplan los siguientes requisitos previos:

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

Consejo:

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

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

      Tu taxonomía de 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 regex 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 modelos de extracción e incluye la actividad Extractor de proyecto de Document Understanding.
      
      

      

      
      
   2. Añade la actividad Clasificar ámbito de documento para configurar modelos de clasificación e incluye la actividad Clasificador de proyecto de Document Understanding.
4. Configurar credenciales de tiempo de diseño.
   1. Abre el asistente Obtener capacidades desde el ámbito de la actividad.
      El asistente se muestra cuando incluyes las actividades del proyecto de Document Understanding dentro de ese ámbito. Este asistente te permite configurar las credenciales de tiempo de diseño necesarias para asignar los campos de taxonomía de un proyecto moderno.
   2. Rellena la siguiente información:
      • ID de la aplicación y secreto de la aplicación desde 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. Mapea 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 de Document Understanding.
   
   

   

   
   
6. Guarda la credencial de tiempo de ejecución como un activo de Orchestrator.
   1. Navega a tu tenant de Automation Cloud.
   2. Ve a Orchestrator.
   3. Elige tu 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 previamente como el nombre de usuario y la contraseña.
   
   

   

   
   
7. Configurar credenciales de runtime en Studio.
   1. Navega a tu proyecto de Studio.
   2. Ve a la actividad Ámbito de extracción de datos.
   3. Configurar la propiedad del Activo de credenciales de runtime.
      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 de tenant de runtime.
      Utiliza este campo junto con la propiedad del activo de credenciales de runtime. 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 necesitas configurar el acceso para cada proyecto individualmente.

Configurar versiones de 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. Navega a tu tenant de Automation Cloud.
2. Ve a Orchestrator.
3. Elige tu 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 de acuerdo con el activo en Orchestrator. Este proceso es similar a guardar las credenciales de la aplicación externa como activos.
10. Navega 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 una variable de entrada a las actividades del proyecto de 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 del proceso de Document Understanding.