Saltar al contenido

Conector de Microsoft Excel v3 (Beta) en Jitterbit Studio

Resumen

El conector de Microsoft Excel v3 (Beta) establece acceso a archivos de libros de Microsoft Excel almacenados en el sistema de archivos del agente, dentro del directorio de instalación del agente o en una ubicación de red.

El conector de Microsoft Excel v3 (Beta) proporciona una interfaz para crear una conexión de Microsoft Excel v3 (Beta), la base utilizada para generar instancias de actividades de Microsoft Excel v3 (Beta). Estas actividades, una vez configuradas, interactúan con Microsoft Excel a través de la conexión.

Se accede al conector de Microsoft Excel v3 (Beta) desde la pestaña Project endpoints and connectors de la paleta de componentes de diseño (consulta Design component palette).

Nota

Este conector se encuentra actualmente en beta. Para enviar comentarios, contacta al Equipo de Producto de Jitterbit.

Descripción general del conector

Este conector se utiliza primero para configurar una conexión de Microsoft Excel v3 (Beta). Los tipos de actividad asociados a esa conexión se utilizan posteriormente para crear instancias de actividades que se pretende usar como orígenes u objetivos (para proporcionar o consumir datos en una operación).

En conjunto, una conexión específica de Microsoft Excel v3 (Beta) y sus actividades se conocen como un punto de conexión de Microsoft Excel v3 (Beta):

Tipos de actividad de Microsoft Excel v3

  • Update Rows: Actualiza una o más filas existentes de una hoja de cálculo y se pretende usar como objetivo en una operación.

  • Insert Rows: Escribe una o más filas en una hoja de cálculo y se pretende usar como objetivo en una operación.

  • Delete Rows: Elimina una o más filas existentes de una hoja de cálculo y se pretende usar como objetivo en una operación.

  • Read Rows: Lee filas de una hoja de cálculo y se pretende usar como origen en una operación.

Los puntos de conexión creados con este conector se incluyen en endpoint usage reporting y cuentan hacia tu licencia.

Requisitos previos y versiones de API compatibles

Este conector se puede utilizar solo con agentes privados y requiere la versión 12.3 del agente privado o posterior. No es compatible con la versión 11.x del agente privado.

Los agentes descargan automáticamente la versión más reciente de este conector cuando es necesario. En agentes privados, puedes suspender estas actualizaciones con la política de organización Disable Auto Connector Update.

Este conector lee y escribe archivos de libros (.xlsx y .xls) en la carpeta configurada en el campo Local Path de la conexión, por lo que no se requiere autenticación y no aplica ninguna versión de API externa. Esta carpeta puede ser una ubicación en el sistema de archivos del agente, dentro del directorio de instalación del agente o en una ubicación de red, siempre y cuando el agente pueda acceder a la ruta configurada.

Importante

En agentes privados de Linux, otorga acceso de lectura y escritura tanto a la carpeta configurada como a sus archivos a la cuenta de usuario que ejecuta el servicio del agente. Si esta cuenta no tiene suficiente acceso, las actividades fallan con un error similar a:

The "{activityName}" activity failed. /opt/jitterbit/dev/excel/sample.xlsx (Permission denied)

Solución de problemas

Si experimentas problemas con el conector Microsoft Excel v3 (Beta), se recomiendan estos pasos para solucionar problemas:

  1. Haz clic en el botón Test en la configuración de conexión para asegurar que la conexión sea exitosa y para verificar que se descargue la versión más reciente del conector en el agente (a menos que se utilice la política de organización Disable Auto Connector Update).

  2. Revisa los registros de operación para obtener cualquier información escrita durante la ejecución de la operación.

  3. Habilita registro de depuración de operación para agentes privados para generar archivos de registro y datos adicionales.

  4. Habilita registro detallado del conector para este conector agregando esta entrada de configuración de logger al archivo logback.xml de tu agente privado:

    <logger name="org.jitterbit.connector.excelv3" level="TRACE"/>
    

    Para obtener más información sobre el registro detallado del conector, consulta Registro detallado para conectores que utilizan agentes privados de Jitterbit.

  5. Revisa los registros del agente para obtener más información.

  6. Para consideraciones de solución de problemas adicionales, consulta Solución de problemas de operación.