Salesforce

El conector de Salesforce te permite conectarte a Salesforce en Designer. Utiliza el conector para leer datos de objetos de Salesforce y volver a escribir datos en Salesforce desde un solo conector que funcione de la misma manera en Alteryx Designer (escritorio) y Alteryx One (nube).

Salesforce está disponible como una fuente de datos en las herramientas Datos de entrada y Datos de salida, y como las herramientas independientes Entrada de Salesforce y Salida de Salesforce. Output Data Tool Icon Herramienta Datos de salida

Nueva versión del conector en Designer

El conector de Salesforce ahora es parte de la experiencia de conectores de Alteryx One. Revisa cuidadosamente la información de esta página para asegurarte de que estás utilizando las herramientas adecuadas de forma correcta.

Si deseas actualizar el conector de Salesforce en tus flujos de trabajo de Designer, puedes utilizar la utilidad Migración de flujos de trabajo.

Configuración del conector de Salesforce

Salesforce está disponible en Designer el parche 7 2025.1.2 o posterior. Si utilizaste anteriormente el conector de Salesforce, consulta Migración a conector unificado.

Prerrequisitos

Asegúrate de haber completado los siguientes prerrequisitos antes de continuar:

Requisito	Detalle
Versión de Designer	2025.1 parche 5, 2025.2 parche 3 o 2026.1 o posterior (todas las características excepto OAuth integrado y personalizado) 2025.1.2 parche 7, 2025.2.1 parche 5 o 2026.1 parche (todos los métodos de autenticación)
Configuración de la aplicación personalizada (OAuth 2.0), si se utiliza	Una aplicación conectada de Salesforce con Id. de cliente, Secreto de cliente, URI de redirección (debe coincidir con la aplicación conectada) y Alcance
URL del entorno	Producción (predeterminado), Sandbox o, Dominio personalizado
DCM	Debes habilitar DCM en Designer. Ve a Opciones > Configuración avanzada > DCM para habilitarlo

Instalar el conector

Puedes instalar fácilmente la versión más reciente del conector de Salesforce desde Designer a través de los complementos. Este es el método de instalación recomendado que te permite examinar, instalar y actualizar conectores sin salir de Designer ni visitar Alteryx Marketplace.

Para instalar el conector…

En Designer, ve a Complementos > Administrar complementos de Marketplace. Verás una lista de conectores disponibles.
Selecciona Conector de Salesforce y selecciona Instalar. Designer descarga e instala el paquete. Designer puede requerir un reinicio para completar la instalación.
Una vez que se complete la instalación y la configuración, el Conector de Saleforce estará disponible en las herramientas Datos de entrada y Datos de salida.

Configurar una conexión

Haz lo siguiente para conectarte a Salesforce con DCM...DCM - Designer

Arrastra la herramienta Datos de entrada o Datos de salida al lienzo y selecciona Conectar a datos.
En Configuración del conector, selecciona Crear o examinar una conexión de datos.
Si creaste una conexión de Salesforce anteriormente, puedes seleccionar la conexión en la pestaña Recientes.
Selecciona + Nuevo. En la lista de tecnologías, selecciona Salesforce.
Selecciona Conexión rápida y, a continuación, selecciona Configurar la conexión. Se abre la ventana Conexiones.
Selecciona + Nuevo.
Especifica el nombre de la conexión y el nombre de la fuente de datos. Selecciona el entorno.
En la sección Credenciales, selecciona tu método de autenticación e ingresa el nombre de la credencial. Para obtener más información, consulta Métodos de autenticación.
Selecciona Guardar.
Selecciona Conectar. Salesforce puede solicitar autenticación.
Selecciona el archivo desde el que deseas leer o escribir en la ventana del explorador de archivos.
Selecciona la configuración de lectura o escritura en la ventana Opciones.
Selecciona Confirmar para crear una conexión con el archivo. Puedes seguir creando tu flujo de trabajo.

Migración al conector unificado

Si ya utilizas el conector de Salesforce en Alteryx, lee la sección a continuación. Recorre lo que se ha cambiado en la versión unificada.

