Consideraciones sobre conectores basados en REST en Jitterbit Integration Studio

Introducción

Se pueden usar varios conectores de Integration Studio para conectarse a servicios web RESTful, también conocidos como APIs REST. Esta página ofrece consideraciones para elegir el conector adecuado, pudiendo elegir entre dos conectores HTTP genéricos o varios conectores específicos de la aplicación. También se pueden crear conectores REST personalizados.

Consideraciones de alto nivel y depreciación futura

Conectores de aplicaciones a menudo incluyen funciones 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, los conectores genéricos generalmente permiten mayor flexibilidad en la configuración. Conectores personalizados ofrecen opciones adicionales que requieren trabajo previo para su creación, pero facilitan a los usuarios el uso de su conector de marca con configuraciones que de otro modo no estarían disponibles.

Conectores genéricos

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

HTTP: El conector HTTP es el conector HTTP original de Jitterbit, cuyo código subyacente se ha utilizado durante más de una década. Este conector es probado y confiable, pero es difícil de ampliar y mantener. Por lo tanto, el desarrollo futuro no se centrará en él.
HTTP v2: El conector HTTP v2 es la nueva versión del conector HTTP de Jitterbit. Se ha reconstruido utilizando el SDK del conector extensible de Jitterbit), lo que permite que las nuevas funciones estén disponibles más rápidamente. El conector HTTP v2 admite 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 los conectores HTTP y HTTP v2.

La intención a largo plazo de Jitterbit es descontinuar el conector HTTP, lo que se anunciará de acuerdo con la Política de fin de vida útil de Jitterbit). Actualmente, no hay un plazo para su desuso y el conector HTTP sigue siendo totalmente compatible. Recomendamos convertir 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 desarrollándose.

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

Teniendo en cuenta la intención de Jitterbit de dejar obsoleto en el futuro el conector HTTP, recomendamos utilizar 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 el Creador de Conectores o el SDK del Conector:

Creador de Conectores
Los conectores del Creador de Conectores Personalizados pueden diseñarse para usar autenticación básica o sin autenticación. Durante la creación del conector, seleccione entre los métodos HTTP compatibles: GET, POST, PUT, DELETE, PATCH o MERGE para crear las actividades correspondientes que los usuarios puedan configurar.
SDK del Conector
Los conectores del SDK de Conectores Personalizados se pueden diseñar para usar cualquier tipo de autenticación y se puede integrar la compatibilidad con cualquier método. Este tipo de conector personalizado ofrece la mayor flexibilidad, ya que un desarrollador puede añadir mejoras según las necesidades de su organización.

Matriz de capacidad para conectores Jitterbit

