Saltar al contenido principal
ABBYY Vantage le permite cargar documentos desde carpetas compartidas alojadas en el servidor de Vantage. El acceso a la carpeta se establece mediante el protocolo SFTP. Los datos de acceso de la carpeta creada (como los enlaces a las carpetas de importación y excepciones, así como el nombre de usuario y la contraseña para acceder a ellas) se muestran en el cuadro de diálogo Input Settings: Shared Folder.
Importante: Para cargar archivos en la carpeta compartida de entrada, debe usarse el modo de transferencia binaria en el cliente SFTP.

Permisos de acceso de usuario

CarpetaAcciones de usuario disponibles
Carpeta de importación- Ver la lista de archivos y directorios
- Cargar archivos en la carpeta
- Cambiar el nombre de archivos y directorios
- Sobrescribir archivos existentes al cargar
- Eliminar archivos
Carpeta de excepciones- Ver la lista de archivos y directorios
- Descargar archivos de la carpeta
- Cambiar el nombre de archivos y directorios
- Eliminar archivos

Procesamiento de documentos

Una vez publicada la Habilidad, ABBYY Vantage empezará a comprobar la carpeta en busca de archivos nuevos cada 20 segundos.
Tip: El agente de importación podrá procesar como máximo 30 archivos a la vez. Si la carga en la carpeta SFTP se convierte en un cuello de botella de rendimiento, considere crear dos Habilidades, cada una con su propia carpeta SFTP. Esto le permitirá contar con dos agentes que recojan archivos simultáneamente.

Parámetros de registro de documentos

El tipo de origen (FolderImport) y el nombre del archivo de origen se guardan en los parámetros de registro de documentos SourceType y SourceFileName. Puede acceder a los valores de estos parámetros si añade las columnas correspondientes en la sección Transacciones del Skill Monitor. También se exportan al archivo JSON de salida que contiene los resultados completos de extracción de datos, lo cual puede configurarse en la sección Exported Data de la actividad Output.
Nota: Los siguientes caracteres no están permitidos en los nombres de archivo y se sustituirán por guiones bajos al cargar: / : ? # [ ] @ ! $ & ' ( ) * + , ; = \. Los nombres de archivo originales se guardan en los parámetros de registro de documentos. Puede recuperarlos mediante este script.

Resultados de importación

Si el archivo se importa correctamente, se crea una transacción para él y, a continuación, el archivo se elimina de la carpeta de importación. Si el archivo no pudo importarse y no se creó ninguna transacción para él, se mueve a la carpeta de excepciones denominada <Input folder name>-exception. La ubicación de la carpeta de excepciones se especifica en el cuadro de diálogo Input Settings: Shared Folder. La duración de almacenamiento de los archivos en la carpeta de excepciones está determinada por la política de retención y, de forma predeterminada, es de 2 semanas. Si un archivo ya no está en la carpeta de importación, pero no se encuentran resultados de procesamiento, esto puede deberse a que la transacción se haya completado con un error. Puede encontrar más detalles sobre errores de transacción en Skill Monitor. Para obtener más información, consulte Skill Monitor Transactions Section.

Importación de archivos comprimidos

Vantage puede importar archivos comprimidos desde el directorio de nivel superior de la carpeta compartida. Actualmente se admiten los siguientes tipos de archivo:
  • Archivos ZIP creados en Windows,
  • Archivos TAR GZ creados con el comando tar czvf en Linux.
Importante: Los archivos comprimidos solo se pueden importar cuando se selecciona el método de importación Single file.
El tamaño del archivo comprimido está limitado a 3 GB. El tamaño de cada archivo dentro del archivo comprimido está limitado a 100 MB. Se crea una nueva transacción para cada archivo comprimido. Todos los archivos del archivo comprimido pasan a ser documentos de esta transacción. El nombre del archivo comprimido se guarda en el parámetro de registro del documento SourceArchiveName. Si el tipo de archivo comprimido no es compatible o si el archivo comprimido contiene tipos de archivo y/o archivos comprimidos no compatibles, la transacción correspondiente fallará. Si se superan los límites de tamaño de archivo o si el archivo comprimido contiene subcarpetas, el archivo se transferirá a la carpeta de excepciones y no se creará ninguna transacción. El error correspondiente podrá consultarse en el registro de errores.

Importación de varios archivos en una única transacción

