Schnellstarts

Überblick

Im Folgenden finden Sie Links zu Schritt-für-Schritt-Anweisungen zur Verwendung der Amazon Textract-Aktivitäten. Diese Leitfäden helfen Ihnen, ein funktionierendes Beispiel der verschiedenen Aktivitäten zu erstellen, damit Sie die Verbindung zu Ihren AWS-Ressourcen überprüfen und sich mit den Eingabe-/Ausgabedatentypen vertraut machen können.

Schnellstart	Beschreibung
Analyze Single Page Document	Nachdem Sie die Schritte in dieser Anleitung ausgeführt haben, verfügen Sie über eine Automatisierungs-Sequence, die Folgendes ausführt: Stellt eine Verbindung zu Ihren AWS-Ressourcen (Amazon Scope) her. Analysiert eine einzelne JPEG- oder PNG-Datei (Analyze Single Page Document). Gibt die Ergebnisse der Analyse abhängig vom Typ der gefundenen Daten aus (If). Wenn die Datei Formulardaten (FormField[]) enthält, werden die Werte von PageDetail.FormFields.Items().Key und PageDetail.FormFields.Items().Value in das Ausgabefenster geschrieben (For Each and Write Line). Wenn die Datei Tabellendaten (DataTable) enthält, werden die PageDetail.Tables -Werte in das Ausgabefenster geschrieben (Output Data Table and Write Line).
Analyse starten und abrufen	Nachdem Sie die Schritte in dieser Anleitung ausgeführt haben, verfügen Sie über eine Automatisierungs-Sequence, die Folgendes ausführt: Stellt eine Verbindung zu Ihren AWS-Ressourcen (Amazon Scope) her. Startet einen Amazon Textract-Analyseauftrag (Start Document Analysis). Ruft den Status des gestarteten Analyseauftrags ab (Do While, Get Document Analysis Status, Write Line und Delay) und gibt ihn aus. Ruft die Ergebnisse der Analyse ab und gibt sie aus, wenn der Analyseauftrag erfolgreich ist (If, Get Document Analysis, For Each und Write Line).

Schnellstart – Analysieren einseitiger Dokumente

Überblick

Dieser Leitfaden soll Sie bei der Erstellung eines funktionierenden Beispiels unterstützen, das die Aktivität Amazon Textract Analyze Single Page Document verwendet.

Mit diesem Arbeitsbeispiel können Sie schnell die Verbindung zu Ihren AWS-Ressourcen überprüfen und sich mit den Eingabe-/Ausgabedatentypen der Aktivität vertraut machen.

Nachdem Sie die Schritte in dieser Anleitung ausgeführt haben, verfügen Sie über eine Automatisierungs-Sequence, die Folgendes ausführt:

1. Stellt eine Verbindung zu Ihren AWS-Ressourcen (Amazon Scope) her.
2. Analysiert eine einzelne JPEG- oder PNG-Datei (Analyze Single Page Document).

3. Gibt die Ergebnisse der Analyse abhängig vom Typ der gefundenen Daten aus (If).

   • Wenn die Datei Formulardaten (FormFields) enthält, werden die Werte von PageDetail.FormFields.Items().Name und PageDetail.FormFields.Items().Value in das Ausgabefenster geschrieben (For Each and Write Line).
   • Wenn die Datei Tabellendaten (DataTable) enthält, werden die PageDetail.Tables -Werte in das Ausgabefenster geschrieben (Output Data Table and Write Line).
     
     

     

     
     

Voraussetzungen

Bevor Sie beginnen:

1. Schließen Sie die Schritte zum Einrichten von Amazon Textract ab.
2. Stellen Sie eine JPEG- oder PNG-Datei zur Verfügung, indem Sie sie in einen S3-Bucket hochladen oder lokal speichern.

Schritte

Erstellen Ihres Projekts

1. Fügen Sie die Aktivität Amazon Scope zu Ihrem Projekt hinzu.

