Consommer des modèles provenant de différents environnements

When using Document Understanding^TM modern projects, you need to configure an external application to access models across various tenants and organizations.

Cette procédure offre une vue d’ensemble complète sur la façon d’accéder aux modèles déployés dans différents environnements à l’aide d’applications externes. Elle comprend des instructions pas à pas sur la configuration d’une application externe pour les droits d’accès, la configuration du workflow Studio pour utiliser ces modèles et l’établissement des workflows de production.

This functionality also allows you to use models in hybrid deployment environments. In this case, Document Understanding projects are configured on Automation Cloud^TM, while Orchestrator and Robots are deployed on-premises.

1. Configuration d’une application externe
2. Configuration du workflow UiPath Studio
3. Configuration des versions de modèles en tant que paramètres
4. Modèle de processus Document Understanding

Configuration d’une application externe

1. Accédez à votre espace locataire Automation Cloud.

2. Go to the Administration page and select your organization.

3. Go to the External applications page.

   

4. Select Add Application from the External applications page.

   Astuce :

   For more information on adding an external application, check the Managing external OAuth applications page from the Automation Cloud admin guide.

5. Type in a unique name for the application in the Application Name field.

6. Select an application type from the Application type section:

   • Confidential application: suitable for storing the App Secret securely. Use this for high-security requirements.

   • Non-Confidential application: use this option only when secure storage for the App Secret is not required.

     

7. Définissez les étendues d’accès de votre application externe.

   1. Select Add Scopes from the Resources section.

   2. Select Document Understanding from the Resource drop-down list.

   3. Configure User scope(s) to grant permissions within a user context.

      Select the checkboxes corresponding to the logical API permissions you want to grant as per your requirement in the User scope(s) tab. If you grant permissions under user scope, it is implied that the external application can access those resources within a user context. Therefore, a user with the corresponding permissions must be logged in.

   4. Configure Application scope(s) to provide application-level access for broader automation needs.

      If you are using a confidential application, navigate to the Application scope(s) tab to allocate application-level permissions for the chosen resource as required. By delegating permissions under the application scope, the external application can access data across the selected scopes without any user interaction.

      Les applications non confidentielles ne peuvent pas accéder à l’étendue de l’application.

   

   5. Sélectionnez Enregistrer.
      Remarque :

      If you have registered the external application with user scopes, add a Redirect URL. This URL will receive the authorization response. However, if you selected only application scopes, providing a redirect URL is optional.

8. Sélectionnez Ajouter pour créer l'enregistrement.

   Un message de confirmation s’affiche. Pour les applications confidentielles, ce message inclut le secret de l’application. L’application externe enregistrée peut utiliser ce secret pour demander une autorisation. Veillez à enregistrer le secret de l’application dans un emplacement sécurisé, car vous ne pourrez plus le voir.

   

Configuration du workflow UiPath Studio

Avant de commencer, vérifiez que les conditions préalables suivantes sont remplies :

• Use a compatible Windows Project version.
• Make sure that the IntelligentOCR activity package is installed. The IntelligentOCR.Activities package supports the consumption of Document Understanding modern projects starting with v6.22.1.

Astuce :

For a more detailed understanding of the differences between the DocumentUnderstanding.Activities and IntelligentOCR.Activities packages, as well as guidance on when to use each of them, check the Automations in Document Understanding page.

1. Open your UiPath Studio project.
2. Définir la taxonomie.

   1. Open Taxonomy Manager to define relevant document types and fields for your automation.

      Your project taxonomy should encompass each document type and the necessary fields. The taxonomy you create in Studio can contain additional document types and fields that are not part of the Document Understanding modern projects. If you wish to use additional extractors like the Form Extractor or the Regex Extractor for various document types, this step will be necessary.

      

3. Install the IntelligentOCR.Activities package to use activities such as Document Understanding Project Extractor and Document Understanding Project Classifier.

   1. Add the Data Extraction Scope activity to configure extraction models and include the Document Understanding Project Extractor activity.

      

   2. Add the Classify Document Scope activity to configure classification models and include the Document Understanding Project Classifier activity.