De forma predeterminada, Vantage crea una transacción independiente para cada archivo importado desde la carpeta compartida. Puede cambiar este comportamiento estableciendo Import method en From subfolder. En este modo, Vantage comprobará la carpeta compartida en busca de subcarpetas en lugar de archivos. El nombre de la subcarpeta debe ajustarse al esquema de nomenclatura especificado. Cuando se encuentra una subcarpeta adecuada, todos sus archivos, incluidos los de las carpetas anidadas, se importan como documentos de una única transacción. El nombre de la subcarpeta se guarda en el parámetro de registro de documento SourceFolderName de cada documento.
Nota: Si el archivo se importó desde una carpeta anidada dentro de una subcarpeta, el parámetro SourceFolderName contendrá el nombre de la subcarpeta raíz.
Si no se puede importar la subcarpeta, se trasladará a la carpeta Exceptions. Vantage no creará una transacción para ella y generará un error que puede consultar en el registro de errores (Error Log) del servicio Skill Monitor. Si la subcarpeta contiene archivos en un formato no admitido, la transacción correspondiente fallará.
Importante: No se admite la importación de archivos comprimidos desde subcarpetas.
Una subcarpeta vacía con un nombre que coincida con el esquema de nomenclatura se eliminará de la carpeta compartida; sin embargo, Vantage no creará una transacción para ella y generará una advertencia porque no se pudieron importar datos. Puede consultar esta advertencia en el registro de errores (Error Log) del servicio Skill Monitor.

Esquema de nombres de subcarpetas

Una subcarpeta se importa solo si su nombre coincide con el esquema de nombres de subcarpetas. El valor predeterminado ”*” coincide con cualquier cadena. Puede configurar la máscara usando el símbolo * como comodín para cualquier cantidad de caracteres. El carácter ”?” no es compatible como comodín para un solo carácter. La máscara no distingue mayúsculas de minúsculas: nombres como “subfolder” y “SUBFOLDER” coinciden con la máscara “subfolder”. La longitud de la máscara está limitada a 64 caracteres. Para evitar posibles conflictos de acceso a archivos, copie primero los archivos en la subcarpeta y luego cambie el nombre de la subcarpeta según el esquema.

Configuración de la carga de Document desde una carpeta compartida en ABBYY Vantage

  1. Haz clic con el botón izquierdo en el bloque de actividad Input de tu flujo de procesamiento de documentos. Si aún no se ha agregado en Skill Designer, hazlo usando el panel Activities.
  2. En el panel Actions, selecciona la opción Select additional source y elige Shared folder.
screen_Process_Input_SharedFolder_Settings
  1. Haz clic en Settings. Se abrirá un cuadro de diálogo con los detalles de acceso a la carpeta compartida.
screen_Process_Input_SharedFolder_Credentials_cloud También puedes modificar el nombre sugerido de la carpeta de importación.

Requisitos para los nombres de carpetas

El nombre de la carpeta debe cumplir lo siguiente:
  • Debe ser único en toda la skill (no puede coincidir con el nombre de otra carpeta compartida en el bloque de actividad Output).
  • Debe comenzar con un número o una letra.
  • No debe contener caracteres especiales : * ? " < > / | \ ni caracteres de control (por ejemplo, salto de línea o tabulación).
  • No debe terminar con un punto.
  • No debe estar vacío.
  • No debe superar los 64 caracteres.
  1. Si es necesario, cambie Import method a From subfolder y ajuste Subfolder naming scheme según sus requisitos (si los hay).
  2. Configure la importación de archivos en la carpeta mediante un cliente SFTP usando las credenciales proporcionadas en el cuadro de diálogo Input Settings: Shared Folder. El contenido de cada campo se puede copiar al portapapeles haciendo clic en el icono de copia del campo correspondiente. El enlace de la carpeta contiene todos los datos necesarios para configurar la conexión. Al pegar el enlace en el cuadro de diálogo de configuración del cliente SFTP, los demás parámetros se completan automáticamente.
  3. Cierre el cuadro de diálogo haciendo clic en Save si necesita guardar los cambios o en Cancel si no hay cambios que guardar.
Importante: Cualquier cambio realizado en la configuración solo entra en vigor después de publicar su Habilidad.

Notas adicionales

El administrador puede usar el servicio Skill Monitor para inhabilitar la importación de documentos. Para obtener más información, consulta Skill Monitor. Inhabilitar la importación de documentos no afecta la importación de documentos a esta skill a través de la API. Cuando se elimina una skill, la carpeta de importación compartida se elimina del servidor.