Conector HTTP v2 para Jitterbit Studio

Resumen

El conector HTTP v2 establece acceso a través del protocolo HTTP o HTTPS a un servicio como una API REST, API GraphQL o un formulario web.

El conector HTTP v2 proporciona una interfaz para crear una conexión HTTP v2, la base utilizada para generar instancias de actividades HTTP v2. Estas actividades, una vez configuradas, interactúan con un servicio accesible a través del protocolo HTTP o HTTPS mediante la conexión.

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

Para otras formas de conectarse a un servicio web RESTful y una comparación con el conector HTTP, consulte Consideraciones sobre conectores basados en REST.

Importante

Con el lanzamiento del conector HTTP v2, recomendamos convertir las conexiones y actividades HTTP existentes a HTTP v2. Obtenga más información sobre los beneficios del conector HTTP v2 en nuestro artículo de blog sobre HTTP v2 o consulte una comparación de las características de los conectores HTTP y HTTP v2.

La intención a largo plazo de Jitterbit es descontinuar el conector HTTP, lo cual se anunciará de acuerdo con la política de fin de vida de Jitterbit. En la actualidad, no hay un cronograma para la descontinuación y el conector HTTP sigue siendo totalmente compatible. Recomendamos que convierta las conexiones y actividades HTTP existentes a HTTP v2 cuando sea posible.

Descripción general del conector

Este conector se utiliza para primero configurar una conexión HTTP v2. Los tipos de actividad asociados con esa conexión se utilizan luego para crear instancias de actividades que pueden ser utilizadas como fuentes (para proporcionar datos en una operación) o destinos (para consumir datos en una operación).

Si una instancia de actividad puede ser utilizada como fuente o destino depende de si el servicio web requiere una solicitud estructurada o devuelve una respuesta estructurada. Cada instancia de actividad puede configurarse con esquemas de solicitud y respuesta utilizando esquemas personalizados proporcionados por el usuario o esquemas predeterminados incluidos con el conector.

Juntos, una conexión HTTP v2 específica y sus actividades se denominan un endpoint HTTP v2:

Tipos de actividad HTTP v2

PATCH: Aplica modificaciones parciales a un recurso existente en un servicio accesible a través del protocolo HTTP o HTTPS y puede ser utilizado como fuente o destino en una operación.
HEAD: Recupera la línea de estado y la sección de encabezado de un recurso en un servicio accesible a través del protocolo HTTP o HTTPS y puede ser utilizado como fuente o destino en una operación.
POST: Crea un nuevo recurso en un servicio accesible a través del protocolo HTTP o HTTPS y puede ser utilizado como fuente o destino en una operación.
GET: Recupera información sobre un recurso en un servicio accesible a través del protocolo HTTP o HTTPS y puede ser utilizado como fuente o destino en una operación.
OPTIONS: Recupera información sobre las opciones de comunicación para un recurso en un servicio accesible a través del protocolo HTTP o HTTPS y puede ser utilizado como fuente o destino en una operación.
BULK: Envía múltiples solicitudes a un servicio accesible a través del protocolo HTTP o HTTPS y puede ser utilizado como fuente o destino en una operación.
DELETE: Elimina un recurso en un servicio accesible a través del protocolo HTTP o HTTPS y puede ser utilizado como fuente o destino en una operación.
PUT: Reemplaza un recurso existente en un servicio accesible a través del protocolo HTTP o HTTPS y puede ser utilizado como fuente o destino en una operación.

Nota

Este conector es un conector basado en Connector SDK, que puede ser mencionado por Jitterbit al comunicar cambios realizados en conectores construidos con el Connector SDK.

Los puntos finales creados con este conector están incluidos en informes de uso de puntos finales y cuentan para su licencia.

Prerrequisitos y versiones de API soportadas

El conector HTTP v2 requiere el uso de una versión de agente 10.1 o posterior. Estas versiones de agente descargan automáticamente la última versión del conector cuando es necesario.

El conector HTTP v2 se utiliza para interactuar con un servicio accesible a través del protocolo HTTP o HTTPS utilizando una API REST especificada por el usuario, API GraphQL o formulario web. Los esquemas de solicitud y respuesta del conector HTTP v2 se definen a partir de esquemas personalizados proporcionados por el usuario o esquemas predeterminados incluidos con el conector.

Solución de problemas

Si experimenta problemas con el conector HTTP v2, se recomiendan los siguientes pasos de solución de problemas:

Haga clic en el botón Probar en la configuración de conexión para asegurarse de que la conexión sea exitosa y de que la última versión del conector se descargue al agente (a menos que esté utilizando la política de organización Deshabilitar actualización automática del conector).
Revise los registros de operación para cualquier información escrita durante la ejecución de la operación.
Habilite el registro de depuración de operaciones (para agentes en la nube o para agentes privados) para generar archivos de registro y datos adicionales.
Si utiliza agentes privados, puede habilitar el registro detallado del conector para este conector agregando esta entrada de configuración de registro al archivo logback.xml de su agente privado:

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

Para obtener más información sobre el registro detallado del conector, consulte Registro detallado para conectores que utilizan agentes privados de Jitterbit.

Si utiliza agentes privados, puede consultar los registros de agentes para obtener más información.
Para consideraciones adicionales de solución de problemas, consulte Solución de problemas de operación.