共用方式為

SharePoint Online 列表

  • 發行項

總結

項目 描述
發行狀態 正式運作
產品 Excel
Power BI （語意模型）
Power BI （數據流）
網狀架構 （資料流 Gen2）
Power Apps （數據流）
Dynamics 365 Customer Insights
支援的驗證類型 匿名
窗戶
Microsoft帳戶
服務主體
函式參考檔 SharePoint.Contents
SharePoint.Files
SharePoint.Tables

注意

某些功能可能會存在於一個產品中，但由於部署排程和主機特定功能，而不存在其他功能。

注意

如果您選取 [服務主體] 作為 Power BI 服務中的驗證類型，您必須透過 Azure 訪問控制服務 （ACS） 授與僅限應用程式的許可權。 如需詳細資訊，請移至 使用 SharePoint 應用程式專用授與存取權。

支援的功能

  • 網站 URL

判斷網站 URL

當您連線到 SharePoint 網站時，系統會要求您輸入網站 URL。 若要尋找包含 SharePoint Online 清單的網站 URL，請先在 SharePoint 中開啟頁面。 從 SharePoint 中的頁面，您通常可以選取瀏覽窗格中的 [首頁]，或頂端網站的圖示來取得網站位址。 從網頁瀏覽器的網址列複製位址，並儲存以供稍後使用。

影像，其中包含導航窗格中的首頁位置、網站頂端的圖示，以及產生的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

    選取 [確定] 繼續。

  3. 如果這是您第一次造訪此網站位址，請選取適當的驗證方法。 輸入您的認證，然後選擇要套用這些設定的層級。 然後選取 [Connect]。

    選擇Microsoft帳戶。

    如需驗證方法和層級設定的詳細資訊，請移至資料來源驗證 。

  4. 從 Navigator中，您可以選取位置，然後選取 [轉換數據]來轉換 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] 欄位。

    線上清單選取。

  3. 視需要輸入內部部署數據閘道的名稱。

  4. 選取驗證種類，然後輸入任何所需的認證。

  5. 選取 下一步。

  6. 從 Navigator中，您可以選取位置，然後在 Power Query 編輯器中選取 轉換數據，以轉換數據。

    使用資料的 導覽器。

連線至 SharePoint Online 清單 v2.0

在 Power BI Desktop 的 2020 年 10 月版本中，我們引進了 SharePoint Online 列表連接器的更新版本。 此連接器的 API 已改進並具有更高的可用性，但與 1.0 版連接器的使用不相容。 2.0 連接器版本自 2022 年 9 月起正式推出。

若要存取它，您將透過從Power Query Desktop 連接到SharePoint Online 清單中的步驟 2，輸入相同的連接器畫面。 不過，如果您尚未選取 [實作 ]，請確定在 [ 實作] 底下選取 [2.0]。

顯示 SharePoint Online 清單設定範例的畫面。

透過連接器的此更新，我們會針對相同的數據提供兩個不同的檢視：

  • 全部
  • 預設

[所有] 視圖包含所有使用者建立與系統定義的數據行。 您可以看到下列頁面中包含哪些欄位。

顯示 SharePoint Online 清單中特定檢視的檢視設定範例畫面。

默認檢視是您在在線查看清單時會看到的內容，無論您在設定中設定為 預設 檢視。 如果您編輯此檢視以新增或移除使用者建立或移除系統定義的數據行，或建立新的檢視並將其設定為預設值，這些變更將會透過連接器傳播。

顯示 SharePoint Online 清單預設檢視範例的畫面。

注意

如果您將 SharePoint 網站中的預設檢視設定為 [行事曆] 檢視或 [面板] 檢視，SharePoint 只會傳回選取檢視中顯示的數據行。 在此案例中，即使您選擇 [全部] 選項，Power BI 也不會擷取清單中的所有數據行。 這是根據設計。

故障排除

使用根 SharePoint 位址

請確定您提供 SharePoint 網站的根位址，而不需要任何子資料夾或檔。 例如，使用類似 https://contoso.sharepoint.com/teams/ObjectModel/的連結。

時區問題

使用 SharePoint Online 清單 （v1.0） 連接器時，您可能會注意到時區數據不符合瀏覽器的預期。 SharePoint 網頁型用戶端會根據瀏覽器對使用者的時區知識，執行本機時區轉換。

適用於 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，而第二個作業會將它轉換成計算機的當地時間。

SharePoint 加入限制

注意

此問題僅限於 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 長度上限