Salesforce

El conector de Salesforce te permite conectarte a Salesforce en Designer.

Salesforce is available as a data source in the Input Data tool and Output Data tool, and as the standalone Salesforce Input and Salesforce Output tool.

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.

Detalles del conector de Salesforce

Salesforce está disponible en Designer 2025.2, parche 3, o en versiones posteriores como una fuente de datos para la herramienta Datos de entrada. Para obtener más información sobre las opciones de tipo de archivo, ve a [enlaces].

Prerequisites

Ensure you have completed the following prerequisites before proceeding:

Requirement	Detail
Designer version	2025.1 Patch 5, 2025.2 Patch 3, or 2026.1 or later (all features except Built-in and Custom OAuth) 2025.1.2 Patch 7, 2025.2.1 Patch 5, or 2026.1 Patch (all auth methods)
Custom app (OAuth 2.0) setup, if used	A Salesforce Connected App with Client ID, Client Secret, Redirect URI (must match the connected app) and scope
Environment URL	Production (default), Sandbox or, Custom domain
DCM	You must enable DCM in Designer. Go to Options > Advanced Settings > DCM to enable it

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. No es necesario que visites Alteryx Marketplace si instalas conectores de esta manera.

Para instalar el conector…

En Designer, ve a Complementos > Administrar complementos de Marketplace.
Designer abre una ventana con una lista de conectores disponibles.
Escribe Salesforce para buscar.

Configura una conexión con DCM

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

Arrastra la herramienta Datos de entrada o Datos de salida de la paleta de herramientas al lienzo y selecciónala.
Si ya creaste una conexión a Google Drive, puedes seleccionar Fuentes de datos > Salesforce > Conexión rápida y avanzar al paso 12.
If you've created a Salesforce connection before, you can select the connection from the Recents tab.
Select + New. From the list of technologies, select Salesforce.
En la ventana Conexiones de datos, selecciona Fuentes de datos.
Select +New.
Specify the connection name and the data source name. Select the Environment.
In the Credentials section, select your authentication method, and enter the credential name. For more information, see Authentication Methods.
Selecciona Guardar. También puedes probar la conexión antes de guardarla.
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.

Input and Output Tools

The Salesforce Input and Output tools are used to read from and write to Salesforce.

Salesforce Input

Salesforce Input reads standard and custom objects. You can read in three ways:

Query Builder: Pick an object and select the fields you want to read. The field picker offers a multiselect list with Select All, search by string or substring, a live count of selected versus total fields, and a filter to show only what's selected. A record limit can also be set. Four field modes are available: Read all Standard Fields, Read all Custom Fields, Read all Fields, and Choose Manually.
Custom Query (SOQL): Write a SOQL query to read standard and custom objects, including __r relationship fields, then validate it before running. A custom query always returns a single table.
Read from Report: Browse and search saved reports, select one report, and parse its results.

Salesforce Output

Salesforce Output writes rows to a standard or custom object. Choose an action:

Insert: Add new records.
Update: Modify existing records. Requires the Salesforce record ID.
Delete: Remove records. Requires the Salesforce record ID.
Upsert: Insert new records and update existing ones in a single action.

Output processes records in batches and lets you choose the Salesforce API version. When you use Update, Delete, or Upsert, include the record ID as the primary key in your data.

Object Model

Salesforce stores data in objects, which behave like database tables:

Standard objects are built in, for example Account, Contact, Lead, Opportunity, Case, Campaign, Task, Event, and User.
Custom objects are created in your org and end with __c, for example Invoice__c.
Relationship fields between objects use the __r suffix and can be referenced in SOQL.

Métodos de autenticación

Salesforce admite lo siguiente:

