> ## Documentation Index
> Fetch the complete documentation index at: https://docs.abbyy.com/llms.txt
> Use this file to discover all available pages before exploring further.

# ABBYY FlexiCapture Connect

> Instale y configure ABBYY FlexiCapture Connect, el servicio de Windows que importa y exporta documentos y sincroniza conjuntos de datos con proyectos de ABBYY FlexiCapture Cloud.

ABBYY FlexiCapture Connect se ejecuta como un servicio de Windows y permite a los usuarios importar documentos en proyectos de ABBYY FlexiCapture Cloud, exportar documentos desde proyectos de ABBYY FlexiCapture Cloud y sincronizar conjuntos de datos.

<Frame>
  <img src="https://mintcdn.com/abbyy/IFr-A2MDVJd80FDs/images/flexi-capture/FlexiCaptureConnect_scheme.png?fit=max&auto=format&n=IFr-A2MDVJd80FDs&q=85&s=d3744fbf6a31a0223b8389e17f541a66" alt="Diagrama que muestra ABBYY FlexiCapture Connect ejecutándose en un servidor Windows y conectándose a ABBYY FlexiCapture Cloud a través de un firewall por el puerto 443." width="900" height="304" data-path="images/flexi-capture/FlexiCaptureConnect_scheme.png" />
</Frame>

<div id="system-requirements">
  ## Requisitos del sistema
</div>

| Requisito                  | Details                                                                                                           |
| -------------------------- | ----------------------------------------------------------------------------------------------------------------- |
| Sistema operativo          | Windows 10, Windows 11 o Windows Server 2012, 2012 R2, 2016, 2019, 2022 o 2025 (cada uno con Desktop Experience). |
| RAM                        | Se recomienda un mínimo de 2,5 GB para un conjunto de datos que contenga aproximadamente 500.000 proveedores.     |
| Compatibilidad de software | ABBYY FlexiCapture Application Server Release 3 o posterior; .NET Framework 4.6.1 o posterior.                    |

<div id="setup">
  ## Configuración
</div>

Para configurar ABBYY FlexiCapture Connect:

<Note>
  Le recomendamos que utilice su cuenta de servicio para seguir las instrucciones de esta sección.
</Note>