2. Geben Sie die ID, dasGeheimnisund die Region für den IAM-Benutzer ein, den Sie für die Amazon Textract-Aktivitäten verwenden möchten.

   • Weitere Informationen finden Sie im Abschnitt IAM-Benutzer erstellen in der Setup- Anleitung.
3. Fügen Sie die Aktivität Analyze Single Page Document innerhalb der Aktivität Amazon Scope hinzu.
4. Geben Sie DocumentPath oder den Bucket und DocumentName der JPEG- oder PNG-Datei ein, die Sie analysieren möchten.
5. Erstellen und geben Sie eine PageDetail -Variable für Ihren Seitenwert ein (z. B. pageDetail).
   • Wählen Sie beim Erstellen Ihrer Variablen UiPath.Amazon.Texttract.Client.Models.PageDetail als Variablentyp aus.
6. Fügen Sie eine If -Aktivität nach der Aktivität Analyze Single Page Document hinzu.
7. Geben Sie in der Eigenschaft Bedingung die Variable PageDetail ein, die Sie im obigen Schritt erstellt haben, und .HasFormData.ToString.Equals("True") , um zu bestimmen, ob die Datei FormField -Objekte enthält (z. B. pageDetail.HasFormData.ToString.Equals( „true“).

8. Fügen Sie im Then -Anweisungsfeld eine For Each -Aktivität hinzu.

   1. Wählen Sie in der Eigenschaft „Argumenttyp“ (TypeArgument) die Option _UiPath.Amazon.Texttract.Client.Models.FormFields
   2. Geben Sie in der Eigenschaft Werte die Eigenschaft FormFields.Items der Variablen ein, die Sie für die Aktivität Nachrichten abrufen (Get Messages) erstellt haben (z. B. pageDetail.FormFields.Items).

   3. Fügen Sie eine Zeile schreiben ( Write Line )-Aktivität in die Aktivität Für jede ( For Each ) ein.

      1. Geben Sie in der Eigenschaft Text item.Name+" | "+item.Value+" | "+item.Confidence ein, um die KeyValuePair -Werte der Formulardaten auszugeben.
   4. Fügen Sie im Feld Else Statement eine Write Line- Aktivität hinzu.
   5. Geben Sie in der Eigenschaft Text „Keine Formulardaten gefunden“ ein.
9. Fügen Sie nach der ersten If -Aktivität eine weitere If -Aktivität hinzu.,
10. Geben Sie in der Eigenschaft Bedingung die Variable PageDetail ein, die Sie im obigen Schritt erstellt haben, und .HasTableData.ToString.Equals("True") , um zu bestimmen, ob die Datei DataTable -Objekte enthält (z. B. pageDetail.HasTableData.ToString.Equals( „true“).

11. Fügen Sie im Then -Anweisungsfeld eine Aktivität Output Data Table hinzu.

    1. Geben Sie in der Eigenschaft DatenTabelle ( DataTable ) die Variable PageDetail ein, die Sie für die Aktivität Analyze Single Page Document erstellt haben, und .Tables(0) , um das Objekt 'DataTable' in der Datei anzugeben (z. B. pageDetail.Tables(0))
    2. Erstellen und geben Sie für die Eigenschaft Text (Text) eine String -Variable für den DataTable -Inhalt ein (z. B dataTable).

    3. Fügen Sie eine Write Line- Aktivität nach der Output Data Table- Aktivität hinzu.

       1. Geben Sie in der Eigenschaft Text die Variable String ein, die Sie im obigen Schritt erstellt haben, um den DataTable -Inhalt auszugeben.
    4. Fügen Sie im Feld Else Statement eine Write Line- Aktivität hinzu.
    5. Geben Sie in der Eigenschaft Text „Keine Tabellendaten gefunden“ ein.

12. Klicken Sie auf Ausführen und überprüfen Sie, ob das Fenster Ausgabe ( Output ) die erwarteten Formular- und Tabellendaten enthält.

    
    

    

    
    
    
    

    

    
    

Alles erledigt!

Wenn Sie bereit sind, lesen Sie die anderen Schnellstartanleitungen, um sich mit den verschiedenen Amazon Textract -Aktivitäten vertraut zu machen.

Weitere Informationen zu den Amazon Textact-Aktivitäten (einschließlich Beispieleigenschaftseingaben/-ausgaben) finden Sie auf der Seite Aktivitäten . Dort finden Sie eine vollständige Aktivitätsliste und Links zu den Detailseiten der Aktivität.

Schnellstart – Analyse starten und abrufen

Überblick

Dieser Leitfaden soll Sie bei der Erstellung eines funktionierenden Beispiels unterstützen, das die Aktivitäten Amazon Textract Start Document Analysis, Get Document Analysis Statusund Get Document Analysis verwendet.

Mit diesem Arbeitsbeispiel können Sie schnell die Verbindung zu Ihren AWS-Ressourcen überprüfen und sich mit den Eingabe-/Ausgabedatentypen der Aktivität vertraut machen.

Nachdem Sie die Schritte in dieser Anleitung ausgeführt haben, verfügen Sie über eine Automatisierungs-Sequence, die Folgendes ausführt:

1. Stellt eine Verbindung zu Ihren AWS-Ressourcen (Amazon Scope) her.
2. Startet einen Amazon Textract-Analyseauftrag (Start Document Analysis).
3. Ruft den Status des gestarteten Analyseauftrags ab (Do While, Get Document Analysis Status, Write Line und Delay) und gibt ihn aus.

4. Ruft die Ergebnisse der Analyse ab und gibt sie aus, wenn der Analyseauftrag erfolgreich ist (If, Get Document Analysis, For Each, For Each und Write Line).

   
   

   

   
   

Voraussetzungen

Bevor Sie beginnen:

1. Schließen Sie die Schritte zum Einrichten von Amazon Textract ab.
2. Stellen Sie eine JPEG- oder PNG-Datei zur Verfügung, indem Sie sie in einen S3-Bucket hochladen oder lokal speichern.

Schritte

Erstellen Ihres Projekts

1. Fügen Sie die Aktivität Amazon Scope zu Ihrem Projekt hinzu.

2. Geben Sie die ID, dasGeheimnisund die Region für den IAM-Benutzer ein, den Sie für die Amazon Textract-Aktivitäten verwenden möchten.

   • Weitere Informationen finden Sie im Abschnitt IAM-Benutzer erstellen in der Setup- Anleitung.
3. Fügen Sie die Aktivität Start Document Analysis innerhalb der Aktivität Amazon Scope hinzu.
4. Geben Sie Bucket und DocumentName der JPEG- oder PNG-Datei ein, die Sie analysieren möchten.
5. Erstellen und geben Sie eine String -Variable für den JobId- Wert ein (z. B. jobId).
6. Fügen Sie eine Do While -Aktivität nach der Aktivität Start Document Analysis hinzu.
7. Fügen Sie in der Aktivität Do While die Aktivität Get Document Analysis Status hinzu.
8. Geben Sie in der Eigenschaft Auftrags-ID die Variable String ein, die Sie für die obige JobId erstellt haben (z. B. jobId).
9. Erstellen und geben Sie eine String -Variable für den JobStatus- Wert ein (z. B. jobStatus).

10. Geben Sie in der Eigenschaft Bedingung ( Condition ) der Aktivität Währenddessen ausführen ( Do While ) die Variable JobStatus zusammen mit einem Bedingungswert ein (z. B. jobStatus = "IN_PROGRESS").

    • Eine Liste der möglichen Auftragsstatuswerte finden Sie im Abschnitt zur Eigenschaft Auftragsstatus auf der Detailseite Dokumentanalysestatus abrufen.
11. Fügen Sie eine Aktivität Write Line nach der Aktivität Get Document Analysis Status hinzu.
12. Geben Sie in der Eigenschaft Text die Variable String ein, die Sie für den obigen JobStatus- Wert erstellt haben (z. B. jobStatus).
13. Fügen Sie eine Delay -Aktivität nach der Aktivität Write Line hinzu.

14. Geben Sie in der Eigenschaft Dauer die geschätzte Zeit ein, die für die Verarbeitung Ihres Dokuments benötigt wird. In unserem Beispiel geben wir 00:00:20 ein, um die Änderungen des Ausgabewerts „Auftragsstatus“ zu veranschaulichen (für Nicht-Demo-Szenarien geben wir 00:00:55 für ein einzelnes Formulardokument ein).

    Hinweis: Im oben beschriebenen Szenario ruft Ihr Roboter den Status des Analyseauftrags alle 20 Sekunden ab und gibt ihn aus, solange der Status gleich IN_PROGRESS ist. Diese Bedingung ermöglicht es dem Roboter, den Status abzurufen und auszugeben, bis er sich ändert.
15. Fügen Sie eine If -Aktivität nach der Do While -Aktivität hinzu.
16. Geben Sie die JobStatus- Variable in der Eigenschaft Bedingung ( Condition ) zusammen mit einem Bedingungswert ein (z. B. jobStatus = "ERFOLGREICH" oder jobStatus="PARTIAL_SUCCESS").

17. Fügen Sie im Feld Then Statement die Aktivität Get Document Analysis hinzu.

    1. Geben Sie in der Eigenschaft Job -ID die Variable String ein, die Sie für die Eigenschaft JobId in der Aktivität Start Document Analysis erstellt haben. (z. B. jobId).
    2. Erstellen und geben Sie eine PageDetail[] -Variable für Ihren Seitenwert ein (z. B. pageDetails).
    • Wählen Sie beim Erstellen Ihrer Variablen UiPath.Amazon.Texttract.Client.Models.PageDetail[] als Variablentyp aus.
18. In unserem folgenden Beispiel werten wir nur das erste Dokument im PageDetail[] -Array der Seiten -Eigenschaft aus.
    1. Erstellen und geben Sie eine PageDetail -Variable ein, um das erste Element im Array zu speichern, und verwenden Sie eine Assign -Aktivität nach der Aktivität Get Document Analysis (z. B. pageDetail).
    2. Weisen Sie PageDetail(0) als Wert der Variablen zu, die Sie gerade erstellt haben (pageDetail).

19. Fügen Sie eine For Each -Aktivität nach der Assign- Aktivität hinzu.

    1. Wählen Sie in der Eigenschaft „Argumenttyp“ (TypeArgument) die Option UiPath.Amazon.Texttract.Client.Models.FormFields aus
    2. Geben Sie in der Eigenschaft Werte die FormFields.Items -Eigenschaft der Variablen ein, die Sie für die Zuweisen ( Assign )-Aktivität erstellt haben (z. B. pageDetail.FormFields.Items).

    3. Fügen Sie eine Zeile schreiben ( Write Line )-Aktivität in die Aktivität Für jede ( For Each ) ein.

       1. Geben Sie in der Eigenschaft Text item.Name+" | "+item.Value+" | "+item.Confidence ein, um die Formularwerte auszugeben.
    4. Fügen Sie im Feld Else Statement eine Write Line- Aktivität hinzu.
    5. Geben Sie in der Eigenschaft Text eine Meldung für einen fehlgeschlagenen Auftrag ein (z. B. _"Auftrag fehlgeschlagen, versuchen Sie es erneut.")

20. Führen Sie die Sequence aus, und überprüfen Sie, ob das Fenster Ausgabe ( Output ) den Auftragsstatus und die erwarteten Formulardatenwerte enthält.

    
    

    

    
    
    
    

    

    
    

Alles erledigt!

Wenn Sie bereit sind, lesen Sie die anderen Schnellstartanleitungen, um sich mit den verschiedenen Amazon Textract -Aktivitäten vertraut zu machen.

Weitere Informationen zu den Amazon Textact-Aktivitäten (einschließlich Beispieleigenschaftseingaben/-ausgaben) finden Sie auf der Seite Aktivitäten . Dort finden Sie eine vollständige Aktivitätsliste und Links zu den Detailseiten der Aktivität.