Saltar al contenido

Conexión de Salesforce

Introducción

Una conexión de Salesforce, creada utilizando el conector de Salesforce, establece acceso a Salesforce. Una vez que se configura una conexión, se pueden crear instancias de actividades de Salesforce asociadas con esa conexión para ser utilizadas como fuentes (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 o posterior del agente para usar OAuth 2.0 de 2 patas con el conector de Salesforce.

Este conector admite la Política de organización de Habilitar reautenticación en cambio [(/es/management-console/organizations/#reauth)]. 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 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:

Una conexión de Salesforce existente se puede editar desde estas ubicaciones:

Configurar una conexión de Salesforce

Cada elemento de la interfaz de usuario de la pantalla de configuración de la conexión de Salesforce se describe a continuación.

Consejo

Los campos con un icono de variable admiten el uso de variables globales, variables de proyecto y variables de Jitterbit. Comience escribiendo un corchete cuadrado abierto [ en el campo o haciendo clic en el icono de variable para mostrar un menú que enumera las variables existentes de las que se puede elegir.

  • Nombre de la conexión: 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 (/) ni dos puntos (:). Este nombre también se utiliza 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: Seleccione el tipo de autenticación para conectarse a Salesforce, ya sea Autenticación básica o Credenciales de cliente OAuth 2.0.

    Seleccione Autenticación básica para mostrar estos campos:

    • 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 cambiar el campo Host del servidor anterior a https://test.salesforce.com.

    • Nombre de usuario: Ingrese el nombre de usuario para la cuenta de Salesforce. Se requiere una cuenta de Salesforce que no tenga habilitada la autenticación de múltiples factores (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 seleccionada la opción Autenticación de múltiples factores 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 lo describe Salesforce en ¿Se requiere MFA para mis usuarios de integración? en su documentación Preguntas frecuentes sobre la autenticación de múltiples factores de Salesforce.

    • Contraseña: Ingresa la contraseña de la cuenta de Salesforce.

      Precaución

      Una contraseña de Salesforce que utilice caracteres ASCII extendidos, como £, puede causar el siguiente error al obtener datos durante la configuración de la actividad:

      Nombre de usuario, contraseña, token de seguridad inválidos; o usuario bloqueado. [INVALID_LOGIN]

      En este caso, la prueba de conexión puede seguir siendo exitosa. Si recibes este error durante la configuración de la actividad y estás utilizando caracteres especiales en la contraseña, intenta cambiar la contraseña.

    • Token de seguridad: Si es requerido por la configuración de seguridad de la instancia de Salesforce, 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 se puede ver la opción de restablecer el token de seguridad.

    Selecciona Credenciales de cliente OAuth 2.0 para mostrar estos campos:

    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 o posterior del agente para usar OAuth 2.0 de 2 patas con el conector de Salesforce.

  • Probar: Haz clic para verificar la conexión utilizando 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 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 del 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 ser utilizadas como fuente 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 actividades masivas. Las actividades masivas deben usarse solo si no necesitas utilizar una transformación para cambiar los datos antes de llegar al destino.

  • Consulta: Consulta datos de Salesforce y está destinada a ser utilizada como fuente para proporcionar datos en una operación.

  • Insertar: Inserta nuevos datos en Salesforce y está destinada a ser utilizada como destino para consumir datos en una operación.

  • Actualizar: Actualiza datos existentes en Salesforce y está destinada a ser utilizada como destino para consumir datos en una operación.

  • Upsert: Actualiza datos existentes e inserta nuevos datos en Salesforce y está destinado a ser utilizado como un objetivo para consumir datos en una operación.

  • Delete: Elimina datos en Salesforce y está destinado a ser utilizado como un objetivo para consumir datos en una operación.

  • Bulk Query: Consulta un gran número de registros de Salesforce y está destinado a ser utilizado como una fuente para proporcionar datos en una operación.

  • Bulk Insert: Inserta un gran número de nuevos registros en Salesforce y está destinado a ser utilizado como un objetivo para consumir datos en una operación.

  • Bulk Update: Actualiza un gran número de registros existentes en Salesforce y está destinado a ser utilizado como un objetivo para consumir datos en una operación.

  • Bulk Upsert: Actualiza un gran número de registros existentes e inserta un gran número de nuevos registros en Salesforce y está destinado a ser utilizado como un objetivo para consumir datos en una operación.

  • Bulk Delete: Elimina un gran número de registros de Salesforce y está destinado a ser utilizado como un objetivo para consumir datos en una operación. Los registros eliminados se almacenan en la Papelera de reciclaje de Salesforce antes de ser eliminados permanentemente.

  • Bulk Hard Delete: Elimina de forma permanente un gran número de registros de Salesforce y está destinado a ser utilizado como un objetivo para consumir datos en una operación. Los registros eliminados de forma permanente se vuelven automáticamente elegibles para su eliminación.

Usar conexiones de Salesforce en scripts

Las conexiones de Salesforce se pueden referenciar en un script utilizando funciones de script que usan un salesforceOrg como parámetro. Para más información, consulta Usar funciones de Salesforce.