Vai al contenuto principale
ABBYY Vantage consente di caricare documenti da cartelle condivise ospitate sul server Vantage. L’accesso alla cartella avviene tramite il protocollo SFTP. I dettagli di accesso per la cartella creata (ad esempio i collegamenti alle cartelle di importazione ed eccezioni, nonché il nome utente e la password utilizzati per accedervi) vengono mostrati nella finestra di dialogo Impostazioni di input: Cartella condivisa.
Importante! Per caricare file nella cartella di input condivisa, è necessario utilizzare la modalità di trasferimento binario nel client SFTP.

Autorizzazioni di accesso degli utenti

CartellaAzioni disponibili per l’utente
Cartella Import- Visualizzare l’elenco di file e directory
- Caricare file nella cartella
- Rinominare file e directory
- Sovrascrivere i file esistenti durante il caricamento
- Eliminare file
Cartella Eccezioni- Visualizzare l’elenco di file e directory
- Scaricare file dalla cartella
- Rinominare file e directory
- Eliminare file

Elaborazione dei documenti

Una volta pubblicata la Skill, ABBYY Vantage inizia a controllare la cartella alla ricerca di nuovi file ogni 20 secondi.
Suggerimento: L’agente di importazione può acquisire al massimo 30 file per volta. Se il caricamento nella cartella SFTP diventa un collo di bottiglia per le prestazioni, valuta la creazione di due Skill, ciascuna con la propria cartella SFTP. In questo modo potrai avere due agenti che acquisiscono i file simultaneamente.

Parametri di registrazione del documento

Il tipo di origine (FolderImport) e il nome del file di origine vengono salvati nei parametri di registrazione del documento SourceType e SourceFileName. È possibile accedere ai valori di questi parametri aggiungendo le colonne corrispondenti nella sezione Transactions dello Skill Monitor. Vengono inoltre esportati nel file JSON di output che contiene i risultati completi dell’estrazione dei dati, configurabile nella sezione Exported Data dell’attività Output.
Nota: I seguenti caratteri non sono consentiti nei nomi dei file e verranno sostituiti con underscore al momento del caricamento: / : ? # [ ] @ ! $ & ' ( ) * + , ; = \. I nomi originali dei file vengono salvati nei parametri di registrazione del documento. È possibile recuperarli utilizzando questo script.

Risultati dell’importazione

Se il file viene importato correttamente, viene creata una Transaction per esso e il file viene quindi eliminato dalla cartella di importazione. Se il file non può essere importato e non è stata creata alcuna Transaction, viene spostato nella cartella delle eccezioni denominata <Input folder name>-exception. La posizione della cartella delle eccezioni è specificata nella finestra di dialogo Input Settings: Shared Folder. La durata di conservazione dei file nella cartella delle eccezioni è determinata dalla retention policy ed è impostata su 2 settimane per impostazione predefinita. Se un file non è più nella cartella di importazione, ma non sono presenti risultati di elaborazione, ciò potrebbe essere dovuto al completamento della Transaction con un errore. Ulteriori dettagli sugli errori di Transaction sono disponibili in Skill Monitor. Per ulteriori informazioni, vedere Transactions in Skill Monitor.

Importazione di archivi

Vantage può importare archivi dalla directory di primo livello della cartella condivisa. Attualmente sono supportati i seguenti tipi di file:
  • file ZIP creati in Windows,
  • file TAR GZ creati con il comando tar czvf in Linux.
Importante! Gli archivi possono essere importati solo quando è selezionato il metodo di importazione File singolo.
La dimensione dell’archivio è limitata a 3 GB. La dimensione di ciascun file nell’archivio è limitata a 100 MB. Viene creata una nuova transaction per ogni archivio. Tutti i file nell’archivio diventano quindi documenti di questa transaction. Il nome dell’archivio viene salvato nel Parameter di registrazione del Document SourceArchiveName. Se il tipo di archivio non è supportato o se l’archivio contiene tipi di file e/o archivi non supportati, la transaction corrispondente non andrà a buon fine. Se i limiti di dimensione dei file vengono superati o se l’archivio contiene sottocartelle, l’archivio verrà spostato nella cartella delle eccezioni e non verrà creata alcuna transaction. L’errore corrispondente potrà quindi essere visualizzato nel registro Error.

Importazione di più file in un’unica Transaction

