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 Extremos y conectores del proyecto de la paleta de componentes de diseño (consulte 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 a esa conexión se utilizan luego para crear instancias de actividades que pretenden usarse 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 conocen como un extremo de Eventos de Salesforce:

Tipos de actividades de Eventos de Salesforce

Suscribirse a Evento: Recibe un evento de plataforma o un evento de CDC desde Salesforce y está destinado a utilizarse como origen en una operación.
Suscribirse a Evento de Inserción de CDC: Recibe un evento de CDC de inserción desde Salesforce y está destinado a utilizarse como origen en una operación.
Publicar Evento: Publica un evento de plataforma en Salesforce y está destinado a utilizarse como destino en una operación.
Suscribirse a Evento de Actualización de CDC: Recibe un evento de CDC de actualización desde Salesforce y está destinado a utilizarse como origen en una operación.
Suscribirse a Evento de Eliminación de CDC: Recibe un evento de CDC de eliminación desde Salesforce y está destinado a utilizarse como origen en una operación.

La clase de licencia de este conector es Enterprise, disponible como complemento a su suscripción de Harmony iPaaS. Para habilitarla, comuníquese con su Gerente de Éxito del Cliente. Los extremos creados con este conector se incluyen en informes de uso de extremos y cuentan para su licencia.

Requisitos previos y versiones de API admitidas

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 los agentes privados, puede suspender estas actualizaciones con la política de organización Disable Auto Connector Update.

Los requisitos previos para usar 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. El valor predeterminado es la versión 63.0. Consulte la documentación de la API para obtener información sobre los nodos de esquema y los campos.

Solución de problemas

Si experimenta problemas con el conector de Eventos de Salesforce, se recomienda seguir estos pasos de solución de problemas:

Haga clic en el botón Test en la configuración de conexión para garantizar que la conexión sea exitosa y para garantizar que la versión más reciente del conector se descargue en el agente (a menos que esté utilizando la política de organización Disable Auto Connector Update).
Revisa los registros de operación para ver 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 añadiendo esta entrada de configuración de registrador al archivo logback.xml de tu agente privado:
```
<logger name="org.jitterbit.connector.platformevents" level="DEBUG"/>
```
Para más información sobre el registro detallado del conector, consulta Registro detallado para conectores usando 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
No se pueden habilitar ni deshabilitar eventos.	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.
No se pueden habilitar eventos.	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.
No se pueden habilitar eventos.	Se ha alcanzado el número máximo de clientes (suscriptores) permitidos por la instancia de Salesforce.	Ninguno.
No se pueden habilitar eventos.	El objeto no está seleccionado para Captura de Datos de Cambios en Salesforce. En este caso, se devolverán los siguientes detalles de error: `Unable to subscribe to [/data/<ObjectName>ChangeEvent:-1] [...]: 400::The channel specified is not valid {/data/<ObjectName>ChangeEvent}`	Añade el objeto a Entidades seleccionadas en Salesforce, como se describe en Selecciona las entidades que generan eventos.
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.	Ninguno.
Se devuelven valores nulos en la respuesta.	Para actividades CDC, los campos sin modificar se devuelven como nulos en la respuesta debido al diseño de la API de Salesforce.	Ninguno.