Salesforce オブジェクト
まとめ
| 項目 | 説明 |
|---|---|
| リリース状態 | 一般提供 |
| 製品 | Excel Power BI (セマンティック モデル) Power BI (データフロー) ファブリック (データフロー Gen2) Power Apps (データフロー) Dynamics 365 Customer Insights Analysis Services |
| サポートされている認証の種類 | Salesforce アカウント |
Note
デプロイ スケジュールにより、またホスト固有の機能があることにより、ある製品に存在する機能が他の製品にはない場合があります。
警告
既定では、Salesforce では Power Query Desktop のオンライン サービスへの認証エクスペリエンスの一部として使用される Internet Explorer 11 をサポートしていません。 Microsoft Internet Explorer 11 を使用して Lightning Experience にアクセスするための拡張サポートをオプトインしてください。 Internet Explorer の構成に関する Salesforce のドキュメントを確認することもできます。 この時点で、ユーザーの認証に障害が発生しますが、保存されている資格情報は、既存の認証トークンの有効期限が切れるまで機能し続ける必要があります。 これを解決するには、「Power BI Desktop で OAuth 認証用に Microsoft Edge (Chromium) を有効にする」を参照してください。
前提条件
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 を選択します。
Note
現時点では、[カスタム] URL を選択し、テキストボックスに「
https://www.salesforce.com」と入力してから、[実稼働] を選択してデータに接続する必要がある場合があります。[カスタム] を選択し、サインインするカスタム URL を入力することもできます。 このカスタム URL は、Salesforce 内で作成したカスタム ドメイン (例、
https://contoso.salesforce.comなど) である可能性があります。 Salesforce にリダイレクトする独自の CNAME レコードを使用している場合は、カスタム URL の選択を使用することもできます。また、[リレーションシップ列を含める] を選択することもできます。 この選択により、他のテーブルとの外部キー リレーションシップを持つ可能性のある列が含まれるようになり、クエリが変更されます。 このボックスをオフにすると、それらの列は表示されません。
初めて接続する場合は、必要に応じてオンプレミス データ ゲートウェイを選択します。
[サインイン] を選んで Salesforce アカウントにサインインします。 正常にサインインしたら、[次へ] を選びます。
[ナビゲーター] ダイアログ ボックスで、読み込む Salesforce オブジェクトを選択します。 次に、[データの変換] を選択して、データを変換します。
Salesforce API バージョンの指定
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 の制限と割り当てに関するクイック リファレンス」を参照してください。
フィードバック
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「https://aka.ms/ContentUserFeedback」を参照してください。
フィードバックの送信と表示