Saltar al contenido principal
Para configurar la exportación a una base de datos, complete los siguientes pasos:
  1. En la ventana del editor de Definición de Document, seleccione el elemento de menú Definición de Document → Configuración de exportación…
  2. Haga clic en Add… y seleccione Export to ODBC-compatible database en el campo Type.
  3. Especifique si la exportación es obligatoria.
  4. Especifique si se deben exportar las imágenes.
  5. Especifique qué documentos (con y/o sin errores) se deben exportar y haga clic en Next>.
  6. Especifique la configuración de exportación y haga clic en Next>.
    • Establezca una conexión con una base de datos. Introduzca los parámetros de conexión en la ventana Connection string o haga clic en el botón Setup… y configure los parámetros de conexión en el cuadro de diálogo Data Link Properties.
Para una base de datos Microsoft SQL 2016 SP2, 2017 o 2019:
  1. Provider - OLE DB Provider for ODBC Drivers Nota: Seleccionar “OLE DB Provider for SQL Server” puede causar problemas al trabajar con determinados tipos de datos y campos largos.
  2. Driver - SQL Server
Para una base de datos Access 2003, 2007 o 2010:
  1. Provider - OLE DB Provider for ODBC Drivers
  2. Driver - Microsoft Access Driver (Driver do Microsoft Access or Microsoft Access-Treiber) Nota: Para conectar la versión de 64 bits de FlexiCapture a la base de datos Access, deberá instalar la versión de 64 bits del controlador Access Database Engine x64.
Para una base de datos Oracle 10g, 11g o 12c:
  1. Provider - Oracle Provider for OLE DB
  2. No es necesario seleccionar el controlador Para obtener más información, consulte Exportación a una base de datos Oracle.
Para una base de datos PostgreSQL:
  1. Provider - OLE DB Provider for ODBC Drivers
  2. No es necesario seleccionar el controlador
El proveedor y el controlador deben estar disponibles en el equipo donde se realiza la exportación.
  • Seleccione un esquema en la lista desplegable.
No es necesario especificar un esquema al trabajar con Microsoft SQL (exportación, almacenamiento en caché, administración de reglas). Si deja el campo en blanco, el esquema dbo se utilizará automáticamente. Al trabajar con PostgreSQL, especifique el esquema public. Nota: Si una base de datos no contiene tablas, el esquema dbo no aparecerá en la lista de esquemas. Para seguir trabajando con el esquema dbo, seleccione el valor en blanco en el campo de esquema.
  • Puede comprobar la conexión con la base de datos haciendo clic en el botón Test Connection.
  • Haga clic en el botón Create Tables Automatically para crear automáticamente nuevas tablas en la base de datos a las que se exportarán los datos de los documentos. Se creará una tabla independiente para cada sección del documento. La estructura y el formato de los campos de las tablas creadas automáticamente corresponden al conjunto de campos de la Definición de Document y a sus tipos de datos. Nota: Antes de la exportación, ABBYY FlexiCapture consulta la base de datos para obtener información sobre todos los objetos del esquema. Se recomienda usar para la exportación esquemas con un número reducido de objetos. De lo contrario, la creación de tablas puede tardar bastante tiempo (hasta varias horas).
  • Si es necesario exportar datos a tablas existentes de una base de datos, establezca una correspondencia entre los campos de la Definición de Document y los campos de la tabla de la base de datos mediante el botón Set Up Field Mapping…
  • En el cuadro de diálogo Field Mapping, especifique a qué tablas y columnas de tabla de la base de datos exportará el programa los valores de campo de la Definición de Document.
