REST API

Mantiseinträge

 3212

Systemtyp

 69 

Eintrittsinvarianz

JA

Beschreibung

OJOHZDORestApi

Stellt eine Verbindung zu einer WEB-Dienst API (http(s) Verbindung zu einer externen Plattform) eines Anbieters (Provider) her, und führt von der API zur verfügung gestellte Befehle aus.

Damit können z.B.:

• Dateien hochgeladen werden
• Daten (Metadaten) übermittelt werden
• Externe Prozesse verfolgt oder gesteuert werden

Zugehöriger Arbeitsschritt

Quittierung - Warten Schritt, welcher auf eine Bestätigung der Gegenstelle wartet. z.B. wenn alle Metadaten bereistehen.

Konfiguration

Das Konfigurationsfenster besteht jeweils aus zwei Teilen:

• Auswahl und Konfiguration des API Anbieter
• Auswahl und Konfiguration eines verfügbaren API Befehls

Die Konfiguration ist je nach Anbieter unterschiedlich. In der Regel verlangt jeder Anbieter eine Authentifizierung und Authorisierung. Dies wird meistens in Form einers API-Keys (Token) gehandhabt.

Ein Wechsel zwischen Anbieter und/oder Befehlen hat die Löschung der aktuellen Konfiguration zur Folge und muss deshalb zusätzlich bestätigt werden.

Verfügbare Anbieter

Parashift

API Konfiguration

Die API verlangt aktuell nur nach einem API Key. Dieser ist in das entsprechende Feld einzugeben und muss beim API Provider erstellt werden.

API Befehle

Dokumente upload

Lädt Dateien zu einem Parashift Workflow hoch. Bei PDF Dateien können zusätzlich die zu berücksichtigenden Seitenzahlen angegeben werden.

Felder:

Interne ID - Helper Objektidentifikation, Standart = DO_SEQ. Verwendet Platzhalter, erlaub sind [DOSEQ], [DOSIGNATUR].

Objektname - Der Name für das Objekt, wird auf der Parashift Webseite entsprechend zur identifikation verwendet. Verwendet Platzhalter, erlaub sind [DOSEQ], [DOSIGNATUR] und [FILENAME]

Klassifizierungsscope - Weist ein Objekt direkt einer Klassifizierung zu. Überspringt die Erkennung des Dokumentetyps auf der Gegenseite. Ist der Scope bekannt, sollte das Feld entsprechend gefüllt werden. Erlaubt die Angabe mehrerer möglicher Scopes als Kommagetrennte Werte (e.g.: Einwohnerkarten, Haustierkarten, XYKarten)

Upload Konfiguration - Ist auf der Gegenstelle im Web-UI für den entsprechenden Workflow / Projekte zu Konfigurieren. Standard=client

Validierung erforderlich - Standard = nein. Gibt an, ob Objekte bei der Verarbeitung zusätzlich manuell validiert werden müssen.

Nicht für Training verwenden - Standard = ja. Gibt an, ob das Objekt für das Training des Erkennungsalgorhytmus verwendet werden soll.

Seitennummer(n) - Kommagetrennte Liste mit den zu berücksichtigenden Seitennummern. Standard = leer (alle Seiten senden)

Metadaten abholen

Holt die bei Parashift ermittelten Metadaten ab und speichert diese in den zugehörigen Attributen.

Varianten:

Standard: Provider ID - Verwendet zum finden des zugehörigen Dokuments die Dokumente ID der Gegenstelle (Feld = DO_ISQ)

Helper ID - Verwendet zum finden des zugehörigen Dokuments die Objekt ID aus dem Helper (Feld = DO_SEQ)

Konfiguration:

Für jedes zu importierende Metadatum muss eine Zeile in der Tabelle erstellt werden, welches den Attributsnamen im Helper mit dem Attributsnamen der Gegenstelle mapped. Gross-Kleinschreibung beachten!

Wird die Option "Ist Pflicht" ausgewählt, dann darf das empfangene Attribut nicht leer sein. Die Objekte gehen sonst in Fehlerstatus.