<Steps>
  <Step title="Descargue y ejecute el instalador">
    Descargue y ejecute el archivo `FlexiCapture_Connect_Installer_*.msi` desde [https://www.abbyy.com/flexicapture-downloads/cloud/](https://www.abbyy.com/flexicapture-downloads/cloud/).

    <Note>
      Si ABBYY FlexiCapture Connect ya está instalado y va a actualizar una versión existente, cree una copia de seguridad del archivo `config.json`, ubicado en `C:\Program Files (x86)\ABBYY FlexiCapture Connect\config.json`.
    </Note>
  </Step>

  <Step title="Modifique el archivo de configuración">
    Modifique el archivo `config.json` según sus necesidades (consulte [Explicación del archivo de configuración](#configuration-file-explained) más abajo).
  </Step>

  <Step title="Pruebe la nueva configuración">
    1. Pause el servicio ABBYY FlexiCapture Connect.
    2. Ejecute el archivo `ABBYY.FlexiCapture.Connect.exe`. Se abrirá una ventana de consola con un registro detallado.
  </Step>

  <Step title="Reinicie el servicio">
    Reinicie ABBYY FlexiCapture Connect.
  </Step>
</Steps>

<div id="configuration-file-explained">
  ## Explicación del archivo de configuración
</div>

Un archivo de configuración típico se ve así:

```json theme={null}
{
  "url": "https://europe.flexicapture.com/",
  "tenant": "testtenant",
  "user": "user1",
  "password": "password1",
  "projects": [
    {
      "name": "project1",
      "import": {
        "directory": "C:\\HotFolder\\Import",
        "fileMask": "*",
        "settings": {
          "region": "US",
          "verification_type": "NoVerification",
          "export_format": "Xml"
        },
        "createDocument": "ForEachFile",
        "period": "00:01:00",
        "schedule": [ "12:00:00", "06:00:00" ]
      },
      "export": {
        "directory": "C:\\HotFolder\\Export",
        "period": "00:01:00",
        "schedule": [ "12:00:00" ]
      },
      "templates": [
        {
          "name": "template",
          "datasets": [
            {
              "name": "DataSet",
              "file": "C:\\HotFolder\\DataSets\\DataSet.csv",
              "period": "00:01:00",
              "schedule": [ "12:00:00" ]
            }
          ]
        }
      ]
    }
  ]
}
```

Las secciones de un archivo de configuración típico se describen a continuación.

<div id="general-settings">
  ### Configuración general
</div>

* **url** — La URL del tenant (por ejemplo, `https://europe.flexicapture.com`).
* **tenant** — El nombre del tenant.
* **user** — El nombre de usuario de la cuenta de servicio.
* **password** — La contraseña de la cuenta de servicio.
* **projects** — Contiene la configuración de proyectos individuales, como los parámetros de importación y exportación de documentos, y los parámetros de sincronización de conjuntos de datos.

<Info>
  Para importar y exportar documentos, configure la cuenta del tenant como **External User**. Para sincronizar conjuntos de datos, la cuenta del tenant necesita el rol **Administrator** o ambos roles **Project Settings Editor** y **External User**. De forma predeterminada, la cuenta del tenant tiene acceso a todos los proyectos; puede cambiarlo ajustando los permisos de acceso otorgados a roles de usuario específicos. Para obtener más información, consulte [Configurar roles de usuario y permisos de acceso](/es/flexi-capture/admin-guide/roles-setup).
</Info>

<div id="project-settings">
  ### Configuración del proyecto
</div>

* **name** — Nombre del proyecto.
* **import** — Configuración para importar documentos.
* **export** — Configuración para exportar documentos.
* **templates** — Configuración para sincronizar conjuntos de datos.

<div id="import-settings">
  ### Configuración de importación
</div>

* **directory** — La ruta de acceso a la carpeta desde la que se importan los documentos.
* **fileMask** — Un filtro de archivos y carpetas. Se admiten los comodines `*` y `?`.
* **settings** — Parámetros de registro del lote.
* **createDocument** — Los valores posibles son `ForEachFile` (crea un documento independiente para cada archivo importado) o `Automatically` (usa los parámetros del proyecto). Para usar esta función, primero seleccione la opción **Automatically when Document Definition is applied** en el proyecto de FlexiCapture de ABBYY.
* **period** y **schedule** — programación de tarea. La propiedad `period` especifica la frecuencia con la que se inicia la tarea (por ejemplo, `"period": "00:02:30"` inicia la tarea cada dos minutos y medio). La propiedad `schedule` especifica las horas a las que se inicia la tarea (por ejemplo, `"schedule": [ "09:00:00", "19:00:00" ]` inicia la tarea todos los días a las 9:00 y a las 19:00).

<Note>
  Se crea un nuevo lote cada vez que se importan archivos. El nombre del lote contiene la fecha y la hora actuales. Las propiedades **period** y **schedule** pueden establecerse de forma independiente.
</Note>

<a id="exportsettings" />

<div id="export-settings">
  ### Configuración de exportación
</div>

* **directory** — La ruta de la carpeta donde se almacenan los archivos exportados.
* **period** y **schedule** — programación de tarea, especificada de la misma forma que para la configuración de importación.

<Note>
  Cuando se exportan los documentos, se crea una carpeta para cada lote del proyecto que se encuentra actualmente en la etapa «Procesado». Estas carpetas de destino tienen los mismos nombres que sus respectivos lotes y contienen todos los resultados del procesamiento. Si se elimina una carpeta de destino, el programa crea una nueva con el mismo nombre y coloca allí los resultados del procesamiento. Las propiedades **period** y **schedule** se pueden establecer de forma independiente.
</Note>

<div id="document-definition-settings">
  ### Configuración de Definición de Document
</div>

* **name** – El nombre de la Definición de Document relacionada con esta sección.
* **datasets** – Los parámetros de sincronización de conjuntos de datos para la Definición de Document.

<div id="data-set-synchronization-settings">
  ### Configuración de sincronización del conjunto de datos
</div>

* **name** — El nombre del conjunto de datos.
* **file** — La ruta del archivo CSV que contiene los datos maestros exportados desde el sistema ERP. La primera línea del archivo CSV debe contener los nombres de los campos del conjunto de datos separados por comas, y cualquier valor que contenga comas debe ir entre comillas dobles.
* **period** y **schedule** — programación de tarea, especificada de la misma manera que para la configuración de importación.

<Note>
  Al sincronizar conjuntos de datos:

  * Los conjuntos de datos actuales se sustituyen por los nuevos.
  * Todos los registros existentes modificados por un operador de verificación (mediante la edición, adición o eliminación de valores) se guardan y sincronizan, mientras que los nuevos registros agregados manualmente se eliminan y no se sincronizan.
  * En el caso de conjuntos de datos muy grandes, la sincronización puede tardar varias horas.
</Note>

El siguiente ejemplo muestra un archivo CSV de un conjunto de datos "Vendors" con un proveedor que tiene varios IBAN:

```text theme={null}
Id,Name,Street,City,ZIP,CountryCode,VATID,IBAN,IBAN,BusinessUnitId
1,MacWay,9 Route d'Eschau,Illkirch-Graffenstaden,67411,FR,1A345678901,FR1420041010050500012M02606,FR7630006000011234567890189,1
2,Bottled Water Ltd,Mary Ann St,Cardiff,CF102EN,GB,123456789,GB29NWBK60161331926819,,2
3,CCcompany Ltd.,2 Wilkins Grove,Welwyn Garden City,AL86JS,GB,234567890,GB27BOFI90212729823529,,3
4,MANZANA solutions,"Calle de la Botanica, 15",Madrid,28000,ES,E73895722,ES9121000418450200051332,,4
```

<div id="store-service-account-credentials-in-windows-vault">
  ## Almacenar las credenciales de la cuenta de servicio en Windows Vault
</div>

Las credenciales de la cuenta de servicio pueden almacenarse en el archivo `config.json` del directorio del servicio ABBYY FlexiCapture Connect o, de forma más segura, en Windows Vault. Para obtener más información, consulte la documentación de Microsoft sobre [Credential Manager](https://support.microsoft.com/en-us/help/4026814/windows-accessing-credential-manager) y [cmdkey](https://docs.microsoft.com/en-us/windows-server/administration/windows-commands/cmdkey).

Para permitir que ABBYY FlexiCapture Connect recupere las credenciales de la cuenta de servicio desde Windows Vault:

<Steps>
  <Step title="Crear o elegir una cuenta de Windows">
    Cree una nueva cuenta de Windows o elija una cuenta existente.
  </Step>

  <Step title="Registrar las credenciales con cmdkey">
    Inicie `cmd.exe` con esa cuenta de Windows y ejecute el siguiente comando, donde `https://europe.flexicapture.com#tenant` es una combinación de la URL de ABBYY FlexiCapture y el nombre del tenant:

    ```text theme={null}
    cmdkey /generic:https://europe.flexicapture.com#tenant /user:userName /password:p@ssword
    ```
  </Step>

  <Step title="Eliminar las credenciales del archivo de configuración">
    Elimine el nombre de usuario y la contraseña del archivo `config.json`, ubicado en el directorio del servicio ABBYY FlexiCapture Connect.
  </Step>

  <Step title="Ejecutar el servicio con la cuenta de Windows">
    Ejecute **Windows Service Manager** (`services.msc`) y configure ABBYY FlexiCapture Connect para que se inicie con la misma cuenta de Windows que seleccionó en el segundo paso:

    1. En las propiedades de **Services**, abra **ABBYY FlexiCapture Connect**.
    2. En la pestaña **Log On**, seleccione **This account** e introduzca las credenciales de su cuenta de Windows.

    <Frame>
      <img src="https://mintcdn.com/abbyy/IFr-A2MDVJd80FDs/images/flexi-capture/FlexiCaptureConnect_WinCred1.png?fit=max&auto=format&n=IFr-A2MDVJd80FDs&q=85&s=cca7fc73ceac5af4a0846539bef88f3c" alt="Captura de pantalla de la pestaña Log On en las propiedades del servicio ABBYY FlexiCapture Connect, con This account seleccionado y las credenciales de la cuenta de Windows introducidas." width="1208" height="889" data-path="images/flexi-capture/FlexiCaptureConnect_WinCred1.png" />
    </Frame>
  </Step>
</Steps>

Para eliminar credenciales de Windows Vault:

<Steps>
  <Step title="Abrir Credential Manager">
    Abra **Credential Manager**.
  </Step>

  <Step title="Eliminar la credencial">
    En la pestaña **Windows Credentials**, expanda la credencial que desea eliminar y haga clic en **Remove**.

    <Frame>
      <img src="https://mintcdn.com/abbyy/IFr-A2MDVJd80FDs/images/flexi-capture/FlexiCaptureConnect_WinCred2.png?fit=max&auto=format&n=IFr-A2MDVJd80FDs&q=85&s=7be7120f4e81b22d617ab0b37e605d77" alt="Captura de pantalla de la pestaña Windows Credentials en Credential Manager, con una credencial expandida y la opción Remove disponible." width="1243" height="890" data-path="images/flexi-capture/FlexiCaptureConnect_WinCred2.png" />
    </Frame>
  </Step>
</Steps>

<div id="set-up-export">
  ## Configurar la exportación
</div>

Para usar ABBYY FlexiCapture Connect para exportar archivos desde ABBYY FlexiCapture Cloud, ajuste el proyecto como se describe a continuación.

<Steps>
  <Step title="Borre la ruta raíz de exportación">
    En la pestaña **General** del cuadro de diálogo **Propiedades de \<project>**, asegúrese de que el campo **Ruta raíz de exportación** esté vacío. Para obtener más información, consulte [Propiedades del proyecto](/es/flexi-capture/project-settings/project-properties).

    <Frame>
      <img src="https://mintcdn.com/abbyy/IFr-A2MDVJd80FDs/images/flexi-capture/FlexiCaptureConnect_Export1.png?fit=max&auto=format&n=IFr-A2MDVJd80FDs&q=85&s=dc787f30b73139624a9130b26223d198" alt="Captura de pantalla de la pestaña General del cuadro de diálogo Propiedades del proyecto, con el campo Ruta raíz de exportación vacío." width="526" height="594" data-path="images/flexi-capture/FlexiCaptureConnect_Export1.png" />
    </Frame>
  </Step>

  <Step title="Especifique una ruta de exportación relativa">
    En el cuadro de diálogo **Configuración de exportación**, especifique la ruta de exportación relativa a la ruta raíz indicada en la pestaña **General** del cuadro de diálogo **Propiedades de \<project>**. Como esta ruta raíz está vacía, especifique el directorio sin la ruta raíz exacta.

    <Frame>
      <img src="https://mintcdn.com/abbyy/IFr-A2MDVJd80FDs/images/flexi-capture/FlexiCaptureConnect_Export2.png?fit=max&auto=format&n=IFr-A2MDVJd80FDs&q=85&s=adddc5bc4a06839a5e101018c83a442d" alt="Captura de pantalla del cuadro de diálogo Configuración de exportación, con la ruta de exportación especificada en relación con una ruta raíz vacía." width="526" height="509" data-path="images/flexi-capture/FlexiCaptureConnect_Export2.png" />
    </Frame>
  </Step>
</Steps>

<Note>
  La opción **If file exists** se ignora. Cuando los archivos se exportan desde ABBYY FlexiCapture Cloud mediante ABBYY FlexiCapture Connect, se crea un archivo nuevo para cada documento nuevo.
</Note>

<div id="limitations">
  ## Limitaciones
</div>

La versión actual de ABBYY FlexiCapture Connect tiene las siguientes limitaciones:

* Solo se pueden sincronizar conjuntos de datos de hasta aproximadamente 500 000 registros.
* Mientras se actualiza un conjunto de datos, los usuarios no podrán buscar proveedores en las estaciones web.
* La versión actual no reconoce perfiles de importación de Hot Folder basados en la configuración del proyecto.
* ABBYY FlexiCapture Connect exportará documentos de todos los lotes disponibles en el servidor. La configuración del proyecto no afectará al nombre del directorio de destino, que siempre tendrá el mismo nombre que el lote de origen.
* ABBYY FlexiCapture Connect solo puede exportar un lote completo, lo que significa que, si desactiva la opción **Esperar a que estén todos los documentos en un lote** en la configuración del flujo de trabajo del proyecto, los documentos seguirán sin exportarse por separado.
* La versión actual no puede exportar los resultados de todos los documentos de un lote a un único archivo. Se crea un archivo independiente en el directorio de exportación para cada documento del lote.
* La versión actual no puede exportar los resultados de todos los lotes a un único archivo. Se crea un archivo independiente en el directorio de exportación para cada documento de cada lote.
* El tamaño de los archivos importados y exportados está limitado a 199 MB.
* No se admiten servidores proxy.

<div id="troubleshooting">
  ## Solución de problemas
</div>

Si encuentra un error, primero revise el archivo de registro, que puede encontrar en `%LocalAppData%\ABBYY\FlexiCapture\Connect\Logs`. Los errores también pueden deberse a ajustes incorrectos o incompletos especificados en el archivo de configuración, así que revise el archivo `config.json` por si hubiera alguna inconsistencia u omisión.

Si el error persiste, póngase en contacto con el servicio de soporte técnico de ABBYY, que puede requerir tanto el archivo `config.json` como el archivo de registro.