Capacidad del conector	Conector HTTP v2	Conector HTTP	Conector específico de la aplicación
Compatibilidad con autorización	Una conexión HTTP v2 admite estos tipos de autorización: Clave API Firma de AWS Autorización básica Token al portador Autorización de resumen Sin autorización OAuth 2.0	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 PUBLICACIÓN PONER ELIMINAR PARCHE CABEZA OPCIONES	El conector HTTP admite estos métodos con estas actividades del mismo nombre: GET PUBLICACIÓN PONER ELIMINAR 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 fuentes	Las actividades HTTP v2 utilizadas como fuente se pueden usar con estos patrones: Patrón de Transformación Patrón de archivo de dos objetivos (solo como primera fuente) Patrón de archivo HTTP de dos destinos (solo como la primera fuente) Patrón de dos transformaciones (como primera o segunda fuente)	Las actividades HTTP utilizadas como fuente se pueden usar con estos patrones: Patrón de archivo Patrón de Transformación Patrón de archivo de dos objetivos (solo como primera fuente) Patrón de archivo HTTP de dos destinos (como primera o segunda fuente) (Ver Nota para actividades HTTP GET debajo de esta tabla.) Patrón de dos transformaciones (solo como primera fuente) Patrón de destino masivo de Salesforce	La compatibilidad varía según el conector. La mayoría de las actividades de conector específicas de la aplicación que se usan como fuente se pueden usar con estos patrones: Patrón de Transformación Patrón de archivo de dos objetivos (solo como primera fuente) Patrón de archivo HTTP de dos destinos (solo como la primera fuente) Patrón de dos transformaciones (como primera o segunda fuente)
Compatibilidad con patrones de operación para actividades utilizadas como objetivos	Las actividades HTTP v2 utilizadas como objetivo se pueden usar con estos patrones: Patrón de Transformación Patrón de dos transformaciones (como primer o segundo objetivo)	Las actividades HTTP utilizadas como objetivo se pueden usar con estos patrones: Patrón de archivo Patrón de Secuencia de comandos Patrón de Transformación Patrón de archivo de dos objetivos (solo como segundo objetivo) Patrón de archivo HTTP de dos objetivos (como primer o segundo objetivo) (Ver Nota para actividades HTTP GET debajo de esta tabla.) Patrón de dos transformaciones (solo como segundo objetivo) Patrón de origen masivo de Salesforce	La compatibilidad varía según el conector. La mayoría de las actividades de conector específicas de la aplicación utilizadas como objetivo se pueden usar con estos patrones: Patrón de Transformación Patrón de dos transformaciones (como primer o segundo objetivo)
Compatibilidad con esquemas	Los esquemas de solicitud y respuesta personalizados son opcionales y el usuario puede proporcionarlos 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 los esquemas predeterminados que admiten un diseño general de API REST.	Los esquemas de solicitud y respuesta personalizados son opcionales y el usuario puede proporcionarlos 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 extremo o es posible que exista 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 `sourceId` o `targetId` parámetro de función.	Utilice la ruta de referencia de cadena a la actividad como `sourceId` o `targetId` parámetro de función.	Escribe los datos en un archivo temporal y luego usa la ruta de referencia de cadena a esa actividad de archivo temporal como `sourceId` o `targetId` parámetro de función. Algunos conectores pueden tener soporte adicional.
Número de reintentos	Máximo de 5 reintentos enviados con un intervalo de hasta 5 segundos. Compatible solo con agentes privados.	Máximo superior (se recomienda un máximo de 5 reintentos) con un intervalo de hasta 5 segundos. Compatible solo con agentes privados.	La compatibilidad varía según el conector.
Tiempo de espera de transferencia	30 segundos por defecto. El `connection-timeout` La clave 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 la transferencia.	3600 segundos de forma predeterminada. Las variables de origen de Jitterbit y variables de destino cuyos nombres terminan con `http.transfer.timeout` Se puede utilizar para cambiar el tiempo de espera de transferencia.	El soporte varía según el conector.
Compatibilidad con redirecciones	50 redirecciones por defecto. El `max-redirect` La clave en el área Configuración adicional de la configuración de la actividad HTTP v2 se puede usar para cambiar la cantidad 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 puede utilizar para permitir que se sigan las redirecciones.	El soporte varía según el conector.
Compatibilidad con datos de formulario	La configuración Multipart de HTTP v2 POST, PONER, y [PARCHE][HTTPv2PATCH`La configuración de la actividad se puede usar para admitir la carga de formularios RFC 1687 al usar esquemas predeterminados.</p><p>No compatible con esquemas personalizados.</p> \| Las [variables de destino de Jitterbit][`JitterbitTargetVariables] cuyos nombres incluyen `http.form_data` Se puede utilizar con la carga de formularios 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 los saltos de línea solicitados se mantienen sin cambios de forma predeterminada. El `trailing-linebreaks` La clave en el área Configuración adicional de la configuración de la actividad HTTP v2 se puede establecer en verdadero para eliminar los espacios en blanco iniciales y finales y los saltos de línea.	El `http.remove_trailing_linebreaks`Variable de destino de Jitterbit se puede usar para eliminar espacios en blanco iniciales y finales, así como saltos de línea.	La compatibilidad varía según el conector.
Configuración de conexión activa	La configuración de conexión activa en una conexión HTTP v2 se puede usar para mantener una única conexión TCP abierta 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 el `jitterbit.http.enable_cookies` configuración está configurado en `true` en el archivo de configuración del agente (`jitterbit.conf`).	El soporte varía según el conector.
Compatibilidad con certificados personalizados	No compatible.	Se puede especificar un certificado para la autenticación con el servidor HTTP mediante el campo Certificado de una conexión HTTP.	El soporte varía según el conector.
Compatibilidad con Expect: 100-continue	No compatible.	El encabezado Expect: 100 continue se envía al enviar `Expect 100-continue`se selecciona en una conexión HTTP.	El soporte varía según el conector.
Compatibilidad con cifrados débiles	No compatible.	Los servidores HTTP que utilizan cifrados débiles (DES/3DES y RC4) se pueden usar cuando se selecciona Permitir cifrados débiles en una conexión HTTP.	El soporte varía según el conector.
Compatibilidad con complementos de Jitterbit	No compatible.	Los complementos de Jitterbit se pueden configurar durante el último paso de la configuración de la actividad HTTP (consulte [Complementos añadidos a una actividad])`PluginsAdded`]).	No compatible.
Compatibilidad con el inicio de sesión en Agentes privados	El conector HTTP v2 admite registro detallado del conector.	El conector HTTP admite registro de depurar 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 indicando éxito {"success": true}o fracaso {"success": false}en lugar de la respuesta real.

Funciones de Jitterbit y JavaScript basadas en archivos

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