Valider des documents avec des actions App

Ce guide de démarrage rapide vous aide à commencer à valider des documents en ajoutant la station de validation dans les applications UiPath® Action, puis à les envoyer pour validation via Action Center en tant qu’actions d’application. Le tutoriel utilise UiPath Studio pour automatiser le traitement de document, UiPath Apps pour afficher la station de validation et Action Center pour effectuer la validation. Le type de document utilisé dans les exemples tout au long de ce tutoriel est un formulaire d'assurance maladie, de type formulaire de demande CMS 1500.

Les étapes de vue d'ensemble de ce guide de démarrage rapide sont les suivantes :

1. Construisez l'application d'action qui affiche le contrôle de validation.
2. Utilisez une application précédemment configurée pour concevoir l'automatisation de Studio qui traite le document et l'envoie pour validation dans Action Center.
3. Terminez l’action dans Action Center.

Étapes

1. Créer une application Action

Prérequis

Assurez-vous que votre locataire :

• Possède suffisamment de Robot Units, puisque l'application s'exécute à l'aide de robots Serverless.
• Un modèle de robot sans serveur est créé dans Orchestrator et enregistré. Pour plus d'informations sur les robots sans serveur et leur ajout à un locataire, consultez Exécution d'automatisations unattended avec des robots sans serveur.

1. Créer une application Action

Remarque : contrairement aux applications VB disponibles via le service Apps, les applications sont accessibles via Studio Web.

Pour créer une application Action (Action), procédez comme suit :

1. Accédez à Studio Web.
2. Sélectionnez Créer nouveau (Create New) > Application (App) pour créer un nouveau projet.
3. Dans l' explorateur de projets (Project Explorer) de votre application, sélectionnez Ajouter des pages, des workflows, des contrôles, des intégrations (Add pages, workflows, controls, integrations) > Action (Action).

   Cette étape ajoute une action à votre application et vous permet de configurer un schéma d'action pour celle-ci.

4. Développez Action et sélectionnez SchémaAction.

   Configurez le schéma d'action avec les arguments d'entrée et de sortie souhaités pour les actions d'application dans Action Center.

   1. Pour Résultats (Outcomes), ajoutez d'autres résultats personnalisés pour votre action.

      Par exemple, vous pouvez ajouter un résultat personnalisé nommé « Approuver ».

   2. Pour les propriétés d'entrée, ajoutez des propriétés pour les données que vous souhaitez transmettre dans l'action.

      Ces propriétés apparaîtront dans l'activité Créer une tâche d'application (Create App Task) , lorsque cette application sera sélectionnée dans la liste déroulante Applications (Apps) . Les propriétés d'entrée vous permettent de transmettre des données de votre automatisation Studio à votre action.

   3. Pour les propriétés de sortie, ajoutez des propriétés pour les arguments que vous souhaitez récupérer de l'action.

      Ces propriétés seront accessibles à partir de l'activité Attendre la tâche d'application et reprendre (Wait for App Task and Resume) , via la variable Objet de tâche (sortie) .

   4. Pour les propriétés Entrée/Sortie (Input/Output) , ajoutez des propriétés qui fonctionnent comme arguments In/Out dans votre automatisation Studio.

      Ces propriétés d'entrée/de sortie apparaissent d'abord en tant que propriétés dans l'activité Créer une tâche d'application (Create App Task) , que vous transmettez à l'action. Ensuite, une fois l'action terminée, vous pouvez accéder aux mêmes propriétés qui ont été mises à jour depuis l'activité Attendre la tâche d'application et reprendre (Wait for App Task and Resume ) via la propriété Objet de tâche (sortie) (Task Object (Output)) .

2. Ajouter et personnaliser le contrôle de validation

Un contrôle de validation contient la station de validation utilisée dans les workflows de traitement de documents. Pour ajouter et personnaliser un contrôle de validation dans une application Action, suivez ces étapes :