Parámetro	Conector heredado	Conector unificado (v6.1.0)
Plataformas y herramientas	Escritorio (entrada y salida) Nube (solo entrada)	Escritorio (entrada y salida) Nube (entrada y salida, en curso)
Marco	SDK de Python (escritorio) Controlador ODBC de CDATA (nube)	Marco EACD (escritorio y nube)
Comunicación / API	API v52 de Salesforce (verano 21)	API de Salesforce v61+ (verano 24)
Métodos de autenticación	OAuth 2.0 Nombre de usuario + Contraseña + Token de seguridad	Mismos métodos, con configuración expandida
Modelo de conexión	Separa las opciones de producción /sandbox / URL personalizada	DCM, con un solo campo de URL de entorno

Cambios clave

Las opciones del menú desplegable Producción, Sandbox y URL personalizada se reemplazaron por un solo campo URL de entorno. Reconfigura cualquier flujo de trabajo que haya utilizado este menú desplegable.
La URL del entorno reemplaza el menú desplegable anterior: https://login.salesforce.com (producción, predeterminado), https://test.salesforce.com (sandbox) o tu dominio personalizado.
La autenticación de credenciales de Salesforce ahora también requiere el Id. de cliente y el secreto de cliente.
En escritorio, los dominios personalizados ahora funcionan con todos los métodos de autenticación (anteriormente solo OAuth).

Los flujos de trabajo existentes se pueden migrar mediante la utilidad Migración de flujos de trabajo de Alteryx en el parche 3 de Designer 2025.2 o posterior. Para obtener más información, consulta la utilidad Migración de flujos de trabajo.

Nota

La utilidad de migración solo está disponible en escritorio.
Después de instalar el conector unificado, es posible que veas las tecnologías heredadas y unificadas de Salesforce enumeradas en Administrar conexiones. Esto es normal durante el período de transición. Utiliza el conector unificado para cualquier trabajo nuevo.

Acerca del conector de Salesforce

Herramientas de entrada y salida

Las herramientas Entrada de Salesforce y Salida se utilizan para leer y escribir en Salesforce.

Entrada de Salesforce

La Entrada de Salesforce lee objetos estándar y personalizados. Puedes leer de tres maneras:

Generador de consultas: elige un objeto y selecciona los campos que deseas leer. El selector de campos ofrece una lista multiselección con Seleccionar todo, buscar por cadena o subcadena, un recuento en vivo de campos seleccionados frente al total y un filtro para mostrar solo lo que se selecciona. También se puede establecer un límite de registros. Hay cuatro modos de campo disponibles: Leer todos los campos estándar, Leer todos los campos personalizados, Leer todos los campos y Elegir manualmente.
Consulta personalizada (SOQL): escribe una consulta SOQL para leer objetos estándar y personalizados, incluidos los campos de relación __r, y luego validarla antes de ejecutarla. Una consulta personalizada siempre devuelve una sola tabla.
Leer del informe: examina y busca informes guardados, selecciona un informe y analiza sus resultados.

Salida de Salesforce

La salida de Salesforce escribe filas en un objeto estándar o personalizado. Elige una acción:

Insertar: agrega nuevos registros.
Actualizar: modifica los registros existentes. Requiere el Id. del registro de Salesforce.
Eliminar: quita registros. Requiere el Id. del registro de Salesforce.
Upsert: inserta nuevos registros y actualiza los existentes en una sola acción.

La salida procesa registros en lotes y te permite elegir la versión de la API de Salesforce. Cuando utilices Actualizar, Eliminar o Actualizar, incluye el Id. del registro como clave principal en tus datos.

Modelo de objetos

Salesforce almacena datos en objetos que se comportan como tablas de base de datos:

Los objetos estándar están integrados, por ejemplo, Cuenta, Contacto, Lead, Oportunidad, Caso, Campaña, Tarea, Evento y Usuario.
Los objetos personalizados se crean en tu organización y terminan con __c, por ejemplo Factura__c.
Los campos de relación entre objetos utilizan el sufijo __r y se pueden hacer referencia en SOQL.

