Skip to main content

Salesforce

Salesforceコネクタを使用すると、DesignerSalesforceに接続できます。コネクタを使用して、Salesforceオブジェクトからデータを読み取り、Alteryx Designer (Desktop)とAlteryx One (Cloud)で同じように機能する単一のコネクタからSalesforceにデータを書き戻します。

Salesforceは、データ入力ツールとデータ出力ツールのデータソースとして、またスタンドアロンのSalesforce入力ツールとSalesforce出力ツールとして使用できます。Output Data Tool Icon データ出力ツール

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

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

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

Salesforceコネクタのセットアップ

Salesforceは、Designer 2025.1.2パッチ7以降で使用できます。以前にSalesforceコネクタを使用したことがある場合は、「ユニファイドコネクタへの移行」を参照してください。

必要条件

続行する前に、次の前提条件を満たしていることを確認してください。

要件

詳細

Designerのバージョン

  • 2025.1パッチ5、2025.2パッチ3、または2026.1以降(ビルトインおよびカスタムOAuthを除くすべての機能)

  • 2025.1.2パッチ7、2025.2.1パッチ5、または2026.1パッチ(すべての認証方法)

カスタムアプリ(OAuth 2.0)のセットアップ(使用している場合)

クライアントID、クライアントシークレット、リダイレクトURI (接続されているアプリと一致している必要がある)、およびスコープを持つSalesforce接続アプリ

環境URL

本番(既定)、サンドボックス、またはカスタムドメイン

DCM

DesignerでDCMを有効にする必要があります。[オプション] > [詳細設定] > [DCM]の順に選択して、DCMを有効にします。

コネクタのインストール

[アドオン]を介して、DesignerからSalesforceコネクタの最新バージョンを簡単にインストールできます。これは、Designerを終了したりAlteryx Marketplaceにアクセスしたりせずに、コネクタの参照、インストール、更新を実行できる推奨のインストール方法です。

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

  1. Designerで、[アドオン] > [Marketplaceアドオンの管理]に移動します。使用可能なコネクタのリストが表示されます。

  2. [Salesforceコネクタ]を選択し、[インストール]を選択します。Designerがパッケージをダウンロードしてインストールします。インストールを完了するために、Designerを再起動する必要がある場合があります。

  3. インストールとセットアップの完了後、データ入力ツールとデータ出力ツールからSalesforceコネクタを使用できるようになります。

接続を設定します

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

  1. データ入力ツールまたはデータ出力ツールをキャンバスにドラッグし、[データに接続]を選択します。

  2. コネクタの設定で、[データ接続の作成または参照]を選択します。

    以前にSalesforce接続を作成したことがある場合は、[最近]タブから接続を選択できます。

  3. [+新規] を選択します。テクノロジーのリストから[Salesforce]を選択します。

  4. [クイック接続]を選択し、[接続セットアップ]を選択します。[接続]ウィンドウが開きます。

  5. [+新規] を選択します。

  6. 接続名とデータソース名を指定します。[環境]を選択します。

  7. [資格情報]セクションで、認証方法を選択し、資格情報名を入力します。詳細については、「認証方法」を参照してください。

  8. [保存]を選択します。

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

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

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

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

ユニファイドコネクタへの移行

AlteryxですでにSalesforceコネクタを使用している場合は、以下のセクションを参照してください。統合バージョンで変更された内容について説明します。

パラメーター

レガシーコネクタ

ユニファイドコネクタ(v6.1.0)

プラットフォームとツール

Desktop (入力と出力)

Cloud (入力のみ)

Desktop (入力と出力)

Cloud (入力および出力、開発中)

フレームワーク

Python SDK (Desktop)

CData ODBCドライバー(Cloud)

EACDフレームワーク(DesktopおよびCloud)

通信/API