1. Ouvrez l'application d'action souhaitée, où vous souhaitez intégrer la station de validation.
2. Sélectionnez Ouvrir la boîte à outils.
3. Sous Affichage (Display), recherchez le contrôle de validation (Validation Control) et ajoutez-le à votre application.
   L'ajout du contrôle de validation à votre application crée automatiquement une variable Var<ValidationControl_PageName> dans la section Variables d'application (App variables) de l' Explorateur de projets (Project Explorer) de votre application.
   Remarque : vous pouvez utiliser le contrôle de validation et la variable d'application correspondante pour lire les informations du contrôle de validation. Utilisez la variable d'application Var<ValidationControl_PageName> pour y écrire des informations.
4. Préparez le schéma d'action :
   1. Dans l' explorateur de projets, sous Action, sélectionnez SchémaAction.
   2. Dans les propriétés d’entrée, sélectionnez Ajouter une propriété.
   3. Dans la barre de recherche de propriétés, sélectionnez Plus d'options (More Options).
   4. Sous Avancé (Advanced), sélectionnez DonnéesValidationContenu (ContentValidationData).
      Il s'agit de la propriété d'entrée qui s'affichera dans l'activité Créer une tâche d'application (Create App Task) . La propriété d'entrée ContentValidationData nécessite un objet ContentValidationData en tant qu'entrée, qui peut être un objet unique ou un tableau/une liste d'instances ContentValidationData . ContentValidationData contient les artefacts de la station de validation. ContentValidationData est créé à l'aide de l'activité Créer des artefacts de validation de document (Create Document Validation Artifacts) .
5. Configurez le contrôle de validation (Validation Control) :
   1. Accédez aux propriétés du contrôle de validation.
   2. Dans l'entrée Source , sélectionnez l'entrée Action que vous avez définie en tant que type ContentValidationData .
6. Configurez le reste de l'application avec les autres contrôles dont vous avez besoin.

3. Accéder aux données de contrôle de validation et à ses propriétés

Diverses propriétés du contrôle de validation, telles que la taxonomie, le résultat de l'extraction, le type de document sélectionné, le champ sélectionné et la source de données, sont accessibles à l'aide de la variable de contrôle de validation (VarValidationControl_PageName). Vous pouvez modifier les valeurs affichées dans le contrôle de validation via la variable d'application correspondante. Suivez les étapes décrites sous Modifier les données du contrôle de validation (Edit Validation Control) pour ajouter, modifier ou supprimer une valeur de champ.

Le tableau suivant décrit les propriétés auxquelles vous pouvez accéder à partir du contrôle de validation, leur type de données et leur description.

Tableau 1. Propriétés du contrôle de validation

Propriété	Type de données	Description
Taxonomy	UiPath.DocumentProcessing.Contracts.Taxonomy.DocumentTaxonomy	L’objet de taxonomie avec lequel le contenu a été préparé pour l’affichage. Il contient des informations sur les types de documents, les champs et les propriétés d'affichage.
RésultatExtraction	UiPath.DocumentProcessing.Contracts.Results.ExtractionResult	Les résultats d'extraction, tels que (avec ou sans modifications humaines), du contrôle de validation.
TypeDocumentSélectionné	System.String	Le nom du type de document actuellement sélectionné dans le contrôle de validation.
SelectedField	UiPath.DocumentProcessing.Contracts.Apps.FieldValueDetails	Le champ actuellement sélectionné dans le contrôle de validation avec sa valeur.
DataSource	UiPath.DocumentProcessing.Contracts.Actions.ContentValidationData	Les données de validation de contenu qui sont actuellement la source du contrôle de validation.
Hidden	boolean	L'état de la propriété de commande déterminant si la commande est visible ou masquée.
Disabled	boolan	L’état de la propriété de commande déterminant si la commande est modifiable ou non.
IsValid	boolean	Vérifie la validité de la valeur du contrôle de validation. Si True, indique qu'il est valide.

4. Modifier les données de contrôle de validation

Vous pouvez modifier les valeurs affichées dans le contrôle de validation via la variable d'application correspondante. Par exemple, vous pouvez modifier les valeurs de résultat d'extraction affichées dans le contrôle de validation via la variable d'application correspondante.

L'exemple suivant montre comment mettre à jour une valeur de champ normal :

1. Sélectionnez n'importe quel contrôle dans votre application et accédez à Événements (Events).
2. Sélectionnez Définir l'automatisation (Define automation).

   Cette action ouvre le panneau du concepteur de Studio Web, dans lequel vous pouvez créer une automatisation de déclencheur pour un certain contrôle d'application.

3. Dans le contexte des résultats d'extraction du document, pour ajouter ou modifier une valeur de champ pour les champs réguliers, ajoutez une activité Définir la valeur de la variable (Set Variable Value) dans l'automatisation.
   1. Pour le champ À la variable (To Variable) , utilisez AppVariable.VarValidationControl_PageName.Field("<field name>").Value.
      Cette expression représente le champ que vous souhaitez modifier, accessible via la variable VarValidationControl_PageName .
   2. Dans le champ À (To ), saisissez la valeur souhaitée pour le champ référencé.
   Outre les champs réguliers, la variable AppVariable.VarValidationControl_PageName peut également manipuler les champs multi-valeurs à l'aide AppVariable.VarValidationControl_PageName.Field("<field name>", <index>) et interagir avec les cellules de table à l'aide AppVariable.VarValidationControl_PageName.Field("<table field name").Field("<column name>", <row index>).
   Pour supprimer des valeurs, sélectionnez la valeur cible de la même manière et utilisez l'indicateur .DeleteValue défini sur Vrai (True).

   Les propriétés des valeurs que vous pouvez mettre à jour dans le contrôle de validation incluent :

   • Valeur textuelle (.Value)
   • État confirmé (.Confirmed)
   • Niveau de confiance de la valeur (.Confidence)
   • Indicateur de suppression (.DeleteValue)
   • Indicateur pour supprimer une référence de valeur (.KeepReference)

Vous pouvez utiliser les mêmes étapes pour modifier d'autres données de contrôle de validation au moment du runtime. La seule différence est que vous utilisez une variable différente, dans le champ À la variable (To Variable) , afin qu'elle corresponde aux données de contrôle de validation que vous souhaitez modifier. Par exemple, vous pouvez utiliser la variable AppVariable.ValidationControl.SelectedDocumentType si vous souhaitez la mettre à jour avec une valeur différente.

Figure 1. Les activités Définir la valeur de la variable (Set Variable Value) via lesquelles vous pouvez mettre à jour les données depuis le contrôle de validation

5. Créer des événements pour le contrôle de validation

Vous pouvez déclencher divers événements spécifiques au contrôle de validation. Dans l' explorateur de projets, accédez au contrôle de validation et sélectionnez-le. Le panneau Événements (Events ) du contrôle de validation vous permet de définir des automatisations pour des événements spécifiques.

Le tableau suivant décrit les événements de contrôle de validation disponibles :

Tableau 2. Événements de contrôle de validation

Événement (Event)	Description
Sur prêt	Se déclenche lorsque le contrôle de validation est chargé.
Type de document modifié	Se déclenche lorsque l'utilisateur modifie le type de document à partir du contrôle de validation.
Champ sélectionné	Se déclenche lorsque l'utilisateur sélectionne l'un des champs, ou la valeur d'un champ, dans le contrôle de validation.
Valeur du champ modifiée	Se déclenche lorsque l'utilisateur ajoute, supprime ou remplace une valeur de champ dans le contrôle de validation.

6. Utiliser des activités de contrôle de validation dédiées

Vous pouvez utiliser des activités spécifiques dédiées à l'utilisation du contrôle de validation à partir du package AppEvents.Activities :

1. Définir l'accent sur le champ du contrôle de validation (Set Validation Control Field Focus) : vous permet de vous concentrer sur un champ, en fonction d'un événement configuré.
2. Enregistrer l'état du contrôle de validation (Save Validation Control State) : enregistre l'état du contrôle de validation. Vous pouvez l'utiliser lorsque vous souhaitez revoir et terminer la validation ultérieurement.

Expressions de contrôle de validation courantes

