Formular analysieren

Die Aktivität Analyze Form verwendet die Form Recognizer Analyze Form API, um Schlüssel-Wert-Paare und Tabellendaten aus einem angegebenen Dokument (Dateipfad oder Datei-URL) mithilfe eines angegebenen Trainingsmodells (Modell-ID) zu extrahieren.

Nach Abschluss des Formularanalysevorgangs gibt die Aktivität die Ergebnisse in einem AnalyzeOperationResult -Objekt (Antwortobjekt) und einem Page[] -Objekt (Seiten) aus. Beide Ausgaben können als Eingabevariablen in nachfolgenden Aktivitäten verwendet werden (z. B. bedingte Logik).

Wie es funktioniert

Die folgenden Schritte und das folgende Nachrichtensequenzdiagramm sind ein Beispiel dafür, wie die Aktivität von der Entwurfszeit (d. h. den Aktivitätsabhängigkeiten und Eingabe-/Ausgabeeigenschaften) bis zur Laufzeit funktioniert.

1. Schließen Sie die Einrichtungsschritte ab.
2. Fügen Sie die Aktivität Azure Form Recognizer Scope zu Ihrem Projekt hinzu.
3. Fügen Sie die Aktivität Analyze Form innerhalb der Aktivität Azure Form Recognizer Scope hinzu.
4. Geben Sie Werte für die Eingabeeigenschaften ein.
5. Erstellen und geben Sie die Variablen AnalyzeOperationResult und Page[] für die Ausgabeeigenschaften ein.

6. Führen Sie die Aktivität aus.

   • Ihre Eingabeeigenschaften werden an die Analyze Form API gesendet.
   • Die API gibt die Werte AnalyzeFormResponse und FormPage[] an Ihre Ausgabeeigenschaftsvariablen zurück.
     
     

     

     
     

Eigenschaften

Die Werte für die folgenden Eigenschaften werden beim Hinzufügen dieser Aktivität zu Ihrem Projekt in UiPath Studio angegeben.

Allgemein

DisplayName

Der Anzeigename der Aktivität.

Attribute	Details
Typ	String
Erforderlich	Ja
Standardwert	Formular analysieren
Zulässige Werte	Geben Sie eine String oder String -Variable ein.
Hinweise	Keine Angabe

Zeitüberschreitung

Gibt die zu wartende Zeitspanne (in Millisekunden) bis zum Abschluss des Empfangsanalysevorgangs an, bevor ein Fehler ausgelöst wird.

Attribute	Details
Typ	Int32
Erforderlich	Ja
Standardwert	30000 ms ((30 Sekunden) nicht angezeigt)
Zulässige Werte	Geben Sie eine Int32 oder Int32 -Variable ein.
Hinweise	Keine Angabe

Eingabe

Dateipfad

Der lokale Pfad zum Formulardokument, das Sie analysieren möchten.

Attribute	Details
Typ	String
Erforderlich	Ja (wenn Datei-URL leer ist)
Standardwert	Leer
Zulässige Werte	Geben Sie eine String oder String -Variable ein.
Hinweise	Unterstützte Formulardokumentformate: .json, PDF-Datei, .jpg, PNG, und .tiff (alle anderen Formattypen werden ignoriert).

DateiURL

Die URL des Formulardokuments, das Sie analysieren möchten.

Attribute	Details
Typ	String
Erforderlich	Ja (wenn Dateipfad leer ist)
Standardwert	Leer
Zulässige Werte	Geben Sie eine String oder String -Variable ein.
Hinweise	Unterstützte Formulardokumentformate: .json, PDF-Datei, .jpg, PNG, und .tiff (alle anderen Formattypen werden ignoriert).

Modell-ID

Der Bezeichner des Trainingsmodells, das Sie zum Analysieren des Formulars verwenden möchten.

Attribute	Details
Typ	String
Erforderlich	Ja
Standardwert	Leer
Zulässige Werte	Geben Sie eine String oder String -Variable ein.
Hinweise	Um den Modell-ID-Wert abzurufen , fügen Sie eine Aktivität hinzu, oder führen Sie einen externen Prozess aus, der den Modellbezeichner ausgibt (z. B. Train Model, Get Models).

Optionen

IncludeTextDetails

Wenn diese Option ausgewählt ist, enthält das Ergebnis Textzeilen und Elementverweise.

Attribute	Details
Typ	Kontrollkästchen
Erforderlich	Nein
Standardwert	nicht ausgewählt
Zulässige Werte	Ausgewählt oder nicht ausgewählt
Hinweise	Keine Angabe

Sonstiges

Private

Falls ausgewählt werden die Werte von Variablen und Argumenten nicht mehr auf ausführlicher Ebene protokolliert.

Attribute	Details
Typ	Kontrollkästchen
Erforderlich	Nein
Standardwert	nicht ausgewählt
Zulässige Werte	Ausgewählt oder nicht ausgewählt
Hinweise	Keine Angabe

Ausgabe

Response Object

Die Vorgangsantwort als deserialisiertes Objekt.

Attribute	Details
Typ	AnalyzeOperationResult
Erforderlich	Nein (erforderlich, um die Ausgabedaten in nachfolgenden Aktivitäten zu verwenden)
Standardwert	Leer
Zulässige Werte	Geben Sie eine AnalyzeOperationResult -Variable ein
Hinweise	Um die JSON-Zeichenfolgendarstellung abzurufen, verwenden Sie die ToString -Methode. Wenn das Modell ein Feld nicht finden kann, wird ein NULL-Wert zurückgegeben.

Seiten

Die Ergebnisse der Formularanalyse, einschließlich der von der Seite extrahierten Schlüssel-Wert-Paare und Tabelleninformationen.

Attribute	Details
Typ	Page[]
Erforderlich	Nein (erforderlich, um die Ausgabedaten in nachfolgenden Aktivitäten zu verwenden)
Standardwert	Leer
Zulässige Werte	Geben Sie eine Page[] -Variable ein
Hinweise	Jedes Page -Objekt enthält KeyValuePairs - und Tables -Eigenschaften.