Activité Get Results

L’activité Get Results récupère les résultats de traitement d’ABBYY Vantage dans UiPath, notamment les données extraites, les scores de confiance de classification et les fichiers de résultats.

L’activité Get Results récupère le résultat d’une transaction lancée par l’activité Use Skill. Transmettez l’ID de transaction de Use Skill et l’activité renvoie un TransactionStatus ainsi que les résultats pour chaque document. Si la transaction est toujours en cours de traitement, appelez de nouveau l’activité après un court délai. Si une activité Review a suspendu la transaction, elle renvoie à la place un lien vers la relecture manuelle plutôt que les résultats finaux.

​

Propriétés de l’activité

Groupe	Propriété	Type	Description
Entrée	ID de transaction	Guid	Identifiant de la transaction. Transmettez à cette propriété la valeur obtenue dans la propriété de sortie Transaction Id de l’activité Use Skill.
Entrée	Supprimer la transaction	Boolean	Indique si la transaction terminée doit être supprimée, qu’elle ait réussi ou non. La valeur par défaut est FALSE, ce qui signifie que la transaction n’est pas supprimée.
Sortie	Résultats des documents	IEnumerable<DocumentResult>	Collection de documents de résultat après traitement.
Sortie	Lien de relecture	String	Lien vers le client de relecture manuelle ABBYY Vantage pour vérifier les résultats de la transaction. Disponible uniquement si la Compétence de processus contient une activité Review.
Sortie	Statut de la transaction	TransactionStatus	Statut de la transaction. Les statuts suivants sont possibles : "New", "Processing", "Review", "Processed". En fonction du statut reçu, vous pouvez configurer votre processus UiPath pour exécuter une logique différente. Par exemple, si la transaction a le statut "Processing", attendez quelques secondes, puis appelez de nouveau l’activité.

Lors de l’utilisation d’un Skill de classification, d’une Compétence de document ou d’une compétence OCR, tous les fichiers d’entrée de la transaction sont assemblés en un seul document. Lors de l’utilisation d’une Compétence de processus, plusieurs documents de résultat peuvent être obtenus.

Par défaut, dans une Compétence de processus, chaque fichier d’entrée devient un document distinct dans Vantage. Les documents peuvent appartenir à des classes différentes, mais ils sont traités dans la même transaction. Pour remplacer cet assemblage, configurez l’activité Assemble dans la Compétence de processus.

Chaque document produit ses propres résultats. La propriété de sortie Document Results renvoie une collection d’instances DocumentResult, une par document de la transaction.

​

DocumentResult

Nom	Type	Description
DocumentId	String	Identifiant du document.
ClassificationConfidences	IEnumerable<ClassificationConfidence>	Collection de valeurs de confiance de classification. Liste de toutes les classes disponibles dans le Skill de classification appliqué au document, avec leurs valeurs de confiance de classification.
ClassName	String	Classe du document basée sur les résultats de classification.
ExtractedData	String	Chaîne JSON contenant les données extraites. Remarque : pour une Compétence de processus, cette propriété peut être obtenue si l’option Values, metadata, and field structure for each document est activée dans l’activité Output.
IsClassificationConfident	Boolean	La classe résultante est considérée comme ayant été déterminée avec confiance si cette valeur est TRUE.
ResultFiles	IReadOnlyDictionary<String,Stream>	Collection de fichiers de résultat après traitement.
DocumentFullText	String	Calque de texte intégral d’un document reconnu par ABBYY Vantage. Remarque : si la configuration de la compétence ne contient pas de paramètre d’exportation du texte intégral, cette propriété contiendra la valeur par défaut suivante : TXT export was not configured in the ABBYY Vantage skill settings. Please enable TXT export in the skill that you have selected. L’export TXT est disponible uniquement pour les compétences OCR ou Processing.

Tous les paramètres répertoriés sont regroupés dans un DocumentResult distinct de la collection Document Results. Même s’il n’y a qu’un seul document de sortie, ses paramètres de sortie seront disponibles dans le premier DocumentResult de la collection Document Results.

