Skip to main content
Map Fields ist in der Regel die letzte Vantage-Aktivität in einem UiPath-Workflow. Sie übernimmt die Extracted Data aus Get Results und bindet einzelne Felder an UiPath-Variablen, die nachfolgende Aktivitäten verwenden können. Sie definieren die Zuordnung im Designer-Bereich.

​
Aktivitätseigenschaften

​
Felder UiPath-Variablen zuordnen

Die Aktivität Map Fields kann nur innerhalb einer konfigurierten Vantage Scope Activity verwendet werden.

​
Bevor Sie Felder zuordnen

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, führen Sie die folgenden Prüfungen durch:
  • 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.

​
Felder zuordnen

1

Die Anmeldedaten festlegen

Legen Sie in der Aktivität Vantage Scope je nach Ihrem Authentifizierungsablauf die Eigenschaft Password oder Client Secret fest. Dadurch kann der Connector die Skill-Liste abrufen. Sobald der Workflow konfiguriert ist, wechseln Sie zur Eigenschaft Secure Password oder Secure Client Secret. Weitere Informationen finden Sie unter Vantage Scope activity.
2

Die verfügbaren Skills laden

Öffnen Sie die Aktivität Map Fields im Bereich Designer. Klicken Sie auf die Schaltfläche rechts neben der Dropdown-Liste Skill Name.
3

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.
4

Die Feldstruktur aktualisieren

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

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
6

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 Tabelle Zuordnung von Feldtypen empfohlenen Typ entspricht.
7

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 einem 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.

​
Zuordnung von Feldtypen

Die folgende Tabelle zeigt, welchem Typ von UiPath-Variable die einzelnen ABBYY Vantage-Feldtypen entsprechen:
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.

​
FieldList

FieldList ist eine Struktur, die einem Feld oder einer Feldgruppe entspricht (Wiederholungsfelder oder wiederholbare Gruppen mit demselben Namen). Sie enthält die Werte dieser Felder oder Gruppen, und mehrere Instanzen sind möglich.
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.