Consideraciones de conectores basados en REST en Jitterbit Studio

Introducción

Se pueden usar múltiples conectores de Studio para conectarse a servicios web RESTful, también conocidos como API REST. Esta página proporciona consideraciones para elegir qué conector usar, seleccionando entre dos conectores HTTP genéricos o numerosos conectores específicos de aplicaciones. También se pueden crear conectores personalizados basados en REST.

Consideraciones de alto nivel y deprecación futura

Los conectores de aplicaciones a menudo incluyen características específicas del endpoint que son más fáciles de configurar usando el conector específico en lugar de los conectores genéricos. Sin embargo, los conectores genéricos generalmente permiten más flexibilidad en la configuración. Los conectores personalizados ofrecen opciones adicionales que requieren trabajo inicial para crear, pero facilitan que los usuarios usen tu conector de marca con configuraciones que de otro modo podrían no estar disponibles.

Conectores genéricos

Jitterbit proporciona dos conectores genéricos para conectarse con API REST:

HTTP: El conector HTTP es el conector HTTP original de Jitterbit cuyo código subyacente ha estado en uso durante más de una década. Este conector es probado y confiable, pero es difícil de extender y mantener. Por lo tanto, el desarrollo futuro no se enfocará en este conector.
HTTP v2: El conector HTTP v2 es la siguiente versión del conector HTTP de Jitterbit. Ha sido reconstruido para permitir que nuevas características estén disponibles más rápidamente. El conector HTTP v2 tiene soporte para tipos de autenticación adicionales, conexiones keep-alive y parámetros de URL en esquemas de solicitud/respuesta. El desarrollo futuro se enfocará en este conector.

Jitterbit admite tanto los conectores HTTP como HTTP v2.

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

Conectores de aplicaciones

Numerosos conectores de aplicaciones están disponibles y continúan siendo desarrollados.

En la mayoría de los casos, si hay un conector de aplicación disponible para tu endpoint, se te recomienda usarlo en lugar de uno de los conectores HTTP genéricos. Los conectores de aplicaciones a menudo incluyen características específicas del endpoint que son más fáciles de configurar usando el conector específico en lugar de los conectores genéricos. Sin embargo, si tienes una necesidad específica que no está disponible en el endpoint de la aplicación, usar un conector genérico es una alternativa lógica.

Considerando la intención de Jitterbit de eventualmente deprecar el conector HTTP, recomendamos usar conectores de aplicaciones o el conector HTTP v2 en nuevos diseños de proyectos siempre que sea posible.

Conectores personalizados

Para mayor flexibilidad, puedes crear conectores personalizados usando Connector Builder o el Connector SDK:

Connector Builder
Los conectores personalizados de Connector Builder pueden diseñarse para usar autenticación básica o ninguna. Durante la creación del conector, seleccionas entre los métodos HTTP compatibles de GET, POST, PUT, DELETE, PATCH o MERGE para crear las actividades correspondientes que los usuarios puedan configurar.
Connector SDK
Los conectores personalizados de Connector SDK pueden diseñarse para usar cualquier tipo de autenticación, y se puede integrar soporte para cualquier método en el conector. Este tipo de conector personalizado ofrece la máxima flexibilidad, ya que un desarrollador puede agregar mejoras según las necesidades de tu organización.

Matriz de capacidades para conectores de Jitterbit

