Skip to main content

Salesforce

Salesforceコネクタを使用すると、DesignerでSalesforceに接続できます。

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.

Designerの新しいコネクタバージョン

Salesforceコネクタは、Alteryx Oneコネクタエクスペリエンスの一部になりました。このページの情報をよく確認して、適切なツールを正しく使用していることを確認してください。

DesignerワークフローでSalesforceコネクタを更新する場合は、ワークフロー移行ユーティリティを使用できます。

Salesforceコネクタの詳細

Salesforceは、データ入力ツールのデータソースとして、Designer 2025.2のパッチ3以降で使用できます。ファイルの種類のオプションについて詳しくは、[links]を参照してください。

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

コネクタのインストール

アドオンを介して、DesignerからSalesforceコネクタの最新バージョンを簡単にインストールできます。コネクタをこの方法でインストールする場合は、Alteryx Marketplaceにアクセスする必要はありません。

コネクタのインストール方法

  1. Designerで、[アドオン] > [Marketplaceアドオンの管理]に移動します。

  2. Designerが、使用可能なコネクタのリストが表示されたウィンドウを開きます。

  3. 「Salesforce」と入力して検索します。

DCMで接続を設定する

DCMを使用してSalesforceに接続するには、次の手順に従います。DCM - Designer

  1. ツールパレットのデータ入力ツールまたはデータ出力ツールをキャンバスにドラッグし、それを選択します。

  2. すでにGoogle Drive接続を作成済みの場合は、[データソース] > [Salesforce] > [クイック接続]の順に選択してから、手順12にスキップします。

    If you've created a Salesforce connection before, you can select the connection from the Recents tab.

  3. Select + New. From the list of technologies, select Salesforce.

  4. [データ接続]ウィンドウで、[データソース]を選択します。

  5. Select +New.

  6. Specify the connection name and the data source name. Select the Environment.

  7. In the Credentials section, select your authentication method, and enter the credential name. For more information, see Authentication Methods.

  8. [保存]を選択します。保存する前に接続をテストすることもできます。

  9. [接続]を選択します。Salesforceが認証を要求する場合があります。

  10. ファイルブラウザーウィンドウで、読み取りまたは書き込み先のファイルを選択します。

  11. [オプション]ウィンドウで読み取りまたは書き込み設定を選択します。

  12. [確認]を選択して、ファイルへの接続を作成します。ワークフローの構築を続行できます。

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.

認証方法

Salesforceは以下をサポートします。

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.

注記

  • 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.

Salesforceコネクタのリリースノート

Designerとの互換性(検討中)

コネクタリリースバージョンxxxx.x.x.xxxxx

ID

説明

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.

Salesforceスタンドアロンコネクタ

接続タイプ

Alteryxツール。最新のバージョンは、Alteryx Marketplace から入手できます。

サポートのタイプ

読み取り、書き込み

検証済み

ODBCクライアントバージョン2.2.20は、データ入力ツールおよびデータ出力ツールでも使用可能です。

Salesforceツールのリリースノート

バージョン

説明

v5.1.4

  • Designer 2021.4.2パッチ6、2022.1パッチ4以降と互換性があります。

  • AMP Engineとのみ互換性があります。

  • このコネクタをAlteryx Serverで実行するには、DCMが必要です。

  • Salesforceコネクタでは、末尾に余分なゼロが表示されないように、既定で時刻と日付/時刻の精度がミリ秒に設定されている一方で、必要なワークフローではナノ秒の解像度にも対応します。(TPM-4753、TPM-4736)

  • ServerでSalesforceツールがプロキシ設定を無視する問題を修正しました。(TPM-4647)

  • SalesforceツールがDesignerのアクセストークンに依存しており、Server上でワークフローを実行できない問題を修正しました。(TPM-4846)

  • Designerの開発者ツールで、返されるJSONファイルのシークレット値が表示される問題を修正しました。(TPM-4788)