Métodos de autenticación

Salesforce admite tres métodos de autenticación. Utiliza la siguiente tabla a fin de elegir el adecuado para tu caso práctico.

Método	Campos obligatorios	Escritorio (Flagship)	Cloud (Alteryx One)
Aplicación integrada (OAuth 2.0)	Ninguno	Sí	No disponible (la creación de conexiones integradas no se ofrece en la nube)
Aplicación personalizada (OAuth 2.0)	Id. de cliente, Secreto de cliente, URI de redirección (predeterminado `http://localhost:1717/`), Alcance (predeterminado `api offline_access)`	Sí	Sí
Credenciales de Salesforce (nombre de usuario, contraseña, token de seguridad)	Nombre de usuario, contraseña, token de seguridad (opcional), Id. de cliente, secreto de cliente	Sí	Sí
Dominio personalizado en todos los métodos	N/A	Sí	No disponible (el dominio personalizado no es compatible con todos los métodos en la nube)

OAuth admite tanto el flujo de código de autorización (de usuario a aplicación) como el flujo de credenciales de cliente (entidad de servicio, para automatización programada o sin cabeza).

Limitaciones

El conector no admite una ejecución en seco para lecturas o consultas personalizadas. Ejecuta el flujo de trabajo para recuperar datos o utiliza el paso de validación SOQL para comprobar una consulta personalizada antes de ejecutarla.
Para objetos con más de 200 campos, fallan los modos Leer todos los campos personalizados y Leer todos los campos. Utiliza Elegir manualmente para seleccionar los campos que necesitas o escribe una consulta personalizada SOQL que enumere campos específicos.
Una consulta personalizada SOQL siempre devuelve una tabla. Para combinar datos de varios objetos, únelos dentro de la consulta SOQL o utiliza varias herramientas de entrada y combina los resultados en el flujo de trabajo.
Leer desde el informe admite la selección de un solo informe por herramienta datos de entrada. Para leer varios informes, utiliza varias herramientas de entrada.
El conector utiliza la API REST de Salesforce. La API de carga masiva de Salesforce aún no es compatible. Para lecturas o escrituras muy grandes, espera que se apliquen los límites de la API REST y de la API de Salesforce.
La vista previa de datos de objetos y campos está disponible en la nube, pero no en escritorio. En escritorio, configura los campos mediante la lista de campos Generador de consultas o una consulta SOQL.
En la nube, la compatibilidad de dominio personalizado en todos los métodos de autenticación no está disponible. Utiliza un método compatible para tu conexión a la nube o conéctate desde el escritorio, donde el dominio personalizado funciona con todos los métodos.
La utilidad Migración de flujos de trabajo se ejecuta solo en escritorio.
En la nube, no se ofrece el flujo de creación de conexiones de aplicaciones integrado. Utiliza una aplicación personalizada de OAuth o credenciales de Salesforce en la nube.
Los tipos de datos producidos a partir del mismo objeto pueden diferir entre la nube y escritorio.
En la nube, la carga de un conjunto de datos puede fallar para algunos objetos. Si un objeto específico no se carga, prueba con una consulta personalizada SOQL para ese objeto o reduce los campos seleccionados.
El conector generalmente está disponible en escritorio. El soporte de la nube está en curso y aún no está disponible en general.

Notas de lanzamiento del conector de Salesforce

Salesforce versión 6.1.0

Versión de lanzamiento 6.1.0 del conector
v6.1.0	Requiere el parche 7 de Designer 2025.1.2, el parche 5 de 2025.2.1, el parche 2 de 2026.1 o el GA de 2026.2 para todos los métodos de autenticación. Utiliza el DCM y se comunica a través de la API de Salesforce v61+ (verano de 2024). Conexiones basadas en el DCM con una configuración de conexión simplificada (una única URL de entorno y OAuth personalizado que expone el URI de redireccionamiento y el alcance). Entrada: Generador de consultas: campo Seleccionar todo, búsqueda, recuento, filtro, límite de registros. Leer desde el informe sin límite de registro. Consulta personalizada SOQL con validación. Elige la versión de la API. Salida Insertar, Actualizar, Eliminar y la nueva acción Actualizar o Insertar. Procesamiento por lotes Elige la versión de la API. Se corrigió un problema por el que la lectura de un informe de Salesforce se limitaba a una cantidad fija de registros (2000). Esto solo funciona cuando se utiliza la API REST estándar. Se corrigió un problema por el que los valores de DateTime se devolvían como 00:00:00, y los valores vacíos ahora se manejan correctamente. Seleccionar todo ahora está disponible en la lista de columnas. La reutilización de una conexión de DCM de OAuth personalizada inactiva ya no devuelve un error de token. La aplicación integrada OAuth ahora se autentica correctamente. La carga del conjunto de datos puede fallar para ciertos objetos en la nube. La vista previa por esquema está deshabilitada para las consultas personalizadas de Salesforce.

Versión de lanzamiento 6.1.0 del conector

Versión

Descripción

v6.1.0

Requiere el parche 7 de Designer 2025.1.2, el parche 5 de 2025.2.1, el parche 2 de 2026.1 o el GA de 2026.2 para todos los métodos de autenticación.
Utiliza el DCM y se comunica a través de la API de Salesforce v61+ (verano de 2024).
Conexiones basadas en el DCM con una configuración de conexión simplificada (una única URL de entorno y OAuth personalizado que expone el URI de redireccionamiento y el alcance).
Entrada:
Generador de consultas: campo Seleccionar todo, búsqueda, recuento, filtro, límite de registros.
Leer desde el informe sin límite de registro.
Consulta personalizada SOQL con validación.
Elige la versión de la API.
Salida
Insertar, Actualizar, Eliminar y la nueva acción Actualizar o Insertar.
Procesamiento por lotes
Elige la versión de la API.
Se corrigió un problema por el que la lectura de un informe de Salesforce se limitaba a una cantidad fija de registros (2000). Esto solo funciona cuando se utiliza la API REST estándar.
Se corrigió un problema por el que los valores de DateTime se devolvían como 00:00:00, y los valores vacíos ahora se manejan correctamente.
Seleccionar todo ahora está disponible en la lista de columnas.
La reutilización de una conexión de DCM de OAuth personalizada inactiva ya no devuelve un error de token.
La aplicación integrada OAuth ahora se autentica correctamente.
La carga del conjunto de datos puede fallar para ciertos objetos en la nube.
La vista previa por esquema está deshabilitada para las consultas personalizadas de Salesforce.

Conectores independientes de Salesforce

Tipo de conexión	Herramientas de Alteryx. La versión más reciente está disponible en Alteryx Marketplace.
Tipo de soporte	Leer y escribir
Se validó en	Versión del cliente ODBC 2.2.20 también está disponible para las herramientas Datos de entrada y Datos de salida.

Notas del lanzamiento de las herramientas de Salesforce

Versión	Descripción
v5.1.4	Compatible con Designer 2021.4.2 (parche 6), 2022.1 (parche 4) y versiones posteriores. Compatible solo con AMP Engine. Se requiere DCM para ejecutar este conector en Alteryx Server. El conector de Salesforce establece de forma predeterminada la precisión de la hora y la fecha y hora en milisegundos para evitar ceros adicionales al final, aunque sigue admitiendo una resolución de nanosegundos cuando lo requiere el flujo de trabajo. (TPM-4753, TPM-4736) Se corrigió un problema en el que las herramientas de Salesforce ignoraban la configuración del proxy en Server. (TPM-4647) Se corrigió el problema por el cual Server no podía ejecutar flujos de trabajo con las herramientas de Salesforce porque dependían de los tokens de acceso de Designer. (TPM-4846) Se corrigió el problema por el que las herramientas de desarrollador de Designer exponían valores secretos en los archivos JSON devueltos. (TPM-4788)
v5.1.3	Compatible con Designer 2021.4.2 (parche 6), 2022.1 (parche 4) y versiones posteriores. Compatible solo con AMP Engine. Se requiere DCM para ejecutar este conector en Alteryx Server. Se agregó compatibilidad con dominios personalizados de Salesforce cuando se utiliza DCM. Se mejoró la autenticación. Se actualizó el SDK a la versión 2.4.2. Se actualizó la API a la última versión. Se corrigió un problema en el que las herramientas de Salesforce ignoraban el script PAC cuando se utilizaba DCM. (TPM-4620) Se corrigió un problema en el que la herramienta Entrada de Salesforce no podía leer ciertas columnas de tipo fecha. (TPM-4604) Se corrigió un problema en el que la herramienta Salida de Salesforce no mostraba la asignación de campos para la operación de actualización. (TPM-4519) Se corrigió un problema en el que las herramientas de Salesforce mostraban “Acceso denegado” si el token de seguridad no se creaba en DCM. (TPM-4507) Se corrigió un problema en el que las herramientas de Salesforce no tenían la versión de la API alineada según la etiqueta front-end. (TPM-4493) Se corrigió un problema en el que las herramientas de Salesforce no se podían conectar mediante el dominio personalizado. (TPM-4488) Se corrigió un problema en el que las herramientas de Salesforce advertían de un truncamiento inesperado de las marcas de tiempo. (TPM-4368) Se corrigió un problema en el que la herramienta Entrada de Salesforce truncaba los valores cuando se utilizaban objetos de relación anidados en una consulta SOQL personalizada. (TPM-4367) Se solucionó un problema en el que las herramientas Salida de Salesforce se ejecutaban de forma indefinida si los flujos de trabajo contienen varias herramientas Salida de Salesforce. (TPM-4268) Se corrigió un problema en el que las herramientas de Salesforce mostraban varias versiones de API como opciones seleccionables. (TPM-4264) Se corrigió un problema en el que la herramienta Salida de Salesforce no podía escribir datos con las operaciones de insertar y actualizar. (TPM-4248) Se corrigió un problema en el que las herramientas de Salesforce no podían leer correctamente el tipo de dato porcentual. (TPM-4174) Se corrigió el problema en el que las herramientas de Salesforce arrojaban un error con campos de fecha personalizados. (TPM-4051) Se corrigió un problema en el que las herramientas de Salesforce arrojaban el mensaje “Código de error 400: sintaxis de solicitud incorrecta o método no compatible”. (TPM-3982) Se corrigió un problema en el que las herramientas de Salesforce mostraban un rendimiento lento. (TPM-3919) Se corrigió un problema en el que la herramienta Entrada de Salesforce devolvía el campo versionData como una URL en lugar de un cuerpo de documento. (TPM-3662) Problemas conocidos Ciertos campos aparecen como nulos después de actualizar a la nueva versión de las herramientas de Salesforce. (TPM-4805) Los conectores de SDK ignoran el proxy en Server (Galería). (TPM-4647) Las herramientas de desarrollador HMTL de Designer muestran un valor secreto en el JSON devuelto. (TPM-4788) Las consultas devuelven registros nulos en la herramienta Entrada de Salesforce. (TPM-4641)
v5.1.2	Compatible con Designer 2021.4.2 (parche 6), 2022.1 (parche 4) y versiones posteriores. Compatible solo con AMP Engine. Se requiere DCM para ejecutar este conector en Alteryx Server. Se actualizó para ejecutarse en Designer y Server 2024.1. Se corrigió un problema en el que la Entrada de Salesforce fallaba después de ejecutarse durante 45 minutos. (TPM-3556) Se corrigió un problema en el que faltaban los metadatos de origen y descripción. (TPM-3486) Se corrigió un problema en el que las herramientas de Salesforce ignoraban la configuración del proxy. (TPM-3358) Se corrigió un problema en el que la herramienta Entrada de Salesforce devolvía el error “Código de error 401: Sin permiso: consulta los esquemas de autorización”. (TDCE-449 y TDCE-361)
v5.1.1	Compatible con Designer 2021.4.2 (parche 6), 2022.1 (parche 4) y versiones posteriores. Compatible solo con AMP Engine. Se requiere DCM para ejecutar este conector en Alteryx Server. Se actualizó para ejecutarse en Designer y Server 2024.1. Se corrigió un problema en el que la autenticación a través de la aplicación personalizada de OAuth no funcionaba. (TFLN-1912) Se corrigió un problema en el que Entrada de Salesforce se ejecutaba indefinidamente cuando se configuraba para leer un conjunto de datos vacío. (TPM-2453) Problemas conocidos La herramienta Salesforce 5.1.1 no funciona en Designer-FIPS y Server-FIPS. Como solución alternativa, utiliza la versión 5.1.0. (TFLN-1982) Los metadatos Fuente y Descripción actualmente no aparecen en los resultados del flujo de trabajo. (TPM-3486)
v5.1.0	Compatible con Designer 2021.4.2 (parche 6), 2022.1 (parche 4) y versiones posteriores. Compatible solo con AMP Engine. Se agregó compatibilidad con DCM a Salida de Salesforce. Se requiere DCM para ejecutar este conector en Alteryx Server. Salida de Salesforce ahora es compatible con FIPS. Rendimiento mejorado de la característica de configuración automática. Se agregó la opción de simulacro a Entrada de Salesforce. Se corrigió el problema en el que Entrada de Salesforce 5.0.10 analizaba incorrectamente los tipos de datos. (TFLN-1676)
v5.0.10	Compatible con Designer 2021.4.2 (parche 6), 2022.1 (parche 4) y versiones posteriores. Compatible solo con AMP Engine. Se agregó la compatibilidad con DCM. Se requiere DCM para ejecutar este conector en Alteryx Server. Se puede utilizar FIPS. Se agregó compatibilidad con la autenticación OAuth y los dominios personalizados. Se corrigió el problema por el cual la Entrada de Salesforce no mostraba todos los campos y objetos. (TPM-1579) Se corrigió el problema por el cual la Entrada de Salesforce analizaba incorrectamente el archivo PAC. (TFLN-1243) Se corrigió el problema por el cual la Entrada de Salesforce no mostraba la ventana de configuración cuando el idioma de Designer estaba configurado en francés. (TDCE-119) Problemas conocidos En los informes solo se enumeran los informes recientes, en lugar de todos los informes disponibles para el usuario. Los informes devuelven solo los primeros 2000 registros.
v4.2.4	Corrige el error de las consultas personalizadas que no se analizan desde la herramienta Entrada de Salesforce. Los trabajos de Entrada de Salesforce ya no fallarán cuando se programen o ejecuten desde la línea de comandos. Se corrige un error en la verificación de certificados de la herramienta Entrada de Salesforce. Se admite la carga de la herramienta Entrada de Salesforce en la Galería sin token.
v4.1.0	Se agregó compatibilidad con la conexión a través de un proxy con la detección y la configuración automáticas. Compatible con Alteryx versión 2019.2 y posteriores.
v4.0.0	Se agregó la posibilidad de consultar los informes de Salesforce. Generador de consultas y Consulta personalizada devuelven de manera predeterminada todos los registros (incluidos los eliminados). Agrega “IsDeleted=False” a la cláusula WHERE para excluir los registros eliminados. Compatible con Alteryx versión 2018.3 - 2019.2.
v3.1	Corrige errores en Límite de registros en la pestaña Tiempo de ejecución de la configuración del flujo de trabajo y contraseñas que contienen caracteres especiales XML. Compatible con Alteryx versión 11.0 - 2018.2.

Notas del lanzamiento de la herramienta Salida de Salesforce (obsoleta)

Versión	Descripción
v1.3.1	Actualización de la herramienta metainfo.
v1.3	Actualización de la versión de la API de Salesforce en el motor de macros. Se corrigió la falla de los caracteres de escape correctamente.
v1.2	Los campos de hora y fecha se convierten automáticamente a AAAA-MM-DDThh:mm:ss.sss. Se solucionó el problema por el que aparecían los mensajes de error “Se requiere el nombre de la tabla” y “Se requiere la operación de salida” aunque el usuario no haya iniciado sesión todavía.