Utilisation de modèles d'environnements différents

Lorsque vous utilisez les projets modernes Document Understanding^TM , vous devez configurer une application externe pour accéder aux modèles de différents locataires et de différentes organisations.

Cette procédure offre un aperçu complet de la façon d'accéder aux modèles déployés dans différents environnements à l'aide d'applications externes. Il comprend des instructions étape par étape 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 de workflows de production.

Cette fonctionnalité vous permet également d'utiliser des modèles dans des environnements de déploiement hybrides. Dans ce cas, les projets Document Understanding sont configurés sur Automation Cloud^TM, tandis qu’Orchestrator et les Robots sont déployés localement.

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

Configurer une application externe

1. Accédez à votre locataire Automation Cloud.
2. Accédez à la page Administration et sélectionnez votre organisation.
3. Accédez à la page Applications externes (External applications ).
   
   

   

   
   
4. Sélectionnez Ajouter une application (Add Application) sur la page Applications externes (External applications) .
   Astuce : pour plus d’informations sur l’ajout d’une application externe, consultez la page Gestion des applications externes OAuth du guide d’administration d’Automation Cloud pour le secteur public .
5. Saisissez un nom unique pour l'application dans le champ Nom de l'application (Application Name) .
6. Sélectionnez un type d'application dans la section Type d'application (Application type) :
   • Application confidentielle : adaptée pour stocker la clé secrète de l’application en toute sécurité. Utilisez-le pour les exigences de haute sécurité.
   • Application non confidentielle (Non-Confidential application) : utilisez cette option uniquement lorsque le stockage sécurisé de la clé secrète de l’application n’est pas requis.
   
   

   

   
   
7. Définissez les étendues d'accès pour votre application externe.
   1. Sélectionnez Ajouter des étendues (Add Scopes) dans la section Ressources (Resources ).
   2. Sélectionnez Document Understanding dans la liste déroulante Ressource .
   3. Configurez la ou les étendues des utilisateurs pour accorder des autorisations dans un contexte utilisateur.

      Cochez les cases correspondant aux autorisations d'API logiques que vous souhaitez accorder selon vos besoins dans l'onglet Étendue (s) des utilisateurs (User scope(s)) . Si vous accordez des autorisations sous l'étendue de l'utilisateur, il est implicite que l'application externe peut accéder à ces ressources dans un contexte utilisateur. Par conséquent, un utilisateur disposant des autorisations correspondantes doit être connecté.

   4. Configurez la ou les étendues d'application pour fournir un accès au niveau de l'application pour des besoins d'automatisation plus larges.

      Si vous utilisez une application confidentielle, accédez à l'onglet Étendue(s) de l' application (Application scope(s)) pour attribuer à la ressource choisie les autorisations au niveau de l'application. En déléguant des autorisations sous l'étendue de l'application, l'application externe peut accéder aux données des étendues sélectionnées sans aucune interaction de l'utilisateur.

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

      
      

      

      
      
   5. Sélectionnez Enregistrer (Save).
      Remarque : Si vous avez enregistré l'application externe avec des étendues d'utilisateurs, ajoutez une URL de redirection (Redirect URL). Cette URL recevra la réponse d’autorisation. Toutefois, si vous avez sélectionné uniquement des étendues d’application, fournir une URL de redirection est facultatif.
8. Sélectionnez Ajouter (Add) pour créer l'enregistrement.

   Un message de confirmation s’affiche. Pour les applications confidentielles, ce message inclut la clé secrète de l’application. L'application externe enregistrée peut utiliser cette clé secrète pour demander une autorisation. Assurez-vous d’enregistrer la clé secrète de l’application dans un emplacement sécurisé, car vous ne pourrez plus la consulter.

   
   

   

   
   

Configurer le workflow UiPath Studio

Avant de commencer, assurez-vous que les conditions préalables suivantes sont remplies :

• Utilisez une version de projet Windows compatible.
• Assurez-vous que le package d’activités IntelligentOCR est installé. Le package IntelligentOCR.Activities prend en charge l’utilisation des projets modernes Document Understanding à partir de la version v6.22.1.

Astuce :

Pour une présentation plus détaillée des différences entre les packages DocumentUnderstanding.Activities et IntelligentOCR.Activities , ainsi que des conseils sur l'utilisation de chacun d'eux, consultez la page Automatisations dans Document Understanding .

1. Ouvrez votre projet UiPath Studio .
2. Définir la taxonomie.
   1. Ouvrez Taxonomy Manager pour définir des types de documents et des champs pertinents pour votre automatisation.

      La taxonomie de votre projet doit englober chaque type de document et les champs nécessaires. La taxonomie que vous créez dans Studio peut contenir des types de documents et des champs supplémentaires qui ne font pas partie des projets modernes de Document Understanding. Si vous souhaitez utiliser des extracteurs supplémentaires tels que l' extracteur de formulaires ou l' extracteur de RegEx pour différents types de documents, cette étape sera nécessaire.

      
      

      

      
      
3. Installez le package IntelligentOCR.Activities pour utiliser des activités telles que l' Extracteur de projet Document Understanding (Document Understanding Project Extractor) et le Classificateur de projet Document Understanding (Document Understanding Project Classifier).
   1. Ajoutez l’activité Étendue de l’extraction de données (Data Extraction Scope) pour configurer les modèles d’extraction et incluez l’activité Extracteur de projet Document Understanding (Document Understanding Project Extractor).
      
      

      

      
      
   2. Ajoutez l'activité Classer la portée du document (Classify Document Scope) pour configurer des modèles de classification et incluez l'activité Classifieur de projet Document Understanding (Document Understanding Project Classifier).
