從畫布應用程式連線到 SharePoint

SharePoint。

連線到 SharePoint 網站以從自訂清單自動產生應用程式,或者在您新增資料到現有應用程式之前建立連線,或從頭開始建立應用程式。

根據您的資料所在位置,您可以採取下列其中一項或兩種方法:

  • 在 SharePoint Online 網站或內部部署網站中顯示自訂清單的資料。
  • 在程式庫中顯示映像並播放影片或音訊檔 (SharePoint Online 專用)。

產生應用程式

如果您想要管理自訂清單中的資料,Power Apps 可 自動為您產生三畫面式應用程式。 使用者可在第一個畫面瀏覽清單,在第二個畫面中顯示項目的詳細資料,並在第三個畫面建立或更新項目。

注意

如果您的 SharePoint 清單包含 ChoiceLookupPerson or group 欄位,請參閱本主題稍後的 在資源庫中顯示資料

建立關係

  1. 登入 Power Apps,選取左導覽列中的 Data > Connections,然後選取左上角附近的 New connection

    選取左導覽列中的 Data > Connections,然後選取左上角附近的 New connection。

  2. 選取 SharePoint

    選取 SharePoint。

  3. 執行這些步驟組的任何一個︰

    • 若要連線 SharePoint Online,請選取 Connect directly (cloud services),和 Create,然後提供認證 (如果看到提示)。

      若要連線 SharePoint Online,請選取直接連接 (雲端服務)。

      連線已建立,而您可以新增資料到現有的應用程式或從頭開始建置應用程式。

    • 若要連線到內部部署的網站,請選取 Connect using on-premises data gateway

      若要連線到內部部署的網站,請選取使用內部部署資料閘道連線。

      指明 Windows 作為驗證類型,然後指明您的認證。 (如果您的認證包括網域名稱,請指明它為 網域\別名。)

      指明認證。

      Choose a gateway 下,選取您要使用的閘道,然後選取 Create

      注意

      如果您尚未安裝內部部署資料閘道,請 安裝一個,然後選取圖示重新整理閘道清單。

      選擇閘道。

      連線已建立,而您可以新增資料到現有的應用程式或從頭開始建置應用程式。

將資料新增到現有的應用程式

  1. 在 Power Apps Studio 中,開啟您要更新的應用程式,並在左窗格中選取 資料

    選取左側窗格上的資料。

  2. 選取 新增資料 > 連接器 > SharePoint

  3. Connect to a SharePoint site 下,在 近期網站 清單中選取輸入項目 (或者鍵入或貼上您要使用的網站 URL),然後選取 Connect

    選取網站。

  4. 選擇清單 下,選取您想要使用的一個或多個清單的核取方塊,然後選取 連線

    在選擇清單下,選取您想要使用的一個或多個清單的核取方塊,然後選取連線。

    並非所有類型的清單都是預設出現。 Power Apps 支援自訂清單,但不支援範本型清單。 如果您想要使用的清單名稱並未出現,請捲動到底部,然後在包含 Enter custom table name 的方塊中鍵入清單名稱。

    在包含輸入自訂清單名稱的方塊中鍵入清單名稱。

    資料來源或來源便會新增到您的應用程式。

從頭建置您自己的應用程式

從頭開始建立應用程式 中將概念套用到 SharePoint,而不是 Excel。

如果您的自訂清單包含任何一種欄位類型,請使用公式列在 Gallery 控制項中顯示該資料,以便設定該資源庫中一個或多個 Label 控制項的 Text 屬性:

  • 若是 ChoiceLookup 欄位,請指明 ThisItem.ColumnName.Value 顯示該欄位的資料。

    例如,如果您的 Choice 欄位名為 Location,請指明 ThisItem.Location.Value,如果您的 Lookup 欄位名為 PostalCode,則指明 ThisItem.PostalCode.Value

  • 若是 個人或群組 欄位,請指明 ThisItem.ColumnName.DisplayName 顯示使用者或群組的顯示名稱。

    例如,指明 ThisItem.Manager.DisplayName 顯示來自名為 Manager個人或群組 欄位的顯示名稱。

    您也可以顯示關於使用者的不同資訊,例如電子郵件地址或職稱。 若要顯示完整的選項清單,請指 ThisItem.ColumnName (包括後置句點)。

    注意

    若是 CreatedBy 欄位,請指明 ThisItem.Author.DisplayName 顯示建立清單項目之使用者的顯示名稱。 若是 ModifiedBy 欄位,請指明 ThisItem.Editor.DisplayName 顯示變更清單項目之使用者的顯示名稱。

  • 若是 受管理中繼資料 欄位,請指明 ThisItem.ColumnName.Label 顯示該欄位的資料。

    例如,如果您的 受管理中繼資料 欄位名為 Languages,則指明 ThisItem.Languages.Label