v5.1.3

  • Designer 2021.4.2パッチ6、2022.1パッチ4以降と互換性があります。

  • AMP Engineとのみ互換性があります。

  • このコネクタをAlteryx Serverで実行するには、DCMが必要です。

  • DCM使用時のカスタムSalesforceドメインのサポートを追加しました。

  • 認証を改善しました。

  • SDKをバージョン2.4.2に更新しました。

  • APIを最新バージョンに更新しました。

  • DCMの使用時にSalesforceツールがPACスクリプトを無視する問題を修正しました。(TPM-4620)

  • Salesforce入力ツールが特定の日付型の列を読み込めない問題を修正しました。(TPM-4604)

  • Salesforce出力ツールで、更新操作時にフィールドマッピングが表示されない問題を修正しました。(TPM-4519)

  • セキュリティトークンがDCMで作成されていない場合、Salesforceツールに「アクセスが拒否されました」と表示される問題を修正しました。(TPM-4507)

  • SalesforceツールでAPIバージョンがフロントエンドタグに応じて整合されない問題を修正しました。(TPM-4493)

  • Salesforceツールがカスタムドメインを使用して接続できない問題を修正しました。(TPM-4488)

  • Salesforceツールで、タイムスタンプの予期しない切り捨てに関する警告が表示される問題を修正しました。(TPM-4368)

  • Salesforce入力ツールで、カスタムSOQLクエリにネストされたリレーションシップオブジェクトを使用した際に値が切り捨てられる問題を修正しました。(TPM-4367)

  • ワークフローに複数のSalesforce出力ツールが含まれている場合、Salesforce出力ツールが際限なく実行される問題を修正しました。(TPM-4268)

  • Salesforceツールに複数のAPIバージョンが選択可能なオプションとして表示される問題を修正しました。(TPM-4264)

  • Salesforce出力ツールが、挿入操作と更新操作時にデータを書き込めない問題を修正しました。(TPM-4248)

  • Salesforceツールがパーセンテージのデータ型を正しく読み取れない問題を修正しました。(TPM-4174)

  • Salesforceツールがカスタム日付フィールドでエラーを返す問題を修正しました。(TPM-4051)

  • Salesforceツールが「エラーコード400: 正しくないリクエスト構文またはサポートされていないメソッドです。」を返す問題を修正しました。(TPM-3982)

  • Salesforceツールの動作が遅くなる問題を修正しました。(TPM-3919)

  • Salesforce入力ツールがドキュメント本文ではなくURLとしてversionDataフィールドを返す問題を修正しました。(TPM-3662)

既知の問題

  • 新しいバージョンのSalesforceツールにアップグレードすると、一部のフィールドが[Null]として表示される。(TPM-4805)

  • SDKコネクタがServer (Gallery)のプロキシを無視する。(TPM-4647)

  • DesignerのHTML開発者ツールで、返されるJSON内にシークレット値が露出する。(TPM-4788)

  • Salesforce入力ツールでクエリを実行するとNullレコードが返される。(TPM-4641)

v5.1.2

  • Designer 2021.4.2パッチ6、2022.1パッチ4以降と互換性があります。

  • AMP Engineとのみ互換性があります。

  • このコネクタをAlteryx Serverで実行するには、DCMが必要です。

  • DesignerおよびServer 2024.1で実行できるようになりました。

  • 実行時間が45分を過ぎるとSalesforce入力が失敗する問題を修正しました。(TPM-3556)

  • ソースと説明メタデータが欠落していた問題を修正しました。(TPM-3486)

  • Salesforceツールがプロキシ設定を無視する問題を修正しました。(TPM-3358)

  • Salesforce入力が「エラーコード401: 権限がありません -- 認証スキームを参照してください。」というエラーを返す問題を修正しました。(TDCE-449およびTDCE-361)

v5.1.1

  • Designer 2021.4.2パッチ6、2022.1パッチ4以降と互換性があります。

  • AMP Engineとのみ互換性があります。

  • このコネクタをAlteryx Serverで実行するには、DCMが必要です。

  • DesignerおよびServer 2024.1で実行できるようになりました。

  • カスタムOAuthアプリケーションによる認証が機能しない問題を修正しました。(TFLN-1912)

  • 空のデータセットを読み取るよう設定されているとき、Salesforce入力が際限なく実行される問題を修正しました。(TPM-2453)

既知の問題

  • Designer FIPSおよびServer FIPSで、Salesforceツール5.1.1が動作しない。回避策として、バージョン5.1.0を使用してください。(TFLN-1982)

  • 現在、ワークフローの結果にソースと説明のメタデータがない。(TPM-3486)