Lorsque vous créez votre application qui contient un contrôle de validation, vous pouvez utiliser les expressions suivantes pour accéder à diverses données exposées par le contrôle de validation. Le tableau suivant décrit les expressions les plus courantes que vous pouvez utiliser lorsque vous travaillez avec le contrôle de validation :

Tableau 3. Expressions de contrôle de validation courantes

Objectif	Expression
Accéder aux résultats d’extraction affichés dans le contrôle de validation	AppVariable.VarValidationControl_PageName.ExtractionResult RésultatPage.ValidationContrôle.ExtractionRésultat
Accéder à la taxonomie chargée dans le contrôle de validation	AppVariable.VarValidationControl_PageName.Taxonomy MainPage.ValidationControl.Taxonomy
Accéder au champ sélectionné dans le contrôle de validation	AppVariable.VarValidationControl_PageName.SelectedField MainPage.ValidationControl.SelectedField Les propriétés du champ sélectionné peuvent être : Field.FieldName – Nom du champ. Field.FieldType – Type de champ. Field.ValidatorNotes – Les notes du validateur de champ. Field.Values : Toutes les valeurs d'un champ sélectionné. Field.Value – Informations relatives à la valeur de champ : FieldValue.Value FieldValue.Confidence FieldValue.OperatorConfirmed FieldValue.FieldValueIndex (pour les champs à valeurs multiples, renvoie l’index auquel la valeur de champ sélectionnée appartient).
Accéder aux propriétés supplémentaires du contrôle de validation	MainPage.ValidationControl.<PropertyName>
Lire les données des résultats d'extraction	Utilisez les méthodes exposées par la classe Résultat d'extraction (Extraction Result).
Lire les données de taxonomie	Utilisez les méthodes exposées par la classe Taxonomy.
Accéder à une valeur de champ pour la mettre à jour dans le contrôle de validation	AppVariable.<ValidationControlVariable>.Field("<FieldName>").Value
Récupérer la liste des noms de champs affichés dans le contrôle de validation	AppVariable.<ValidationControlVariable>.ExtractionResult.GetFields().Select(Function(f) f.FieldName)

6. Publier et déployer l'application

Après avoir créé votre application Action et déclenché les automatisations pour les contrôles à l'intérieur, vous pouvez la publier. La publication de l’application la rend disponible pour la création d’actions d’application. Pour plus d’informations sur la publication d’applications, consultez la section Publication, déploiement et mise à niveau de projets d’application.

2. Créer l'automatisation de Studio

Prérequis

• Installez les versions de package d'activités suivantes :
  • IntelligentOCR.Activities version 6.24.0
  • Persistence.Activities version 1.5.5 ou supérieure.
  • AppEvents.Activities version 3.12.0 ou supérieure.
• Créez un compartiment de stockage dans Orchestrator, dans le même dossier où vous souhaitez publier l'automatisation du traitement de document.

  Les données requises pour charger le contrôle de validation dans les applications sont stockées dans un compartiment de stockage Orchestrator.

• Ajoutez le document que vous souhaitez traiter dans le dossier du projet Studio.
• Éventuellement, si vous souhaitez utiliser des capacités d'extraction ou de validation génératives, vous avez besoin d'unités de service spécifiques
  • Si vous êtes inscrit au plan Flex, vous avez besoin d'unités d'IA

  Pour plus d'informations sur les fonctionnalités génératives de Document Understanding, consultez Fonctionnalités génératives.

1. Traiter un fichier à l'aide de Document Understanding

Ajoutez des activités qui utilisent Document Understanding pour traiter un fichier. Préparez le document pour validation dans Action Center, via des applications, en utilisant la numérisation et l’extraction.

Après avoir ajouté les activités pour le traitement du fichier, les variables suivantes doivent être disponibles :

