Consommer des modèles provenant de différents environnements

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

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.

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 en local.

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. Accédez à la page Administration et sélectionnez votre organisation.
3. Accédez à la page Applications externes.
   
   

   

   
   
4. Sélectionnez Ajouter une application sur la page Applications externes.
   Conseil : pour plus d’informations sur l’ajout d’une application externe, consultez la page Gestion des applications OAuth externes du Guide d’administration d’Automation Cloud.
5. Saisissez un nom unique pour l’application dans le champ Nom de l’application.
6. Sélectionnez un type d’application dans la section Type d’application :
   • Application confidentielle : adaptée pour stocker le secret de l’application de manière sécurisée. Utilisez cette fonction pour les besoins de haute sécurité.
   • Application non confidentielle : utilisez cette option uniquement lorsque le stockage sécurisé du secret de l’application n’est pas nécessaire.
   
   

   

   
   
7. Définissez les étendues d’accès de votre application externe.
   1. Sélectionnez Ajouter des étendues dans la section Ressources.
   2. Sélectionnez Document Understanding dans la liste déroulante ressources.
   3. Configurer les Étendue(s) utilisateur pour accorder des autorisations dans le contexte d’un utilisateur.

      Cochez les cases correspondant aux autorisations d’API logiques que vous souhaitez accorder en fonction de vos besoins dans l’onglet Étendue(s) utilisateur. L’octroi d’autorisations dans l’étendue utilisateur implique que l’application externe peut accéder à ces ressources dans le contexte d’un utilisateur. Par conséquent, un utilisateur disposant des autorisations correspondantes doit être connecté.

   4. Configurer les Étendue(s) d’application pour fournir un accès au niveau de l’application afin de répondre à des besoins d’automatisation plus étendus.

      Si vous utilisez une application confidentielle, accédez à l’onglet Étendue(s) d’application pour allouer les autorisations au niveau de l’application à la ressource choisie, selon les besoins. En déléguant des autorisations sous l’étendue de l’application, l’application externe peut accéder aux données dans les domaines sélectionnés 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 utilisateur, ajoutez une URL de redirection. Cette URL recevra la réponse d’autorisation. Toutefois, si vous avez sélectionné uniquement les é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 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 :

• Utilisez une version compatible du projet Windows.
• Vérifiez 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 6.22.1.

Astuce :

Pour comprendre plus précisément les différences entre les packages DocumentUnderstanding.Activities et IntelligentOCR.Activities et savoir quand utiliser 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 les types de documents et les champs pertinents de votre automatisation.

      La taxonomie de votre projet doit inclure 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 Document Understanding. Si vous souhaitez utiliser des extracteurs supplémentaires comme l’Extracteur de formulaire ou l’Extracteur de RegEx, cette étape sera nécessaire.

      
      

      

      
      
3. Installez le package IntelligentOCR.Activities pour utiliser des activités telles que l’Extracteur de projet Document Understanding et le Classifieur de projet Document Understanding.
   1. Ajoutez l’activité Étendue d’extraction des données pour configurer les modèles d’extraction, et incluez l’activité Extracteur de projet Document Understanding.
      
      

      

      
      
   2. Ajoutez l’activité Classifier l’étendue du document pour configurer les modèles de classification, et incluez l’activité Classifieur de projet Document Understanding.
4. Configurez les identifiants de conception.
   1. Ouvrez l’assistant Obtenir des capacités à partir de l’étendue de l’activité.
      L’assistant s’affiche lorsque vous incluez les activités du projet Document Understanding dans cette étendue. Cet assistant vous permet de configurer les identifiants nécessaires à la conception pour mapper les champs de taxonomie d’un projet moderne.
   2. Renseignez les informations suivantes :
      • ID de l’application et Secret de l’application de l’application externe.
      • URL du locataire de l’environnement cible.
   3. Sélectionnez Obtenir des projets et choisissez le projet et la version dont vous avez besoin.
   4. Fermez l’assistant.
   
   

   

   
   
5. Mapper la taxonomie.
   1. Sélectionnez Configurer des extracteurs dans l’activité Étendue d’extraction des données.
   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. Accédez à l’onglet Ressources.
   5. Sélectionnez Ajouter une ressource, puis Créer une nouvelle ressource dans la liste déroulante.
   6. Saisissez un nom dans le champ Nom de la ressource.
   7. Sélectionnez Informations d’identification dans la liste déroulante Type.
   8. Utilisez l’ID d’application et le secret d’application créés précédemment comme Nom d’utilisateur et Mot de passe.
   
   

   

   
   
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. Configurer la propriété Ressource d’informations d’identification runtime.
      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. Configurer la propriété URL locataire runtime.
      Utilisez ce champ avec la propriété Ressource d’informations d’identification runtime. Saisissez l’URL du locataire auquel le robot se connectera pour exécuter l’extraction. L’URL doit se présenter au format suivant : 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. Accédez à l’onglet Ressources.
5. Sélectionnez Ajouter une ressource, puis Créer une nouvelle ressource dans la liste déroulante.
6. Saisissez un nom dans le champ Nom de la ressource.
7. Sélectionnez Texte dans la liste déroulante Type.
8. Saisissez un nom dans le champ Texte pour définir une ressource spécifique à une version.
   
   

   

   
   
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. Ajoutez une activité Obtenir une ressource à votre workflow pour récupérer la ressource de version.
12. Transmettez la valeur récupérée en tant que variable d’entrée aux activités 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 Modèle de processus Document Understanding.