從程式庫顯示資料

如果您在 SharePoint 程式庫中有幾個映像,您可以新增 Drop down 控制項到您的應用程式,讓使用者可以指明要顯示的映像。 您也可以將相同原則套用到其他控制項 (例如 Gallery 控制項) 和其他類型的資料 (例如影片)。

  1. 如果尚未做好,建立連線,然後 新增資料到現有的應用程式

  2. 新增 Drop down 控制項,並將它命名為 ImageList

  3. ImageListItems 屬性設定為 Documents

  4. 在右側窗格的 Properties 索引標籤上,打開 Value 清單,然後選取 Name

    在您的程式庫的映像檔案名稱會出現在 ImageList

    影像清單。

  5. 新增 Image 控制項,並將其 Image 屬性設定為以下運算式:

    ImageList.Selected.'Link to item'

  6. 按 F5,然後在 ImageList 中選取不同的值。

    此時會出現您指明的映像。

    影像清單。

您可以 下載範例應用程式,示範從 SharePoint 程式庫顯示資料的方式比較複雜。

  1. 下載應用程式之後,請打開 Power Apps Studio,選取左導覽列中的 Open,然後選取 Browse
  2. Open 對話方塊中,尋找並打開您下載的檔案,然後遵循本主題的前兩道程序新增 SharePoint 程式庫為資料來源。

注意

根據預設,此應用程式會顯示 委派警告,但如果您的程式庫包含不到 500 個項目,您可以忽略它們。

在這個畫面控制項型應用程式中,左下角的清單會顯示您程式庫中的所有檔案。

  • 您可以在頂端附的搜尋方塊中,鍵入或貼上一個或多個字元搜尋檔案。
  • 如果您的程式庫包含資料夾,您可以在緊挨標題列下方的資料夾清單中選取篩選圖示,以篩選檔案清單。

當您找到想要的檔案時,請選取它以便在 VideoImage,或 Audio 控制項中沿著右側顯示。

範例影像。

已知問題

清單

Power Apps 會讀取包含空格的欄位名稱,但是空格會取代為十六進位逸出碼 _x0020_。 例如,SharePoint 中的 "Column Name" 在資料版面配置中顯示或用於公式時,將在 Power Apps 中以 "Column_x0020_Name" 出現。

並非支援所有類型的欄位,而且並非所有類型的欄位支援所有類型的卡片。

欄位類型 支援 預設卡片
單行文字 檢視文字
多行文字 檢視文字
選擇 檢視查閱
編輯查閱
檢視複選 (僅限 SharePoint Online)
編輯複選 (僅限 SharePoint Online)
號碼 檢視百分比
檢視評等
檢視文字
貨幣 檢視百分比
檢視評等
檢視文字
日期及時間 檢視文字
查詢 檢視查閱
編輯查閱
檢視複選
編輯複選
布林值 (是/否) 檢視文字
檢視切換
個人或群組 檢視查閱
編輯查閱
檢視複選
編輯複選
超連結 檢視 URL
檢視文字
圖片 是 (唯讀) 檢視映像
檢視文字
附件 是 (唯讀) 檢視附件
計算 是 (唯讀)
映像
工作結果
外部資料
受管理的中繼資料 是 (唯讀)
評分

程式庫

  • 您無法從 Power Apps 上傳檔案到程式庫。
  • 您無法從 PDF 檢視器控制項的程式庫中顯示 PDF 檔案。
  • Power Apps Mobile 不支援 Download 功能。
  • 如果您的使用者將在 Power Apps Mobile 或 Windows 10 應用程式中執行應用程式,請使用 Launch 功能在資源庫中顯示程式庫內容。

SharePoint 文件庫影像間歇地呈現

包含儲存在 SharePoint 文件庫中的影像連結的 SharePoint 清單,可能會在發生驗證錯誤時無法呈現內部 Power Apps。

與 SharePoint 建立的 Power Apps 連線是連到明確識別的清單,而不是一般的 SharePoint 網站。 Power Apps 嘗試將外部連結解析為外部來源。 如果不需要驗證,或使用者先前已驗證所參考的 SharePoint 網站,呈現此類影像就會成功。 不過,行動裝置上的 Power Apps 使用者可能無法事先驗證所參考的 SharePoint 網站以取得影像。 在此案例中,若要使用連結來參考 SharePoint 文件庫中的影像,可能會失敗。 即使應用程式中的文件庫有不同的連接,也會套用此行為。

作為這類案例的解決方案,請在支援 CORS 的來源(例如 Azure 儲存體)或 CDN 服務(例如允許匿名存取的 Azure CDN)上儲存影像。

後續步驟

請參閱