4. Configurez les identifiants de conception.

   1. Open the Get Capabilities wizard from the activity scope.

      The wizard is displayed when you include the Document Understanding Project activities within that scope. This wizard allows you to configure design-time credentials needed to map the taxonomy fields of a modern project.

   2. Renseignez les informations suivantes :

      • App ID and App Secret from the external application.
      • Tenant URL for the target environment.

   3. Select Get Projects and choose the needed project and version.

   4. Fermez l’assistant.

      

5. Mapper la taxonomie.

   1. Select Configure Extractors within the Data Extraction Scope activity.

   2. Créer une correspondance entre la taxonomie du projet et la taxonomie du modèle pour chaque type de document.

      Pour exécuter cette étape, choisissez un type de document dans la taxonomie et alignez chaque champ de ce type de document avec un champ correspondant dans le modèle conçu pour le projet Document Understanding.

      

6. Enregistrez les informations d’identification d’exécution en tant que ressource Orchestrator.

   1. Accédez à votre espace locataire Automation Cloud.

   2. Accédez à Orchestrator.

   3. Choisissez le dossier de votre automatisation.

   4. Go to the Assets tab.

   5. Select Add asset and choose Create a new asset from the drop-down list.

   6. Type in a name in the Asset name field.

   7. Select Credential from the Type drop-down list.

   8. Use the previously created App ID and App Secret as the Username and Password.

      

7. Configurer les identifiants d’exécution dans Studio.

   1. Accédez à votre projet Studio.

   2. Accédez à l’activité Étendue d’extraction des données.

   3. Configure the Runtime Credentials Asset property.

      Utilisez ce champ pour accéder aux ressources de projet modernes Document Understanding lorsque le robot est connecté à un Orchestrator local ou à un locataire différent. Vous pouvez choisir d’entrer une ressource d’informations d’identification à des fins d’authentification de l’une des manières suivantes :

      • Dans la liste déroulante, sélectionnez l’identifiant souhaité depuis l’Orchestrator auquel le robot est connecté.
      • Saisissez le chemin d’accès à la ressource d’informations d’identification Orchestrator dans lequel vous stockez les informations d’identification des applications externes pour accéder au projet. Le format du chemin doit être le suivant : <OrchestratorFolderName>/<AssetName>.

   4. Configure the Runtime Tenant Url property.

      Use this field together with the Runtime Credentials Asset property. Enter the URL of the tenant to which the robot will connect to execute the extraction. The URL must have the following format: https://<baseURL>/<OrganizationName>/<TenantName>.

L’application externe permet d’accéder à tous les projets Document Understanding au sein du locataire. Il est inutile de configurer individuellement l’accès à chaque projet.

Configuration des versions de modèles en tant que paramètres

Si vous configurez les versions de projet sous forme de paramètres, vous pouvez mettre à jour les workflows d’automatisation pour les nouvelles versions sans ajuster le code du workflow.

1. Accédez à votre espace locataire Automation Cloud.

2. Accédez à Orchestrator.

3. Choisissez le dossier de votre automatisation.

4. Go to the Assets tab.

5. Select Add asset and choose Create a new asset from the drop-down list.

6. Type in a name in the Asset name field.

7. Select Text from the Type drop-down list.

8. Type in a name in the Text field to define a version-specific asset.

   

9. Sélectionnez Créer.

   Cela vous permet de mettre à jour les workflows d’automatisation des versions de projets sans modifier le code du workflow. Lorsque l’automatisation est déployée dans un dossier spécifié, la version du modèle est définie en fonction de la ressource dans Orchestrator. Ce processus est semblable à l’enregistrement des informations d’identification d’applications externes en tant que ressources.

10. Accédez à votre projet Studio.

11. Add a Get Asset activity in your workflow to retrieve the version asset.

12. Pass the retrieved value as an input variable to the Document Understanding Project activities.

    

Modèle de processus Document Understanding

Document Understanding Process is a fully functional UiPath® Studio project template based on a document processing flowchart. You can use it to get started with working on either a demo, or a large-scale implementation of Document Understanding^TM.

Le processus fournit la journalisation, la gestion des exceptions, les mécanismes de nouvelle tentative et toutes les méthodes qui doivent être utilisées dans un workflow Document Understanding prêt à l'emploi.

For more information, check the Document Understanding Process template page.