Zum Hauptinhalt springen
ABBYY Vantage ermöglicht das Hochladen von Dokumenten aus freigegebenen Ordnern, die auf dem Vantage-Server bereitgestellt werden. Der Zugriff auf den Ordner erfolgt über das SFTP-Protokoll. Die Zugriffsdaten für den erstellten Ordner (z. B. Links zu den Import- und Ausnahmeordnern sowie der Benutzername und das Passwort für den Zugriff auf die Ordner) werden im Dialogfeld Input Settings: Shared Folder angezeigt.
Wichtig! Um Dateien in den freigegebenen Eingabeordner hochzuladen, muss im SFTP-Client der Übertragungsmodus „Binär“ verwendet werden.

Benutzerzugriffsrechte

OrdnerVerfügbare Benutzeraktionen
Importordner- Liste der Dateien und Ordner anzeigen
- Dateien in den Ordner hochladen
- Dateien und Ordner umbenennen
- Beim Hochladen vorhandene Dateien überschreiben
- Dateien löschen
Ordner für Ausnahmen- Liste der Dateien und Ordner anzeigen
- Dateien aus dem Ordner herunterladen
- Dateien und Ordner umbenennen
- Dateien löschen

Dokumentverarbeitung

Sobald die Skill veröffentlicht wurde, beginnt ABBYY Vantage alle 20 Sekunden, den Ordner auf neue Dateien zu prüfen.
Hinweis: Der Import-Agent kann maximal 30 Dateien auf einmal verarbeiten. Wenn das Hochladen in den SFTP-Ordner zum Engpass wird, sollten Sie zwei Skills erstellen, jeweils mit einem eigenen SFTP-Ordner. So können zwei Agenten Dateien gleichzeitig abholen.

Registrierungsparameter für Dokumente

Der Quelltyp (FolderImport) und der Quelldateiname werden in den Dokument-Registrierungsparametern SourceType und SourceFileName gespeichert. Sie können auf die Werte dieser Parameter zugreifen, wenn Sie die entsprechenden Spalten im Bereich Transactions des Skill Monitor hinzufügen. Außerdem werden sie in die Ausgabe-JSON-Datei exportiert, die die vollständigen Extraktionsergebnisse enthält und in der Output-Aktivität im Abschnitt Exported Data konfiguriert werden kann.
Hinweis: Die folgenden Zeichen sind in Dateinamen nicht zulässig und werden beim Hochladen durch Unterstriche ersetzt: / : ? # [ ] @ ! $ & ' ( ) * + , ; = \. Die ursprünglichen Dateinamen werden in den Dokument-Registrierungsparametern gespeichert. Sie können sie mithilfe dieses Skripts abrufen.

Importergebnisse

Wenn die Datei erfolgreich importiert wurde, wird dafür ein Vorgang erstellt und die Datei anschließend aus dem Importordner gelöscht. Konnte die Datei nicht importiert werden und wurde kein Vorgang dafür erstellt, wird sie in den Ausnahmedordner mit dem Namen <Input folder name>-exception verschoben. Der Speicherort des Ausnahmedordners wird im Dialog Input Settings: Shared Folder angegeben. Die Aufbewahrungsdauer der Dateien im Ausnahmedordner wird durch die Aufbewahrungsrichtlinie festgelegt und beträgt standardmäßig 2 Wochen. Wenn sich eine Datei nicht mehr im Importordner befindet, aber keine Verarbeitungsergebnisse vorliegen, kann dies daran liegen, dass der Vorgang mit einem Fehler abgeschlossen wurde. Weitere Details zu Vorgangsfehlern finden Sie im Skill Monitor. Weitere Informationen finden Sie unter Skill Monitor Transactions Section.

Importieren von Archiven

Vantage kann Archive aus dem obersten Verzeichnis des freigegebenen Ordners importieren. Derzeit werden die folgenden Dateitypen unterstützt:
  • In Windows erstellte ZIP-Dateien,
  • In Linux mit dem Befehl tar czvf erstellte TAR GZ-Dateien.
Wichtig! Archive können nur importiert werden, wenn die Importmethode Single file ausgewählt ist.
Die Archivgröße ist auf 3 GB begrenzt. Die Größe jeder Datei im Archiv ist auf 100 MB begrenzt. Für jedes Archiv wird ein neuer Vorgang erstellt. Alle Dateien im Archiv werden dann zu Dokumenten dieses Vorgangs. Der Name des Archivs wird im Dokumentregistrierungs-Parameter SourceArchiveName gespeichert. Wenn der Archivtyp nicht unterstützt wird oder wenn das Archiv nicht unterstützte Dateitypen und/oder Archive enthält, schlägt der entsprechende Vorgang fehl. Wenn die Größenlimits verletzt werden oder das Archiv Unterordner enthält, wird das Archiv in den Ausnahmenordner verschoben und es wird kein Vorgang erstellt. Der zugehörige Fehler kann anschließend im Fehlerprotokoll eingesehen werden.

Import mehrerer Dateien in eine einzelne Transaction