​

ClassificationConfidence

Nom	Type	Description
ClassName	String	Classe de document Vantage.
Confidence	Int	Degré de confiance indiquant que le document appartient à cette classe. Les valeurs possibles vont de 0 à 100.

L’activité Get Results ne peut être utilisée qu’à l’intérieur d’une activité Vantage Scope configurée.

Le comportement de l’activité Get Results dépend de la valeur statut de la transaction renvoyée.

Statut de la transaction	Comportement
Processed	Le traitement s’est terminé avec succès. Les résultats sont enregistrés dans les propriétés de sortie.
New / Processing	La transaction est toujours en cours de traitement. Attendez quelques secondes, puis appelez de nouveau l’activité Get Results.
Review	La transaction a été mise en pause pour une relecture manuelle. L’activité Get Results renvoie un lien de relecture vers le client de relecture manuelle ; appelez de nouveau l’activité une fois la relecture terminée pour récupérer les résultats finaux. Pour plus de détails, consultez Compétence de processus.

​

Résultats par type de compétence

Les résultats que l’activité Get Results peut obtenir varient selon la compétence appliquée au document.

​

Skill de classification

Un Skill de classification (telle que Vantage Classifier) renvoie :

• Statut de la transaction
• Résultats des documents (pour chaque DocumentResult) : DocumentId, ClassificationConfidences, ClassName, IsClassificationConfident, ResultFiles (fichier JSON contenant les données des résultats de classification)

​

Compétence de document

Une Compétence de document (telle que Invoice US) renvoie :

• Statut de la transaction
• Résultats des documents (pour chaque DocumentResult) : DocumentId, ExtractedData, ResultFiles (les résultats sont contenus dans deux fichiers JSON : le premier contient toutes les données du document ; le second, se terminant par _fields.json, contient les valeurs des champs extraits et les erreurs de règle)

​

Compétence OCR

Une compétence OCR renvoie :

• Statut de la transaction
• Résultats des documents (pour chaque DocumentResult) : DocumentId, ResultFiles (les fichiers correspondent à l’export configuré dans la compétence OCR), DocumentFullText (si l’export au format TXT est activé dans la compétence)

​

Compétence de processus

Les résultats obtenus dépendent des activités qui composent la Compétence de processus et de leurs paramètres, en particulier des paramètres de l’activité Output. Pour plus d’informations sur la Compétence de processus, consultez Configurer une Compétence de processus.

Si une Compétence de processus comprend une activité Classify et une activité Extract, vous obtenez les résultats décrits précédemment à la fois pour un Skill de classification et une Compétence de document.

Si une Compétence de processus comprend plusieurs activités Classify ou Extract, les résultats sont obtenus pour les dernières activités d’un type donné.

Si l’option PDF est activée dans la boîte de dialogue Exported Data Settings d’une activité Output d’une Compétence de processus, les résultats contiennent le fichier JSON avec les résultats d’extraction. Ils contiennent également l’image du document exportée dans un fichier PDF avec une couche de texte. Pour chaque document de la transaction, le paramètre DocumentFullText est renvoyé si l’exportation au format TXT est activée dans la compétence.

Une Compétence de processus peut également contenir une activité Review. Lorsqu’une telle compétence est utilisée pour le traitement des documents, le traitement peut être suspendu si le document nécessite une relecture manuelle. Dans ce cas, l’activité Get Results obtient :

• statut de la transaction = "Review"
• Lien de relecture

Une fois la relecture manuelle et le traitement de la transaction terminés, vous pouvez obtenir les résultats décrits précédemment en appelant de nouveau l’activité Get Results.

​

Erreurs

Le traitement de la transaction peut échouer pour plusieurs raisons (par exemple, un fichier d’entrée peut être corrompu ou son format peut ne pas être pris en charge par ABBYY Vantage). Dans ce cas, l’activité Get Results lève une exception.

​

Rubriques connexes

• activité Vantage Scope
• activité Use Skill
• Map Fields activity