Démarrages rapides

Vue d'ensemble (Overview)

Vous trouverez ci-dessous des liens vers des instructions étape par étape sur l'utilisation des activités Amazon Textract. Ces guides vous aident à créer un exemple pratique des différentes activités afin que vous puissiez vérifier la connexion à vos ressources AWS et vous familiariser avec les types de données d'entrée/de sortie.

Démarrage rapide	Description
Analyze Single Page Document	Une fois les étapes de ce guide terminées, vous disposerez d'une séquence d'automatisation qui effectuera les opérations suivantes : Établit une connexion à vos ressources AWS (Amazon Scope). Analyse un fichier JPEG ou PNG unique (Analyze Single Page Document). Émet les résultats de l’analyse en fonction du type de données trouvées ( Si (If)). Si le fichier comprend des données de formulaire (FormField[]), les valeurs PageDetail.FormFields.Items().Key et PageDetail.FormFields.Items().Value sont écrites dans la fenêtre de sortie (Pour chaque (For Each ) et Ligne d’ écriture (Write Line). Si le fichier comprend des données de table (DataTable), les valeurs PageDetail.Tables sont écrites dans la fenêtre de sortie ( Table de données de sortie (Output Data Table ) et Ligne d' écriture (Write Line).
Démarrer et obtenir une analyse	Une fois les étapes de ce guide terminées, vous disposerez d'une séquence d'automatisation qui effectuera les opérations suivantes : Établit une connexion à vos ressources AWS (Amazon Scope). Démarre une tâche d'analyse Amazon Textract ( Démarrer l'analyse du document (Start Document Analysis)). Récupère et génère le statut de la tâche d'analyse démarrée (Faire pendant (Do While), Obtenir le statut de l'analyse du document ( Get Document Analysis Status), Ligne d'écriture ( Write Line) et Délai ( Delay). Récupère et affiche les résultats de l’analyse si/lorsque la tâche d’analyse est réussie (Si(If), Obtenir l’analyse du document ( Get Document Analysis), Pour chaque ( For Each) et Ligne d’ écriture (Write Line).

Démarrage rapide : Analyser des documents d'une seule page

Vue d'ensemble (Overview)

L'objectif de ce guide est de vous aider à créer un exemple de travail qui utilise l'activité Amazon Textract Analyze Single Page Document .

Cet exemple pratique vous permet de vérifier rapidement la connexion à vos ressources AWS et de vous familiariser avec les types de données d'entrée/sortie de l'activité.

Une fois les étapes de ce guide terminées, vous disposerez d'une séquence d'automatisation qui effectuera les opérations suivantes :

1. Établit une connexion à vos ressources AWS (Amazon Scope).
2. Analyse un fichier JPEG ou PNG unique (Analyze Single Page Document).

3. Émet les résultats de l’analyse en fonction du type de données trouvées ( Si (If)).

   • Si le fichier comprend des données de formulaire (FormFields), les valeurs PageDetail.FormFields.Items().Name et PageDetail.FormFields.Items().Value sont écrites dans la fenêtre de sortie (Pour chaque (For Each ) et Ligne d’ écriture (Write Line).
   • Si le fichier comprend des données de table (DataTable), les valeurs PageDetail.Tables sont écrites dans la fenêtre de sortie ( Table de données de sortie (Output Data Table ) et Ligne d' écriture (Write Line).
     
     

     

     
     

Prérequis

Avant de commencer :

1. Terminez les étapes de configuration d'Amazon Textract.
2. Rendez un fichier JPEG ou PNG disponible en le téléchargeant dans un compartiment S3 ou en l’enregistrant localement.

Étapes

Construire votre projet

1. Ajoutez l'activité Amazon Scope à votre projet.

2. Saisissez l ' Id, la Clésecrèteet la Région de l'utilisateur IAM que vous souhaitez utiliser pour les activités Amazon Textract.

   • Pour plus d’informations, consultez la section Créer un utilisateur IAM dans le Guide de configuration .
3. Ajoutez l'activité Analyze Single Page Document à l'intérieur de l'activité Amazon Scope .
4. Entrez le CheminDocument ( DocumentPath ) ou le Compartiment et le NomDocument du fichier JPEG ou PNG que vous souhaitez analyser.
5. Créez et entrez une variable PageDetail pour la valeur de votre Page (p. ex., pageDetail).
   • Lors de la création de votre variable, sélectionnez UiPath.Amazon.Textract.Client.Models.PageDetail comme type de variable.
6. Ajoutez une activité If après l'activité Analyze Single Page Document .
7. Dans la propriété Condition , entrez la variable PageDetail que vous avez créée à l'étape ci-dessus et .HasFormData.ToString.Equals("True") pour déterminer si le fichier contient des objets FormField (par exemple, pageDetail.HasFormData.ToString.Equals( "True"))

8. Dans la zone d'instruction Puis (Then), ajoutez une activité de type Pour chaque ( For Each ).

   1. Dans la propriété TypeArgument , sélectionnez _UiPath.Amazon.Textract.Client.Models.FormFields
   2. Dans la propriété Valeurs , entrez la propriété FormFields.Items de la variable que vous avez créée pour l'activité Get Messages (par exemple, pageDetail.FormFields.Items).

   3. Dans l'activité Pour chaque ( For Each ), ajoutez une activité de type Écrire une ligne (Write Line) .

      1. Dans la propriété Texte , entrez item.Name+" | "+item.Value+" | "+item.Confidence pour générer les valeurs KeyValuePair des données du formulaire.
   4. Dans la zone Instruction Sinon ( Else ), ajoutez une activité Écrire une ligne (Write Line) .
   5. Dans la propriété Texte (Text), saisissez « Aucune donnée de formulaire trouvée ».
9. Ajoutez une autre activité If après la première activité If .,
10. Dans la propriété Condition , entrez la variable PageDetail que vous avez créée à l'étape ci-dessus et .HasTableData.ToString.Equals("True") pour déterminer si le fichier contient des objets DataTable (par exemple, pageDetail.HasTableData.ToString.Equals( "True"))

11. Dans la zone d'instruction Puis (Then), ajoutez une activité de type Table de données de sortie (Output Data Table) .

    1. Dans la propriété TableDonnées , entrez la variable PageDetail que vous avez créée pour l'activité Analyze Single Page Document et .Tables(0) pour spécifier l'objet 'DataTable` dans le fichier (p. ex., pageDetail.Tables(0) )
    2. Pour la propriété Texte (Text), créez et entrez une variable String pour le contenu DataTable (par ex. TableDonnées).

    3. Ajoutez une activité Write Line après l'activité Output Data Table .

       1. Dans la propriété Texte (Text), entrez la variable String que vous avez créée à l'étape ci-dessus pour générer le contenu DataTable .
    4. Dans la zone Instruction Sinon ( Else ), ajoutez une activité Écrire une ligne (Write Line) .
    5. Dans la propriété Texte (Text), saisissez « Aucune donnée de table trouvée ».

12. Cliquez sur Exécuter ( Run) et vérifiez que la fenêtre Sortie (Output) inclut les données de formulaire et les données de table attendues.

    
    

    

    
    
    
    

    

    
    

Vous avez terminé !

Lorsque vous êtes prêt, essayez les autres guides de démarrage rapide pour vous familiariser avec les différentes activités Amazon Textract.

Pour en savoir plus sur les activités Amazon Textact (y compris des exemples d'entrées/sorties de propriétés), consultez la page Activités (Activities) pour obtenir une liste complète des activités et des liens vers les pages de détails des activités.

Démarrage rapide : Démarrer et obtenir une analyse

Vue d'ensemble (Overview)

L'objectif de ce guide est de vous aider à créer un exemple de travail qui utilise les activités Amazon Textract Start Document Analysis, Get Document Analysis Statuset Get Document Analysis .

Cet exemple pratique vous permet de vérifier rapidement la connexion à vos ressources AWS et de vous familiariser avec les types de données d'entrée/sortie de l'activité.

Une fois les étapes de ce guide terminées, vous disposerez d'une séquence d'automatisation qui effectuera les opérations suivantes :

1. Établit une connexion à vos ressources AWS (Amazon Scope).
2. Démarre une tâche d'analyse Amazon Textract ( Démarrer l'analyse du document (Start Document Analysis)).
3. Récupère et génère le statut de la tâche d'analyse démarrée (Faire pendant (Do While), Obtenir le statut de l'analyse du document ( Get Document Analysis Status), Ligne d'écriture ( Write Line) et Délai ( Delay).

4. Récupère et affiche les résultats de l’analyse si/lorsque la tâche d’analyse est réussie (Si(If), Obtenir l’analyse du document ( Get Document Analysis), Pour chaque (For Each), Pour chaque ( For Each ) et Ligne d’ écriture (Write Line).

   
   

   

   
   

Prérequis

Avant de commencer :

1. Terminez les étapes de configuration d'Amazon Textract.
2. Rendez un fichier JPEG ou PNG disponible en le téléchargeant dans un compartiment S3 ou en l’enregistrant localement.

Étapes

Construire votre projet

1. Ajoutez l'activité Amazon Scope à votre projet.

2. Saisissez l ' Id, la Clésecrèteet la Région de l'utilisateur IAM que vous souhaitez utiliser pour les activités Amazon Textract.

   • Pour plus d’informations, consultez la section Créer un utilisateur IAM dans le Guide de configuration .
3. Ajoutez l'activité Démarrer l'analyse du document (Start Document Analysis) à l'intérieur de l'activité Amazon Scope .
4. Saisissez le Compartiment et le NomDocument du fichier JPEG ou PNG que vous souhaitez analyser.
5. Créez et entrez une variable String pour la valeur JobId (par exemple, jobId).
6. Ajoutez une activité Faire pendant ( Do While ) après l'activité Démarrer l'analyse du document (Start Document Analysis) .
7. Dans l'activité Faire pendant ( Do While ), ajoutez l'activité Get Document Analysis Status .
8. Dans la propriété ID de tâche ( Job Id ), entrez la variable String que vous avez créée pour JobId ci-dessus (par exemple, jobId).
9. Créez et entrez une variable String pour la valeur JobStatus (par exemple, jobStatus).

10. Dans la propriété Condition (Condition ) de l'activité Faire pendant ( Do While ), saisissez la variable StatutTâche (JobStatus) avec une valeur de condition (par exemple, jobStatus = "IN_PROGRESS")

    • Pour obtenir la liste des valeurs de statut de tâche possibles, consultez la section de propriété JobStatus de la page de détails Obtenir le statut d'analyse du document ( Get Document Analysis Status) .
11. Ajoutez une activité Écrire une ligne (Write Line) après l’activité Obtenir le statut de l’analyse du document ( Get Document Analysis Status) .
12. Dans la propriété Texte (Text), entrez la variable String que vous avez créée pour la valeur StatutTâche (JobStatus) ci-dessus (par exemple, jobStatus).
13. Ajoutez une activité Delay après l'activité Write Line .

14. Dans la propriété Durée (Duration), saisissez le temps estimé nécessaire au traitement de votre document. Dans notre exemple, nous saisissons 00:00:20 pour illustrer les changements de la valeur de sortie Statut de la tâche ( Job Status ) (pour les scénarios sans démonstration, nous saisissons 00:00:55 pour un document de formulaire unique).

    Remarque : dans le scénario décrit ci-dessus, votre Robot récupère et génère le statut de la tâche d'analyse toutes les 20 secondes lorsque le statut est égal à IN_PROGRESS. Cette condition permet au Robot de récupérer et d'afficher l'état jusqu'à ce qu'il change.
15. Ajoutez une activité If après l'activité Do While .
16. Dans la propriété Condition (Condition), saisissez la variable JobStatus avec une valeur de condition (par exemple, jobStatus = "SUCCEEDED" or jobStatus="PARTIAL_SUCCESS")

17. Dans la zone Instruction Puis ( Then ), ajoutez l'activité Get Document Analysis .

    1. Dans la propriété Job Id , entrez la variable String que vous avez créée pour la propriété JobId dans l'activité Start Document Analysis . (par exemple, jobId).
    2. Créez et entrez une variable PageDetail[] pour votre valeur Pages (par exemple, pageDetails).
    • Lors de la création de votre variable, sélectionnez UiPath.Amazon.Textract.Client.Models.PageDetail[] comme type de variable.
18. Pour notre exemple ci-dessous, nous évaluerons uniquement le premier document du tableau PageDetail[] de la propriété Pages .
    1. Créez et entrez une nouvelle variable PageDetail pour stocker le premier élément du tableau, et utilisez une activité Assign après l'activité Get Document Analysis (p. ex., pageDetail).
    2. Attribuez DétailsPage(0) comme valeur à la variable que vous venez de créer (pageDetail)

19. Ajoutez une activité For Each après l'activité Assign .

    1. Dans la propriété TypeArgument , sélectionnez UiPath.Amazon.Textract.Client.Models.FormFields
    2. Dans la propriété Valeurs (Values), entrez la propriété FormFields.Items de la variable que vous avez créée pour l'activité Affecter (Assign) (par exemple, pageDetail.FormFields.Items).

    3. Dans l'activité Pour chaque ( For Each ), ajoutez une activité de type Écrire une ligne (Write Line) .

       1. Dans la propriété Texte , entrez item.Name+" | "+item.Value+" | "+item.Confidence pour générer les valeurs du formulaire.
    4. Dans la zone Instruction Sinon ( Else ), ajoutez une activité Écrire une ligne (Write Line) .
    5. Dans la propriété Texte (Text), saisissez un message pour une exécution ayant échoué (par exemple, _"Échec de l'exécution, réessayez.")

20. Exécutez la séquence et vérifiez que la fenêtre Sortie (Output) inclut l'état de la tâche et les valeurs de données de formulaire attendues.

    
    

    

    
    
    
    

    

    
    

Vous avez terminé !

Lorsque vous êtes prêt, essayez les autres guides de démarrage rapide pour vous familiariser avec les différentes activités Amazon Textract.

Pour en savoir plus sur les activités Amazon Textact (y compris des exemples d'entrées/sorties de propriétés), consultez la page Activités (Activities) pour obtenir une liste complète des activités et des liens vers les pages de détails des activités.