Importer des documents à partir d’un dossier partagé
Téléversez des documents depuis un dossier partagé accessible via SFTP sur le serveur Vantage, en les regroupant éventuellement dans une transaction ou en important des archives ZIP/TAR.GZ.
ABBYY Vantage vous permet de téléverser des documents depuis des dossiers partagés hébergés sur le serveur Vantage. L’accès s’effectue via SFTP. Les informations d’accès au dossier (liens vers les dossiers d’importation et les dossiers des exceptions, ainsi que le nom d’utilisateur et le mot de passe) sont affichées dans la boîte de dialogue Paramètres d’entrée : dossier partagé.
Pour téléverser des fichiers dans le dossier partagé d’entrée, utilisez le mode de transfert binaire dans le client SFTP.
Une fois la compétence publiée, Vantage vérifie le dossier partagé toutes les 20 secondes pour détecter de nouveaux fichiers.
L’agent d’import traite au maximum 30 fichiers à la fois. Si le téléversement SFTP devient un goulot d’étranglement, répartissez la charge entre deux compétences (chacune avec son propre dossier SFTP) afin que deux agents récupèrent les fichiers en parallèle.
Le type de source (FolderImport) et le nom du fichier source sont enregistrés dans les paramètres d’enregistrement de document SourceType et SourceFileName. Vous pouvez accéder aux valeurs de ces paramètres en ajoutant les colonnes correspondantes dans la section Transactions du Skill Monitor. Ils sont également exportés dans le fichier JSON de sortie (configuré dans la section Exported Data de l’activité Output).Les caractères suivants ne sont pas autorisés dans les noms de fichiers et sont remplacés par des traits de soulignement lors du téléversement : / : ? # [ ] @ ! $ & ' ( ) * + , ; = \. Les noms de fichiers d’origine sont enregistrés dans les paramètres d’enregistrement de document. Récupérez-les à l’aide d’un script d’exemple d’activité personnalisée.
Si un fichier est importé avec succès, une transaction est créée pour ce fichier, puis celui-ci est supprimé du dossier d’importation. Si l’importation d’un fichier échoue, il est déplacé vers le dossier des exceptions nommé <Input folder name>-exception. Le chemin du dossier des exceptions est indiqué dans la boîte de dialogue Paramètres d’entrée : Dossier partagé.
Par défaut, les fichiers du dossier des exceptions sont conservés pendant 2 semaines (selon la stratégie de rétention).
Si un fichier n’est plus dans le dossier d’importation, mais qu’aucun résultat de traitement n’est disponible, il se peut que la transaction se soit terminée par une erreur. Pour plus d’informations, voir les transactions de Skill Monitor.
Vantage peut importer des archives depuis le répertoire racine du dossier partagé. Types pris en charge :
Fichiers ZIP créés sous Windows
Fichiers TAR GZ créés avec tar czvf sous Linux
Les archives ne peuvent être importées que lorsque la méthode d’importation Single file est sélectionnée.
Chaque archive est limitée à 3 Go, et chaque fichier qu’elle contient à 100 Mo.
Une nouvelle transaction est créée pour chaque archive. Tous les fichiers de l’archive deviennent des documents de cette transaction. Le nom de l’archive est enregistré dans le paramètre d’enregistrement du document SourceArchiveName.Si le type d’archive n’est pas pris en charge, ou si elle contient des types de fichiers non pris en charge ou des archives imbriquées, la transaction échoue.Si les limites de taille des fichiers sont dépassées, ou si l’archive contient des sous-dossiers, elle est déplacée vers le dossier des exceptions et aucune transaction n’est créée. L’erreur correspondante apparaît dans le journal des erreurs.
Importer plusieurs fichiers dans une seule transaction
Par défaut, Vantage crée une transaction distincte pour chaque fichier. Pour regrouper des fichiers, définissez la Méthode d’importation sur À partir d’un sous-dossier. Dans ce mode, Vantage analyse le dossier partagé à la recherche de sous-dossiers dont le nom correspond à la convention de nommage configurée. Lorsqu’un sous-dossier correspondant est trouvé, tous ses fichiers (y compris ceux des dossiers imbriqués) sont importés comme documents d’une seule transaction. Le nom du sous-dossier est enregistré dans le paramètre d’enregistrement SourceFolderName de chaque document.Si un fichier est importé depuis un dossier imbriqué, SourceFolderName contient le nom du sous-dossier racine.Si un sous-dossier ne peut pas être importé, il est déplacé vers le dossier des exceptions. Vantage ne crée pas de transaction pour celui-ci et consigne une erreur dans le Journal des erreurs de Skill Monitor.Si un sous-dossier contient des fichiers dans un format non pris en charge, la transaction correspondante échoue.
L’importation d’archives à partir de sous-dossiers n’est pas prise en charge.
Un sous-dossier vide dont le nom correspond à la convention est supprimé du dossier partagé. Aucune transaction n’est créée, et Vantage consigne un avertissement dans le Journal des erreurs.
Un sous-dossier n’est importé que si son nom correspond au schéma de nommage des sous-dossiers. La valeur par défaut * correspond à n’importe quelle chaîne de caractères. Configurez le masque en utilisant * comme caractère générique représentant un nombre quelconque de caractères.Le caractère ? n’est pas pris en charge comme caractère générique pour un seul caractère. Le masque ne tient pas compte de la casse. Par exemple, subfolder et SUBFOLDER correspondent tous deux à subfolder. La longueur maximale du masque est de 64 caractères.
Pour éviter les conflits d’accès aux fichiers, copiez d’abord les fichiers dans le sous-dossier, puis renommez ce dernier pour qu’il corresponde au schéma.
Configurer l’importation depuis un dossier partagé
1
Ouvrir l’activité Input
Cliquez sur le bloc d’activité Input dans votre flux de traitement des documents. S’il n’est pas encore présent dans le Skill Designer, ajoutez-le depuis le volet Activities.
2
Sélectionner dossier partagé comme source supplémentaire
Dans le Volet des actions, cochez Select additional source et choisissez dossier partagé.
Sélection de dossier partagé comme source Input supplémentaire
3
Ouvrir les paramètres du dossier
Cliquez sur Settings pour ouvrir une boîte de dialogue contenant les informations d’accès au dossier partagé. Le nom suggéré du dossier d’importation peut être modifié ici.
Identifiants d’accès au dossier partagé
4
(Facultatif) Configurer la méthode d’importation
Pour regrouper les fichiers en transactions, définissez méthode d’importation sur à partir d’un sous-dossier et ajustez schéma de nommage des sous-dossiers selon vos besoins.
5
Se connecter via SFTP
Configurez le téléversement de fichiers via un client SFTP à l’aide des informations de connexion figurant dans la boîte de dialogue Paramètres d’entrée : dossier partagé. Cliquez sur l’icône de copie dans chaque champ pour copier les valeurs dans le presse-papiers. Le lien du dossier contient toutes les données de connexion. En le collant dans le client SFTP, les autres paramètres sont renseignés automatiquement.
6
Enregistrer ou annuler
Cliquez sur Save pour conserver vos modifications, ou sur Cancel pour les ignorer.
Les modifications apportées à ces paramètres ne prennent effet qu’après la publication de la compétence.
Les administrateurs peuvent désactiver l’import de documents depuis Skill Monitor. La désactivation de l’import depuis le dossier partagé n’affecte pas l’import de documents via l’API.
