Conexión con Salesforce
Introducción
Una conexión de Salesforce se configura mediante el conector de Salesforce, lo que establece el acceso al extremo de Salesforce. Una vez que se establece una conexión, puede configurar una o más actividades de Salesforce asociadas con esa conexión para que se utilicen como origen para proporcionar datos a una operación o como destino para consumir datos en una operación. Además, la conexión de Salesforce se puede utilizar en secuencias de comandos.
Nota
Este conector admite la política de la organización Habilitar reautenticación en caso de cambio. Si está habilitado, un cambio en el Host del servidor o en el Nombre de usuario en esta conexión requiere que los usuarios vuelvan a ingresar la Contraseña y el Token de seguridad para la conexión.
Crear o editar una conexión de Salesforce
Se crea una nueva conexión de Salesforce utilizando el conector de Salesforce desde una de estas ubicaciones:
- La pestaña extremos y conectores del proyecto de la paleta de componentes de diseño (consulte paleta de componentes de diseño).
- La página Conexiones globales (vea Crear un extremo global en Conexiones globales).
Se puede editar una conexión de Salesforce existente desde estas ubicaciones:
- La pestaña extremos y conectores del proyecto de la paleta de componentes de diseño (consulte paleta de componentes de diseño).
- La pestaña Componentes del panel del proyecto (vea menú de acciones de componentes en la pestañaComponentes del panel Proyecto).
- La página Conexiones globales (vea Editar un extremo global en Conexiones globales).
Configurar una conexión de Salesforce
La configuración de una conexión de Salesforce incluye estos campos:
Consejo
Campos con un icono variable admite el uso de variables globales, variables del proyecto y variables Jitterbit. Comience escribiendo un corchete abierto [
en el campo o haciendo clic en el ícono de variable para mostrar una lista de las variables existentes para elegir.
-
Nombre del Extremo: Ingrese 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 (
/
) o dos puntos (:
) Este nombre también se utiliza para identificar el extremo de Salesforce, que hace referencia tanto a una conexión específica como a sus actividades. -
Host del servidor: Ingrese la URL del servidor de Salesforce. Si está utilizando una instancia de producción, deje la URL predeterminada como https://login.salesforce.com. Si está utilizando una instancia de sandbox, seleccione la casilla de verificación Sandbox a continuación.
-
Sandbox: Si está utilizando una instancia de sandbox de Salesforce, seleccione esta casilla de verificación para alternar el campo Host del servidor arriba a https://test.salesforce.com.
-
Nombre de usuario: Ingrese 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úrese de que el Conjunto de permisos asignado al inicio de sesión de integración del sistema de Salesforce no tenga la selecció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 autenticación multifactor de Salesforce.
-
Contraseña: Ingrese la contraseña de la cuenta de Salesforce.
Precaución
Una contraseña de Salesforce que utiliza caracteres ASCII extendidos, como £, puede provocar el siguiente error al obtener datos durante la configuración de la actividad:
Invalid username, password, security token; or user locked out. [INVALID_LOGIN]
En este caso, la prueba de conexión puede ser exitosa. Si recibe este error durante la configuración de la actividad y está usando caracteres especiales en la contraseña, intente cambiar la contraseña.
-
Token de seguridad: Si la configuración de seguridad de la instancia de Salesforce lo requiere, ingrese el token de seguridad asociado con la cuenta de Salesforce. Para obtener más información, consulte la documentación de Salesforce para Restablecer su token de seguridad o No se puede ver la opción Restablecer token de seguridad.
-
Prueba: Haz clic para verificar la conexión usando las credenciales proporcionadas.
-
Guardar cambios: Haz clic para guardar y cerrar la configuración de la conexión.
-
Descartar cambios: Después de realizar cambios en una configuración nueva o existente, haz clic para cerrar la configuración sin guardar. Un mensaje te pedirá 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 pedirá que confirmes que deseas eliminar la conexión.
Próximos pasos
Una vez creada una conexión de Salesforce, se puede acceder a las acciones del menú para esa conexión desde la pestaña Componentes del panel del proyecto. Consulte menú de acciones de conexión para más detalles.
Después de configurar una conexión de Salesforce, puede configurar una o más actividades de Salesforce asociadas con esa conexión para que se utilicen como fuente para proporcionar datos a una operación o como destino para consumir datos en una operación, o puede utilizar la conexión de Salesforce en un secuencia de comandos.
Configurar actividades
Las actividades de Salesforce interactúan con la conexión de Salesforce para actuar como fuentes (proporcionando datos dentro de una operación) o destinos (recibiendo datos dentro de una operación).
Después de configurar una conexión de Salesforce, use el menú desplegable Mostrar para filtrar por Extremos y luego haga clic en el bloque de conexión de Salesforce para mostrar las actividades que están disponibles para usarse con una conexión de Salesforce:
Para más información, consulte estas actividades:
Actividades estándar de Salesforce
- Consulta: Consulta datos desde un extremo de Salesforce y está destinado a usarse como fuente en una operación.
- Insertar: Inserta nuevos datos en un extremo de Salesforce y está destinado a usarse como destino en una operación.
- Actualizar: Actualiza datos existentes en un extremo de Salesforce y está destinado a usarse como destino en una operación.
- Upsert: Actualiza datos existentes e inserta datos nuevos en un extremo de Salesforce y está destinado a usarse como destino en una operación.
- Borrar: Elimina datos en un extremo de Salesforce y está destinado a usarse como destino en una operación.
Actividades masivas de Salesforce
Las actividades masivas de Salesforce son más rápidas y escalan mejor que las actividades no masivas de Salesforce, pero deben usarse solo si no necesita usar una transformación para cambiar los datos antes de alcanzar el objetivo.
- Consulta masiva: Consulta una gran cantidad de registros desde un extremo de Salesforce y está destinado a usarse como fuente en una operación.
- Inserción masiva: Inserta una gran cantidad de registros nuevos en un extremo de Salesforce y está destinado a usarse como destino en una operación.
- Actualización masiva: Actualiza una gran cantidad de registros existentes en un extremo de Salesforce y está destinado a usarse como destino en una operación.
- Inserción masiva: Ambos actualizan una gran cantidad de registros existentes e insertan una gran cantidad de registros nuevos en un extremo de Salesforce y están destinados a usarse como destino en una operación.
- Eliminación masiva: Elimina una gran cantidad de registros de un extremo de Salesforce y está destinado a usarse como destino en una operación. Los registros eliminados se almacenan en la papelera de reciclaje de Salesforce antes de eliminarse de forma permanente.
- Eliminación total masiva: Elimina de forma permanente una gran cantidad de registros de un extremo de Salesforce y está destinado a usarse como objetivo en una operación. Los registros eliminados de forma permanente se vuelven elegibles para su eliminación de forma automática.
Uso de conexiones de Salesforce en secuencias de comandos
Se puede hacer referencia a las conexiones de Salesforce en un secuencia de comandos mediante funciones de secuencia de comandos que utilizan un salesforceOrg
como parámetro. Para obtener más información, consulte Usar funciones de Salesforce.