Aktivität Get Results - ABBYY Documentation

Get Results ruft die Ergebnisse eines Vorgangs ab, der mit der Use-Skill-Aktivität gestartet wurde. Übergeben Sie die Transaction Id aus Use Skill, und die Aktivität gibt einen TransactionStatus sowie die Ergebnisse für jedes Dokument zurück. Wenn der Vorgang noch verarbeitet wird, rufen Sie die Aktivität nach einer kurzen Verzögerung erneut auf. Wenn eine Review-Aktivität den Vorgang angehalten hat, gibt sie statt der endgültigen Ergebnisse einen Link zur Manuellen Überprüfung zurück.

Aktivitätseigenschaften

Gruppe	Eigenschaft	Typ	Beschreibung
Eingabe	Transaction Id	`Guid`	Der Bezeichner des Vorgangs. Übergeben Sie an diese Eigenschaft den Wert der Ausgabe-Eigenschaft Transaction Id aus der Use-Skill-Aktivität.
Eingabe	Delete Transaction	`Boolean`	Gibt an, ob der abgeschlossene Vorgang gelöscht werden soll, unabhängig davon, ob er erfolgreich war oder nicht. Der Standardwert ist `FALSE`, d. h., der Vorgang wird nicht gelöscht.
Ausgabe	Document Results	`IEnumerable<DocumentResult>`	Eine Sammlung von Ergebnisdokumenten nach der Verarbeitung.
Ausgabe	Review Link	`String`	Ein Link zum ABBYY Vantage Manual Review-Client, in dem die Vorgangsergebnisse überprüft werden können. Nur verfügbar, wenn der Process-Skill eine Review-Aktivität enthält.
Ausgabe	Transaction Status	`TransactionStatus`	Der Status des Vorgangs. Folgende Status sind möglich: `"New"`, `"Processing"`, `"Review"`, `"Processed"`. Anhand des empfangenen Status können Sie Ihren UiPath-Prozess so konfigurieren, dass unterschiedliche Logik ausgeführt wird. Hat der Vorgang beispielsweise den Status `"Processing"`, warten Sie einige Sekunden und rufen Sie die Aktivität erneut auf.

Bei Verwendung eines Klassifizierungs‑Skills, eines Document-Skills oder eines OCR-Skills werden alle Eingabedateien des Vorgangs zu einem Dokument zusammengefügt. Bei Verwendung eines Process-Skills können mehrere Ergebnisdokumente abgerufen werden. Standardmäßig wird in einem Process-Skill jede Eingabedatei in Vantage zu einem separaten Dokument. Dokumente können unterschiedlichen Klassen angehören, werden aber innerhalb desselben Vorgangs verarbeitet. Um diese Zusammenstellung zu überschreiben, konfigurieren Sie die Aktivität Assemble im Process-Skill. Jedes Dokument erzeugt eigene Ergebnisse. Die Ausgabe-Eigenschaft Document Results gibt eine Sammlung von DocumentResult-Instanzen zurück, eine pro Dokument im Vorgang.

DocumentResult

Name	Type	Description
DocumentId	`String`	Der Bezeichner des Dokuments.
ClassificationConfidences	`IEnumerable<ClassificationConfidence>`	Eine Sammlung von Klassifikations‑Konfidenzwerten. Eine Liste aller Klassen, die im auf das Dokument angewendeten Klassifizierungs‑Skill verfügbar sind, zusammen mit ihren Klassifikations‑Konfidenzwerten.
ClassName	`String`	Die Dokumentklasse auf Grundlage der Klassifikationsergebnisse.
ExtractedData	`String`	Ein JSON-`string`, der die extrahierten Daten enthält. Hinweis: Bei einem Process-Skill kann diese Eigenschaft abgerufen werden, wenn in der Ausgabeaktivität die Option Values, metadata, and field structure for each document aktiviert ist.
IsClassificationConfident	`Boolean`	Die resultierende Klasse gilt als zuverlässig bestimmt, wenn dieser Wert `TRUE` ist.
ResultFiles	`IReadOnlyDictionary<String,Stream>`	Eine Sammlung von Ergebnisdateien nach der Verarbeitung.
DocumentFullText	`String`	Die Volltext-Ebene eines Dokuments, die von ABBYY Vantage erfasst wurde. Hinweis: Wenn die Skill-Konfiguration keine Einstellung für den Volltextexport enthält, enthält diese Eigenschaft den folgenden Standardwert: TXT export was not configured in the ABBYY Vantage skill settings. Please enable TXT export in the skill that you have selected. Der TXT-Export ist nur für OCR- oder Processing-Skills verfügbar.

Alle aufgeführten Parameter werden in einem separaten DocumentResult in der Sammlung Document Results erfasst. Selbst wenn es nur ein Ausgabedokument gibt, sind dessen Ausgabeparameter über das erste DocumentResult in der Sammlung Document Results verfügbar.

ClassificationConfidence

