Conector de Box¶

Resumen¶

El Harmony Box Connector establece acceso a Box.

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

Se accede al conector Box desde la pestaña Conexiones de la paleta de componentes de diseño (consulte Paleta de Componentes de Diseño).

Descripción General del Conector¶

Este conector se utiliza para configurar primero una Conexión de Box. Los tipos de actividad asociados con esa conexión se utilizan luego para crear instancias de actividades que están destinadas a usarse como fuentes (para proporcionar datos en una operación) o destinos (para consumir datos en una operación).

En conjunto, una conexión de Box específica y sus actividades se denominan extremo de Box:

Estas actividades se pueden utilizar con cualquier Box API objeto:

• Buscar: Busca contenido coincidente en Box y está diseñado para usarse como fuente en una operación.

• Consulta: Consulta datos de objetos de Box y está diseñado para usarse como fuente en una operación.

• Crear: Crea datos de objeto en Box y está diseñado para usarse como destino en una operación.

• Borrar: Elimina los datos del objeto de Box y está diseñado para usarse como objetivo en una operación.

• Copiar: Copia un archivo o carpeta en Box y está diseñado para usarse como destino en una operación.

• Actualizar: Actualiza los datos del objeto en Box y está diseñado para usarse como destino en una operación.

Estas actividades sólo se pueden utilizar con objetos Archivo:

• Descargar archivo: Descarga un archivo de Box y está diseñado para usarse como fuente en una operación.

• Subir archivo: Carga un archivo en Box y está diseñado para usarse como destino en una operación.

• Actualizar archivo: Actualiza un archivo en Box y está diseñado para usarse como destino en una operación.

• Borrar archivo: Elimina un archivo de Box y está diseñado para usarse como destino en una operación.

Requisitos Previos y Versiones de API Compatibles¶

El conector Box requiere el uso de una versión del agente 10.1 o después. Estas versiones del agente descargan automáticamente la última versión del conector cuando es necesario.

El conector Box utiliza Box Java SDK v2.28.1 y API de Box. Consulte la documentación para obtener información sobre los campos y nodos del esquema.

Para utilizar el conector Box, necesita lo siguiente como se describe en Requisitos previos de Box:

• Una aplicación personalizada de Box autorizada con autenticación JWT.
• El clientID, clientSecret, publicKeyID, privateKey, y passphrase del archivo JSON descargado automáticamente durante la creación de la aplicación.
• El ID de usuario asociado con la aplicación.

Solución de Problemas¶

Si tiene problemas con el conector Box, se recomiendan estos pasos de solución de problemas:

1. Haga clic en el botón Probar en la configuración de conexión para garantizar que la conexión sea exitosa y que se descargue la última versión del conector en el agente (a menos que se use Desactivar actualización automática del conector política de la organización).

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

3. Habilite el registro de depurar de operación (para Agentes en Nube o para Agentes Privados) para generar archivos de registro y datos adicionales.

4. Si utiliza Agentes Privados, puede habilitar registro detallado del conector para este conector utilizando esta entrada de configuración específica del nombre y nivel del registrador:

   <logger name="org.jitterbit.connector.verbose.logging.box" level="DEBUG"/>
   

5. Si utiliza Agentes Privados, puede consultar los registros de agentes para más información.