Saltar al contenido

Conector API para Jitterbit Studio

Resumen

El conector API expone una operación o un conjunto de operaciones como un punto final REST consumible. Viene con una conexión preconfigurada que no requiere configuración de conexión, como es típico en la mayoría de los conectores de Harmony. Esta conexión proporciona acceso a actividades de API que, una vez configuradas, interactúan con APIs personalizadas configuradas en Jitterbit API Manager.

El conector API se accede desde la pestaña Puntos finales y conectores del componente de diseño en la paleta de componentes de diseño (ver Paleta de componentes de diseño).

Para obtener información sobre la relación entre las actividades del conector API y las APIs del API Manager, consulte estos recursos:

Importante

De forma predeterminada, las operaciones API exitosas (configuradas para APIs personalizadas o APIs OData) no se incluyen en los registros de operaciones a menos que se habilite una de estas configuraciones:

  • Agentes en la nube: Para operaciones API en un agente en la nube, se debe habilitar el registro de depuración de operaciones en la operación.
  • Agentes privados: Para operaciones API en un agente privado, se debe habilitar el registro de depuración de operaciones en la operación o se debe establecer EnableLogging=true en la sección [APIoperation] del archivo de configuración del agente privado.

    • Descripción general del conector

    Este conector está destinado a ser utilizado junto con una API Manager custom API para exponer una operación o un conjunto de operaciones como un endpoint REST consumible.

    Los tipos de actividad se utilizan para crear instancias de actividades que están destinadas a ser utilizadas como fuentes (para proporcionar datos en una operación) o destinos (para consumir datos en una operación).

    Juntos, la conexión API preconfigurada y sus actividades se denominan un endpoint API:

    API activity types

    • Request: Configurada utilizando un esquema JSON, XML, CSV o XSD, esta actividad recupera datos cuando es llamada por una API Manager custom API y está destinada a ser utilizada como una fuente para proporcionar datos a una operación.

    • Response: Configurada utilizando un esquema JSON, XML, CSV o XSD, esta actividad devuelve datos a una API Manager custom API y está destinada a ser utilizada como un destino para consumir datos en una operación.

    • SOAP Request: Configurada utilizando un esquema WSDL, esta actividad recupera datos cuando es llamada por una API Manager custom API y está destinada a ser utilizada como una fuente para proporcionar datos a una operación.

    • SOAP Response: Configurada utilizando un esquema WSDL, esta actividad devuelve datos a una API Manager custom API y está destinada a ser utilizada como un destino para consumir datos en una operación.

    Nota

    Este conector es un conector nativo de Studio, que puede ser mencionado por Jitterbit al comunicar cambios realizados en los conectores. El release schedule para conectores nativos de Studio se basa en la cadencia de las aplicaciones web del portal Harmony.

    Los endpoints creados con este conector no cuentan para tu licencia y no están incluidos en el informe de uso de endpoints.

    Variables de API Jitterbit

    Estas variables de Jitterbit se proporcionan específicamente para su uso con endpoints de API:

    Solución de problemas

    Si experimentas problemas con el conector de API, se recomiendan los siguientes pasos de solución de problemas:

    1. Asegúrate de que la conexión API sea exitosa utilizando el botón Probar en la pantalla de configuración. Si la conexión no es exitosa, el error devuelto puede proporcionar una indicación del problema.

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

    3. Habilita el registro de depuración de operaciones (para agentes en la nube o para agentes privados) para generar archivos de registro y datos adicionales.

    4. Si utilizas agentes privados, puedes revisar los registros de agentes para obtener más información.

    5. Para consideraciones adicionales de solución de problemas, consulta Solución de problemas de operaciones.

    6. Solicitud SOAP y Actividades de respuesta SOAP: Al implementar una operación cuya actividad de Solicitud SOAP o Respuesta SOAP tiene un archivo WSDL que ha sido reemplazado, puedes recibir este error:

      Falló la implementación - Error del cliente: No hay un archivo subido con la ruta del cliente ... Actualiza a la versión 8.4.0 de Studio o superior y vuelve a implementar el proyecto.

      Para resolver, sigue estos pasos:

      1. Abre la actividad donde se ha reemplazado el archivo WSDL.

      2. En el paso 1, vuelve a seleccionar el archivo WSDL que se utilizará para la actividad y luego haz clic en Siguiente.

      3. En el paso 2, haz clic en Finalizar.

      4. Implementa la operación.