Contrôle de validation

Le Contrôle de validation est un composant d'Apps dans Studio Web qui intègre la Station de validation de Document Understanding dans vos applications. Cela vous permet de réviser, de corriger ou d’approuver des données qui ont été automatiquement extraites de documents, tels que des factures, des formulaires ou des e-mails. Les scénarios courants incluent les automatisations avec un humain dans la boucle, surtout lorsque l’extraction de données est incertaine ou incomplète. Par exemple, si une facture est numérisée et que le montant total semble incertain, le contrôle de validation permet à un humain de la vérifier et de la corriger avant sa soumission.

Le contrôle de validation vous permet de réviser manuellement les documents directement dans votre application web, surtout dans les cas suivants :

• les données sont manquantes ou peu claires
• les niveaux de confiance sont faibles
• un conseil humain est requis pour valider les règles métier

Scénarios utilisateur

Voici quelques exemples de scénarios d’utilisation du contrôle de validation :

• Approuver les factures dont les totaux sont incertains
• Examen des déclarations de sinistres grâce à des données partiellement extraites
• Confirmer les noms et adresses lorsque le document est de faible qualité

Capabilities

L'intégration du contrôle de validation dans votre application vous permet :

• Affichez le document complet directement dans l’interface de l’application.
• Consultez les données extraites, telles que les noms, les montants, les dates.
• Modifier, confirmer ou supprimer des données.
• Déclenchez des règles métier ou des workflows en fonction des entrées utilisateur.
• Validez plusieurs types de documents, valeurs de table et structures de champs complexes.
• Échange de données sécurisé via Automation Cloud, à l'aide de compartiments de stockage pour stocker et récupérer tout le contenu de validation des documents.

Mode de fonctionnement

Le workflow principal est le suivant :

1, 2, 3, 4 : vous chargez un document à des fins d’extraction. Le robot va traiter votre document à l’aide de Document Understanding ou de Communications Mining.

5 : le robot utilise les activités Créer des artefacts de validation de document ou Créer un artefact de communication Mining pour créer un objet de sortie de la classe ContentValidationData . Cet objet comprend les résultats extraits, le document d’origine et les informations complémentaires.

L'activité crée et stocke ensuite toutes les données intermédiaires dont le contrôle de validation a besoin pour afficher le document et ses détails d'extraction. Ces données sont enregistrées dans un compartiment de stockage Orchestrator et vous pouvez y accéder à l'aide de l'objet ContentValidationData .

6 : le robot qui a extrait vos données déclenche une application d'action qui inclut le contrôle de validation. Cette application vous est présentée comme une tâche d’Action Center.

