Conector API para Jitterbit Integration Studio

Resumen

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

Se accede al conector API desde la pestaña extremos y conectores del proyecto de la paleta de componentes de diseño (consulte paleta de componentes de diseño).

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

• Tipos de API de API Manager

• Configuración de API personalizada

• Construcción de una API personalizada sencilla

Importante

De forma predeterminada, las operaciones de API exitosas (configuradas para APIs personalizadas o servicios OData) no están incluidos en los registros de operación a menos que una de estas configuraciones esté habilitada:

Agentes de la nube: Para las operaciones de API en un agente de la nube, registro de depurar de operación debe estar habilitado en la operación.

Agentes privados: Para las operaciones de API en un agente privado, registro de depurar de la operación debe estar habilitado en la operación o debe configurar EnableLogging=true en el [APIoperation] sección del archivo de configuración del agente privado.

Descripción general del conector

Este conector está diseñado para usarse junto con una API personalizada de API Manager para exponer una operación o un conjunto de operaciones como un extremo REST consumible.

Los tipos de actividad se utilizan 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, la conexión API preconfigurada y sus actividades se denominan extremo de API:

• Solicitud: Configurada mediante un esquema JSON, XML, CSV o XSD, esta actividad recupera datos cuando la llama una API personalizada de API Manager y está destinado a ser utilizado como fuente para proporcionar datos a una operación.

• Respuesta: Configurada mediante un esquema JSON, XML, CSV o XSD, esta actividad devuelve datos a una API personalizada de API Manager y está destinado a ser utilizado como un objetivo para consumir datos en una operación.

• Solicitud SOAP: Configurada mediante un esquema WSDL, esta actividad recupera datos cuando la llama una API personalizada de API Manager y está destinado a ser utilizado como fuente para proporcionar datos a una operación.

• Respuesta SOAP: Configurada mediante un esquema WSDL, esta actividad devuelve datos a una API personalizada de API Manager y está destinado a ser utilizado como un objetivo para consumir datos en una operación.

Nota

Este conector es nativo Integration Studio Conector, al que Jitterbit puede hacer referencia cuando comunica cambios realizados en los conectores. El programa de lanzamiento para nativos Integration Studio Los conectores se basan en la cadencia de las aplicaciones web del portal Harmony.

Variables de API Jitterbit

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

• jitterbit.api.request.body y jitterbit.api.request.body.*

• jitterbit.api.request.enum.body

• jitterbit.api.request.enum.headers

• jitterbit.api.request.enum.mvparameters

• jitterbit.api.request.enum.parameters

• jitterbit.api.request.headers.*

• jitterbit.api.request.headers.fulluri

• jitterbit.api.request.method

• jitterbit.api.request.mvparameters.*

• jitterbit.api.request.parameters.*

• jitterbit.api.response

• jitterbit.api.response.headers.*

• jitterbit.api.response.status_code

Solución de problemas

Si experimenta problemas con el conector API, se recomiendan estos pasos de solución de problemas:

1. Asegúrese de la conexión API se realiza correctamente utilizando el botón Probar en la pantalla de configuración. Si la conexión no se realiza correctamente, el error que aparece puede indicar cuál es el problema.

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

3. Habilitar el registro de depurar de operación (para agentes de la nube o para agentes privados) para generar archivos de registro y datos adicionales.

4. Si utiliza agentes privados, puede consultar los registros de agentes para obtener más información.

5. Para obtener más información sobre la solución de problemas, consulte Solución de problemas de funcionamiento.

6. Solicitud SOAP y Actividades de respuesta SOAP: Al desplegar una operación cuyo archivo WSDL de la actividad Solicitud SOAP o Respuesta SOAP ha sido reemplazado, puede recibir este error:

   Failed to deploy - Client Error: There is no uploaded file with client path ... Upgrade to the 8.4.0 Studio or higher and deploy the project again.

   Para resolverlo, siga estos pasos:

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

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

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

   4. Desplegar la operación.