Method	Required Fields	Desktop (Flagship)	Cloud (Alteryx One)
Built-in app (OAuth 2.0)	None	Yes	Not available (built-in connection creation is not offered on Cloud)
Custom app (OAuth 2.0)	Client ID, Client Secret, Redirect URI (default `http://localhost:1717/`), Scope (default `api offline_access)`	Yes	Yes
Salesforce Credentials (username, password, security token)	Username, Password, Security Token (optional), Client ID, Client Secret	Yes	Yes
Custom domain across all methods	NA	Yes	Not available (custom domain is not supported for all methods on Cloud)

OAuth supports both the Authorization Code flow (user to app) and the Client Credentials flow (service principal, for headless or scheduled automation).

Migration to Unified Connector

If you already use the Salesforce connector in Alteryx, read the section below. It walks through what has been changed in the unified version.

Parameter	Legacy Connector	Unified Connector (v6.1.0)
Platforms and Tools	Desktop (Input and Output) Cloud (Input only)	Desktop (Input and Output) Cloud (Input and Output, in progress)
Framework	Python SDK (Desktop) CData ODBC driver (Cloud)	EACD framework (Desktop and Cloud)
Communication / API	Salesforce API v52 (Summer '21)	Salesforce API v61+ (Summer '24)
Auth methods	OAuth 2.0 Username + Password + Security Token	Same methods, with expanded configuration
Connection model	Separate Production / Sandbox / Custom URL choices	DCM, with a single Environment URL field

Key Changes

Production, Sandbox, and Custom URL dropdown options have been replaced by a single Environment URL field. Reconfigure any workflow that used this dropdown.
Environment URL replaces the old dropdown: https://login.salesforce.com (production, default), https://test.salesforce.com (sandbox), or your custom domain.
Salesforce Credentials authentication now also requires Client ID and Client Secret.
On Desktop, custom domains now work with all authentication methods (previously OAuth only).

Existing workflows can be migrated using the Alteryx Workflow Migration Utility in Designer 2025.2 Patch 3 or later. For more information, see workflow migration utility.

Nota

The migration utility is available on Desktop only.
After installing the unified connector, you may see both the legacy and unified Salesforce technologies listed in Manage Connections. This is expected during the transition. Use the unified connector for any new work.

Limitations

The connector does not support a dry run for reads or custom queries. Run the workflow to retrieve data, or use the SOQL validation step to check a custom query before running.
For objects with more than 200 fields, the Read all Custom Fields and Read all Fields modes fail. Use Choose Manually to pick the fields you need, or write a SOQL Custom Query that lists specific fields.
A SOQL Custom Query always returns one table. To combine data from multiple objects, join them within the SOQL query, or use multiple Input tools and blend the results in the workflow.
Read from Report supports selecting a single Report per Input tool. To read multiple reports, use multiple input tools.
The connector uses the Salesforce REST API. The Salesforce Bulk API is not yet supported. For very large reads or writes, expect REST API throughput and Salesforce API limits to apply.
The object and field data preview is available on Cloud but not on Desktop. On Desktop, configure fields using the Query Builder field list or a SOQL query.
On Cloud, custom domain support across all authentication methods is not available. Use a supported method for your Cloud connection, or connect from Desktop where custom domain works with all methods.
The workflow migration utility runs on Desktop only.
On Cloud, the built-in app connection creation flow is not offered. Use a Custom OAuth app or Salesforce Credentials on Cloud.
The datatypes produced from the same object can differ between Cloud and Desktop.
On Cloud, loading a dataset can fail for some objects. If a specific object does not load, try a SOQL Custom Query for that object or reduce the selected fields.
The connector is generally available on Desktop. Cloud support is in progress and not yet generally available.

Notas de lanzamiento del conector de Salesforce

Compatibilidad con Designer (por discutir)

Lanzamiento de Connector, versión xxxx.x.x.xxxxx
JIRA-ID	Requires Designer 2025.1.2 Patch 7, 2025.2.1 Patch 5, 2026.1 Patch 2, or 2026.2 GA for all authentication methods. Uses DCM and communicates via Salesforce API v61+ (Summer '24). DCM-based connections with a simplified connection setup (a single Environment URL, and Custom OAuth that exposes Redirect URI and Scope). Input: Query Builder: field Select All, search, count, filter, record limit. Read from Report with no record cap. SOQL Custom Query with validation. Choose API version. Output Insert, Update, Delete, and new Upsert action. Batch processing Choose API version. Fixed an issue where reading from a Salesforce report was limited to a fixed number of records (2000). This works only when using the standard REST API. Fixed an issue where DateTime values were returned as 00:00:00, and empty values are now handled correctly. Select All is now available on the column list. Reusing an idle Custom OAuth DCM connection no longer fails with a token error. Built-in app OAuth now authenticates correctly. Dataset loading can fail for certain objects on Cloud. Preview by schema is disabled for a Salesforce Custom Query.

Lanzamiento de Connector, versión xxxx.x.x.xxxxx

Descripción

JIRA-ID

Requires Designer 2025.1.2 Patch 7, 2025.2.1 Patch 5, 2026.1 Patch 2, or 2026.2 GA for all authentication methods.
Uses DCM and communicates via Salesforce API v61+ (Summer '24).
DCM-based connections with a simplified connection setup (a single Environment URL, and Custom OAuth that exposes Redirect URI and Scope).
Input:
Query Builder: field Select All, search, count, filter, record limit.
Read from Report with no record cap.
SOQL Custom Query with validation.
Choose API version.
Output
Insert, Update, Delete, and new Upsert action.
Batch processing
Choose API version.
Fixed an issue where reading from a Salesforce report was limited to a fixed number of records (2000). This works only when using the standard REST API.
Fixed an issue where DateTime values were returned as 00:00:00, and empty values are now handled correctly.
Select All is now available on the column list.
Reusing an idle Custom OAuth DCM connection no longer fails with a token error.
Built-in app OAuth now authenticates correctly.
Dataset loading can fail for certain objects on Cloud.
Preview by schema is disabled for a Salesforce Custom Query.

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.