Remarque : si vous créez une application autonome, au lieu d'ajouter les étapes 6 (Créer la tâche d'application) et 7 (Attendre la tâche de l'application et reprendre), vous pouvez affecter l'objet ContentValidationData à la variable ContentValidationData . Vous pouvez utiliser cette variable comme source de données du contrôle de validation.

7: En tant qu'utilisateur, vous recevez une tâche dans Action Center. Vous ouvrez l'application Web et voyez le document d'un côté et les données extraites de l'autre. Vous pouvez ensuite corriger les valeurs, confirmer les données ou rejeter les entrées incorrectes.

8, 9, 10 : une fois que vous avez envoyé les données validées, le robot utilise les activités Récupérer les artefacts de validation de document ou Récupérer les artefacts de validation de Communications Mining pour récupérer les informations mises à jour, puis reprend l’automatisation. Cela garantit que le workflow utilise uniquement les données examinées et approuvées.

Limitations

Lorsque vous utilisez le contrôle de validation dans votre application, gardez à l'esprit les limitations suivantes :

• Vous ne pouvez l'utiliser que dans Automation Cloud. Les environnements sur site ou hybrides ne sont pas pris en charge.
• Le contrôle de validation fonctionne uniquement dans les projets d’application Studio Web. Vous ne pouvez pas l’utiliser dans Apps VB.
• Vous pouvez l’utiliser uniquement pour les tâches de validation de document. Il ne prend pas en charge la classification des documents pour le moment.

L'objet ContentValidationData

L'objet ContentValidationData représente les données requises pour que le contrôle de validation charge et restitue un document et ses détails d'extraction. Il sert de source de données pour la commande.

Cet objet est créé et stocké dans un compartiment de stockage Orchestrator par les activités Créer des artefacts de validation de document ou Créer des artefacts de validation Communications Mining . Lorsqu’une tâche est terminée, vous pouvez utiliser l’objet ContentValidationData comme entrée des activités Récupérer les artefacts de validation de document ou Récupérer les artefacts de validation Communications Mining pour récupérer les informations validées.

La structure JSON DonnéesValidationContenu

Vous pouvez accéder à l'objet ContentValidationData au format JSON à partir des journaux de workflow, après avoir activé les activités de journal. Ce fichier JSON indique au contrôle de validation exactement où trouver tous les fichiers dont il a besoin dans le compartiment de stockage, afin d’afficher le document et ses données extraites. Voici un exemple d'objet sérialisé ContentValidationData au format JSON :

{
"BucketName":"DUValidationStationTestSb",
"BucketId":186140,
"FolderId":756377,
"FolderKey":"c2751834-1f05-4f4e-9cb8-509406f6faac",
"DocumentId":"4e32cef6-d4ee-4eac-a382-e80a2640de8a",
"DocumentPath":"v1\\4e32cef6-d4ee-
4eac-a382-e80a2640de8a\\CMS 1500.zip",
"EncodedDocumentPath":"v1\\4e32cef6-d4ee-4eac-a382-
e80a2640de8a\\encoded.zip",
"TextPath":"v1\\4e32cef6-d4ee-4eac-a382-
e80a2640de8a\\text.zip",
"DocumentObjectModelPath":"v1\\4e32cef6-d4ee-4eac-a382-
e80a2640de8a\\dom.zip",
"TaxonomyPath":"v1\\4e32cef6-d4ee-4eac-a382-
e80a2640de8a\\taxonomy.zip",
"AutomaticExtractionResultsPath":"v1\\4e32cef6-d4ee-4eac-a382-
e80a2640de8a\\input_results.zip",
"ValidatedExtractionResultsPath":"v1\\4e32cef6-d4ee-4eac-a382-
e80a2640de8a\\output_results.zip",
"ExtractorPayloadsPath":"v1\\4e32cef6-d4ee-4eac-a382-
e80a2640de8a\\extractor_payloads.zip",
"ShowOnlyRelevantPageRange":false,
"AdditionalDataPath":"",
"OriginalDocumentFileName":"CMS 1500.pdf",
"CustomizationInfoPath":"v1\\4e32cef6-d4ee-4eac-a382-
e80a2640de8a\\customization_info.zip"
}

Où :

• BucketName et BucketId : ces propriétés indiquent le compartiment de stockage dans lequel tous les fichiers liés à la validation du document sont stockés.
• FolderId et FolderKey : ces propriétés indiquent un dossier spécifique dans le compartiment de stockage où se trouve le document et ses fichiers associés.
• DocumentId : un identifiant unique pour le document spécifique en cours de validation.
• DocumentPath : le chemin d’accès complet au fichier du document d’origine dans le compartiment de stockage.
• EncodedDocumentPath, TextPath, DocumentObjectModelPath, TaxonomyPath : il s'agit de chemins d'accès à divers fichiers intermédiaires également stockés dans le compartiment. Ces fichiers sont essentiels pour que le contrôle de validation restitue correctement le document. Ils comprennent des données telles que les informations sur la mise en page du document (DocumentObjectModelPath) et le texte complet (TextPath).
• AutomaticExtractionResultsPath : le chemin d'accès au fichier contenant les données extraites automatiquement par le robot.
• ValidatedExtractionResultsPath—C'est ici que les données finales validées sont enregistrées une fois la validation terminée.
• OriginalDocumentFileName : le nom du fichier d’origine.

Utilisation de DonnéesValidationContenus comme source de données

Si vous utilisez l'activité Créer des artefacts de validation de document , vous pouvez affecter l'objet ContentValidationData obtenu directement au contrôle de validation en tant que source de données. Pour ce faire, vous devez :

1. Ajoutez une application Action à votre projet.
2. Pour les Propriétés d'entrée de l' ActionSchema, sélectionnez + Ajouter une propriété.
3. Recherchez l'objet ContentValidationData , sélectionnez-le et nommez-le. Par exemple, « cvd ».

4. Définissez le champ Source de données du Contrôle de validation sur la propriété d'entrée de l'action (cvd). Cela définit ActionProperties.cvd comme source de données de votre contrôle de validation.

   

   

Cependant, lorsque vous créez manuellement un objet JSON, vous ne pouvez pas l'utiliser directement avec le contrôle de validation. Vous devez d’abord le convertir en expression Visual Basic (VB) avec un ensemble simplifié de propriétés, telles que BucketId, FolderKey, DocumentId.

Par exemple :

New UiPath.DocumentProcessing.Contracts.Actions.ContentValidationData With { 
.BucketId = 186140, 
.FolderKey =
new Guid("c2751834-1f05-4f4e-9cb8-509406f6faac"), 
.DocumentId = "4e32cef6-d4ee-4eac-a382-e80a2640de8a",
.DocumentObjectModelPath = "v1/4e32cef6-d4ee-4eac-a382-e80a2640de8a/dom.zip", 
.TaxonomyPath = "v1/4e32cef6-
d4ee-4eac-a382-e80a2640de8a/taxonomy.zip", 
.TextPath = "v1/4e32cef6-d4ee-4eac-a382-e80a2640de8a/text.zip",
.EncodedDocumentPath = "v1/4e32cef6-d4ee-4eac-a382-e80a2640de8a/encoded.zip", 
.AutomaticExtractionResultsPath
= "v1/4e32cef6-d4ee-4eac-a382-e80a2640de8a/input_results.zip",
.CustomizationInfoPath = "v1/4e32cef6-d4ee-4eac-a382-e80a2640de8a/customization_info.zip"
}

Remarque : vous pouvez utiliser cette approche comme moyen avancé pour dépanner votre application sans créer de tâche Action Center.