Zum Hauptinhalt springen

Documentation Index

Fetch the complete documentation index at: https://docs.abbyy.com/llms.txt

Use this file to discover all available pages before exploring further.

Mit der Aktivität Map Fields werden extrahierte Feldwerte in UiPath-Variablen gespeichert. Sie können ABBYY Vantage-Felder im Designer-Bereich UiPath-Variablen zuordnen.

Aktivitätseigenschaften

GruppeEigenschaftTypBeschreibung
Connection SettingsSkill NameStringDer Name des Vantage Document-Skills.
InputExtracted DataStringAkzeptiert einen JSON-String mit den extrahierten Daten. Übergeben Sie an diese Eigenschaft den Wert der Eigenschaft ExtractedData des jeweiligen DocumentResult, das in der Aktivität Get Results empfangen wurde. Verwenden Sie UiPath-Variablen, um Werte zwischen den Eigenschaften zu übergeben.
Die Aktivität Map Fields kann nur innerhalb einer konfigurierten Vantage Scope Activity verwendet werden.
Legen Sie beim Konfigurieren der Aktivität in der Vantage Scope Activity die Eigenschaft Password oder Client Secret fest (abhängig von Ihrem Authentifizierungsablauf), damit der Connector die Skill-Liste abrufen kann. Wechseln Sie zur Eigenschaft Secure Password oder Secure Client Secret, sobald Ihr Workflow konfiguriert ist — siehe Vantage Scope Activity. Zur Laufzeit muss die Eigenschaft Extracted Data den ExtractedData-Wert aus dem DocumentResult erhalten, das Get Results für den Document-Skill zurückgegeben hat, für den diese Aktivität Map Fields konfiguriert ist. Bevor Sie die Daten an Map Fields übergeben:
  • Vergewissern Sie sich, dass der Document-Skill des Dokuments mit dem in Map Fields konfigurierten übereinstimmt. Verwenden Sie die Eigenschaft ClassName des DocumentResult, um den Dokumenttyp zu identifizieren.
  • Damit ClassName ausgefüllt wird, konfigurieren Sie in der Extract-Aktivität des Process-Skills die Zuordnung von Klassen zu Skills — der Klassenname muss dem Namen des Document-Skills entsprechen.
Weitere Informationen zum Einrichten der Extract-Aktivität finden Sie unter Map Document skills to classes. Um ABBYY Vantage-Felder UiPath-Variablen zuzuordnen:
1

Die Aktivität Map Fields öffnen

Öffnen Sie die Aktivität Map Fields im Bereich Designer und klicken Sie auf die Schaltfläche rechts neben der Dropdown-Liste unter Skill Name, um eine Liste der verfügbaren Skills abzurufen.
2

Einen Document-Skill auswählen

Erweitern Sie die Dropdown-Liste Skill Name und wählen Sie den Document-Skill aus, dessen extrahierte Feldwerte in UiPath-Variablen gespeichert werden sollen.
Sie können nur einen Document-Skill auswählen.
3

Die Feldstruktur aktualisieren

Klicken Sie auf die Schaltfläche Refresh. In der Spalte Vantage Extracted Field wird eine Feldstruktur angezeigt.
4

Ein Feld einer UiPath-Variablen zuordnen

Erweitern Sie die Struktur und klicken Sie neben dem Feld, das Sie zuordnen möchten, auf die Schaltfläche Plus. In der Spalte UiPath Variable werden dann ein UiPath-Variablenname und der zugehörige Typ angezeigt. Standardmäßig ist der Name der Variablen derselbe wie der Name des Vantage-Felds, Sie können diesen Namen jedoch bei Bedarf ändern.
Stellen Sie sicher, dass die in der Aktivität Map Fields angegebenen UiPath-Variablennamen mit der in Ihrem UiPath-Prozess konfigurierten Benennungskonvention für Variablen übereinstimmen. Wenn Variablennamen nicht den Benennungsregeln entsprechen, werden sie in der UiPath-Variablenliste mit einem Warnsymbol angezeigt. Weitere Informationen zur Benennungskonvention für Variablen finden Sie in der UiPath-Dokumentation.
Aktivität Map Fields mit der Feldstruktur Vantage Extracted Field und der Spalte UiPath Variable
5

Die übrigen Felder zuordnen

Wiederholen Sie den vorherigen Schritt für die anderen Felder, die Sie zuordnen müssen. Sie können bereits vorhandene UiPath-Variablen angeben. Stellen Sie in diesem Fall sicher, dass der Typ Ihrer Variablen dem in der folgenden Tabelle empfohlenen Typ entspricht.
6

Die Zuordnung anwenden

