Conexión de Salesforce
Introducción
Una conexión de Salesforce, creada mediante el conector de Salesforce, establece acceso a Salesforce. Una vez que configures una conexión, puedes crear instancias de actividades de Salesforce 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
Se requiere la versión 11.59 / 12.3 del agente o posterior para usar OAuth 2.0 de dos patas con el conector de Salesforce.
Este conector admite la política de organización Habilitar reautenticación al cambiar. Si está habilitada, un cambio en el Host del servidor o Nombre de usuario en esta conexión requiere que los usuarios vuelvan a ingresar la Contraseña y el Token de seguridad de la conexión.
Crear o editar una conexión de Salesforce
Se crea una nueva conexión de Salesforce mediante el conector de Salesforce desde una de estas ubicaciones:
- La pestaña Puntos finales del proyecto y conectores de la paleta de componentes de diseño (consulta Paleta de componentes de diseño).
- La página Puntos finales globales (consulta Crear un punto final global en Puntos finales globales).
Se puede editar una conexión de Salesforce existente desde estas ubicaciones:
- La pestaña Puntos finales del proyecto y conectores de la paleta de componentes de diseño (consulta Paleta de componentes de diseño).
- La pestaña Componentes del panel del proyecto (consulta Menú de acciones de componentes en Pestaña Componentes del panel del proyecto).
- La página Puntos finales globales (consulta Editar un punto final global en Puntos finales globales).
Configurar una conexión de Salesforce
A continuación se describe cada elemento de la interfaz de usuario de la pantalla de configuración de la conexión de Salesforce.
Consejo
Los campos con un icono de variable admiten el uso de variables globales, variables del proyecto y variables de Jitterbit. 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 elegir.
-
Nombre de la conexión: Ingresa un nombre para identificar la conexión de Salesforce. El nombre debe ser único para cada conexión de Salesforce y no debe contener barras diagonales (
/) ni dos puntos (:). Este nombre también se usa para identificar el punto final de Salesforce, que se refiere tanto a una conexión específica como a sus actividades. -
Tipo de autenticación: Selecciona el tipo de autenticación para conectarte a Salesforce, ya sea Autenticación básica u Credenciales de cliente de OAuth 2.0.
Selecciona Autenticación básica para mostrar estos campos:
-
Host del servidor: Ingresa la URL del servidor de Salesforce. Si usas una instancia de producción, deja la URL predeterminada como https://login.salesforce.com. Si usas una instancia de espacio aislado, marca la casilla Espacio aislado a continuación.
-
Espacio aislado: Si usas una instancia de espacio aislado de Salesforce, marca esta casilla para cambiar el campo Host del servidor anterior a https://test.salesforce.com.
-
Nombre de usuario: Ingresa el nombre de usuario de la cuenta de Salesforce. Se requiere una cuenta de Salesforce que no tenga habilitada la autenticación multifactor (MFA).
Para configurar una cuenta de Salesforce sin MFA, asegúrate de que el Conjunto de permisos asignado al inicio de sesión de integración del sistema de Salesforce no tenga seleccionada la opción Autenticación multifactor para inicios de sesión de API. Los tipos de inicio de sesión de integración del sistema están exentos del requisito de MFA de Salesforce, como se describe en Salesforce en ¿Se requiere MFA para mis usuarios de integración? en su documentación Preguntas frecuentes sobre autenticación multifactor de Salesforce.
-
-
Contraseña: Ingresa la contraseña de la cuenta de Salesforce.
-
Token de seguridad: Si la configuración de seguridad de la instancia de Salesforce lo requiere, ingresa el token de seguridad asociado con la cuenta de Salesforce. Para más información, consulta la documentación de Salesforce sobre Restablecer tu token de seguridad o No puedo ver la opción Restablecer token de seguridad.
Selecciona OAuth 2.0 Client Credentials para mostrar estos campos:
-
URL de instancia: Ingresa la URL de instancia de Salesforce.
-
ID de cliente: Ingresa el ID de cliente de tu aplicación de Salesforce configurada.
-
Secreto de cliente: Ingresa el secreto de cliente de tu aplicación de Salesforce configurada.
Consulta los requisitos previos de OAuth 2.0 de 2 patas para más información.
Nota
Se requiere la versión 11.59 / 12.3 del agente o posterior para usar OAuth 2.0 de 2 patas con el conector de Salesforce.
-
Probar: Haz clic para verificar la conexión usando las credenciales proporcionadas.
-
Guardar: Haz clic para guardar y cerrar la configuración de conexión.
-
Descartar cambios: Después de hacer 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.
-
Eliminar: 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.
Próximos pasos
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 más detalles, consulta Menús de acciones en Conceptos básicos del conector.
Después de configurar una conexión de Salesforce, puedes configurar una o más actividades de Salesforce asociadas con esa conexión para usarlas como origen para proporcionar datos a una operación o como destino para consumir datos en una operación, o puedes usar la conexión de Salesforce en un script.
Configurar actividades
Hay once actividades disponibles, cinco estándar y seis de carga masiva. Las actividades de carga masiva deben usarse solo si no necesitas usar una transformación para cambiar datos antes de llegar al destino.
-
Consulta: Consulta datos de Salesforce y está diseñada para usarse como origen para proporcionar datos en una operación.
-
Insertar: Inserta datos nuevos en Salesforce y está diseñada para usarse como destino para consumir datos en una operación.
-
Actualizar: Actualiza datos existentes en Salesforce y está diseñada para usarse como destino para consumir datos en una operación.
-
Actualizar o insertar: Tanto actualiza datos existentes como inserta datos nuevos en Salesforce y está diseñada para usarse como destino para consumir datos en una operación.
-
Eliminar: Elimina datos en Salesforce y está diseñada para usarse como destino para consumir datos en una operación.
-
Consulta masiva: Consulta un gran número de registros de Salesforce y está diseñada para usarse como origen para proporcionar datos en una operación.
-
Inserción masiva: Inserta un gran número de registros nuevos en Salesforce y está diseñada para usarse como destino para consumir datos en una operación.
-
Actualización masiva: Actualiza un gran número de registros existentes en Salesforce y está diseñada para usarse como destino para consumir datos en una operación.
-
Actualización o inserción masiva: Tanto actualiza un gran número de registros existentes como inserta un gran número de registros nuevos en Salesforce y está diseñada para usarse como destino para consumir datos en una operación.
-
Eliminación masiva: Elimina un gran número de registros de Salesforce y está diseñada para usarse como destino para consumir datos en una operación. Los registros eliminados se almacenan en la Papelera de reciclaje de Salesforce antes de ser eliminados permanentemente.
-
Eliminación forzada masiva: Elimina forzadamente un gran número de registros de Salesforce y está diseñada para usarse como destino para consumir datos en una operación. Los registros eliminados forzadamente se vuelven automáticamente elegibles para su eliminación.
Usar conexiones de Salesforce en scripts
Se pueden hacer referencia a las conexiones de Salesforce en un script usando funciones de script que usan un salesforceOrg como parámetro. Para obtener más información, consulta Usar funciones de Salesforce.