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

# Aktivität Map Fields

> Aktivität Map Fields bindet von ABBYY Vantage extrahierte Feldwerte an UiPath-Variablen, mit Typzuordnungen für Text, Datumswerte, Häkchen, Gruppen und Tabellen.

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

<div id="activity-properties">
  ## Aktivitätseigenschaften
</div>

| Gruppe              | Eigenschaft    | Typ      | Beschreibung                                                                                                                                                                                                                                                                                                  |
| ------------------- | -------------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Connection Settings | Skill Name     | `String` | Der Name des Vantage Document-Skills.                                                                                                                                                                                                                                                                         |
| Input               | Extracted Data | `String` | Akzeptiert 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. |

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

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](/de/vantage/connectors/uipath/activities/vantage-scope).

<div id="before-you-map">
  ### Bevor Sie Felder zuordnen
</div>

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](/de/vantage/documentation/skill-designer/process/extract-activity).

Um ABBYY Vantage-Felder UiPath-Variablen zuzuordnen:

<Steps>
  <Step title="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.
  </Step>

  <Step title="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.

    <Note>
      Sie können nur einen Document-Skill auswählen.
    </Note>
  </Step>

  <Step title="Die Feldstruktur aktualisieren">
    Klicken Sie auf die Schaltfläche **Refresh**. In der Spalte **Vantage Extracted Field** wird eine Feldstruktur angezeigt.
  </Step>

  <Step title="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.

    <Warning>
      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](https://docs.uipath.com/).
    </Warning>

    <Frame>
      <img src="https://mintcdn.com/abbyy/Km9nwnkPeY8_wARd/images/vantage/developer/connectors/uipath/map-fields-activity.jpg?fit=max&auto=format&n=Km9nwnkPeY8_wARd&q=85&s=76f740256ad1baec40fdc56c7faebec7" alt="Aktivität Map Fields mit der Feldstruktur Vantage Extracted Field und der Spalte UiPath Variable" width="1102" height="1346" data-path="images/vantage/developer/connectors/uipath/map-fields-activity.jpg" />
    </Frame>
  </Step>

  <Step title="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.
  </Step>

  <Step title="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.
  </Step>
</Steps>

<Note>
  Die angegebenen UiPath-Variablen werden in der Sequence erstellt, die der Aktivität Map Fields am nächsten liegt (zum Beispiel in Flowchart).
</Note>

<Note>
  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.
</Note>

<div id="field-type-mapping">
  ## Zuordnung von Feldtypen
</div>

Die folgende Tabelle zeigt, welchem Typ von UiPath-Variable die einzelnen ABBYY Vantage-Feldtypen entsprechen:

| ABBYY Vantage Field Type                                        | UiPath Variable Type |
| --------------------------------------------------------------- | -------------------- |
| Text                                                            | `String`             |
| Date                                                            | `String`             |
| Number                                                          | `String`             |
| Money                                                           | `String`             |
| Barcode                                                         | `String`             |
| Checkmark                                                       | `Boolean`            |
| Checkmark group (kann als separate Checkmarks abgerufen werden) | `FieldList`          |
| Group                                                           | `FieldList`          |
| Group (für wiederholbare Gruppen)                               | `FieldList[]`        |
| Table                                                           | `FieldList[]`        |

<Note>
  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.
</Note>

<Frame>
  <img src="https://mintcdn.com/abbyy/Km9nwnkPeY8_wARd/images/vantage/developer/connectors/uipath/map-fields-groups.jpg?fit=max&auto=format&n=Km9nwnkPeY8_wARd&q=85&s=103c1a0f62e25c81d3636f855b18813b" alt="Aktivität Map Fields mit dem Baum Vantage Extracted Field und der Spalte UiPath Variable mit zugeordneten Gruppen und wiederholbaren Feldern" width="1308" height="920" data-path="images/vantage/developer/connectors/uipath/map-fields-groups.jpg" />
</Frame>

<div id="groupitem">
  ### GroupItem
</div>

`GroupItem` ist eine Struktur, die eine Instanz eines sich wiederholenden Objekts (eines Felds oder einer Feldgruppe) enthält.

| Method/Property | Parameter                                               | Type                                    | Description                                                                                                                      |
| --------------- | ------------------------------------------------------- | --------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------- |
| Keys            |                                                         | `IEnumerable<string>`                   | Schlüsselwerte. Jeder Wert ist der Name einer bestimmten Verschachtelungsebene.                                                  |
| Values          |                                                         | `IEnumerable<IReadOnlyList<FieldList>>` | Menge der Feldwerte der Verschachtelungsebenen.                                                                                  |
| Count           |                                                         | `Integer`                               | Anzahl der verschachtelten Felder.                                                                                               |
| ContainsKey     | `Key: String`                                           | `Boolean`                               | Gibt an, ob ein verschachteltes Feld vorhanden ist.                                                                              |
| TryGetValue     | `Key: String, Value: IReadOnlyList<FieldList>`          | `Boolean`                               | Gibt an, ob ein Wert vorhanden ist. Wenn ein Wert vorhanden ist, werden `True` und der Wert zurückgegeben, andernfalls `False`.  |
| this\[]         | `Name: String`                                          | `IReadOnlyList<FieldList>`              | Gibt den Wert des angegebenen verschachtelten Felds zurück.                                                                      |
| Find            | `Name: String`                                          | `IEnumerable<FieldList>`                | Findet alle verschachtelten Felder auf beliebiger Verschachtelungsebene mit dem angegebenen Namen.                               |
| Filter          | `Predicate: (Name: String, Node: FieldList) => Boolean` | `IEnumerable<FieldList>`                | Findet alle verschachtelten Felder auf beliebiger Verschachtelungsebene, die das Prädikat erfüllen.                              |
| Descendents     | `NameItems: Params String[]`                            | `IEnumerable<FieldList>`                | Findet alle verschachtelten Felder auf beliebiger Verschachtelungsebene, deren Name mit dem Parameter `nameItems` übereinstimmt. |

<div id="fieldlist">
  ### FieldList
</div>

`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/Property | Parameter                                               | Type                     | Description                                                                                                                      |
| --------------- | ------------------------------------------------------- | ------------------------ | -------------------------------------------------------------------------------------------------------------------------------- |
| Values          |                                                         | `IEnumerable<Object>`    | Menge skalarer Feldwerte.                                                                                                        |
| Count           |                                                         | `Integer`                | Anzahl der verschachtelten `GroupItem`.                                                                                          |
| Find            | `Name: String`                                          | `IEnumerable<FieldList>` | Findet alle verschachtelten Felder auf beliebiger Verschachtelungsebene mit dem angegebenen Namen.                               |
| Filter          | `Predicate: (Name: String, Node: FieldList) => Boolean` | `IEnumerable<FieldList>` | Findet alle verschachtelten Felder auf beliebiger Verschachtelungsebene, die das Prädikat erfüllen.                              |
| this\[]         | `Num: Integer`                                          | `GroupItem`              | Gibt das `GroupItem` mit verschachtelten Feldern (falls vorhanden) an der durch den Parameter `num` angegebenen Position zurück. |

<Tip>
  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).
</Tip>

Weitere Informationen zum Feldtyp Group finden Sie unter [Group field](/de/vantage/documentation/skill-designer/document/adding-fields/group).

<div id="related-topics">
  ## Verwandte Themen
</div>

<CardGroup cols={3}>
  <Card title="Vantage Scope Activity" icon="cube" href="/de/vantage/connectors/uipath/activities/vantage-scope">
    Übergeben Sie die ABBYY Vantage-Verbindungseinstellungen an verschachtelte Vantage-Aktivitäten.
  </Card>

  <Card title="Use-Skill-Aktivität" icon="play" href="/de/vantage/connectors/uipath/activities/use-skill">
    Erstellen Sie einen Vantage-Vorgang, um ein Dokument mit einem Skill zu verarbeiten.
  </Card>

  <Card title="Get Results activity" icon="circle-down" href="/de/vantage/connectors/uipath/activities/get-results">
    Rufen Sie die Verarbeitungsergebnisse aus ABBYY Vantage ab.
  </Card>
</CardGroup>