Valider des documents avec des actions App

Ce guide de démarrage rapide vous aide à commencer à valider les documents en ajoutant la station de validation dans les applications UiPath® Action, puis en les envoyant pour validation via Action Center en tant qu’actions d’application. Le tutoriel utilise UiPath Studio pour automatiser le traitement du 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 déclaration 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 la section Exécuter des automatisations non assistées 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 > Application pour créer un nouveau projet.
3. Dans l' explorateur de projet de votre application, sélectionnez Ajouter des pages, des workflows, des contrôles, des intégrations > Action. Cette étape ajoute une action à votre application et vous permet de configurer un schéma d'actions pour celle-ci.
4. Développez Action, puis sélectionnez SchémaAction. Configurez le schéma d'action avec les arguments d'entrée et de sortie souhaités pour les actions App dans Action Center.
   1. Dans le champ Résultats, ajoutez d'autres résultats personnalisés que vous souhaitez voir l'action. Par exemple, vous pouvez ajouter un résultat personnalisé nommé « Approuver ».
   2. Pour Propriétés d'entrée, ajoutez des propriétés pour les données que vous souhaitez transmettre à l'action. Ces propriétés apparaîtront dans l’activité Créer une tâche d'application lorsque cette application sera sélectionnée dans la liste déroulante Apps. Les propriétés d'entrée vous permettent de transmettre des données de votre automatisation Studio à votre action.
   3. Pour Propriétés de sortie, ajoutez des propriétés pour les arguments que vous souhaitez récupérer à partir de l'action. Ces propriétés seront accessibles à partir de l'activité Attendre la tâche d'application et reprendre , via la variable Objet de tâche (Sortie) .
   4. Pour les propriétés Input/Output , ajoutez des propriétés qui fonctionnent comme des 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 , 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 à partir de l’activité Attendre l’application de tâche et reprendre , via la propriété Objet de tâche (Sortie) .

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 Afficher, recherchez la commande de validation et ajoutez-la à 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 de l' explorateur de projets 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émaActions.

   2. Dans 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.

   4. Sous Avancé, sélectionnez DonnéesValidationContenu.

      Il s'agit de la propriété d'entrée qui s'affichera dans l'activité Créer une tâche d'application . La propriété d’entrée ContentValidationData requiert un objet ContentValidationData comme entrée, qui peut être un objet unique ou un tableau/liste de ContentValidationData instances. 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 .

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 comme 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 dans la section Modifier les données du contrôle de validation 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.

Table 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.
ExtractionResult	UiPath.DocumentProcessing.Contracts.Results.ExtractionResult	Les résultats d'extraction, tels que (avec ou sans modifications humaines), du contrôle de validation.
SelectedDocumentType	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 une commande dans votre application et accédez à Événements.
2. Sélectionnez Définir l'automatisation. Cette action ouvre le panneau concepteur de Studio Web, où 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 dans l'automatisation.

   1. Pour le champ À 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 À , 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. Les propriétés des valeurs que vous pouvez mettre à jour dans le contrôle de validation incluent les éléments suivants :

   • 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 de l'exécution. La seule différence est que vous utilisez une variable différente, dans le champ À la 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 via lesquelles vous pouvez mettre à jour les données du 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 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 du 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 de contrôle de validation: permet de vous concentrer sur un champ, en fonction d’un événement configuré.
2. Enregistrer l’état du contrôle de validation: 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 MainPage.ValidationControl.ExtractionResult
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 .
Lire les données de taxonomie	Utilisez les méthodes exposées par la classe Taxonomie .
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é des automatisations pour les contrôles, vous pouvez la publier. La publication de l'application la rend disponible pour être utilisée pour créer des actions d'application. Pour de plus amples informations sur la publication d'applications, consultez la section Publier, déployer et mettre à jour des projets d'applications.

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 de traitement du document. Les données nécessaires 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 avez souscrit au régime Flex, vous avez besoin d'AI Units. Pour de plus amples informations sur les fonctionnalités génératives de Document Understanding, consultez la section 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 (Taxe) : Récupéré via l'activité Charger la taxonomie .
• Dom (Modèle d'objet document) et text (Texte du document) : Obtenus via l'activité Numériser le 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 d'extraction de données , 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 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 précédemment créées ou générées :
   • Chemin du dossier du compartiment: le nom du dossier Orchestrator dans lequel le compartiment de stockage a été créé.
   • Nom du compartiment: storageBucketName
   • Chemin d'accès au compartiment: le chemin d'accès au répertoire dans le compartiment de stockage précédemment saisi, où vous souhaitez stocker les 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 pour 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
   • Apps: 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.

       Image 2. L’activité Créer une tâche d’application

       

3. Ajoutez une activité Attendre l’application de tâche et reprendre pour renvoyer les informations sur l’action et reprendre le workflow. Dans le champ Tâche d'application créée , saisissez la variable de sortie de l'activité Créer une tâche d'application .
4. Ajoutez une activité Récupérer les artefacts de validation de document 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 comme entrée de l’activité Récupérer les artefacts de validation de document .
   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 AutomaticExtractionResults et ValidatedExtractionResults.

3. Effectuer la validation dans Action Center

1. Ouvrez Action Center et accédez à Mes actions ou Gérer les actions.
2. Dans l'onglet Non affecté , recherchez l'action que vous venez de créer à l'aide de la précédente automatisation de Studio.
3. Si vous souhaitez vous attribuer l'action, sélectionnez l'action souhaitée, puis sélectionnez Se l'affecter.
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 et sélectionnez un utilisateur dans la liste déroulante.
5. Accédez à l' onglet En attente et effectuez l'action afin que le workflow Studio puisse être repris.