Consideraciones del conector basado en REST en Jitterbit Integration Studio

Introducción

Se pueden utilizar múltiples conectores de Integration Studio para conectarse a servicios web RESTful, también conocidos como APIs REST. Esta página proporciona consideraciones para elegir qué conector utilizar, 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 generales y futura descontinuación

Los conectores de aplicaciones a menudo incluyen características específicas de puntos finales que son más fáciles de configurar utilizando 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 previo para crear, pero facilitan a los usuarios el uso de su 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 a APIs 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 centrará en este conector.
HTTP v2: El conector HTTP v2 es la próxima versión del conector HTTP de Jitterbit. Ha sido reconstruido utilizando el Connector SDK extensible de Jitterbit, lo que permite 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 centrará en este conector.

Jitterbit admite tanto los conectores HTTP como los conectores HTTP v2.

La intención a largo plazo de Jitterbit es desaprobar 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 desaprobació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 aplicación

Numerosos conectores de aplicación están disponibles y continúan en desarrollo.

En la mayoría de los casos, si hay un conector de aplicación disponible para tu punto final, se te anima a usarlo en lugar de uno de los conectores HTTP genéricos. Los conectores de aplicación a menudo incluyen características específicas del punto final que son más fáciles de configurar utilizando 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 punto final de la aplicación, usar un conector genérico es una alternativa lógica.

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

Conectores personalizados

Para una flexibilidad extendida, puedes crear conectores personalizados utilizando el Constructor de Conectores o el SDK de Conectores:

