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 の制限と割り当てに関するクイック リファレンス」を参照してください。