• DocumentTaxonomy (Taxonomy) : Récupéré via l'activité Charger la taxonomie (Load Taxonomy) .
• Dom (Modèle d'objet de document) et text (Texte de document) : acquis via l'activité Numériser le document (Digitize Document ).
• doc (Chemin d'accès au document) : représente le chemin d'accès au fichier traité.
• autoExtractionResults (ExtractionResults) : il s'agit de la sortie de l'activité Étendue de l'extraction de données (Data Extraction Scope) , quelles que soient les méthodes d'extraction utilisées.

2. Envoyer les informations de validation à l'application

Une fois le document prêt à être validé, vous pouvez préparer toutes les informations à envoyer à l'application créée et déployée précédemment. Suivez ces étapes :

1. Ajoutez une activité Créer des artefacts de validation de document (Create Document Validation Artifacts) pour créer l'objet Content Validation Data qui stocke les informations nécessaires au chargement du contrôle de validation dans l'application Action.
   Dans cet exemple, configurez l'activité à l'aide des variables créées ou générées précédemment :

   • Chemin d'accès au dossier du compartiment (Bucket Folder Path): le nom du dossier Orchestrator dans lequel le compartiment de stockage a été créé.
   • Nom du compartiment: storageBucketName
   • Chemin du répertoire du compartiment: le chemin du répertoire dans le compartiment de stockage précédemment saisi, où vous souhaitez stocker des données d'action.
   • CheminDocument: doc
   • Texte du document: text
   • Modèle d'objet document: dom
   • Taxonomie: taxonomy
   • Résultats de l'extraction automatique: autoExtractionResults
2. Ajoutez une activité Créer une tâche d'application (Create App Task ) afin de pouvoir lier l'objet Content Validation Data à l'application précédemment conçue, puis l'envoyer à Action Center pour validation.

   Dans cet exemple, configurez l'activité comme suit :

   • Titre: CVD
   • Priorité: Medium
   • Applications: Demo.Validation.Control.in.Apps
   • Version de l'application: v2.0.0

     Après avoir sélectionné l' application et la version correspondante que vous souhaitez utiliser pour créer l'action, les propriétés d'entrée de cette application s'afficheront dans le corps de l'activité.

     • Dans cet exemple, l'une des propriétés d'entrée est Action_Content_Validation_Data, qui nécessite les artefacts de validation de document précédemment créés : contentValidationData.
   Figure 2. L’activité Créer une tâche d’application (Create App Task)
   

   

   
   
3. Ajoutez une activité Attendre la tâche d’application et reprendre (Wait for App Task and Resume) pour renvoyer les informations sur l’action et reprendre le workflow.

   Dans le champ Tâche d'application créée (Created App Task) , saisissez la variable de sortie de l'activité Créer une tâche d'application (Create App Task) .

4. Ajoutez une activité Récupérer les artefacts de validation de document (Retrieve Document Validation Artifacts ) pour renvoyer les artefacts de validation de document après que l'utilisateur a effectué une validation dans Action Center.

   Passez la variable de sortie de l'activité Créer des artefacts de validation de document (Create Document Validation Artifacts) comme entrée de l'activité Récupérer les artefacts de validation de document (Retrieve Document Validation Artifacts) .

   Astuce : Vous pouvez également créer des variables de sortie dédiées pour les informations supplémentaires stockées dans les artefacts de validation, telles que Résultats de l'extraction automatique (AutomaticExtractionResults) et Résultats de l'extraction validée (ValidatedExtractionResults).

3. Effectuer la validation dans Action Center

1. Ouvrez Action Center et accédez à Mes actions (My Actions) ou Gérer les actions (Manage Actions).
2. Dans l'onglet Non affectée (Unassigned) , recherchez l'action que vous venez de créer à l'aide de la précédente automatisation Studio.
3. Si vous souhaitez vous attribuer l'action, sélectionnez l'action souhaitée, puis sélectionnez Attribuer à soi-même (Assign to self).
4. Si vous souhaitez affecter l'action à un autre utilisateur, sélectionnez Plus d’options pour l’action souhaitée. Sélectionnez ensuite Affecter à l'utilisateur (Assign to user) et sélectionnez un utilisateur dans la liste déroulante.
5. Accédez à l' onglet En attente (Pending) et terminez l'action, afin que le workflow Studio puisse être repris.