Per impostazione predefinita, Vantage crea una Transaction separata per ogni file importato dalla cartella condivisa. È possibile modificare questo comportamento impostando Import method su From subfolder. In questa modalità, Vantage controllerà la cartella condivisa cercando sottocartelle invece di file. Il nome della sottocartella deve rispettare lo schema di denominazione specificato. Quando viene trovata una sottocartella idonea, tutti i file in essa contenuti, inclusi quelli presenti nelle cartelle annidate, vengono importati come documenti di un’unica Transaction. Il nome della sottocartella viene salvato nel Parameter di registrazione del documento SourceFolderName di ciascun documento.
Nota: Se il file è stato importato da una cartella annidata all’interno di una sottocartella, il Parameter SourceFolderName conterrà il nome della sottocartella radice.
Se la sottocartella non può essere importata, verrà spostata nella cartella Exceptions. Vantage non creerà una Transaction per essa e genererà un errore che è possibile visualizzare nell’Error Log del servizio Skill Monitor. Se la sottocartella contiene file in un formato non supportato, la Transaction corrispondente non andrà a buon fine.
Importante! L’importazione di archivi dalle sottocartelle non è supportata.
Una sottocartella vuota con un nome conforme allo schema di denominazione verrà eliminata dalla cartella condivisa; tuttavia, Vantage non creerà una Transaction per essa e genererà un avviso perché non è stato possibile importare dati. È possibile visualizzare questo avviso nell’Error Log del servizio Skill Monitor.

Schema di denominazione delle sottocartelle

Una sottocartella viene importata solo se il suo nome corrisponde allo schema di denominazione delle sottocartelle. Il valore predefinito ”*” corrisponde a qualsiasi string. È possibile configurare la maschera utilizzando il simbolo * come segnaposto per un numero qualsiasi di caratteri. Il carattere ”?” non è supportato come segnaposto per un singolo carattere. La maschera non distingue tra maiuscole e minuscole: nomi come “subfolder” e “SUBFOLDER” corrispondono entrambi alla maschera “subfolder”. La lunghezza della maschera è limitata a 64 caratteri. Per evitare possibili conflitti di accesso ai file, copiare prima i file nella sottocartella e poi rinominare la sottocartella in base allo schema.

Configurazione del caricamento dei documenti da una cartella condivisa in ABBYY Vantage

  1. Fai clic con il tasto sinistro sul blocco di attività Input nel flusso di elaborazione dei documenti. Se non è stato ancora aggiunto nello Skill Designer, aggiungilo dal riquadro Activities.
  2. Nel riquadro Actions, seleziona l’opzione Select additional source e scegli Shared folder.
screen_Process_Input_SharedFolder_Settings
  1. Fai clic su Settings. Si aprirà una finestra di dialogo con i dettagli di accesso alla cartella condivisa.
screen_Process_Input_SharedFolder_Credentials_cloud È inoltre possibile modificare il nome della cartella di importazione suggerito.

Requisiti per l’assegnazione dei nomi alle cartelle

Il nome della cartella deve soddisfare i seguenti requisiti:
  • Deve essere univoco all’interno della Skill (non può coincidere con il nome di un’altra cartella condivisa nel blocco di attività Output).
  • Deve iniziare con un numero o una lettera.
  • Non deve contenere caratteri speciali : * ? " < > / | \ né caratteri di controllo (ad esempio, a capo e tabulazione).
  • Non deve terminare con un punto.
  • Non deve essere vuoto.
  • Non deve superare i 64 caratteri.
  1. Se necessario, cambiare il Metodo di importazione in Da sottocartella e adattare lo Schema di denominazione della sottocartella alle proprie esigenze (se presenti).
  2. Configurare l’importazione dei file nella cartella tramite un client SFTP utilizzando le credenziali fornite nella finestra di dialogo Impostazioni input: cartella condivisa. Il contenuto di ciascun field può essere copiato negli appunti facendo clic sull’icon di copia nel field corrispondente. Il collegamento alla cartella contiene tutti i dati necessari per configurare la connessione. Incollando il collegamento nella finestra di dialogo delle impostazioni del client SFTP, gli altri Parameter vengono compilati automaticamente.
  3. Chiudere la finestra di dialogo facendo clic su Salva se è necessario salvare le modifiche oppure su Annulla se non è necessario salvare alcuna modifica.
Importante! Qualsiasi modifica apportata alle impostazioni avrà effetto solo dopo la pubblicazione della Skill.

Note aggiuntive

L’amministratore può utilizzare il servizio Skill Monitor per disabilitare l’importazione dei documenti. Per ulteriori informazioni, vedere Skill Monitor. La disabilitazione dell’importazione dei documenti non influisce sull’importazione dei documenti in questa skill tramite API. Quando una skill viene eliminata, la cartella di importazione condivisa viene rimossa dal server.