4. Configurez les informations d'identification pour la phase de conception.
   1. Ouvrez l'assistant Obtenir des capacités (Get Capabilities) à partir de l'étendue de l'activité.
      L'assistant s'affiche lorsque vous incluez les activités de projet Document Understanding dans cette étendue. Cet assistant vous permet de configurer les informations d'identification en phase de conception nécessaires pour mapper les champs de taxonomie d'un projet moderne.
   2. Remplissez les informations suivantes :
      • ID et clé secrète de l'application de l'application externe.
      • URL du locataire pour l'environnement cible.
   3. Sélectionnez Obtenir les projets (Get Projects) et choisissez le projet et la version requis.
   4. Fermez l'assistant.
   
   

   

   
   
5. Cartographiez la taxonomie.
   1. Sélectionnez Configurer les extracteurs (Configure Extractors) dans l'activité Étendue de l'extraction des données (Data Extraction Scope) .
   2. Créez un mappage de la taxonomie du projet à 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 sur un champ correspondant dans le modèle conçu pour le projet Document Understanding.
   
   

   

   
   
6. Enregistrez les informations d’identification de runtime en tant que ressource Orchestrator.
   1. Accédez à votre locataire Automation Cloud.
   2. Accéder à Orchestrator
   3. Choisissez votre dossier d’automatisation.
   4. Accédez à l'onglet Ressources (Assets) .
   5. Sélectionnez Ajouter une ressource (Add asset) et choisissez Créer une nouvelle ressource (Create a new asset) dans la liste déroulante.
   6. Saisissez un nom dans le champ Nom de l'actif (Asset name) .
   7. Sélectionnez Informations d’identification dans la liste déroulante Type .
   8. Utilisez l' ID d'application et la clé secrète de l'application précédemment créés comme nom d'utilisateur et mot de passe.
   
   

   

   
   
7. Configurez les informations d’identification pour le runtime dans Studio.
   1. Accédez à votre projet Studio.
   2. Accédez à l'activité Étendue de l'extraction de données (Data Extraction Scope).
   3. Configurez la propriété Ressources d'informations d'identification de runtime .
      Utilisez ce champ pour accéder aux ressources de projet moderne Document Understanding lorsque le Robot est connecté à un Orchestrator local ou à partir d’un locataire différent. Vous pouvez choisir de saisir une ressource d'informations d’identification, à des fins d'authentification, de l’une des manières suivantes :

      • Sélectionnez la ressource d'informations d'identification souhaitée dans l'Orchestrator auquel le robot est connecté dans la liste déroulante.
      • Entrez le chemin d'accès à la ressource d'informations d'identification Orchestrator où vous stockez les informations d'identification de l'application externe pour accéder au projet. Le format de chemin doit être le suivant : <OrchestratorFolderName>/<AssetName>.
   4. Configurez la propriété URL du locataire du runtime .
      Utilisez ce champ avec la propriété Runtime Credentials Asset . Saisissez l'URL du locataire auquel le robot se connectera pour exécuter l'extraction. Le URL doit avoir le format suivant : https://<baseURL>/<OrganizationName>/<TenantName>.

L’application externe permet d’accéder à tous les projets Document Understanding du locataire. Vous n'avez pas besoin de configurer l'accès pour chaque projet individuellement.

Configurer les versions du modèle en tant que paramètres

Si vous configurez des versions de projet en tant que paramètres, vous pouvez mettre à jour les workflows d'automatisation pour les nouvelles versions de projet sans ajuster le code de workflow.

1. Accédez à votre locataire Automation Cloud.
2. Accéder à Orchestrator
3. Choisissez votre dossier d’automatisation.
4. Accédez à l'onglet Ressources (Assets) .
5. Sélectionnez Ajouter une ressource (Add asset) et choisissez Créer une nouvelle ressource (Create a new asset) dans la liste déroulante.
6. Saisissez un nom dans le champ Nom de l'actif (Asset name) .
7. Sélectionnez Texte dans la liste déroulante Type .
8. Saisissez un nom dans le champ Texte (Text) pour définir une ressource spécifique à la version.
   
   

   

   
   
9. Sélectionnez Créer.
   Cela vous permet de mettre à jour les workflows d'automatisation pour les nouvelles versions de projet sans changer le code de 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 similaire à l'enregistrement des informations d'identification d'application externe en tant que ressources.
10. Accédez à votre projet Studio.
11. Ajoutez une activité Obtenir la ressource (Get Asset) dans votre workflow pour récupérer la ressource de version.
12. Transmettez la valeur récupérée comme variable d'entrée aux activités de projet Document Understanding .
    
    

    

    
    

Modèle de processus Document Understanding

Le Processus Document Understanding est un modèle de projet UiPath® Studio entièrement fonctionnel basé sur un organigramme de traitement de documents. Vous pouvez l’utiliser pour commencer à travailler sur une démonstration ou sur une implémentation à grande échelle de 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.

Pour plus d'informations, consultez la page du modèle de processus Document Understanding .