Constructor de Conectores
Los conectores del Constructor de Conectores personalizados pueden diseñarse para usar autenticación básica o ninguna autenticación. Durante la creación del conector, seleccionas entre los métodos HTTP admitidos de GET, POST, PUT, DELETE, PATCH o MERGE para crear las actividades correspondientes que los usuarios pueden configurar.
SDK de Conectores
Los conectores del SDK de Conectores personalizados pueden diseñarse para usar cualquier tipo de autenticación, y se puede incorporar soporte para cualquier método en el conector. Este tipo de conector personalizado ofrece la mayor flexibilidad, ya que un desarrollador puede agregar mejoras de acuerdo con 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 la aplicación
Soporte de autorización	Una conexión HTTP v2 soporta estos tipos de autorización: Clave API Firma de AWS Autorización básica Token Bearer Autorización Digest Sin autorización OAuth 2.0	Una conexión HTTP soporta estos tipos de autorización: Autorización básica Autorización Digest	El soporte varía según el conector.
Soporte de método HTTP	El conector HTTP v2 soporta estos métodos con estas actividades del mismo nombre: GET POST PUT DELETE PATCH HEAD OPTIONS	El conector HTTP soporta estos métodos con estas actividades del mismo nombre: GET POST PUT DELETE Personalizado (cualquier verbo especificado por el usuario)	El soporte varía según el conector.
Soporte de patrones de operación para actividades utilizadas como fuentes	Las actividades HTTP v2 utilizadas como fuente pueden usarse con estos patrones: Patrón de transformación Patrón de archivo de dos objetivos (solo como la primera fuente) Patrón de archivo HTTP de dos objetivos (solo como la primera fuente) Patrón de dos transformaciones (como la primera o segunda fuente)	Las actividades HTTP utilizadas como fuente pueden usarse con estos patrones: Patrón de archivo Patrón de transformación Patrón de archivo de dos objetivos (solo como la primera fuente) Patrón de archivo HTTP de dos objetivos (como la primera o segunda fuente) (Ver Nota para actividades HTTP GET debajo de esta tabla.) Patrón de dos transformaciones (solo como la primera fuente) Patrón de destino masivo de Salesforce	El soporte varía según el conector. La mayoría de las actividades de conectores específicos de la aplicación utilizadas como fuente pueden usarse con estos patrones: Patrón de transformación Patrón de archivo de dos objetivos (solo como la primera fuente) Patrón de archivo HTTP de dos objetivos (solo como la primera fuente) Patrón de dos transformaciones (como la primera o segunda fuente)
Soporte de patrones de operación para actividades utilizadas como objetivos	Las actividades HTTP v2 utilizadas como objetivo pueden usarse con estos patrones: Patrón de transformación Patrón de dos transformaciones (como el primer o segundo objetivo)	Las actividades HTTP utilizadas como objetivo pueden usarse con estos patrones: Patrón de archivo Patrón de script Patrón de transformación Patrón de archivo de dos objetivos (solo como el segundo objetivo) Patrón de archivo HTTP de dos objetivos (como el primer o segundo objetivo) (Ver Nota para actividades HTTP GET debajo de esta tabla.) Patrón de dos transformaciones (solo como el segundo objetivo) Patrón de origen masivo de Salesforce	El soporte varía según el conector. La mayoría de las actividades de conectores específicos de la aplicación utilizadas como objetivo pueden usarse con estos patrones: Patrón de transformación Patrón de dos transformaciones (como el primer o segundo objetivo)
Soporte de esquema	Los esquemas de solicitud y respuesta personalizados son opcionales y pueden ser proporcionados por 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 soportan un diseño general de API REST.	Los esquemas de solicitud y respuesta personalizados son opcionales y pueden ser proporcionados por el usuario durante la configuración de la actividad HTTP.	El soporte varía según el conector. Los esquemas de solicitud y respuesta pueden generarse directamente desde el punto final o puede estar disponible el soporte para esquemas personalizados.
Funciones de Jitterbit y JavaScript basadas en archivos	Escriba los datos en un archivo temporal y luego use la ruta de referencia de cadena a esa actividad de archivo temporal como el parámetro de función `sourceId` o `targetId`.	Use la ruta de referencia de cadena a la actividad como el parámetro de función `sourceId` o `targetId`.	Escriba los datos en un archivo temporal y luego use la ruta de referencia de cadena a esa actividad de archivo temporal como el parámetro de función `sourceId` o `targetId`. Algunos conectores pueden tener soporte adicional.
Número de reintentos	Máximo de 5 reintentos enviados a intervalos de hasta 5 segundos. Soportado solo en agentes privados.	Máximo más alto (se recomienda no más de 5 reintentos) a intervalos de hasta 5 segundos. Soportado solo en agentes privados.	El soporte varía según el conector.
Tiempo de espera de transferencia	30 segundos por defecto. La clave `connection-timeout` en el área de Configuraciones adicionales de la configuración de la actividad HTTP v2 puede usarse para cambiar el tiempo de espera de transferencia.	3,600 segundos por defecto. Las variables de origen de Jitterbit y variables de destino cuyos nombres terminan con `http.transfer.timeout` pueden usarse para cambiar el tiempo de espera de transferencia.	El soporte varía según el conector.
Soporte para redirecciones	50 redirecciones por defecto. La clave `max-redirect` en el área de Configuraciones adicionales de la configuración de la actividad HTTP v2 puede usarse para cambiar el número de redirecciones a seguir.	Las redirecciones no se siguen por defecto. Las variables de origen de Jitterbit y variables de destino cuyos nombres terminan con `http.max_redirs` pueden usarse para permitir que se sigan las redirecciones.	El soporte varía según el conector.
Soporte para datos de formulario	La configuración Multipart de POST, PUT y PATCH de la actividad HTTP v2 puede usarse para soportar cargas de formularios RFC 1687 al usar esquemas predeterminados. No se soporta con esquemas personalizados.	Las variables de destino de Jitterbit cuyos nombres incluyen `http.form_data` pueden usarse con cargas de formularios RFC 1687.	El soporte varía según el conector.
Soporte para eliminar espacios en blanco finales y saltos de línea	Los espacios en blanco y saltos de línea de la solicitud se dejan sin cambios por defecto. La clave `trailing-linebreaks` en el área de Configuraciones adicionales de la configuración de la actividad HTTP v2 puede establecerse en verdadero para eliminar espacios en blanco y saltos de línea iniciales y finales.	La variable de destino de Jitterbit `http.remove_trailing_linebreaks` puede usarse para eliminar espacios en blanco y saltos de línea iniciales y finales.	El soporte varía según el conector.
Configuración de mantener viva la conexión	La configuración Mantener viva en una conexión HTTP v2 puede usarse para mantener una única conexión TCP abierta para múltiples solicitudes y respuestas HTTP.	No soportado.	El soporte varía según el conector.
Soporte para cookies	No soportado.	Soportado solo si se utiliza un agente privado y la configuración `jitterbit.http.enable_cookies` está establecida en `true` en el archivo de configuración del agente (`jitterbit.conf`).	El soporte varía según el conector.
Soporte para certificados personalizados	No soportado.	Se puede especificar un certificado para autenticarse con el servidor HTTP utilizando el campo Certificado de una conexión HTTP.	El soporte varía según el conector.
Soporte para Expect: 100-continue	No soportado.	El encabezado Expect: 100 continue se envía cuando se selecciona Enviar `Expect 100-continue` en una conexión HTTP.	El soporte varía según el conector.
Soporte para cifrados débiles	No soportado.	Los servidores HTTP que utilizan cifrados débiles (DES/3DES y RC4) pueden usarse cuando se selecciona Permitir cifrados débiles en una conexión HTTP.	El soporte varía según el conector.
Soporte para complementos de Jitterbit	No soportado.	Los complementos de Jitterbit están disponibles para configurar durante el último paso de la configuración de la actividad HTTP (ver Complementos añadidos a una actividad).	No soportado.
Soporte para registro en agentes privados	El conector HTTP v2 soporta registro detallado de conectores.	El conector HTTP soporta registro de depuración de Curl.	El soporte 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 que indica éxito {"success": true} o fracaso {"success": false} en lugar de la respuesta real.

Funciones de Jitterbit y JavaScript basadas en archivos

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

Funciones de Jitterbit

Funciones de Jitterbit en JavaScript