Nachdem Sie Ihre Dokumentfelder UiPath-Variablen zugeordnet haben, klicken Sie auf Apply, um die Änderungen zu speichern. Wenn die Aktivität Map Fields nun zur Laufzeit aufgerufen wird, werden die Variablenwerte mit den extrahierten Daten gefüllt.
Die angegebenen UiPath-Variablen werden in der Sequence erstellt, die der Aktivität Map Fields am nächsten liegt (zum Beispiel in Flowchart).
Der Parameter Skill Name akzeptiert eine UiPath-Variable vom Typ String. Wenn Sie einen Document-Skill aus der Dropdown-Liste auswählen, wird der neue Wert in die Variable geschrieben. Ausdrücke und Verweise auf andere Variablen werden nicht unterstützt.
Die folgende Tabelle zeigt, welcher Typ von UiPath-Variable welchem ABBYY Vantage-Feldtyp entspricht:
ABBYY Vantage Field TypeUiPath Variable Type
TextString
DateString
NumberString
MoneyString
BarcodeString
CheckmarkBoolean
Checkmark group (kann als separate Checkmarks abgerufen werden)FieldList
GroupFieldList
Group (für wiederholbare Gruppen)FieldList[]
TableFieldList[]
Sich wiederholende Blattelemente (wie Text) und Tabellenspalten werden String[] zugeordnet. Wiederholbare Gruppen — auch solche, die in andere wiederholbare Gruppen verschachtelt sind — werden FieldList[] zugeordnet. Innerhalb einer wiederholbaren Gruppe können Sie auch einzelne untergeordnete Felder einfachen Typen zuordnen.
Aktivität Map Fields mit dem Baum Vantage Extracted Field und der Spalte UiPath Variable mit zugeordneten Gruppen und wiederholbaren Feldern

GroupItem

GroupItem ist eine Struktur, die eine Instanz eines sich wiederholenden Objekts (eines Felds oder einer Feldgruppe) enthält.
Method/PropertyParameterTypeDescription
KeysIEnumerable<string>Schlüsselwerte. Jeder Wert ist der Name einer bestimmten Verschachtelungsebene.
ValuesIEnumerable<IReadOnlyList<FieldList>>Menge der Feldwerte der Verschachtelungsebenen.
CountIntegerAnzahl der verschachtelten Felder.
ContainsKeyKey: StringBooleanGibt an, ob ein verschachteltes Feld vorhanden ist.
TryGetValueKey: String, Value: IReadOnlyList<FieldList>BooleanGibt an, ob ein Wert vorhanden ist. Wenn ein Wert vorhanden ist, werden True und der Wert zurückgegeben, andernfalls False.
this[]Name: StringIReadOnlyList<FieldList>Gibt den Wert des angegebenen verschachtelten Felds zurück.
FindName: StringIEnumerable<FieldList>Findet alle verschachtelten Felder auf beliebiger Verschachtelungsebene mit dem angegebenen Namen.
FilterPredicate: (Name: String, Node: FieldList) => BooleanIEnumerable<FieldList>Findet alle verschachtelten Felder auf beliebiger Verschachtelungsebene, die das Prädikat erfüllen.
DescendentsNameItems: Params String[]IEnumerable<FieldList>Findet alle verschachtelten Felder auf beliebiger Verschachtelungsebene, deren Name mit dem Parameter nameItems übereinstimmt.

FieldList

FieldList ist eine Struktur, die einem Feld oder einer Feldgruppe entspricht (Wiederholungsfelder oder wiederholbare Gruppen mit demselben Namen) und die Werte der Felder oder Gruppen enthält (mehrere Instanzen sind möglich).
Method/PropertyParameterTypeDescription
ValuesIEnumerable<Object>Menge skalarer Feldwerte.
CountIntegerAnzahl der verschachtelten GroupItem.
FindName: StringIEnumerable<FieldList>Findet alle verschachtelten Felder auf beliebiger Verschachtelungsebene mit dem angegebenen Namen.
FilterPredicate: (Name: String, Node: FieldList) => BooleanIEnumerable<FieldList>Findet alle verschachtelten Felder auf beliebiger Verschachtelungsebene, die das Prädikat erfüllen.
this[]Num: IntegerGroupItemGibt das GroupItem mit verschachtelten Feldern (falls vorhanden) an der durch den Parameter num angegebenen Position zurück.
Der Sample Process enthält ein Beispiel für die Verwendung einer Variablen vom Typ FieldList[] (die Spalte Description der Tabelle LineItems wird in den Protokollmeldungen angezeigt).
Weitere Informationen zum Feldtyp Group finden Sie unter Group field.

Vantage Scope Activity

Übergeben Sie die ABBYY Vantage-Verbindungseinstellungen an verschachtelte Vantage-Aktivitäten.

Use-Skill-Aktivität

Erstellen Sie einen Vantage-Vorgang, um ein Dokument mit einem Skill zu verarbeiten.

Get Results activity

Rufen Sie die Verarbeitungsergebnisse aus ABBYY Vantage ab.