v5.1.0

  • Designer 2021.4.2パッチ6、2022.1パッチ4以降と互換性があります。

  • AMP Engineとのみ互換性があります。

  • Salesforce出力にDCMのサポートを追加しました。

  • このコネクタをAlteryx Serverで実行するには、DCMが必要です。

  • Salesforce出力がFIPSに対応しました。

  • 自動設定機能のパフォーマンスが向上しました。

  • Salesforce入力にドライランオプションを追加しました。

  • Salesforce入力5.0.10でデータ型が正しく解析されない問題を修正しました。(TFLN-1676)

v5.0.10

  • Designer 2021.4.2パッチ6、2022.1パッチ4以降と互換性があります。

  • AMP Engineとのみ互換性があります。

  • DCM のサポートを追加しました。

    • このコネクタをAlteryx Serverで実行するには、DCMが必要です。

  • FIPS対応。

  • OAuth認証とカスタムドメインのサポートが追加されました。

  • Salesforce入力ですべてのフィールドとオブジェクトが表示されない問題を修正しました。(TPM-1579)

  • Salesforce入力でPACファイルが正しく解析されない問題を修正しました。(TFLN-1243)

  • Designerの言語がフランス語に設定されている場合、Salesforce入力で設定ウィンドウが表示されない問題を修正しました。(TDCE-119)

既知の問題

  • レポートに、最近のレポートだけが表示され、利用可能なすべてのレポートが表示されない。

  • レポートが最初の2,000レコードのみを返す。

v4.2.4

  • Salesforce 入力ツールから解析できないカスタムクエリの不具合を修正しました。

  • Salesforce 入力ジョブは、スケジュールされている場合やコマンドラインから実行されている場合に、失敗しなくなりました。

  • Salesforce 入力ツールでの証明書検証の不具合を修正しました。

  • トークンを使用しない Salesforce 入力ツールの Gallery へのアップロードをサポートしています。

v4.1.0

  • 自動検出および設定を使用したプロキシ経由の接続のサポートが追加されました。

  • Alteryx バージョン 2019.2 以降と互換性があります。

v4.0.0

  • Salesforce レポートのクエリ機能が追加されました。

  • クエリビルダーとカスタムクエリは、既定ですべてのレコード (削除されたレコードを含む) を返します。

  • 削除されたレコードを除外するには、WHERE 句に 'IsDeleted=False' を追加します。

  • Alteryx バージョン 2018.3 - 2019.2 と互換性があります。

v3.1

  • ワークフロー設定の [ランタイム] タブにあるレコード制限の問題と、XML 特殊文字を含むパスワードの問題を修正しました。

  • Alteryxバージョン11.0 - 2018.2と互換性があります。

Salesforce出力ツール(廃止)のリリースノート

バージョン

説明

v1.3.1

  • ツール metainfo を更新しました。

v1.3

  • マクロエンジンの Salesforce API バージョンを更新しました。

  • 文字が正しくエスケープされない不具合を修正しました。

v1.2

  • DateTimeフィールドは、YYYY-MM-DDThh:mm:ss.sssに自動的に変換されます。

  • ユーザーがまだログインしていないにもかかわらず、「Table name is required」および「Output operation is required」というエラーメッセージが表示される問題を修正しました。

注記

  • Make sure you have the AMP engine enabled for the workflows which contain the Salesforce Input tool version 2.2.0 and later.

  • To setup a custom API application for this tool, see this guide.

  • If you want to process a PAC file that routes requests through multiple proxy IPs, use security tokens.

カスタムSalesforceドメイン

Salesforceツールは、カスタムSalesforceドメインをサポートしています。

カスタムドメインに手動で接続するには、次の手順に従ってください。

  1. Salesforceツールの設定ウィンドウで、[カスタム環境URLを使用]を選択します。

  2. [カスタム環境]にカスタムドメインを入力します。

DCMを使用してカスタムドメインに接続するには、以下の手順に従ってください。

  1. [接続を設定する]を選択します。DCMが開きます。

  2. [+新規] を選択します。[新しいデータソース]ウィンドウが、Salesforceテクノロジーがあらかじめ選択されている状態で開きます。

  3. [環境]で[カスタム]を選択します。

  4. [カスタム環境]にカスタムドメインを入力します。

このセクションの内容: