SharePoint Online リスト
まとめ
項目 | 説明 |
---|---|
リリース状態 | 一般提供 |
製品 | Excel Power BI (セマンティック モデル) Power BI (データフロー) ファブリック (データフロー Gen2) Power Apps (データフロー) Dynamics 365 Customer Insights |
サポートされている認証の種類 | 匿名 Windows Microsoft アカウント サービス プリンシパル |
関数リファレンス ドキュメント | SharePoint.Contents SharePoint.Files SharePoint.Tables |
Note
デプロイ スケジュールにより、またホスト固有の機能があることにより、ある製品に存在する機能が他の製品にはない場合があります。
サポートされている機能
- サイトの URL
サイトの URL を確認する
SharePoint サイトへの接続時には、そのサイト URL を入力するように求められます。 ご利用の SharePoint Online リストを含むサイト URL を見つけるには、最初に SharePoint でページを開きます。 SharePoint のページから、該当するサイト アドレスを取得するには、通常、ナビゲーション ペイン内の [ホーム] を選択するか、または上部にあるサイトのアイコンを選択します。 ご利用の Web ブラウザーのアドレス バーからアドレスをコピーし、後で使用するために保存します。
Power Query Desktop から SharePoint Online リストに接続する
SharePoint Online リストに接続するには、次のようにします。
データの取得エクスペリエンスで [SharePoint Online リスト] を選択します。 Power Query Desktop でのデータの取得エクスペリエンスは、アプリによって異なります。 アプリの Power Query Desktop データの取得エクスペリエンスの詳細については、「データを取得する場所」を参照してください。
「サイトの URL を確認する」でコピーした SharePoint サイト URL を、開いているダイアログ ボックス内の [サイトの URL] フィールドに貼り付けます。
入力した URL アドレスが無効な場合は、サイト URL テキストボックスの横に 警告アイコンが表示されます。
このコネクタの 1.0 実装または 2.0 実装のいずれかを選択することもできます。 詳細情報: SharePoint Online リスト v2.0 に接続する
OK を選択して続行します。
今回初めてこのサイト アドレスにアクセスした場合は、適切な認証方法を選択します。 自分の資格情報を入力し、これらの設定の適用先とするレベルを選択します。 次に、 [接続](Connect) を選択します。
認証の方法およびレベル設定の詳細については、「データ ソースを使用した認証」を参照してください。
ナビゲーターで場所を選択すると、Power Query エディターで [データの変換] を選択してデータを変換することも、[読み込み] を選択してデータを読み込むこともできます。
Power Query Online から SharePoint Online リストに接続する
SharePoint Online リストに接続するには、次のようにします。
データの取得エクスペリエンスで [SharePoint Online リスト] オプションを選択します。 Power Query Online のデータの取得エクスペリエンスに到達する方法は、アプリによって異なります。 Power Query Online のデータの取得エクスペリエンスに到達する方法の詳細については、「データを取得する場所」を参照してください。
「サイトの URL を確認する」でコピーした SharePoint サイト URL を、開いているダイアログ ボックス内の [サイトの URL] フィールドに貼り付けます。
必要に応じて、オンプレミス データ ゲートウェイの名前を入力します。
認証の種類を選択し、必要とされる資格情報を入力します。
[次へ] を選択します。
ナビゲーターで場所を選択すると、Power Query エディターで [データの変換] を選択してデータを変換することができます。
SharePoint Online リスト v2.0 に接続する
Power BI Desktop の 2020 年 10 月のリリースで、Microsoft は SharePoint Online リスト コネクタの更新済みバージョンを導入しました。 このコネクタは、API が改良され、使いやすさが向上していますが、1.0 コネクタ バージョンと使用上の下位互換性がありません。 2.0 コネクタ バージョンは、2022 年 9 月から一般提供されています。
それにアクセスするには、「Power Query Desktop から SharePoint Online リストに接続する」の手順 2 で同じコネクタ画面にアクセスします。 ただし、実装 で 2.0 がまだ選択されていないことを確認してください。
この更新プログラムをコネクタに適用すると、同じデータに対して 2 種類のビューが使用できるようになります。
- すべて
- 既定値
[すべて] ビューには、ユーザーが作成した列とシステムによって定義されている列のすべてが含まれます。 どのような列が含まれているかを、次の画面で確認できます。
既定のビューとは、ご利用の設定で 既定値 として設定されているビューでリストをオンラインで見たときに表示される内容です。 このビューを編集してユーザー作成の列またはシステム定義の列を追加または削除する場合、あるいは新しいビューを作成し、それを既定値として設定する場合、それらの変更はコネクタを介して反映されます。
Note
SharePoint サイトの既定のビューを カレンダー ビューまたは ボード ビューに設定すると、SharePoint は選択したビューに表示される列のみを返します。 このシナリオでは、すべて オプションを選択しても、Power BI はリスト内のすべての列を取得しません。 これは仕様です。
トラブルシューティング
SharePoint のルート アドレスを使用する
SharePoint サイトのルートアドレスを指定していることを確認してください。これにはサブフォルダやドキュメントを含めません。 例として、https://contoso.sharepoint.com/teams/ObjectModel/
のようなリンクを使用してください。
タイムゾーンの問題
SharePoint Online リスト (v1.0) コネクタを使用している場合、タイムゾーン データはお客様がブラウザーに期待するものと一致しない場合があるので注意してください。 SharePoint Web ベースのクライアントでは、ユーザーのタイムゾーンに関するブラウザーの知識に基づいて、ローカル タイムゾーン変換を実行します。
SharePoint 用のバックエンド API では、UTC 時刻を使用し、この UTC 時刻を Power BI に直接送信します。 Power BI によって、この UTC 時刻は変換されませんが、ユーザーには報告されます。
時刻をローカル時刻にするには、ユーザー側で SharePoint クライアントと同じ変換を行う必要があります。 これを行う列操作の例を次に示します。
#"Changed Type" = Table.TransformColumnTypes(#"Renamed Columns",{{"Datewithtime", type datetimezone}}),
#"Timezone Shifted" = Table.TransformColumns(#"Changed Type", {"Datewithtime", DateTimeZone.ToLocal})
最初の操作で、型を datetimezone
に変更し、2 番目の操作でそれをコンピューターのローカル時刻に変換します。
SharePoint の結合に関する制限
Note
この問題は、SharePoint Online リスト v2.0 コネクタに限定されています。
SharePoint Online リスト v2.0 コネクタでは、v1.0 コネクタとは異なる API が使用されます。そのため、クエリごとの結合操作は最大で 12 回となっています。詳細については、SharePoint Online のドキュメントのリスト ビューの検索しきい値に関するページを参照してください。 この問題は、SharePoint リストから 12 を超える列が同時にアクセスされると、SharePoint クエリが失敗するので、明らかになります。 ただし、ルックアップ列が 12 未満のデフォルト ビューを作成することで、この状況を回避できます。
OData を使用して SharePoint Online リストにアクセスする
OData フィードを使用して SharePoint Online リストにアクセスする場合、接続に使用する URL には約 2100 文字の制限があります。 詳細については、「URL の最大長」を参照してください。