Conector de Eventos de Salesforce en Jitterbit Studio

Resumen

El conector de Eventos de Salesforce proporciona acceso a Eventos de plataforma de Salesforce y Eventos de Captura de cambios de datos (CDC) de Salesforce en una instancia de Salesforce.

El conector de Eventos de Salesforce proporciona una interfaz para crear una conexión de Eventos de Salesforce, la base utilizada para generar instancias de actividades de Eventos de Salesforce. Estas actividades, una vez configuradas, interactúan con Eventos de Salesforce a través de la conexión.

Se accede al conector de Eventos de Salesforce desde la pestaña Puntos finales y conectores del proyecto de la paleta de componentes de diseño (consulta Paleta de componentes de diseño).

Descripción general del conector

Este conector se utiliza para configurar primero una conexión de Eventos de Salesforce. Los tipos de actividades asociados con esa conexión se utilizan luego para crear instancias de actividades que se pretende utilizar como orígenes (para proporcionar datos en una operación) o destinos (para consumir datos en una operación).

En conjunto, una conexión específica de Eventos de Salesforce y sus actividades se denominan punto final de Eventos de Salesforce:

Tipos de actividades de Eventos de Salesforce

Suscribirse a evento: Recibe un evento de plataforma o un evento de CDC de Salesforce y se pretende utilizar como origen en una operación.
Suscribirse a evento de inserción de CDC: Recibe un evento de inserción de CDC de Salesforce y se pretende utilizar como origen en una operación.
Publicar evento: Publica un evento de plataforma en Salesforce y se pretende utilizar como destino en una operación.
Suscribirse a evento de actualización de CDC: Recibe un evento de actualización de CDC de Salesforce y se pretende utilizar como origen en una operación.
Suscribirse a evento de eliminación de CDC: Recibe un evento de eliminación de CDC de Salesforce y se pretende utilizar como origen en una operación.

La clase de licencia de este conector es Enterprise, disponible como complemento de tu suscripción a Harmony iPaaS. Para habilitarla, contacta a tu Gerente de éxito del cliente. Los puntos finales creados con este conector se incluyen en reportes de uso de puntos finales y cuentan para tu licencia.

Requisitos previos y versiones de API compatibles

Este conector se puede utilizar con agentes en la nube y agentes privados.

Los agentes descargan automáticamente la versión más reciente de este conector cuando es necesario. En agentes privados, puedes suspender estas actualizaciones con la política de organización Disable Auto Connector Update.

Los requisitos previos para utilizar el conector de Eventos de Salesforce se describen en Requisitos previos de Eventos de Salesforce.

El conector de Eventos de Salesforce utiliza la versión de la API REST de Salesforce especificada en la conexión. La versión predeterminada es 63.0. Consulta la documentación de la API para obtener información sobre los nodos de esquema y los campos.

Solución de problemas

Si experimentas problemas con el conector de Eventos de Salesforce, se recomiendan estos pasos para la solución de problemas:

Haz clic en el botón Test en la configuración de conexión para asegurar que la conexión sea exitosa y para asegurar que la versión más reciente del conector se descargue en el agente (a menos que utilices la política de organización Disable Auto Connector Update).
Revisa los registros de operación para obtener cualquier información escrita durante la ejecución de la operación.
Habilita el registro de depuración de operación (para agentes en la nube o para agentes privados) para generar archivos de registro y datos adicionales.
Si utilizas agentes privados, puedes habilitar el registro detallado del conector para este conector agregando esta entrada de configuración de registrador al archivo logback.xml de tu agente privado:
```
<logger name="org.jitterbit.connector.platformevents" level="DEBUG"/>
```
Para obtener más información sobre el registro detallado del conector, consulta Registro detallado para conectores que utilizan agentes privados de Jitterbit.
Si utilizas agentes privados, puedes consultar los registros del agente para obtener más información.
Para consideraciones adicionales de solución de problemas, consulta Solución de problemas de operación.

Los problemas comunes con actividades de escucha (Suscribirse a evento, Suscribirse a evento CDC de inserción, Suscribirse a evento CDC de actualización, o Suscribirse a evento CDC de eliminación) se describen a continuación.

Problema	Causa	Solución
Los eventos no se pueden habilitar ni deshabilitar.	El agente privado se ha instalado o reiniciado recientemente.	Abre la configuración de conexión y prueba la conexión para forzar que el conector se descargue en el agente.
Los eventos no se pueden habilitar.	Las credenciales de conexión de Salesforce pueden estar bloqueadas o ser incorrectas. En este caso, se devolverán los siguientes detalles de error: `Unable to login; INVALID_LOGIN: Invalid username, password, security token; or user locked out.`	Confirma que la configuración de conexión sea correcta.
Los eventos no se pueden habilitar.	Se ha alcanzado el número máximo de clientes (suscriptores) permitidos por la instancia de Salesforce.	Ninguna.
Las unidades de medida no se devuelven en la respuesta.	Los símbolos de medida como `$` y `%` no se devuelven debido al diseño de la API de Salesforce.	Ninguna.
Se devuelven valores nulos en la respuesta.	Para actividades de CDC, los campos sin modificar se devuelven como nulos en la respuesta debido al diseño de la API de Salesforce.	Ninguna.