Capacidad del conector	Conector HTTP v2	Conector HTTP	Conector específico de aplicación
Compatibilidad con autorización	Una conexión HTTP v2 admite estos tipos de autorización: Clave de API Firma de AWS Autorización básica Token de portador Autorización implícita Autorización Hawk Sin autorización Autorización NTLM OAuth 2.0 (de 2 y 3 patas)	Una conexión HTTP admite estos tipos de autorización: Autorización básica Autorización implícita	La compatibilidad varía según el conector.
Compatibilidad con métodos HTTP	El conector HTTP v2 admite estos métodos con estas actividades del mismo nombre: GET POST PUT DELETE PATCH HEAD OPTIONS	El conector HTTP admite estos métodos con estas actividades del mismo nombre: GET POST PUT DELETE Personalizado (cualquier verbo especificado por el usuario)	La compatibilidad varía según el conector.
Compatibilidad con patrones de operación para actividades utilizadas como orígenes	Las actividades HTTP v2 utilizadas como origen se pueden usar con estos patrones: Patrón de transformación Patrón de archivo de dos destinos (solo como primer origen) Patrón de archivo HTTP de dos destinos (solo como primer origen) Patrón de dos transformaciones (como primer o segundo origen)	Las actividades HTTP utilizadas como origen se pueden usar con estos patrones: Patrón de archivo Patrón de transformación Patrón de archivo de dos destinos (solo como primer origen) Patrón de archivo HTTP de dos destinos (como primer o segundo origen) (Consulta Nota para actividades HTTP GET debajo de esta tabla.) Patrón de dos transformaciones (solo como primer origen) Patrón de destino masivo de Salesforce	La compatibilidad varía según el conector. La mayoría de las actividades de conector específico de aplicación utilizadas como origen se pueden usar con estos patrones: Patrón de transformación Patrón de archivo de dos destinos (solo como primer origen) Patrón de archivo HTTP de dos destinos (solo como primer origen) Patrón de dos transformaciones (como primer o segundo origen)
Compatibilidad con patrones de operación para actividades utilizadas como destinos	Las actividades HTTP v2 utilizadas como destino se pueden usar con estos patrones: Patrón de transformación Patrón de dos transformaciones (como primer o segundo destino)	Las actividades HTTP utilizadas como destino se pueden usar con estos patrones: Patrón de archivo Patrón de script Patrón de transformación Patrón de archivo de dos destinos (solo como segundo destino) Patrón de archivo HTTP de dos destinos (como primer o segundo destino) (Consulta Nota para actividades HTTP GET debajo de esta tabla.) Patrón de dos transformaciones (solo como segundo destino) Patrón de origen masivo de Salesforce	La compatibilidad varía según el conector. La mayoría de las actividades de conector específico de aplicación utilizadas como destino se pueden usar con estos patrones: Patrón de transformación Patrón de dos transformaciones (como primer o segundo destino)
Compatibilidad con esquemas	Los esquemas de solicitud y respuesta personalizados son opcionales y puede proporcionarlos el usuario durante la configuración de la actividad HTTP v2. Si no se proporcionan esquemas personalizados en la configuración de la actividad, se utilizarán esquemas predeterminados que admitan un diseño de API REST general.	Los esquemas de solicitud y respuesta personalizados son opcionales y puede proporcionarlos el usuario durante la configuración de la actividad HTTP.	La compatibilidad varía según el conector. Los esquemas de solicitud y respuesta se pueden generar directamente desde el punto de conexión o puede haber compatibilidad con esquemas personalizados.
Funciones de Jitterbit y JavaScript basadas en archivos	Escribe los datos en un archivo temporal y luego usa la ruta de referencia de cadena a esa actividad de archivo temporal como parámetro de función `sourceId` o `targetId`.	Usa la ruta de referencia de cadena a la actividad como parámetro de función `sourceId` o `targetId`.	Escribe los datos en un archivo temporal y luego usa la ruta de referencia de cadena a esa actividad de archivo temporal como parámetro de función `sourceId` o `targetId`. Algunos conectores pueden tener compatibilidad adicional.
Número de reintentos	Máximo de 5 reintentos enviados en intervalos de hasta 5 segundos. Compatible solo en agentes privados.	Máximo superior (se recomienda no más de 5 reintentos) en intervalos de hasta 5 segundos. Compatible solo en agentes privados.	La compatibilidad varía según el conector.
Tiempo de espera de transferencia	30 segundos de forma predeterminada. La clave `connection-timeout` en el área Configuración adicional de la configuración de la actividad HTTP v2 se puede usar para cambiar el tiempo de espera de transferencia.	3600 segundos de forma predeterminada. Las variables de origen de Jitterbit y variables de destino cuyos nombres terminan con `http.transfer.timeout` se pueden usar para cambiar el tiempo de espera de transferencia.	La compatibilidad varía según el conector.
Compatibilidad con redirecciones	50 redirecciones de forma predeterminada. La clave `max-redirect` en el área Configuración adicional de la configuración de la actividad HTTP v2 se puede usar para cambiar el número de redirecciones a seguir.	Las redirecciones no se siguen de forma predeterminada. Las variables de origen de Jitterbit y variables de destino cuyos nombres terminan con `http.max_redirs` se pueden usar para permitir que se sigan las redirecciones.	La compatibilidad varía según el conector.
Compatibilidad con datos de formulario	La configuración Multiparte de la configuración de la actividad HTTP v2 POST, PUT y PATCH se puede usar para admitir cargas de formulario RFC 1687 cuando se usan esquemas predeterminados. No compatible con esquemas personalizados.	Las variables de destino de Jitterbit cuyos nombres incluyen `http.form_data` se pueden usar con cargas de formulario RFC 1687.	La compatibilidad varía según el conector.
Compatibilidad con la eliminación de espacios en blanco finales y saltos de línea	Los espacios en blanco y saltos de línea de solicitud se dejan sin cambios de forma predeterminada. La clave `trailing-linebreaks` en el área Configuración adicional de la configuración de la actividad HTTP v2 se puede establecer en true para eliminar espacios en blanco y saltos de línea iniciales y finales.	La variable de destino de Jitterbit `http.remove_trailing_linebreaks` se puede usar para eliminar espacios en blanco y saltos de línea iniciales y finales.	La compatibilidad varía según el conector.
Configuración de mantener vivo	La configuración Mantener vivo en una conexión HTTP v2 se puede usar para mantener abierta una única conexión TCP para múltiples solicitudes y respuestas HTTP.	No compatible.	La compatibilidad varía según el conector.
Compatibilidad con cookies	No compatible.	Compatible solo si se usa un agente privado y la configuración `jitterbit.http.enable_cookies` se establece en `true` en el archivo de configuración del agente (`jitterbit.conf`).	La compatibilidad varía según el conector.
Compatibilidad con certificados personalizados	No compatible.	Se puede especificar un certificado para autenticarse con el servidor HTTP usando el campo Certificado de una conexión HTTP.	La compatibilidad varía según el conector.
Compatibilidad con Expect: 100-continue	No compatible.	El encabezado Expect: 100 continue se envía cuando se selecciona Enviar `Expect 100-continue` en una conexión HTTP.	La compatibilidad varía según el conector.
Compatibilidad con cifrados débiles	La configuración Agregar cifrados en una conexión HTTP v2 se puede usar para definir manualmente cifrados débiles.	Se pueden usar servidores HTTP que usan cifrados débiles (DES/3DES y RC4) cuando se selecciona Permitir cifrados débiles en una conexión HTTP.	La compatibilidad varía según el conector.
Compatibilidad con complementos de Jitterbit	No compatible.	Los complementos de Jitterbit están disponibles para configurar en el último paso de la configuración de la actividad HTTP (consulta Complementos agregados a una actividad).	No compatible.
Compatibilidad con registro en agentes privados	El conector HTTP v2 admite registro detallado del conector.	El conector HTTP admite registro de depuración de Curl.	La compatibilidad varía según el conector.

Nota para actividades HTTP GET

Cuando se utiliza una actividad HTTP GET como Actividad de destino 1 / Actividad de origen 2 en el Patrón de archivo HTTP de dos destinos, la actividad devuelve un mensaje indicando éxito {"success": true} o fallo {"success": false} en lugar de la respuesta real.

Funciones basadas en archivos de Jitterbit y JavaScript

A continuación se enumeran las funciones basadas en archivos de Jitterbit y JavaScript. Las actividades del conector HTTP se pueden usar directamente como parámetro de función. Para usar con conectores HTTP v2 y de aplicaciones, escribe los datos en un archivo temporal y luego usa ese archivo temporal en la función de scripting.

Funciones de Jitterbit

Funciones JavaScript de Jitterbit