Salesforce
Salesforceコネクタを使用すると、DesignerでSalesforceに接続できます。コネクタを使用して、Salesforceオブジェクトからデータを読み取り、Alteryx Designer (Desktop)とAlteryx One (Cloud)で同じように機能する単一のコネクタからSalesforceにデータを書き戻します。
Salesforceは、データ入力ツールとデータ出力ツールのデータソースとして、またスタンドアロンのSalesforce入力ツールとSalesforce出力ツールとして使用できます。
Designerの新しいコネクタバージョン
Salesforceコネクタは、Alteryx Oneコネクタエクスペリエンスの一部になりました。このページの情報をよく確認して、適切なツールを正しく使用していることを確認してください。
DesignerワークフローでSalesforceコネクタを更新する場合は、ワークフロー移行ユーティリティを使用できます。
Salesforceコネクタのセットアップ
Salesforceは、Designer 2025.1.2パッチ7以降で使用できます。以前にSalesforceコネクタを使用したことがある場合は、「ユニファイドコネクタへの移行」を参照してください。
必要条件
続行する前に、次の前提条件を満たしていることを確認してください。
要件 | 詳細 |
|---|---|
Designerのバージョン |
|
カスタムアプリ(OAuth 2.0)のセットアップ(使用している場合) | クライアントID、クライアントシークレット、リダイレクトURI (接続されているアプリと一致している必要がある)、およびスコープを持つSalesforce接続アプリ |
環境URL | 本番(既定)、サンドボックス、またはカスタムドメイン |
DCM | DesignerでDCMを有効にする必要があります。[オプション] > [詳細設定] > [DCM]の順に選択して、DCMを有効にします。 |
コネクタのインストール
[アドオン]を介して、DesignerからSalesforceコネクタの最新バージョンを簡単にインストールできます。これは、Designerを終了したりAlteryx Marketplaceにアクセスしたりせずに、コネクタの参照、インストール、更新を実行できる推奨のインストール方法です。
コネクタのインストール方法
Designerで、[アドオン] > [Marketplaceアドオンの管理]に移動します。使用可能なコネクタのリストが表示されます。
[Salesforceコネクタ]を選択し、[インストール]を選択します。Designerがパッケージをダウンロードしてインストールします。インストールを完了するために、Designerを再起動する必要がある場合があります。
インストールとセットアップの完了後、データ入力ツールとデータ出力ツールからSalesforceコネクタを使用できるようになります。
接続を設定します
DCMを使用してSalesforceに接続するには、次の手順に従います。
データ入力ツールまたはデータ出力ツールをキャンバスにドラッグし、[データに接続]を選択します。
コネクタの設定で、[データ接続の作成または参照]を選択します。
以前にSalesforce接続を作成したことがある場合は、[最近]タブから接続を選択できます。
[+新規] を選択します。テクノロジーのリストから[Salesforce]を選択します。
[クイック接続]を選択し、[接続セットアップ]を選択します。[接続]ウィンドウが開きます。
[+新規] を選択します。
接続名とデータソース名を指定します。[環境]を選択します。
[資格情報]セクションで、認証方法を選択し、資格情報名を入力します。詳細については、「認証方法」を参照してください。
[保存]を選択します。
[接続]を選択します。Salesforceが認証を要求する場合があります。
ファイルブラウザーウィンドウで、読み取りまたは書き込み先のファイルを選択します。
[オプション]ウィンドウで読み取りまたは書き込み設定を選択します。
[確認]を選択して、ファイルへの接続を作成します。ワークフローの構築を続行できます。
ユニファイドコネクタへの移行
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 (既定 | はい | はい |
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 |
|
接続タイプ | Alteryxツール。最新のバージョンは、Alteryx Marketplace から入手できます。 |
サポートのタイプ | 読み取り、書き込み |
検証済み | ODBCクライアントバージョン2.2.20は、データ入力ツールおよびデータ出力ツールでも使用可能です。 |
バージョン | 説明 |
|---|---|
v5.1.4 |
|
v5.1.3 |
既知の問題
|
v5.1.2 |
|
v5.1.1 |
既知の問題
|
v5.1.0 |
|
v5.0.10 |
既知の問題
|
v4.2.4 |
|
v4.1.0 |
|
v4.0.0 |
|
v3.1 |
|
バージョン | 説明 |
v1.3.1 |
|
v1.3 |
|
v1.2 |
|
注記
Salesforce入力ツールバージョン2.2.0以降を含むワークフローでAMP Engineが有効になっていることを確認します。
このツールのカスタムAPIアプリケーションを設定するには、こちらのガイドを参照してください。
複数のプロキシIPを通じてリクエストをルーティングするPACファイルを処理する場合は、セキュリティトークンを使用してください。
カスタムSalesforceドメイン
Salesforceツールは、カスタムSalesforceドメインをサポートしています。
カスタムドメインに手動で接続するには、次の手順に従ってください。
Salesforceツールの設定ウィンドウで、[カスタム環境URLを使用]を選択します。
[カスタム環境]にカスタムドメインを入力します。
DCMを使用してカスタムドメインに接続するには、以下の手順に従ってください。
[接続を設定する]を選択します。DCMが開きます。
[+新規] を選択します。[新しいデータソース]ウィンドウが、Salesforceテクノロジーがあらかじめ選択されている状態で開きます。
[環境]で[カスタム]を選択します。
[カスタム環境]にカスタムドメインを入力し、[保存]を選択します。