Name	Type	Description
ClassName	`String`	Vantage-Dokumentklasse.
Confidence	`Int`	Der Konfidenzwert dafür, dass das Dokument zu dieser Klasse gehört. Mögliche Werte reichen von 0 bis 100.

Die Aktivität Get Results kann nur innerhalb einer konfigurierten Vantage Scope Activity verwendet werden.

Das Verhalten der Aktivität Get Results hängt vom zurückgegebenen Transaction Status ab.

Transaction Status	Verhalten
`Processed`	Die Verarbeitung wurde erfolgreich abgeschlossen. Die Ergebnisse werden in den Ausgabe-Eigenschaften gespeichert.
`New` / `Processing`	Der Vorgang wird noch verarbeitet. Warten Sie einige Sekunden und rufen Sie die Aktivität Get Results erneut auf.
`Review`	Der Vorgang wurde zur Manuellen Überprüfung angehalten. Die Aktivität Get Results gibt einen Review Link zum Manual Review-Client zurück. Rufen Sie die Aktivität nach Abschluss der Überprüfung erneut auf, um die endgültigen Ergebnisse abzurufen. Vollständige Details finden Sie unter Process-Skill.

Ergebnisse nach Skill-Typ

Die Ergebnisse, die die Aktivität Get Results abrufen kann, unterscheiden sich je nach dem auf das Dokument angewendeten Skill.

Klassifizierungs‑Skill

Ein Klassifizierungs‑Skill (z. B. Vantage Classifier) gibt Folgendes zurück:

Transaction Status
Document Results (für jedes DocumentResult): DocumentId, ClassificationConfidences, ClassName, IsClassificationConfident, ResultFiles (JSON-Datei mit Daten zu den Klassifizierungsergebnissen)

Document-Skill

Ein Document-Skill (z. B. Invoice US) gibt Folgendes zurück:

Transaction Status
Document Results (für jedes DocumentResult): DocumentId, ExtractedData, ResultFiles (die Ergebnisse sind in zwei JSON-Dateien enthalten: Die erste enthält alle Dokumentdaten; die zweite endet mit _fields.json und enthält die Werte der extrahierten Felder und Regelfehler)

OCR-Skill

Ein OCR-Skill gibt Folgendes zurück:

Transaction Status
Document Results (für jedes DocumentResult): DocumentId, ResultFiles (die Dateien entsprechen dem im OCR-Skill konfigurierten Export), DocumentFullText (wenn der Export in TXT im Skill aktiviert ist)

Process-Skill

Die zurückgegebenen Ergebnisse hängen von den Aktivitäten ab, aus denen der Process-Skill besteht, und von deren Einstellungen, insbesondere von den Einstellungen der Ausgabeaktivität. Weitere Informationen zum Process-Skill finden Sie unter Einen Process-Skill einrichten. Wenn ein Process-Skill eine Classify-Aktivität und eine Extract-Aktivität umfasst, erhalten Sie die zuvor beschriebenen Ergebnisse sowohl für einen Klassifizierungs‑Skill als auch für einen Document-Skill. Wenn ein Process-Skill mehrere Classify- oder Extract-Aktivitäten umfasst, werden die Ergebnisse für die jeweils letzte Aktivität des betreffenden Typs zurückgegeben.

Wenn die Option PDF im Dialogfeld Exported Data Settings einer Ausgabeaktivität eines Process-Skills aktiviert ist, enthalten die Ergebnisse die JSON-Datei mit den Extraktionsergebnissen. Sie enthalten außerdem das als PDF-Datei exportierte Dokumentbild mit einer Textebene. Für jedes Dokument im Vorgang wird der Parameter DocumentFullText zurückgegeben, wenn im Skill der Export nach TXT aktiviert ist. Ein Process-Skill kann auch eine Review-Aktivität enthalten. Wenn ein solcher Skill für die Dokumentverarbeitung verwendet wird, kann die Verarbeitung unterbrochen werden, wenn das Dokument eine manuelle Überprüfung erfordert. In diesem Fall liefert die Aktivität Get Results:

Transaction Status = "Review"
Review Link

Sobald die manuelle Überprüfung und die Verarbeitung des Vorgangs abgeschlossen sind, können Sie die zuvor beschriebenen Ergebnisse erhalten, indem Sie die Aktivität Get Results erneut aufrufen.

Fehler

Die Verarbeitung des Vorgangs kann aus verschiedenen Gründen fehlschlagen (zum Beispiel kann eine Eingabedatei beschädigt sein oder ihr Format wird von ABBYY Vantage nicht unterstützt). In diesem Fall löst die Aktivität Get Results eine Ausnahme aus.

​Aktivitätseigenschaften

​DocumentResult

​ClassificationConfidence

​Ergebnisse nach Skill-Typ

​Klassifizierungs‑Skill

​Document-Skill

​OCR-Skill

​Process-Skill

​Fehler

​Verwandte Themen

Aktivitätseigenschaften

DocumentResult

ClassificationConfidence

Ergebnisse nach Skill-Typ

Klassifizierungs‑Skill

Document-Skill

OCR-Skill

Process-Skill

Fehler

Verwandte Themen