Salesforce API v52 (Summer '21)

Salesforce API V61以降(Summer '24)

認証方法

OAuth 2.0

ユーザー名 + パスワード + セキュリティトークン

同じ方法(拡張された設定)

接続モデル

本番/サンドボックス/カスタムURLを個別に選択

単一の環境URLフィールドを使用するDCM

主な変更点

  • [本番]、[サンドボックス]、[カスタムURL]のドロップダウンオプションが、単一の[環境URL]フィールドに置き換えられました。このドロップダウンを使用するワークフローを再設定してください。

  • https://login.salesforce.com (本番、既定)、https://test.salesforce.com (サンドボックス)、またはカスタムドメインの古いドロップダウンが環境URLに置き換えられます。

  • Salesforce資格情報の認証には、クライアントIDとクライアントシークレットも必要になりました。

  • Desktopで、カスタムドメインがすべての認証方法で機能するようになりました(以前はOAuthのみ)。

既存のワークフローは、Designer 2025.2パッチ3以降のAlteryxワークフロー移行ユーティリティを使用して移行できます。詳細については、ワークフロー移行ユーティリティを参照してください。

注記

  • 移行ユーティリティはDesktopでのみ使用できます。

  • ユニファイドコネクタをインストールした後、[接続を管理]にレガシー版と統合版のSalesforceテクノロジーの両方が表示される場合があります。これは移行中には想定される動作です。新しい作業にはユニファイドコネクタを使用してください。

Salesforceコネクタについて

入力ツールと出力ツール

Salesforce入力ツールと出力ツールは、Salesforceとの読み取りと書き込みに使用されます。

Salesforce入力

Salesforce入力は、標準オブジェクトとカスタムオブジェクトを読み取ります。次の3つの方法で読み取ることができます。

  • クエリビルダ: オブジェクトを選択し、読み取るフィールドを選択します。フィールド選択では複数選択が可能なリストが表示され、すべて選択、文字列または部分文字列での検索、選択されたフィールド数と全フィールド数のリアルタイム表示、選択されたもののみを表示するフィルターなどのオプションを使用できます。レコード制限も設定できます。フィールドモードは、[すべての標準フィールドの読み込み]、[すべてのカスタムフィールドの読み込み]、[すべてのフィールドの読み込み]、[手動で選択]の4つを使用できます。

  • カスタムクエリ(SOQL): SOQLクエリを記述して、__r関係性フィールドを含む標準オブジェクトとカスタムオブジェクトを読み込み、実行前に検証します。カスタムクエリは常に単一のテーブルを返します。

  • レポートから読み込む: 保存されたレポートを参照および検索し、1つのレポートを選択して結果を解析します。

Salesforce出力

Salesforce出力は、標準オブジェクトまたはカスタムオブジェクトに行を書き込みます。アクションを選択します。

  • 挿入: 新しいレコードを追加します。

  • 更新: 既存のレコードを変更します。SalesforceレコードIDが必要です。

  • 削除: レコードを削除します。SalesforceレコードIDが必要です。

  • アップサート: ワンアクションで新しいレコードを挿入し、既存のレコードを更新します。

出力はレコードをバッチ処理し、Salesforce APIのバージョンを選択できます。[更新]、[削除]、または[アップサート]を使用する場合は、レコードIDをプライマリキーとしてデータに含めます。

オブジェクトモデル

Salesforceは、次のようにデータベーステーブルと同様に動作するオブジェクトにデータを保存します。

  • 取引先、取引先責任者、リード、商談、ケース、キャンペーン、ToDo、行動、ユーザなどの標準オブジェクトは組み込まれています。

  • カスタムオブジェクトは組織内で作成され、末尾が__c (例: Invoice__c)になります。

  • オブジェクト間の関係フィールドは__r接尾辞を使用し、SOQLで参照できます。

認証方法

Salesforceは3つの認証方法をサポートしています。以下の表をご確認いただき、ユースケースに適したものをご使用ください。

メソッド

必須項目

Desktop (主力製品)

Cloud (Alteryx One)

ビルトインアプリ(OAuth 2.0)

なし

はい

使用できない(ビルトイン接続の作成はCloudでは提供されません)

カスタムアプリ(OAuth 2.0)

クライアントID、クライアントシークレット、リダイレクトURI (既定http://localhost:1717/)、スコープ(既定api offline_access)

はい

はい

Salesforce資格情報(ユーザー名、パスワード、セキュリティトークン)

ユーザー名、パスワード、セキュリティトークン(オプション)、クライアントID、クライアントシークレット

はい

はい

すべての方法でカスタムドメイン

NA

はい

使用できない(Cloudでは一部の方法でカスタムドメインがサポートされていないため)

 

OAuthは、認証コードフロー(ユーザーからアプリ)とクライアント資格情報フロー(サービスプリンシパル、ヘッドレスまたはスケジュールされた自動化向け)の両方をサポートしています。

制限事項

  • コネクタは、読み込みまたはカスタムクエリのドライランをサポートしていません。ワークフローを実行してデータを取得するか、SOQL検証ステップを使用して実行前にカスタムクエリを確認してください。

  • フィールド数が200を超えるオブジェクトの場合、[すべてのカスタムフィールドの読み込み]モードと[すべてのフィールドの読み込み]モードは失敗します。[手動で選択]を使用して必要なフィールドを選択するか、特定のフィールドを一覧表示するSOQLカスタムクエリを作成してください。

  • SOQLカスタムクエリは、常に1つのテーブルを返します。複数のオブジェクトのデータを結合するには、SOQLクエリ内で結合するか、複数の入力ツールを使用して結果をワークフロー内でブレンドします。

  • [レポートから読み込む]では、入力ツールごとに1つのレポートを選択できます。複数のレポートを読み込むには、複数の入力ツールを使用してください。

  • コネクタはSalesforce REST APIを使用します。SalesforceバルクAPIはまだサポートされていません。きわめて大きな読み込みまたは書き込みの場合は、REST APIのスループットとSalesforce APIの制限が適用されることを想定してください。

  • オブジェクトとフィールドデータのプレビューはCloudでは使用できますが、Desktopでは使用できません。Desktopでは、クエリビルダのフィールドリストまたはSOQLクエリを使用してフィールドを設定してください。

  • Cloudでは、すべての認証方法でカスタムドメインをサポートすることはできません。Cloud接続でサポートされている方法を使用するか、カスタムドメインがすべての方法で機能するDesktopから接続してください。

  • ワークフロー移行ユーティリティは、Desktopのみで実行できます。

  • Cloudでは、ビルトインアプリ接続作成フローは提供されません。Cloudでは、カスタムOAuthアプリまたはSalesforce資格情報を使用してください。

  • 同じオブジェクトから生成されたデータ型がCloudとDesktopで異なる場合があります。

  • Cloudでは、一部のオブジェクトでデータセットの読み込みが失敗する可能性があります。特定のオブジェクトが読み込まれない場合は、そのオブジェクトのSOQLカスタムクエリを試すか、選択したフィールドを減らしてください。

  • コネクタは通常Desktopで使用できます。Cloudでのサポートは対応中であるため、まだ一般提供されていません。

Salesforceバージョン6.1.0

コネクタリリースバージョン6.1.0

バージョン

説明

v6.1.0

  • すべての認証方法で、Designer 2025.1.2パッチ7、2025.2.1パッチ5、2026.1パッチ2、または2026.2 GAが必要です。

  • DCMを使用し、Salesforce API v61+ (Summer '24)を介して通信します。

  • 接続設定が簡素化されたDCMベースの接続(単一の[環境URL]と、[リダイレクトURI]および[スコープ]を公開する[カスタムOAuth])。

  • 入力:

    クエリビルダ: [すべて選択]、[検索]、[カウント]、[フィルター]、[レコード制限]の各フィールド。

    レコード上限なしでレポートから読み取ります。

    検証付きSOQLカスタムクエリ。

    APIバージョンを選択します。

  • 出力

    [挿入]、[更新]、[削除]、新しい[アップサート]アクション。

    バッチ処理

    APIバージョンを選択します。

  • Salesforceレポートからの読み取りが固定レコード数(2000)に制限される問題を修正しました。これは、標準のREST APIを使用している場合にのみ機能します。

  • 日付/時刻値が00:00:00として返される問題を修正しました。また、空の値が正しく処理されるようになりました。

  • 列リストで[すべて選択]を使用できるようになりました。

  • アイドル状態のカスタムOAuth DCM接続を再利用しても、トークンエラーで失敗しなくなりました。

  • ビルトインアプリのOAuthが正しく認証するようになりました。

  • クラウドの特定のオブジェクトでデータセットの読み込みが失敗することがあります。

  • Salesforceカスタムクエリでスキーマによるプレビューが無効になっています。

接続タイプ

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

サポートのタイプ

読み取り、書き込み

検証済み

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

バージョン

説明

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と互換性があります。

バージョン

説明

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」というエラーメッセージが表示される問題を修正しました。

注記

  • Salesforce入力ツールバージョン2.2.0以降を含むワークフローでAMP Engineが有効になっていることを確認します。

  • このツールのカスタムAPIアプリケーションを設定するには、こちらのガイドを参照してください。

  • 複数のプロキシIPを通じてリクエストをルーティングするPACファイルを処理する場合は、セキュリティトークンを使用してください。

カスタムSalesforceドメイン

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

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

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

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

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

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

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

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

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