Consideraciones Sobre el Conector Basado en REST¶

Introducción¶

Se pueden utilizar varios conectores de Cloud Studio para conectarse a servicios web RESTful, también conocidos como APIs 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 Depreciación Futura¶

Conectores de aplicaciones a menudo incluyen funciones específicas de endpoints 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 una mayor flexibilidad en la configuración. Conectores personalizados ofrecen opciones adicionales que requieren un trabajo inicial 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 está probado y es confiable, pero es difícil de ampliar y mantener. Por lo tanto, el desarrollo futuro no se centrará en este conector.
HTTPv2: El conector HTTP v2 es la próxima versión del conector HTTP de Jitterbit. Se ha reconstruido utilizando el Connector SDK 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 de mantenimiento de actividad 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 dejar obsoleto el conector HTTP, lo cual se anunciará de acuerdo con la Política de fin de vida útil de Jitterbit. Actualmente, no hay un cronograma para su desaprobación y el conector HTTP sigue siendo totalmente compatible. Le recomendamos que convierta 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, le recomendamos que lo utilice a través de uno de los conectores HTTP genéricos. Los conectores de aplicaciones a menudo incluyen funciones específicas de endpoints que son más fáciles de configurar utilizando el conector específico en lugar de los conectores genéricos. Sin embargo, si tiene una necesidad específica que no está disponible en el extremo de la aplicación, utilizar un conector genérico es una alternativa lógica.

Teniendo en cuenta la intención de Jitterbit de eventualmente desaprobar 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, puede crear conectores personalizados utilizando Connector Builder o Connector SDK:

Constructor de conectores
Los conectores Custom Connector Builder se pueden diseñar para utilizar autenticación básica o sin autenticación. Durante la creación del conector, usted selecciona entre los métodos HTTP admitidos GET, POST, PUT, DELETE, PATCH o MERGE para crear las actividades correspondientes para que los usuarios las configuren.
SDK del conector
Los conectores SDK de conector personalizado se pueden diseñar para utilizar cualquier tipo de autenticación y se puede incorporar compatibilidad con cualquier método en el conector. Este tipo de conector personalizado ofrece la mayor flexibilidad, ya que un desarrollador puede agregar mejoras según las necesidades de su organización.

Matriz de Capacidades para Conectores 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 admite estos tipos de autorización: Clave API Firma de AWS Autorización Básica Ficha 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 de resumen	El soporte 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 PONER ELIMINAR PARCHE CABEZA OPCIONES	El conector HTTP admite estos métodos con estas actividades del mismo nombre: GET POST PONER ELIMINAR Personalizado (cualquier verbo especificado por el usuario)	El soporte varía según el conector.
Soporte de patrón de operación para actividades utilizadas como fuentes	Las actividades HTTP v2 utilizadas como fuente se pueden utilizar 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 objetivos (solo como primera fuente) Patrón de dos transformaciones (como primera o segunda fuente)	Las actividades HTTP utilizadas como fuente se pueden utilizar 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 objetivos (como primera o segunda fuente) (Consulte 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	El soporte varía según el conector. La mayoría de las actividades del conector específicas de la aplicación utilizadas como fuente se pueden utilizar 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 objetivos (solo como primera fuente) Patrón de dos transformaciones (como primera o segunda fuente)
Soporte de patrón de operación para actividades utilizadas como objetivos	Las actividades HTTP v2 utilizadas como destino se pueden utilizar con estos patrones: Patrón de Transformación Patrón de dos transformaciones (como primer o segundo objetivo)	Las actividades HTTP utilizadas como destino se pueden utilizar 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 destino) (Consulte 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	El soporte varía según el conector. La mayoría de las actividades del conector específicas de la aplicación utilizadas como destino se pueden utilizar con estos patrones: Patrón de Transformación Patrón de dos transformaciones (como primer o segundo objetivo)
Soporte de esquema	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 esquemas predeterminados que admitan un diseño de API REST general. se utilizará.	Los esquemas de solicitud y respuesta personalizados son opcionales y el usuario puede proporcionarlos durante la configuración de la actividad HTTP.	El soporte varía según el conector. Los esquemas de solicitud y respuesta se pueden generar directamente desde el extremo o puede haber disponible soporte para esquemas personalizados.
Funciones 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 del 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.	Escriba los datos en un archivo temporal y luego use la ruta de referencia de cadena a esa actividad del 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 en un intervalo de hasta 5 segundos. Compatible únicamente con Agentes Privados.	Máximo más alto (se recomienda no más de 5 reintentos) en un intervalo de hasta 5 segundos. Compatible únicamente con Agentes Privados.	El soporte varía según el conector.
Tiempo de espera de transferencia	30 segundos por defecto. El `connection-timeout` La clave en el área Configuraciones adicionales de la configuración de actividad HTTP v2 se puede utilizar para cambiar el tiempo de espera de transferencia.	3600 segundos de forma predeterminada. Las variables fuente de Jitterbit y variables objetivo cuyos nombres terminan con `http.transfer.timeout` se puede utilizar para cambiar el tiempo de espera de la transferencia.	El soporte varía según el conector.
Soporte para redirecciones	50 redireccionamientos por defecto. El `max-redirect` La clave en el área Configuraciones adicionales de la configuración de actividad HTTP v2 se puede utilizar para cambiar el número de redireccionamientos a seguir.	Las redirecciones no se siguen de forma predeterminada. Las variables fuente de Jitterbit y variables objetivo 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 Multiparte de HTTP v2 POST, PONER y PARCHE la configuración de actividad se puede utilizar para admitir cargas de formularios RFC 1687 cuando se utilizan esquemas predeterminados. No se admite con esquemas personalizados.	Las variables objetivo de Jitterbit cuyos nombres incluyen `http.form_data` se puede utilizar 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 de solicitud y los saltos de línea no se modifican de forma predeterminada. El `trailing-linebreaks` La clave en el área Configuraciones adicionales de la configuración de 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 utilizar para eliminar espacios en blanco iniciales y finales y saltos de línea.	El soporte varía según el conector.
Configuración Keep Alive	La configuración Keep Alive en una conexión HTTP v2 se puede utilizar para mantener abierta una única conexión TCP para múltiples solicitudes y respuestas HTTP.	No soportado.	El soporte varía según el conector.
Soporte para cookies	No soportado.	Compatible solo si se utiliza un Agente Privado y el `jitterbit.http.enable_cookies` configuración se establece 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 soportado.	Se puede especificar un certificado para autenticar 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-continuar	No soportado.	El encabezado Expect: 100 continue se envía cuando se envía `Expect 100-continue` está seleccionado en una conexión HTTP.	El soporte varía según el conector.
Soporte para cifrados débiles	No soportado.	Los servidores HTTP que usan 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 Jitterbit	No soportado.	Los complementos de Jitterbit están disponibles para configurar durante el último paso de la configuración de la actividad HTTP (consulte Complementos agregados a una actividad).	No soportado.
Soporte para iniciar sesión con Agentes Privados	El conector HTTP v2 admite registro detallado del conector.	El conector HTTP admite registro de depurar de rizos.	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 objetivos, la actividad devuelve un mensaje indicando éxito {"success": true} o fracaso {"success": false} en lugar de la respuesta real.

Funciones Jitterbit y JavaScript Basadas en Archivos¶

Las funciones Jitterbit y JavaScript basadas en archivos se enumeran a continuación. Las actividades del conector HTTP se pueden utilizar directamente como parámetro de función. Para usar 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 secuencias de comandos.

Funciones Jitterbit

Funciones Jitterbit de JavaScript