Conexión de Salesforce Events en Jitterbit Studio
Introducción
Una conexión de Salesforce Events, creada mediante el conector Salesforce Events, establece acceso a Salesforce Platform Events y Salesforce Change Data Capture Events en una instancia de Salesforce. Una vez configurada la conexión, se pueden crear instancias de actividades de Salesforce Events asociadas a esa conexión para usarlas como orígenes (para proporcionar datos en una operación) o como destinos (para consumir datos en una operación).
Nota
Este conector admite la política de organización Enable Re-authentication on Change organization policy. Si está habilitada, un cambio en Host, Username o Consumer key en esta conexión requiere que los usuarios vuelvan a ingresar la Password, Security token, Consumer secret o Private key (según la Authentication seleccionada) de la conexión.
Crear o editar una conexión de Salesforce Events
Se crea una nueva conexión de Salesforce Events mediante el conector Salesforce Events desde una de estas ubicaciones:
- La pestaña Project endpoints and connectors de la paleta de componentes de diseño (ver Design component palette).
- La página Global Endpoints (ver Create a global endpoint en Global Endpoints).
Se puede editar una conexión de Salesforce Events existente desde estas ubicaciones:
- La pestaña Project endpoints and connectors de la paleta de componentes de diseño (ver Design component palette).
- La pestaña Components del panel de proyectos (ver Component actions menu en Project pane Components tab).
- La página Global Endpoints (ver Edit a global endpoint en Global Endpoints).
Configurar una conexión de Salesforce Events
A continuación se describe cada elemento de la interfaz de usuario de la pantalla de configuración de la conexión de Salesforce Events.
Sugerencia
Los campos con un icono de variable admiten el uso de global variables, project variables y Jitterbit variables. Comienza escribiendo un corchete de apertura [ en el campo o haz clic en el icono de variable para mostrar un menú con las variables existentes entre las que puedas elegir.
-
Connection name: Ingresa un nombre para identificar la conexión. El nombre debe ser único para cada conexión de Salesforce Events y no debe contener barras inclinadas
/ni dos puntos:. Este nombre también se usa para identificar el endpoint de Salesforce Events, que se refiere tanto a una conexión específica como a sus actividades. -
Host: Ingresa la URL de inicio de sesión de la organización de sandbox o producción de Salesforce.
-
Authentication: Selecciona el método de autenticación a usar para conectarse a Salesforce.
-
Username-Password: (Predeterminado.) Selecciona esta opción para autenticarte usando un nombre de usuario y contraseña de Salesforce:
-
Username: Ingresa el nombre de usuario asociado con la cuenta de Salesforce.
-
Password: Ingresa la contraseña asociada con la cuenta de Salesforce.
-
Security token: Ingresa el security token asociado con la cuenta de Salesforce.
-
-
-
Consumer key: Ingresa la clave de consumidor de la aplicación conectada de Salesforce (consulta Requisitos previos).
-
Consumer secret: Ingresa el secreto de consumidor de la aplicación conectada de Salesforce (consulta Requisitos previos).
-
Grant type: Ingresa un tipo de concesión de
password. -
Client Credentials: Selecciona esta opción para autenticarte usando la clave de consumidor y el secreto de una aplicación cliente externa de Salesforce o una aplicación conectada (autenticación de máquina a máquina). Salesforce requiere el flujo de credenciales del cliente OAuth 2.0 para usar la URL de My Domain de tu organización en lugar del servidor de inicio de sesión genérico, así que establece Host arriba en una URL como
https://exampleDomain.my.salesforce.comen lugar de su valor predeterminado:-
Consumer key: Ingresa la clave de consumidor de una aplicación cliente externa de Salesforce o una aplicación conectada configurada para el flujo de credenciales del cliente OAuth 2.0. Para obtener instrucciones sobre la configuración de la aplicación y cómo obtener este valor, consulta Requisitos previos de OAuth 2.0 de dos etapas para conectores basados en Salesforce.
-
Consumer secret: Ingresa el secreto de consumidor de la misma aplicación cliente externa de Salesforce o aplicación conectada.
-
-
JWT Bearer: Selecciona esta opción para autenticarte usando una aserción JWT autofirmada firmada con una clave privada (autenticación de servidor a servidor que no requiere una contraseña):
-
Username: Ingresa el nombre de usuario asociado con la cuenta de Salesforce.
-
Consumer key: Ingresa la clave de consumidor de una aplicación conectada de Salesforce configurada para el flujo de portador OAuth 2.0 JWT. Para obtener más información, consulta la documentación de Salesforce sobre OAuth 2.0 JWT Bearer Flow for Server-to-Server Integration.
-
Private key: Ingresa la clave privada que corresponde al certificado digital cargado en la aplicación conectada de Salesforce, en este formato:
-----BEGIN PRIVATE KEY----- <private key> -----END PRIVATE KEY-----Reemplaza
<private key>(incluyendo los corchetes angulares < >) con el valor apropiado. También se admite una clave privada PKCS1 en el formato-----BEGIN RSA PRIVATE KEY-----.
-
-
API version: Ingresa la versión de Salesforce REST API en formato numérico (
54,56, etc.). De forma predeterminada, este campo se rellena previamente con la versión63. -
Test: Haz clic para verificar la conexión usando la configuración proporcionada. Cuando se prueba la conexión, el agente o los agentes en el grupo de agentes asociado con el entorno actual descargan la última versión del conector. Este conector admite suspender la descarga de la última versión del conector mediante la política organizacional Disable Auto Connector Update.
-
Save changes: Haz clic para guardar y cerrar la configuración de conexión.
-
Discard changes: Después de realizar cambios en una configuración nueva o existente, haz clic para cerrar la configuración sin guardar. Un mensaje te pide que confirmes que deseas descartar los cambios.
-
Delete: Después de abrir una configuración de conexión existente, haz clic para eliminar permanentemente la conexión del proyecto y cerrar la configuración (consulta Dependencias de componentes, eliminación y remoción). Un mensaje te pide que confirmes que deseas eliminar la conexión.
Siguientes pasos
Después de crear una conexión de Salesforce Events, colocas un tipo de actividad en el lienzo de diseño para crear instancias de actividad que se usarán ya sea como orígenes (para proporcionar datos en una operación) o como destinos (para consumir datos en una operación).
Las acciones de menú para una conexión y sus tipos de actividad son accesibles desde el panel del proyecto y la paleta de componentes de diseño. Para obtener más información, consulta Menús de acciones en Conceptos básicos de conectores.
Estos tipos de actividad están disponibles:
-
Suscribirse a evento: Recibe un evento de plataforma o un evento CDC de Salesforce y está diseñado para usarse como fuente en una operación.
-
Suscribirse a evento CDC de inserción: Recibe un evento CDC de inserción de Salesforce y está diseñado para usarse como fuente en una operación.
-
Publicar evento: Publica un evento de plataforma en Salesforce y está diseñado para usarse como destino en una operación.
-
Suscribirse a evento CDC de actualización: Recibe un evento CDC de actualización de Salesforce y está diseñado para usarse como fuente en una operación.
-
Suscribirse a evento CDC de eliminación: Recibe un evento CDC de eliminación de Salesforce y está diseñado para usarse como fuente en una operación.