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

# Tool Use Skill

> Use Skill erstellt ABBYY Vantage-Vorgänge zur Dokumentverarbeitung und gibt Vorgangs-IDs für nachgelagerte Werkzeuge zurück.

Das Tool **Use Skill** erstellt Vorgänge zur Verarbeitung von Dokumenten mit einem ABBYY Vantage-Skill. Es ist üblicherweise das erste Vantage-Werkzeug in einem Alteryx-Workflow.

Das Werkzeug unterstützt zwei Modi, je nachdem, welche Spalte an seinen **Input**-Anker übergeben wird:

* **DirectoryPath-Modus** – Übergeben Sie den Pfad eines Ordners, der die Eingabedateien enthält. Für alle Dateien, die direkt in diesem Ordner liegen, erstellt das Werkzeug einen Vorgang in ABBYY Vantage. Übergeben Sie mehrere Zeilen, um für jeden Ordner einen separaten Vorgang zu erstellen.
* **Files-Modus** – Übergeben Sie die Pfade einzelner Dateien und deren Parameter. In diesem Modus können Sie für jedes Dokument im Vorgang separate Dateiparameter festlegen.

<div id="connection-settings">
  ## Verbindungseinstellungen
</div>

Das Tool **Use Skill** enthält die unter [Verbindung konfigurieren](/de/vantage/connectors/alteryx/setup#configure-the-connection) beschriebenen Verbindungseinstellungen sowie zusätzlich die Einstellung **Vantage Skill**, mit der Sie den Skill für die Dokumentenverarbeitung auswählen.

<div id="input-anchor">
  ## Input-Anker
</div>

| Spalte                              | Typ        | Beschreibung                                                                                           |
| ----------------------------------- | ---------- | ------------------------------------------------------------------------------------------------------ |
| DirectoryPath                       | V\_WString | Der Speicherort des Ordners, der die Datei(en) enthält, die Sie als einen Vorgang verarbeiten möchten. |
| Files                               | V\_WString | Der Speicherort der Datei(en), die Sie verarbeiten möchten, sowie deren Parameter.                     |
| Transaction Registration Parameters | V\_WString | Ein Satz von Vorgangs-Registrierungsparametern. Diese Spalte ist optional.                             |

<div id="directorypath-mode">
  ### DirectoryPath-Modus
</div>

Geben Sie in der Spalte **DirectoryPath** einen Ordnerpfad an. Alle Dateien, die direkt im angegebenen Ordner liegen, werden dem Vorgang als eine Gruppe hinzugefügt. Dateien in Unterordnern werden nicht berücksichtigt.

Übergeben Sie mehrere Zeilen, um für jeden Ordner einen separaten Vorgang zu erstellen:

<Frame>
  <img src="https://mintcdn.com/abbyy/GYXzQ7h3X_sAg5P7/images/vantage/developer/connectors/alteryx/use-skill-directory-path-input.png?fit=max&auto=format&n=GYXzQ7h3X_sAg5P7&q=85&s=30e3a667bc8ff9d27a9bcd805bb88158" alt="Eingabetabelle von Use Skill mit zwei Zeilen und den DirectoryPath-Werten C:\Temp\Input und C:\Temp\Input2" width="193" height="60" data-path="images/vantage/developer/connectors/alteryx/use-skill-directory-path-input.png" />
</Frame>

<div id="files-mode">
  ### Files-Modus
</div>

Übergeben Sie Dateipfade und Parameter in der Spalte **Files** im folgenden Format:

```text theme={null}
File="<absolute filepath>";<FileParamName>="<file parameter value>"
```

Das Semikolon (`;`) dient als Trennzeichen zwischen verschiedenen Dateien sowie zwischen Dateien und ihren Parametern. Verwenden Sie `FileParamName`, um einen benannten Dateiparameter für das Document festzulegen.

Um beispielsweise `Invoice_01.tif` und `Invoice_02.tif` mit jeweils den Parametern **Created** und **Size** zu einem Vorgang hinzuzufügen:

<Frame>
  <img src="https://mintcdn.com/abbyy/GYXzQ7h3X_sAg5P7/images/vantage/developer/connectors/alteryx/use-skill-files-input.png?fit=max&auto=format&n=GYXzQ7h3X_sAg5P7&q=85&s=3c7ca70ee2c54daefe186aeb9d76f3b6" alt="Eingabe der Spalte Use Skill Files mit einer einzelnen Zeile, zwei Dateipfaden und deren Parametern Created und Size" width="831" height="46" data-path="images/vantage/developer/connectors/alteryx/use-skill-files-input.png" />
</Frame>

<Warning>
  Verwenden Sie in Dateipfaden oder in Werten von Registrierungsparametern nicht die Zeichen `=` oder `;`, da diese Zeichen standardmäßig als Trennzeichen fungieren.
</Warning>

<div id="transaction-registration-parameters">
  ### Vorgangs-Registrierungsparameter
</div>

Übergeben Sie Parameter auf Vorgangsebene in der Spalte **Vorgangs-Registrierungsparameter** im folgenden Format:

```text theme={null}
TransactionParamName="transaction parameter value"
```

Trennen Sie mehrere Parameter durch ein Semikolon (`;`). Um beispielsweise den source type und den Computernamen zu übergeben:

<Frame>
  <img src="https://mintcdn.com/abbyy/GYXzQ7h3X_sAg5P7/images/vantage/developer/connectors/alteryx/use-skill-registration-params-input.png?fit=max&auto=format&n=GYXzQ7h3X_sAg5P7&q=85&s=77f2dbb14cd794492560862a0a2375cb" alt="Eingabetabelle von Use Skill mit den Spalten DirectoryPath und TransactionRegistrationParameters, die die Werte SourceType und PCname zeigt" width="449" height="138" data-path="images/vantage/developer/connectors/alteryx/use-skill-registration-params-input.png" />
</Frame>

Die Vorgangs-Registrierungsparameter von Vorgängen und Dateien werden im Vantage Skill Monitor angezeigt und in die exportierte JSON-Datei übernommen:

<Frame>
  <img src="https://mintcdn.com/abbyy/GYXzQ7h3X_sAg5P7/images/vantage/developer/connectors/alteryx/use-skill-json-params.png?fit=max&auto=format&n=GYXzQ7h3X_sAg5P7&q=85&s=421473524f4afc17d9de0474d9cf6fe6" alt="JSON-Ausgabe mit CreationTime, SourceFiles mit Id und Name der Datei, RegistrationParameters mit SourceType und PCname sowie dem Feld Version" width="671" height="235" data-path="images/vantage/developer/connectors/alteryx/use-skill-json-params.png" />
</Frame>

<div id="output-anchor">
  ## Ausgabeanker
</div>

| Column        | Type       | Description                                                                                                                                                                      |
| ------------- | ---------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| TransactionId | V\_WString | Der Bezeichner des erstellten Vorgangs. Diese ID wird an die Tools **Get Status** und **Get Result** übergeben, um den Vorgangsstatus und die Verarbeitungsergebnisse abzurufen. |
| isSuccess     | Bool       | Gibt an, ob der Vorgang erfolgreich erstellt wurde.                                                                                                                              |
| Error         | V\_WString | Gibt die Fehlermeldung an, die beim Erstellen eines Vorgangs aufgetreten ist.                                                                                                    |

Beispiel für die Ausgabe:

<Frame>
  <img src="https://mintcdn.com/abbyy/GYXzQ7h3X_sAg5P7/images/vantage/developer/connectors/alteryx/use-skill-output-example.png?fit=max&auto=format&n=GYXzQ7h3X_sAg5P7&q=85&s=d76126f3002f8673bf8173da283c4891" alt="Ausgabetabelle von Use Skill mit zwei Zeilen, die TransactionId-GUIDs, IsSuccess True und Error Null zeigen" width="477" height="58" data-path="images/vantage/developer/connectors/alteryx/use-skill-output-example.png" />
</Frame>

<Note>
  ABBYY Vantage erlaubt das Hochladen von Vorgängen mit einer Größe von bis zu 2 GB. Um die Dokumentverarbeitung zu beschleunigen, sollten einzelne Dateien maximal 30 MB groß sein.
</Note>

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

* [Tool „Get Status“](/de/vantage/connectors/alteryx/tools/get-status)
* [Tool „Get Result“](/de/vantage/connectors/alteryx/tools/get-result)
* [Tool „Parse Fields“](/de/vantage/connectors/alteryx/tools/parse-fields)
