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

# Benutzerdefinierte Aktivität

> Die benutzerdefinierte Aktivität ermöglicht die Nutzung von Drittanbieter-Tools, die in Vantage nicht verfügbar sind, sowie das Ausführen zusätzlicher Aktionen an Dokumenten, die während der Skill-Verarbeitung empfangen werden.

Eine **benutzerdefinierte** Aktivität sammelt Informationen zu den Dokumenten im Vorgang und sendet diese per HTTP-Anfrage an ein externes System. Die Antwort wird verarbeitet und in den Vorgangsdaten gespeichert. Sie können eines oder alle Dokumente des Vorgangs in einer einzigen Anfrage übermitteln.

<Warning>
  Die benutzerdefinierte Aktivität erfordert ein SSL-Zertifikat der [Sicherheitsstufe 2](https://www.openssl.org/docs/man1.1.1/man3/SSL_CTX_set_security_level.html#DEFAULT-CALLBACK-BEHAVIOUR), um eine sichere Verbindung zu verifizieren. Wenn Ihr Server eine niedrigere Sicherheitsstufe bietet, kann die benutzerdefinierte Aktivität keine Anfragen an ihn senden.
</Warning>

<Note>
  Platzieren Sie eine benutzerdefinierte Aktivität in einer [For Each Document](/de/vantage/documentation/skill-designer/process/for-each)-Aktivität, um jedes Dokument separat zu verarbeiten — die benutzerdefinierte Aktivität hat dann jeweils nur Zugriff auf ein Dokument.
</Note>

<div id="set-up-a-custom-activity">
  ## Eine benutzerdefinierte Aktivität einrichten
</div>

<Steps>
  <Step title="Aktivität hinzufügen">
    Fügen Sie im Designer des Process-Skills dem Dokumentverarbeitungs-Workflow einen **benutzerdefinierte**-Aktivitätsblock hinzu.
  </Step>

  <Step title="Aktivitätseinstellungen öffnen">
    Klicken Sie im Bereich **Actions** auf **Edit Activity**.
  </Step>

  <Step title="Verfügbare Dateien auswählen">
    Wählen Sie auf der Registerkarte **Available Files** die Formate für Text, Dokumentfelder und Bilder aus, die an das externe System gesendet werden sollen. Sie müssen für jeden Typ mindestens ein Format auswählen.
  </Step>

  <Step title="Skript schreiben">
    Konfigurieren Sie auf der Registerkarte **Activity Script** Ihr Skript und klicken Sie auf **Save**.
  </Step>
</Steps>

Eine ausführliche Beschreibung der Objekte, die Sie in Skripten verwenden können, finden Sie unter [Objektmodell](/de/vantage/documentation/skill-designer/process/custom-activity/object-model). Beispiele finden Sie unter [Beispielskripte](/de/vantage/documentation/skill-designer/process/custom-activity/sample-scripts).

<div id="verify-the-custom-activity">
  ## Die benutzerdefinierte Aktivität überprüfen
</div>

<Steps>
  <Step title="Skill veröffentlichen">
    Klicken Sie auf die Registerkarte **Publish**, geben Sie einen Namen, eine Beschreibung und eine Änderungsbeschreibung ein und klicken Sie dann auf **Publish Skill**.
  </Step>

  <Step title="Workflow ausführen">
    Verarbeiten Sie Dokumente mit dem Workflow, in dem die benutzerdefinierte Aktivität verwendet wird.
  </Step>

  <Step title="Ergebnisse in Skill Monitor prüfen">
    Prüfen Sie die Ergebnisse des Skills in Skill Monitor. Wenn im Skript ein Fehler aufgetreten ist, wird der Vorgang unterbrochen und der Fehler im **Transaction-Ereignisprotokoll** angezeigt. Wenn Sie [`LogMessage`](/de/vantage/documentation/skill-designer/process/custom-activity/context) verwendet haben, um benutzerdefinierte Protokolleinträge hinzuzufügen, werden diese ebenfalls im Transaction-Ereignisprotokoll angezeigt.
  </Step>
</Steps>

<div id="deprecated-interfaces">
  ## Veraltete Schnittstellen
</div>

<Warning>
  Die benutzerdefinierte Aktivität wurde aktualisiert. Ältere Skripte funktionieren weiterhin und haben Zugriff auf alle Dokumente in einem Vorgang, aber die unten aufgeführten veralteten Schnittstellen haben nur Zugriff auf das erste Dokument eines Vorgangs.
</Warning>

| Veraltetes Objekt                                                                                  | Ersatz                                                                                                |
| :------------------------------------------------------------------------------------------------- | :---------------------------------------------------------------------------------------------------- |
| [InputData](/de/vantage/documentation/skill-designer/process/custom-activity/input-data)           | [Transaction.Documents](/de/vantage/documentation/skill-designer/process/custom-activity/transaction) |
| [OutputData](/de/vantage/documentation/skill-designer/process/custom-activity/output-data)         | [Transaction.Documents](/de/vantage/documentation/skill-designer/process/custom-activity/transaction) |
| [ExtractedData](/de/vantage/documentation/skill-designer/process/custom-activity/extracted-data)   | [Document](/de/vantage/documentation/skill-designer/process/custom-activity/document)                 |
| [ExtractedField](/de/vantage/documentation/skill-designer/process/custom-activity/extracted-field) | [Field](/de/vantage/documentation/skill-designer/process/custom-activity/field)                       |
| [FieldType](/de/vantage/documentation/skill-designer/process/custom-activity/field-type)           | [FieldOcrType](/de/vantage/documentation/skill-designer/process/custom-activity/field-ocr-type)       |

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

* [Objektmodell](/de/vantage/documentation/skill-designer/process/custom-activity/object-model)
* [Beispielskripte](/de/vantage/documentation/skill-designer/process/custom-activity/sample-scripts)
* [For Each Document-Aktivität](/de/vantage/documentation/skill-designer/process/for-each)
* [Process-Skill einrichten](/de/vantage/documentation/skill-designer/process/set-up)
* [Vorgänge im Skill Monitor](/de/vantage/documentation/runtime/skill-monitor/transactions)