Standardmäßig erstellt Vantage für jede aus dem freigegebenen Ordner importierte Datei eine separate Transaction. Sie können dieses Verhalten ändern, indem Sie die Import method auf From subfolder setzen. In diesem Modus prüft Vantage den freigegebenen Ordner auf Unterordner statt auf Dateien. Der Name des Unterordners sollte dem angegebenen Benennungsschema entsprechen. Wenn ein geeigneter Unterordner gefunden wird, werden alle darin enthaltenen Dateien, einschließlich der Dateien aus geschachtelten Ordnern, als Dokumente einer einzelnen Transaction importiert. Der Unterordnername wird im Dokument-Registrierungsparameter SourceFolderName jedes Dokuments gespeichert.
Hinweis: Wenn die Datei aus einem geschachtelten Ordner innerhalb eines Unterordners importiert wurde, enthält der Parameter SourceFolderName den Namen des Stamm-Unterordners.
Wenn der Unterordner nicht importiert werden konnte, wird er in den Ordner Exceptions verschoben. Vantage erstellt dafür keine Transaction und generiert einen Fehler, den Sie im Error Log des Skill Monitor-Dienstes einsehen können. Wenn der Unterordner Dateien in einem nicht unterstützten Format enthält, schlägt die entsprechende Transaction fehl.
Wichtig! Der Import von Archiven aus Unterordnern wird nicht unterstützt.
Ein leerer Unterordner mit einem Namen, der dem Benennungsschema entspricht, wird aus dem freigegebenen Ordner gelöscht. Vantage erstellt dafür jedoch keine Transaction und generiert eine Warnung, da keine Daten importiert werden konnten. Sie können diese Warnung im Error Log des Skill Monitor-Dienstes einsehen.

Benennungsschema für Unterordner

Ein Unterordner wird nur importiert, wenn sein Name dem Benennungsschema für Unterordner entspricht. Der Standardwert „*“ passt auf jede string. Sie können die Maske konfigurieren; das Symbol * dient dabei als Platzhalter für eine beliebige Anzahl von Zeichen. Das Zeichen „?“ wird nicht als Platzhalter für ein einzelnes Zeichen unterstützt. Die Maske unterscheidet nicht zwischen Groß- und Kleinschreibung: Namen wie „subfolder“ und „SUBFOLDER“ passen beide zur Maske „subfolder“. Die Maskenlänge ist auf 64 Zeichen begrenzt. Um mögliche Konflikte beim Dateizugriff zu vermeiden, kopieren Sie zunächst die Dateien in den Unterordner und benennen Sie den Unterordner anschließend gemäß dem Schema um.

Einrichten von Dokument-Uploads aus einem freigegebenen Ordner in ABBYY Vantage

  1. Klicken Sie mit der linken Maustaste auf den Aktivitätsblock Input in Ihrem Dokumentverarbeitungsfluss. Falls noch keiner im Skill Designer vorhanden ist, fügen Sie ihn über den Bereich Activities hinzu.
  2. Aktivieren Sie im Bereich Actions die Option Select additional source und wählen Sie Shared folder.
screen_Process_Input_SharedFolder_Settings
  1. Klicken Sie auf Settings. Daraufhin öffnet sich ein Dialogfeld mit den Zugriffsdaten für den freigegebenen Ordner.
screen_Process_Input_SharedFolder_Credentials_cloud Der vorgeschlagene Name des Importordners kann ebenfalls geändert werden.

Anforderungen an die Ordnerbenennung

Der Ordnername muss Folgendes erfüllen:
  • Muss innerhalb des Skills eindeutig sein (darf nicht mit dem Namen eines anderen gemeinsamen Ordners im Output-Aktivitätsblock übereinstimmen).
  • Muss mit einer Zahl oder einem Buchstaben beginnen.
  • Darf keine Sonderzeichen : * ? " < > / | \ oder Steuerzeichen enthalten (zum Beispiel Zeilenumbruch und Tabulator).
  • Darf nicht mit einem Punkt enden.
  • Darf nicht leer sein.
  • Darf 64 Zeichen nicht überschreiten.
  1. Falls erforderlich, ändern Sie die Importmethode auf Aus Unterordner und passen Sie das Benennungsschema für Unterordner an Ihre Anforderungen an (falls vorhanden).
  2. Richten Sie den Dateiimport in den Ordner über einen SFTP-Client mit den im Dialog Input Settings: Shared Folder bereitgestellten Anmeldedaten ein. Den Inhalt jedes Felds können Sie durch Klicken auf das Kopier-icon im entsprechenden Feld in die Zwischenablage kopieren. Der Ordnerlink enthält alle für das Einrichten einer Verbindung erforderlichen Daten. Das Einfügen des Links in den Einstellungsdialog des SFTP-Clients füllt die anderen Parameter automatisch aus.
  3. Schließen Sie das Dialogfeld, indem Sie entweder Save klicken, wenn Sie Ihre Änderungen speichern möchten, oder Cancel, wenn keine Änderungen gespeichert werden müssen.
Wichtig! Alle Änderungen an den Einstellungen treten erst in Kraft, nachdem Ihr Skill veröffentlicht wurde.

Zusätzliche Hinweise

Der Administrator kann den Skill Monitor-Dienst verwenden, um den Import von Dokumenten zu deaktivieren. Weitere Informationen finden Sie unter Skill Monitor. Das Deaktivieren des Dokumentenimports wirkt sich nicht auf den Import von Dokumenten in dieses Skill über die API aus. Wenn ein Skill gelöscht wird, wird der freigegebene Importordner vom Server entfernt.