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. Analyse un fichier JPEG ou PNG unique (Analyser un document à page unique). Affiche les résultats de l'analyse en fonction du type de données trouvé (Si). Si le fichier inclut 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 et Ligne d'écriture). Si le fichier inclut des données de table (DataTable), les valeurs PageDetail.Tables sont écrites dans la fenêtre de sortie (Table de données de sortie et Ligne d'écriture).
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. Démarre une tâche d’analyse Amazon Textract (Démarrer l'analyse de document). Récupère et affiche le statut de la tâche d'analyse démarrée (Faire pendant, Obtenir le statut de l'analyse du document, Ligne d'écriture et Délai). Récupère et génère les résultats de l'analyse si/lorsque la tâche d'analyse est réussie (Si, Obtenir l'analyse du document, Pour chaque et Ligne d'écriture).

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 pratique qui utilise l'activité Analyser un document à page unique d'Amazon Textract.

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.
2. Analyse un fichier JPEG ou PNG unique (Analyser un document à page unique).
3. Affiche les résultats de l'analyse en fonction du type de données trouvé (Si).

   • Si le fichier inclut 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 et Ligne d'écriture).

   • Si le fichier inclut des données de table (DataTable), les valeurs PageDetail.Tables sont écrites dans la fenêtre de sortie (Table de données de sortie et Ligne d'écriture).

     

Prérequis

Avant de commencer :

1. Suivez 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ète et 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 du guide de configuration .

3. Ajoutez l'activité Analyser le document à l' intérieur de l'activité Amazon Scope .

4. Saisissez le CheminDocument vers, 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 (par exemple, 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é Si après l'activité Analyser un document à page unique .

7. Dans la propriété Condition , saisissez 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() « Vrai»)

8. Dans la zone d'instruction Puis , ajoutez une activité Pour chaque .

   1. Dans la propriété TypeArgument, sélectionnez _UiPath.Amazon.Textract.Client.Models.FormFields
   2. Dans la propriété Valeurs , saisissez la propriété FormFields.Items de la variable que vous avez créée pour l'activité Obtenir les messages (par exemple, pageDetail.FormFields.Items).
   3. Dans l'activité Pour chaque , ajoutez une activité de type Écrire une ligne .
      1. Dans la propriété Texte , saisissez élément.Name+" | "+item.Value+" | "+item.Confidence afin de générer les valeurs KeyValuePair des données du formulaire.
   4. In the Else statement box, add a Write Line activity.
   5. Dans la propriété Texte , saisissez « Aucune donnée de formulaire trouvée.»

9. Ajoutez une autre activité Si après la première activité Si ,

10. Dans la propriété Condition , saisissez 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() « Vrai»)

11. Dans la zone d'instruction Puis , ajoutez une activité Table de données de sortie .

    1. Dans la propriété TableDonnées , saisissez la variable PageDetail que vous avez créée pour l’activité Analyser un document à page unique et .Tables(0) afin de spécifier l’objet « TableDonnées» dans le fichier (par exemple, pageDetail.Tables(0))
    2. Pour la propriété Texte , créez et saisissez une variable String pour le contenu DataTable (par ex. TableDonnées).
    3. Ajouter une activité Write Line après celle de la Output Data Table .
       1. Dans la propriété Texte , saisissez la variable String que vous avez créée à l'étape ci-dessus pour générer le contenu DataTable .
    4. In the Else statement box, add a Write Line activity.
    5. Dans la propriété Texte , saisissez « Aucune donnée de table trouvée».

12. Cliquez sur Exécuter et vérifiez que la fenêtre Sortie inclut les données de formulaire et 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 d’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 pour obtenir une liste complète des activités et des liens vers les pages de détails de l'activité.

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 pratique qui utilise les activités Amazon Textract Démarrer l'analyse des documents, Obtenir le statut de l'analyse des documents et Obtenir l'analyse des documents .

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.

2. Démarre une tâche d’analyse Amazon Textract (Démarrer l'analyse de document).

3. Récupère et affiche le statut de la tâche d'analyse démarrée (Faire pendant, Obtenir le statut de l'analyse du document, Ligne d'écriture et Délai).

4. Récupère et génère les résultats de l'analyse si/lorsque la tâche d'analyse est réussie (Si, Obtenir l'analyse du document, Pour chaque, Pour chaque et Ligne d'écriture).

   

Prérequis

Avant de commencer :

1. Suivez 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ète et 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 du guide de configuration .

3. Ajoutez l'activité Démarrer l'analyse des documents à 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 après l'activité Démarrer l'analyse du document .

7. Dans l'activité Faire pendant , ajoutez l'activité Obtenir le statut de l'analyse du document .

8. Dans la propriété ID de tâche , saisissez la variable String que vous avez créée pour l' ID de tâche 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 de l' activité Faire pendant , saisissez la variable JobStatus ainsi qu'une valeur de condition (par exemple, jobStatus = "IN_PROGRAMP")

    • Pour obtenir la liste des valeurs de statut possibles des tâches, consultez la section de la propriété StatutTâche de la page de détails Obtenir le statut de l’analyse du document .

11. Ajoutez une activité Écrire une ligne sous l’activité Obtenir le statut de l’analyse du document .

12. Dans la propriété Texte , saisissez la variable String que vous avez créée pour la valeur StatutTâche ci-dessus (par exemple, statutTâche).

13. Ajoutez une activité Délai après l’activité Écrire une ligne .

14. Dans la propriété Durée , saisissez le temps estimé nécessaire pour traiter votre document. Dans notre exemple, nous saisissez 00:00:20 pour démontrer les modifications de la valeur de sortie du statut de la tâche (pour les scénarios hors démonstration, nous saisissez 00:00:55 pour un document de formulaire unique).

    Remarque :

    Dans le scénario décrit ci-dessus, votre Robot récupère et affiche le statut de la tâche d'analyse toutes les 20 secondes, tant que le statut est égal à IN_PROGRAMP. Cette condition permet au Robot de récupérer et de générer le statut jusqu'à ce qu'il change.

15. Ajoutez une activité Si après l'activité Faire pendant .

16. Dans la propriété Condition , saisissez la variable JobStatus ainsi qu'une valeur de condition (par exemple, jobStatus = "S UCCEEDED" ou jobStatus="PartIAL_ SUCCESS")

17. Dans la zone d'instruction Puis , ajoutez l'activité Obtenir l'analyse du document .

    1. Dans la propriété ID de tâche , saisissez la variable String que vous avez créée pour la propriété ID de tâche dans l'activité Démarrer l'analyse du document . (par exemple, jobId).
    2. Créez et entrez une variable PageDetail[] pour la valeur de vos 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. Dans notre exemple ci-dessous, nous évaluerons uniquement le premier document du tableau PageDetail[] de la propriété Pages .

    1. Créez et entrez une variable PageDetail pour stocker le premier élément du tableau, et utilisez une activité Affecter après l'activité Obtenir l'analyse du document (par exemple, pageDétail).
    2. Affectez la valeur PageDétail(0) comme valeur à la variable que vous venez de créer (pageDetail)

19. Ajoutez une activité Pour chaque (For Each) sous l’activité Affecter (Assign).

    1. Dans la propriété TypeArgument, sélectionnez UiPath.Amazon.Textract.Client.Models.FormFields
    2. Dans la propriété Valeurs , saisissez la propriété FormFields.Items de la variable que vous avez créée pour l'activité Attribuer (par exemple, pageDetail.FormFields.Items).
    3. Dans l'activité Pour chaque , ajoutez une activité de type Écrire une ligne .
       1. Dans la propriété Texte , saisissez élément.Name+" | "+item.Value+" | "+item.Confidence - pour générer les valeurs du formulaire.
    4. In the Else statement box, add a Write Line activity.
    5. Dans la propriété Texte , saisissez un message pour une tâche ayant échoué (par exemple, _"Tâche échouée, réessayez.")

20. Exécutez la séquence et vérifiez que la fenêtre Sortie inclut le statut 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 d’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 pour obtenir une liste complète des activités et des liens vers les pages de détails de l'activité.