Conector Jitterbit App Builder en Jitterbit Studio

Resumen

El conector Jitterbit App Builder establece acceso a una aplicación de Jitterbit App Builder publicada como una API REST.

El conector Jitterbit App Builder proporciona una interfaz para crear una conexión de Jitterbit App Builder, que es la base para generar instancias de actividades de Jitterbit App Builder. Estas actividades, una vez configuradas, interactúan con la aplicación de Jitterbit App Builder a través de la conexión.

Se accede al conector Jitterbit App Builder desde la pestaña Project endpoints and connectors (Puntos de conexión y conectores de proyecto) de la paleta de componentes de diseño (consulta Design component palette).

Descripción general del conector

Este conector se utiliza primero para configurar una conexión de Jitterbit App Builder. Los tipos de actividades asociados a esa conexión se utilizan luego para crear instancias de actividades que se destinan a usarse como orígenes (para proporcionar datos en una operación) o destinos (para consumir datos en una operación).

En conjunto, una conexión específica de Jitterbit App Builder y sus actividades se denominan punto de conexión de Jitterbit App Builder:

• Read: Recupera uno o más elementos de un objeto en la aplicación de Jitterbit App Builder y está diseñado para usarse como origen en una operación.

• Create: Crea un nuevo elemento para un objeto en la aplicación de Jitterbit App Builder y está diseñado para usarse como destino en una operación.

• Update: Actualiza un elemento existente para un objeto en la aplicación de Jitterbit App Builder y está diseñado para usarse como destino en una operación.

• Delete: Elimina un elemento existente para un objeto en la aplicación de Jitterbit App Builder y está diseñado para usarse como destino en una operación.

Los puntos de conexión creados con este conector se excluyen de endpoint usage reporting y del recuento de licencias.

Requisitos previos y versiones de API compatibles

Los siguientes requisitos previos aplican al conector Jitterbit App Builder:

• En tu aplicación de Jitterbit App Builder, publica la aplicación como un punto de conexión de API REST y publica un documento OpenAPI (Swagger) para esa API REST. El conector Jitterbit App Builder utiliza este documento para descubrir los objetos y operaciones disponibles de la aplicación.

  Nota

  Un objeto u operación que esté excluido de la documentación publicada no aparece en las tablas de selección de objetos y operaciones del conector.

• Configura la autenticación en la API REST de la aplicación de Jitterbit App Builder que coincida con la opción Authentication de la conexión, y reúne las credenciales que requiere. Por ejemplo, para la opción API Key, configura la autenticación por clave de API y genera una clave de API. Consulta Conexión de Jitterbit App Builder para las opciones disponibles.

• Si la fuente de datos de la aplicación utiliza autorización basada en roles, el usuario de App Builder que la conexión autentica debe pertenecer a un grupo con un rol que otorgue el permiso que cada actividad necesita en los objetos que utiliza. Ese usuario es el propietario de las credenciales en la configuración de autenticación de la conexión:

Se puede usar este conector con agentes en la nube y agentes privados.

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

Solución de problemas

Si se experimentan problemas con el conector de Jitterbit App Builder, se recomiendan los siguientes pasos para solucionarlos:

1. Se hace clic en el botón Test en la configuración de conexión para asegurar que la conexión sea exitosa y para asegurar que la última versión del conector se descargue en el agente (a menos que se use la política organizacional Disable Auto Connector Update). Véase la nota bajo Test en Jitterbit App Builder connection para un caso donde una prueba fallida no necesariamente significa que las credenciales sean incorrectas.

2. Si una actividad falla para un objeto al que la conexión de otro modo puede acceder, se verifica que el usuario de App Builder como el que se autentica la conexión tenga el permiso de rol que la actividad requiere en ese objeto.

3. Se revisan los registros de operación para cualquier información escrita durante la ejecución de la operación.

4. Se habilita el registro de depuración de operación (para agentes en la nube o para agentes privados) para generar archivos de registro y datos adicionales.

5. Si se usan agentes privados, se puede habilitar el registro detallado del conector para este conector agregando esta entrada de configuración de registrador al archivo logback.xml del agente privado:

   <logger name="org.jitterbit.connector.appbuilder" level="DEBUG"/>
   

   Para obtener más información sobre el registro detallado del conector, véase Registro detallado para conectores utilizando agentes privados de Jitterbit.

6. Si se usan agentes privados, se puede revisar el registro del agente para obtener más información.

7. Para consideraciones adicionales sobre solución de problemas, véase Operation troubleshooting.