SharePoint Online リスト

  • [アーティクル]

まとめ

項目 説明
リリース状態 一般提供
製品 Excel
Power BI (セマンティック モデル)
Power BI (データフロー)
ファブリック (データフロー Gen2)
Power Apps (データフロー)
Dynamics 365 Customer Insights
サポートされている認証の種類 匿名
Windows
Microsoft アカウント
サービス プリンシパル
関数リファレンス ドキュメント SharePoint.Contents
SharePoint.Files
SharePoint.Tables

Note

オンプレミス データ ゲートウェイまたは仮想ネットワーク (VNet) データ ゲートウェイを使用する際には、サービス プリンシパル認証のタイプはサポートされません。

Note

デプロイ スケジュールにより、またホスト固有の機能があることにより、ある製品に存在する機能が他の製品にはない場合があります。

サポートされる機能

  • サイトの URL

サイトの URL を確認する

SharePoint サイトへの接続時には、そのサイト URL を入力するように求められます。 ご利用の SharePoint Online リストを含むサイト URL を見つけるには、最初に SharePoint でページを開きます。 SharePoint のページから、該当するサイト アドレスを取得するには、通常、ナビゲーション ペイン内の [ホーム] を選択するか、または上部にあるサイトのアイコンを選択します。 ご利用の Web ブラウザーのアドレス バーからアドレスをコピーし、後で使用するために保存します。

ナビゲーション ペイン内の [ホーム] の場所、サイトの上部にあるアイコン、結果として表示される URL アドレスを示す図。

Power Query Desktop から SharePoint Online リストに接続する

SharePoint Online リストに接続するには、次のようにします。

  1. データの取得エクスペリエンスで [SharePoint Online リスト] を選択します。 Power Query Desktop でのデータの取得エクスペリエンスは、アプリによって異なります。 アプリの Power Query Desktop データの取得エクスペリエンスの詳細については、「データを取得する場所」を参照してください。

  2. 「サイトの URL を確認する」でコピーした SharePoint サイト URL を、開いているダイアログ ボックス内の [サイトの URL] フィールドに貼り付けます。

    フォルダーの選択。

    入力した URL アドレスが無効な場合は、サイト URL テキストボックスの横に 警告アイコン。 警告アイコンが表示されます。

    このコネクタの 1.0 実装または 2.0 実装のいずれかを選択することもできます。 詳細情報: SharePoint Online リスト v2.0 に接続する

    OK を選択して続行します。

  3. 今回初めてこのサイト アドレスにアクセスした場合は、適切な認証方法を選択します。 自分の資格情報を入力し、これらの設定の適用先とするレベルを選択します。 次に、 [接続](Connect) を選択します。

    Microsoft アカウントを選択します。

    認証の方法およびレベル設定の詳細については、「データ ソースを使用した認証」を参照してください。

  4. ナビゲーターで場所を選択すると、Power Query エディターで [データの変換] を選択してデータを変換することも、[読み込み] を選択してデータを読み込むこともできます。

    一覧のチェック ボックスをオンにします。

Power Query Online から SharePoint Online リストに接続する

SharePoint Online リストに接続するには、次のようにします。

  1. データの取得エクスペリエンスで [SharePoint Online リスト] オプションを選択します。 Power Query Online のデータの取得エクスペリエンスに到達する方法は、アプリによって異なります。 Power Query Online のデータの取得エクスペリエンスに到達する方法の詳細については、「データを取得する場所」を参照してください。

    SharePoint Online リストが強調された [データの取得] ウィンドウのスクリーンショット。

  2. 「サイトの URL を確認する」でコピーした SharePoint サイト URL を、開いているダイアログ ボックス内の [サイトの URL] フィールドに貼り付けます。

    Online リストの選択。

  3. 必要に応じて、オンプレミス データ ゲートウェイの名前を入力します。

  4. 認証の種類を選択し、必要とされる資格情報を入力します。

  5. [次へ] を選択します。

  6. ナビゲーターで場所を選択すると、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 がまだ選択されていないことを確認してください。

SharePoint Online リストの設定例を示す画面。

この更新プログラムをコネクタに適用すると、同じデータに対して 2 種類のビューが使用できるようになります。

  • すべて
  • 既定値

[すべて] ビューには、ユーザーが作成した列とシステムによって定義されている列のすべてが含まれます。 どのような列が含まれているかを、次の画面で確認できます。

SharePoint Online リスト内の特定のビューに対するビュー設定の例を示す画面。

既定のビューとは、ご利用の設定で 既定値 として設定されているビューでリストをオンラインで見たときに表示される内容です。 このビューを編集してユーザー作成の列またはシステム定義の列を追加または削除する場合、あるいは新しいビューを作成し、それを既定値として設定する場合、それらの変更はコネクタを介して反映されます。

SharePoint Online リストの既定のビューのサンプルを示す画面。

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 の最大長」を参照してください。