El cuadro de diálogo Field Mapping contiene a la izquierda las secciones y los campos del documento. A la derecha, debe asociarlos con las tablas y los campos de la base de datos. Si la base de datos ya tiene tablas para la exportación de datos, en el cuadro de diálogo Field Mapping debe seleccionar una tabla de base de datos para cada sección del documento y una columna de tabla de base de datos para cada campo del documento. (Además de la exportación directa a tablas de base de datos, es posible guardar datos en una base de datos mediante procedimientos almacenados. Para obtener más información, consulte Aspectos específicos de la configuración de la exportación de datos mediante procedimientos almacenados de bases de datos. Si la base de datos no tiene tablas para la exportación, puede crear tablas de base de datos automáticamente haciendo clic en el botón Create Tables Automatically. Después de hacer clic en él, el programa creará tablas con la estructura necesaria para la exportación. Los campos del documento se asociarán con las columnas de la tabla. Los grupos de campos, los campos con varias instancias y las tablas de documentos se exportan a tablas independientes de la base de datos. Se utilizan una clave primaria y una clave foránea para vincular la tabla principal con las tablas subordinadas. En la tabla principal, se agrega una clave primaria a cada registro. En la tabla subordinada, cada registro tiene una clave foránea que almacena el valor de la clave primaria del registro correspondiente de la tabla principal. Las claves primarias y foráneas se agregan automáticamente cuando es necesario. Solo necesita especificar el campo al que debe exportarse la clave. Seleccione una columna de una tabla de base de datos para cada campo del documento. Si en la tabla falta una columna a la que deban exportarse datos de algún campo, puede agregarse automáticamente a la tabla existente. Para ello, basta con dejar la correspondencia entre el campo del documento y el campo de la base de datos con un nombre similar y con el comentario (auto) entre paréntesis. También puede seleccionar el campo deseado con el mouse y hacer clic en el botón Auto. También puede usar el botón Auto para crear una nueva tabla en la base de datos cuyo nombre sea similar al nombre de la sección o de la tabla de la Definición de Document. Si debe crearse una tabla nueva cuyos nombres y encabezados de columna sean distintos de los nombres de campo de la Definición de Document, use el botón New en el cuadro de diálogo de configuración de correspondencia de campos para crear una tabla para cada campo. Use los botones Move Up y Move Down para administrar el orden de las columnas en la tabla de una base de datos creada automáticamente. Use el botón Format… para configurar los parámetros de guardado de los campos tipificados; por ejemplo, el número de dígitos decimales en el valor de un campo de tipo Number, o el formato y los separadores de un campo de tipo Data.
Al exportar un campo del tipo de datos Time, debe crearse en la tabla de la base de datos una columna correspondiente de tipo DateTime. De forma predeterminada, se crea una columna de tipo SmallDateTime, lo que provoca un error.
  1. Si deben guardarse imágenes (imágenes de documento y/o imágenes de campos del tipo Picture), especifique las opciones de guardado de imágenes y haga clic en Next>.
    • Especifique si las imágenes deben guardarse en la base de datos o como archivos.
    • Si elige guardar imágenes en archivos, especifique una plantilla de nombre de archivo (haga clic en Edit…) y cuándo deben sobrescribirse los archivos si sus nombres coinciden. Para obtener más información, consulte Export file naming options.
    • Si es necesario, especifique los campos que deben ocultarse durante la exportación.
Según la opción seleccionada, el contenido de los campos de tipo Picture y las imágenes de documento pueden exportarse al sistema de archivos o a una base de datos. Al exportar a archivos separados, el nombre y la ruta de acceso a un archivo de imagen o Picture se almacenan en el campo correspondiente de una base de datos (se configura al establecer la correspondencia de campos). Si se especifica un disco de red como ruta de acceso a una carpeta de exportación (para imágenes, Pictures, etc.), asegúrese de que todas las estaciones que trabajan con este disco puedan acceder a él. Un procedimiento especial le permite convertir una imagen binaria de cualquier base de datos en un archivo. Nota: Al exportar imágenes a archivos separados, la longitud de una cadena que almacena rutas de acceso a archivos puede superar los 255 caracteres, lo que provocará un mensaje de error. En este caso, debe aumentar el límite de caracteres de la columna correspondiente.
  1. Si se seleccionó la opción de guardar imágenes, especifique un formato de guardado de archivos y haga clic en Next>.
    • Seleccione el formato de imagen, la calidad y el color que desee.
    • Para cambiar la resolución de las imágenes de origen, seleccione Change resolution to y elija el valor adecuado de la lista.
    • Si selecciona PDF o PDF/A como formato de almacenamiento, puede crear archivos PDF con capacidad de búsqueda.
  2. Introduzca un nombre de perfil de exportación y haga clic en Finish.
  3. Las Pictures se exportan a archivos separados. El nombre y la ruta de acceso al archivo de Picture pueden almacenarse en el campo correspondiente de la base de datos (esto puede configurarse al establecer la correspondencia de campos).
  4. Si la ruta de acceso a la carpeta de destino para imágenes, Pictures, etc. contiene un disco de red, asegúrese de que todas las estaciones de procesamiento que trabajan con el proyecto tengan acceso a ese disco.

Particularidades de la configuración de la exportación de datos mediante procedimientos almacenados de base de datos

Además de exportar datos directamente a las tablas de la base de datos, es posible guardar datos en la base de datos mediante procedimientos almacenados. Un procedimiento almacenado es un objeto de base de datos que representa un conjunto de instrucciones SQL que se compila una vez y luego se almacena en el servidor. Los procedimientos almacenados pueden utilizarse para realizar cálculos numéricos y operaciones con datos de texto, cuyos resultados pueden asignarse a variables y parámetros, así como para llevar a cabo operaciones estándar con bases de datos. Ventajas de utilizar procedimientos almacenados en lugar de exportar directamente a tablas de la base de datos:
  • Mayor velocidad al trabajar con la base de datos
  • Posibilidad de utilizar cálculos adicionales
  • Garantía de la integridad de los datos
Ejemplo de un procedimiento compartido para MS SQL:
Create procedure Export( @userId as int, @lastName as nvarchar(255), @firstName as nvarchar(255) )
as
begin
  if Exists( Select Id from Users where Id = @userId ) begin
     Update Users set LastName = @lastName, FirstName=@firstName where Id = @userId
  end else begin
     Insert into Users ( Id, LastName, FirstName ) values( @userId, @lastName, @firstName
)
  end
end
Al enviar datos desde FlexiCapture a la base de datos mediante el procedimiento anterior, se realizan las siguientes acciones: Los tres parámetros que se pasan como entrada al procedimiento son los campos de un documento de FlexiCapture:
  • un identificador (UserId);
  • el nombre (FirstName);
  • el apellido (LastName).
Si no hay ninguna entrada con ese identificador en la tabla de la base de datos (Users), se añade una nueva entrada a la tabla. Si existe una entrada con ese identificador, los valores del nombre y del apellido de esta entrada se sustituyen por nuevos valores (los valores de los campos de FlexiCapture).

Configuración de la exportación con procedimientos almacenados

Para configurar la exportación con procedimientos almacenados, primero es necesario establecer una conexión con la base de datos (consulte arriba). A continuación, haga clic en Set Up Field Mapping… para definir la correspondencia entre los campos del documento y los parámetros del procedimiento almacenado. En el cuadro de diálogo Set Up Field Mapping…, seleccione en la lista de tablas y procedimientos almacenados de la base de datos el procedimiento almacenado necesario para guardar los datos. A diferencia de la configuración de la exportación directamente a las columnas de una tabla de la base de datos, los campos propuestos para la exportación son parámetros de un procedimiento almacenado. Los parámetros del procedimiento están tipificados. Para la asignación, es necesario que el tipo de parámetro coincida con el tipo de datos del campo de la Definición de Document. Asigne los campos del documento a los parámetros del procedimiento almacenado de la base de datos.
Si es necesario exportar no solo campos individuales del documento, sino también tablas y campos complejos (p. ej., campos con varias instancias), debe configurar correctamente los índices para vincular los registros secundarios con el registro principal de datos del documento. Especifique el valor devuelto (@RETURN_VALUE) o un parámetro de salida del procedimiento almacenado como clave primaria exportable (ROW_INDEX). De este modo, al exportar datos, el procedimiento escribirá los datos en la tabla de la base de datos y devolverá el identificador del registro actual, que se pasará al procedimiento almacenado para exportar los registros secundarios.

Exportación a una base de datos Oracle

Recomendamos usar el mismo esquema de autorización que se utiliza para los usuarios al exportar datos a bases de datos. Se deben especificar los siguientes parámetros para exportar datos:
  1. Rol: Connect
  2. Privilegios:
    • CREATE ANY TABLE para crear una tabla
    • INSERT ANY TABLE y UNLIMITED TABLESPACE para exportar datos
no necesita ningún privilegio para configurar Field Mapping.
Si usa una base de datos Oracle, desaconsejamos usar nombres de campo de más de 30 caracteres en sus Definiciones de Document. Los nombres más largos se truncarán al exportarlos a bases de datos Oracle.