Saltar al contenido

Conexión de Jitterbit App Builder en Jitterbit Studio

Introducción

Una conexión de Jitterbit App Builder, creada usando el conector de Jitterbit App Builder, establece acceso a una aplicación de Jitterbit App Builder publicada como una API REST. Una vez que configures una conexión, puedes crear instancias de actividades de Jitterbit App Builder asociadas a esa conexión para usarlas como orígenes (para proporcionar datos en una operación) o como destinos (para consumir datos en una operación).

Crear o editar una conexión de Jitterbit App Builder

Se crea una nueva conexión de Jitterbit App Builder usando el conector de Jitterbit App Builder desde una de estas ubicaciones:

Se puede editar una conexión de Jitterbit App Builder existente desde estas ubicaciones:

Configurar una conexión de Jitterbit App Builder

A continuación se describe cada elemento de la interfaz de usuario de la pantalla de configuración de la conexión de Jitterbit App Builder.

Consejo

Los campos con un icono de variable permiten usar variables globales, variables del proyecto y variables de Jitterbit. Comienza escribiendo un corchete de apertura [ en el campo o haz clic en el icono de variable para mostrar un menú con las variables existentes entre las que puedas elegir.

  • Connection Name: Introduce un nombre para identificar la conexión. El nombre debe ser único para cada conexión de Jitterbit App Builder y no debe contener barras diagonales / ni dos puntos :. Este nombre también se usa para identificar el endpoint de Jitterbit App Builder, que se refiere tanto a una conexión específica como a sus actividades.

  • Hostname: Introduce el nombre de host de tu servidor de Jitterbit App Builder, sin el protocolo. Si tu instancia de App Builder se sirve desde una ruta, incluye la ruta (por ejemplo, ab.example.com o ab.example.com/production).

  • Authentication: Selecciona el método de autenticación que usa el conector para llamar a la API REST de la aplicación, uno de estos:

    • API Key: (Predeterminado.) Se autentica con una clave API. Esta opción muestra el siguiente campo:

      • API Key: Introduce la clave API configurada para la aplicación de Jitterbit App Builder a la que deseas conectarte. Esta clave se envía como encabezado X-API-KEY en cada solicitud.

    • OAuth 2.0 Client Credentials: Se autentica como una aplicación cliente registrada en el servidor de autorización de App Builder. El conector solicita un token de acceso desde https://<hostname>/connect/token y lo envía como un token portador en cada solicitud. Esta opción muestra los siguientes campos:

      • Client ID: Introduce el ID de cliente de la aplicación cliente registrada.
      • Client Secret: Introduce el secreto de cliente de la aplicación cliente registrada.
      • Scope: Introduce el alcance a solicitar. El valor predeterminado es api, que autoriza el acceso a las API REST alojadas en App Builder.

  • Autenticación básica: Se autentica con autenticación HTTP básica, usando el identificador y la clave de la clave de API de un usuario. Esta opción muestra los siguientes campos:

    -   **Identificador:** Ingresa el identificador de la clave de API.
-   **Clave:** Ingresa la clave.
    • Anónimo: Envía solicitudes sin credenciales. Usa esta opción para una aplicación cuya API REST no requiere autenticación.

  • Punto de conexión de aplicación: Selecciona el punto de conexión de API REST de la aplicación Jitterbit App Builder a la que deseas conectarte. El menú desplegable está vacío hasta que lo cargues: primero ingresa el Nombre de host, selecciona una opción de Autenticación y completa los campos que se muestran debajo de este menú desplegable; luego haz clic en Actualizar encima del menú desplegable. El menú desplegable entonces enumera, por nombre, todas las aplicaciones en tu servidor App Builder que tienen un documento OpenAPI publicado; una aplicación sin un documento publicado no aparece. Si falta un valor requerido o no se puede recuperar la lista, un diálogo No se pudieron obtener los datos describe el problema.

  • Prueba: Haz clic para verificar la conexión usando la configuración especificada. Cuando se prueba la conexión, el agente o los agentes en el grupo de agentes asociado al entorno actual descargan la versión más reciente del conector. Este conector admite suspender la descarga de la versión más reciente del conector usando la política de organización Deshabilitar actualización automática de conectores.

    Nota

    Una prueba fallida no siempre significa que las credenciales sean incorrectas. Prueba verifica la conexión en dos pasos. Primero recupera el documento OpenAPI de la aplicación para confirmar el Nombre de host y el Punto de conexión de aplicación, y luego llama a uno de los puntos de conexión de la aplicación para confirmar las credenciales de Autenticación. Si todos los puntos de conexión de la aplicación requieren un identificador de elemento en su ruta (por ejemplo, /customers/{id}), el segundo paso puede fallar incluso cuando las credenciales son correctas.

  • Guardar: Haz clic para guardar y cerrar la configuración de conexión.

  • Descartar cambios: Después de hacer cambios en una configuración nueva o existente, haz clic para cerrar la configuración sin guardar. Un mensaje te pide que confirmes que deseas descartar los cambios.

  • Eliminar: Después de abrir una configuración de conexión existente, haz clic para eliminar permanentemente la conexión del proyecto y cerrar la configuración (consulta Dependencias de componentes, eliminación y eliminación). Un mensaje te pide que confirmes que deseas eliminar la conexión.

Próximos pasos

Después de crear una conexión Jitterbit App Builder, colocas un tipo de actividad en el lienzo de diseño para crear instancias de actividad que se usen como orígenes (para proporcionar datos en una operación) o como destinos (para consumir datos en una operación).

Las acciones de menú para una conexión y sus tipos de actividad son accesibles desde el panel del proyecto y la paleta de componentes de diseño. Para obtener detalles, consulta Menús de acciones en Conceptos básicos del conector.

Estos tipos de actividad están disponibles:

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

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

  • Actualizar: Actualiza un elemento existente para un objeto en la aplicación 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 Jitterbit App Builder y está diseñado para usarse como destino en una operación.