Salesforce オブジェクト
[アーティクル] 2024/01/24
4 人の共同作成者
フィードバック
この記事の内容
まとめ
前提条件
サポートされる機能
Power Query Desktop から Salesforce オブジェクトに接続する
Power Query Online から Salesforce オブジェクトに接続する
Salesforce API バージョンの指定
既知の問題と制限事項
さらに 3 個を表示
テーブルを展開する
項目
説明
リリース状態
一般提供
製品
Excel Power BI (セマンティック モデル) Power BI (データフロー) ファブリック (データフロー Gen2) Power Apps (データフロー) Dynamics 365 Customer Insights Analysis Services
サポートされている認証の種類
Salesforce アカウント
注意
デプロイ スケジュールにより、またホスト固有の機能があることにより、ある製品に存在する機能が他の製品にはない場合があります。
Salesforce オブジェクト コネクタを使用するには、Salesforce アカウントのユーザー名とパスワードが必要です。
また、Salesforce API アクセスを有効にする必要があります。 アクセス設定を確認するには、個人の Salesforce ページに移動し、プロファイル設定を開いて、[API を有効にする] チェックボックスが選択されていることを検索して確認します。 Salesforce 試用版アカウントには API アクセス権はないことに注意してください。
実稼働
ユーザー定義
カスタム ドメイン
CNAME レコードのリダイレクト
リレーションシップ列
Power Query Desktop から Salesforce オブジェクトに接続する
Salesforce オブジェクト データに接続するには、次の操作を行います。
製品固有のデータ コネクタ リストから [Salesforce オブジェクト] を選択し、[接続] を選択します。
サインインに Salesforce の実稼働の URL (https://www.salesforce.com
) を使用する場合は、[Salesforce オブジェクト] で [実稼働] の URL を選択します。
[カスタム] を選択し、サインインするカスタム URL を入力することもできます。 このカスタム URL は、Salesforce 内で作成したカスタム ドメイン (例、https://contoso.salesforce.com
など) である可能性があります。 Salesforce にリダイレクトする独自の CNAME レコードを使用している場合は、カスタム URL の選択を使用することもできます。 Lightning URL はサポートされていないのでご注意ください。
また、[リレーションシップ列を含める] を選択することもできます。 この選択により、他のテーブルとの外部キー リレーションシップを持つ可能性のある列が含まれるようになり、クエリが変更されます。 このボックスをオフにすると、それらの列は表示されません。
URL を選択したら、[OK] を選んで続行します。
[サインイン] を選んで Salesforce アカウントにサインインします。
正常にサインインしたら、[接続] を選びます。
特定のアプリを使用して初めてサインインする場合は、メール アドレスに送信されたコードを入力して、信頼性を確認するメッセージが表示されます。 その後、使用しているアプリでデータにアクセスするかどうかを確認するメッセージが表示されます。 たとえば、Power BI Desktop で Salesforce データへのアクセスを許可するかどうかを確認するメッセージが表示されます。 許可 を選択してださい。
[ナビゲーター] ダイアログ ボックスで、読み込む Salesforce オブジェクトを選択します。 次に、[読み込み] を選択してデータを読み込むか、[データの変換] を選択してデータを変換することができます。
Power Query Online から Salesforce オブジェクトに接続する
Salesforce オブジェクト データに接続するには、次の操作を行います。
製品固有のデータ コネクタ リストから [Salesforce オブジェクト] を選択し、[接続] を選択します。
[Salesforce オブジェクト] で、接続に使用する URL を選択します。 サインインに Salesforce の実稼働 URL (https://www.salesforce.com
) を使用する場合は、[実稼働] URL を選択します。
注意
現時点では、[カスタム] URL を選択し、テキストボックスに「https://www.salesforce.com
」と入力してから、[実稼働] を選択してデータに接続する必要がある場合があります。
[カスタム] を選択し、サインインするカスタム URL を入力することもできます。 このカスタム URL は、Salesforce 内で作成したカスタム ドメイン (例、https://contoso.salesforce.com
など) である可能性があります。 Salesforce にリダイレクトする独自の CNAME レコードを使用している場合は、カスタム URL の選択を使用することもできます。
また、[リレーションシップ列を含める] を選択することもできます。 この選択により、他のテーブルとの外部キー リレーションシップを持つ可能性のある列が含まれるようになり、クエリが変更されます。 このボックスをオフにすると、それらの列は表示されません。
初めて接続する場合は、必要に応じてオンプレミス データ ゲートウェイを選択します。
[サインイン] を選んで Salesforce アカウントにサインインします。 正常にサインインしたら、[次へ] を選びます。
[ナビゲーター] ダイアログ ボックスで、読み込む Salesforce オブジェクトを選択します。 次に、[データの変換] を選択して、データを変換します。
Salesforce コネクターを使用するには、サポートされている Salesforce API バージョンを指定する必要があります。 これを行うには、Power Query Advanced Editor を使用してクエリを変更します。 たとえば、Salesforce.Data("https://login.salesforce.com/", [ApiVersion=48])
のようにします。
Salesforce でサポートされていないバージョンを指定すると、サポートされていない ApiVersion を指定したことを示すエラー メッセージが表示されます。
Salesforce API のバージョンとサポートの詳細については、「Salesforce Web サイト」 を参照してください。
Salesforce Objects コネクターの結果にテーブルがない場合、原因の 1 つとして、ApiVersion を指定するか、Salesforce でサポートされているバージョンに更新する必要があることが挙げられます。 ApiVersion を指定または更新するには、Advanced Editor を使用して、ApiVersion
パラメーターを明示的に追加します。 次に例を示します。
Source = Salesforce.Data("https://login.salesforce.com/", [ApiVersion = 54.0])
ApiVersion は Salesforce によって定期的に非推奨になるため、Salesforce でサポートされている ApiVersion を指定していることを確認してください。
Salesforce へのクエリに含めることができるフィールドの数には制限があります。 制限は、列の種類、計算列の数などによって異なります。 Query is either selecting too many fields or the filter conditions are too complicated
エラーが発生した場合は、クエリが制限を超えていることを意味します。 このエラーを回避するには、[クエリの選択] の詳細設定オプションを使用し、実際に必要なフィールドを指定します。
Salesforce セッションの設定により、この統合がブロックされる可能性があります。 [セッションを発信元の IP アドレスにロックする] 設定が無効になっていることを確認します。
Salesforce API アクセスを有効にする必要があります。 アクセス設定を確認するには、現在のユーザーのプロファイル設定に移動し、「API が有効」 チェックボックスを検索します。
Salesforce 試用版アカウントには API アクセス権はありません。
"候補リスト (複数選択)" 型のカスタム フィールドは、"レコードの作成" 操作と "レコードの更新" 操作ではサポートされていません。
Lightning URL はサポートされていません。
Salesforce では、1 つのアカウントで実行できる同時実行クエリの数は制限されます。 "INVALID_QUERY_LOCATOR" エラー これは、Salesforce の制限であり、同じアカウントを使用する Salesforce に対して複数の同時クエリがある際に発生する場合があります。 これには、Salesforce API を使用するすべてのクライアント アプリケーション (PowerQuery コネクターだけでなく) が含まれます。 このエラーの可能性を減らすには、Salesforce クエリ数を最小限に抑え、使用可能なオプション (データフローなど) を使用して Salesforce からのデータをステージングし、同じアカウントで Salesforce API の他の使用が同時にスケジュールされていないことを確認します。
Salesforce 内部 API の制限の詳細については、「Salesforce Developer の制限と割り当てに関するクイック リファレンス 」を参照してください。