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 in Abhängigkeit vom Typ der gefundenen Daten aus (Wenn). If the file includes form data (FormField[]), the PageDetail.FormFields.Items().Key and PageDetail.FormFields.Items().Value values are written to the output window (For Each and Write Line). If the file includes table data (DataTable), the PageDetail.Tables values are written to the output window (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 und gibt ihn aus (Do While, Get Document Analysis Status, Write Line und Delay). Retrieves and outputs the results of the analysis if/when the analysis job is successful (If, Get Document Analysis, For Each, and 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 in Abhängigkeit vom Typ der gefundenen Daten aus (Wenn).

   • Wenn die Datei Formulardaten (FormFields) enthält, werden die Werte PageDetail.FormFields.Items().Name und PageDetail.FormFields.Items().Value in das Ausgabefenster (For Each und Write Line) geschrieben.

   • Wenn die Datei Tabellendaten enthält (DataTable), 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,das Geheimnis und 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 den Dokumentpfad 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. SeiteDetail).

   • Wählen Sie beim Erstellen Ihrer Variablen UiPath.Amazon.Textract.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 die Option _UiPath.Amazon.Textract.Client.Models.FormFields aus
   2. Geben Sie in der Eigenschaft Werte die FormFields.Items -Eigenschaft der Variablen ein, die Sie für die Aktivität Get Messages erstellt haben (z. B. pageDetail.FormFields.Items).
   3. Fügen Sie in der Aktivität For Each eine Aktivität Write Line hinzu.
      1. Geben Sie in der Eigenschaft Text den Wert item.Name+" | "+item.Value+" | "+item.Confidence" ein, um die KeyValuePair -Werte der Formulardaten auszugeben.
   4. In the Else statement box, add a Write Line activity.
   5. Geben Sie in der Eigenschaft Text den Text „Keine Formulardaten gefunden“ ein.

9. Fügen Sie eine weitere If- Aktivität nach der ersten 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 Output Data Table -Aktivität hinzu.

    1. Geben Sie in der Eigenschaft Datentabelle die Variable PageDetail ein, die Sie für die Aktivität „Analyze Single Page Document“ erstellt haben, und .Tables(0), um das „DataTable“-Objekt in der Datei anzugeben (z. B. pageDetail.Tables(0))
    2. Erstellen und geben Sie für die Eigenschaft Text eine String -Variable für den DataTable -Inhalt ein (z. B Datentabelle).
    3. Fügen Sie eine Write Line- Aktivität nach der Aktivität Output Data Table 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. In the Else statement box, add a Write Line activity.
    5. Geben Sie in der Eigenschaft Text den Text „Keine Tabellendaten gefunden“ ein.

12. Klicken Sie auf Ausführen und stellen Sie sicher, dass das Fenster Ausgabe die erwarteten Formulardaten und Tabellendaten enthält.

    

    

Alles erledigt!

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

Weitere Informationen zu den Amazon Textact-Aktivitäten (einschließlich Beispiele für die Ein-/Ausgabe von Eigenschaften), finden Sie auf der Seite Aktivitäten für eine vollständige Aktivitätsliste und Links zu den Seiten mit Aktivitätsdetails.

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 Status und 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 und gibt ihn aus (Do While, Get Document Analysis Status, Write Line und Delay).

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,das Geheimnis und 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 den Bucket und Dokumentnamen der JPEG- oder PNG-Datei ein, die Sie analysieren möchten.

5. Erstellen und geben Sie eine String -Variable für den Wert der Auftrags-ID 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 innerhalb 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 Auftrags-ID erstellt haben (z. B. jobId).

9. Erstellen und geben Sie eine String -Variable für den Wert von JobStatus ein (z. B. jobStatus).

10. Geben Sie in der Eigenschaft Bedingung der Aktivität Do While die Variable JobStatus zusammen mit einem Bedingungswert ein (z. B. jobStatus = "IN_PROGRAMP")

    • Eine Liste der möglichen Auftragsstatuswerte finden Sie im Abschnitt Auftragsstatus auf der Detailseite zum Abrufen des Dokumentanalysestatus .

11. Fügen Sie eine Write Line- Aktivität 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 Wert JobStatus erstellt haben (z. B. jobStatus).

13. Fügen Sie eine Delay- Aktivität nach der Write Line- Aktivität 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-Demoszenarien 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, während der Status gleich IN_PROGRAMP 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 Aktivität Do While hinzu.

16. Geben Sie in der Eigenschaft Bedingung die Variable JobStatus zusammen mit einem Bedingungswert ein (z. B. jobStatus = "SucCEEDED" oder jobStatus="partpartal_ SUCCESS")

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

    1. Geben Sie in der Eigenschaft Auftrags-ID die Variable String ein, die Sie für die Eigenschaft Auftrags-ID 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.Textract.Client.Models.PageDetail[] als Variablentyp aus.

18. Für unser folgendes Beispiel werten wir nur das erste Dokument im PageDetail[] -Array der Eigenschaft Seiten 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. SeiteDetail).
    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 die Option UiPath.Amazon.Textract.Client.Models.FormFieldsaus
    2. Geben Sie in der Eigenschaft Werte die FormFields.Items -Eigenschaft der Variablen ein, die Sie für die Aktivität Zuweisen erstellt haben (z. B. pageDetail.FormFields.Items).
    3. Fügen Sie in der Aktivität For Each eine Aktivität Write Line hinzu.
       1. Geben Sie in der Eigenschaft Text Folgendes ein: item.Name+" | "+item.Value+" | "+item.Confidence , um die Formularwerte auszugeben.
    4. In the Else statement box, add a Write Line activity.
    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 stellen Sie sicher, dass das Fenster Ausgabe den Auftragsstatus und die erwarteten Formulardatenwerte enthält.

    

    

Alles erledigt!

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

Weitere Informationen zu den Amazon Textact-Aktivitäten (einschließlich Beispiele für die Ein-/Ausgabe von Eigenschaften), finden Sie auf der Seite Aktivitäten für eine vollständige Aktivitätsliste und Links zu den Seiten mit Aktivitätsdetails.