SharePoint

SharePoint 可協助組織與同事、合作夥伴和客戶共用和共同作業。 您可以使用內部部署數據閘道，連線到 SharePoint Online 或內部部署 SharePoint 2016 或 2019 伺服器陣列，以管理檔和清單專案。

此連接器適用於以下產品和區域：

服務	Class	Regions
副駕駛工作室	標準	所有 Power Automate 區域
邏輯應用程式	標準	所有 Logic Apps 區域
Power Apps	標準	所有 Power Apps 區域
Power Automate（自動化服務）	標準	所有 Power Automate 區域

連絡人​​
名稱	SharePoint
URL	https://learn.microsoft.com/en-us/connectors/sharepoint/
Email	idcknowledgeeco@microsoft.com

連接器中繼資料
Publisher	Microsoft
網站	https://products.office.com/sharepoint/collaboration
隱私策略	https://privacy.microsoft.com/
類別	內容和文件

注意事項

• Power Automate
  • 清單的 Power Automate 流程僅在一般清單和一般文件庫中受支援。 目前不支援自訂清單和文件庫範本，包括但不限於公告、連絡人、事件和任務等清單。
• Power Apps
  • 如果自訂表單選項不可用或無法正常運作，則清單可能包含 Power Apps 不支援的資料類型。
  • 清單的自訂表單僅在一般清單和一般文件庫中受支援。 目前不支援自訂清單和文件庫範本，包括但不限於公告、連絡人、事件和任務等清單。
  • 文件庫的自訂表單僅支援編輯自訂中繼資料。 不支援編輯或管理檔案。
  • 自訂表單在建立後，無法移至其他清單或 環境 。 不過，您可以設定 Power Apps 儲存新自訂表單的 環境 。
• 標示為「已棄用」的觸發程式和動作不再主動維護。 雖然它們仍然存在於此連接器中，但強烈建議不要在任何新的應用程式或解決方案中使用它們。

已知問題與限制

• 條件式存取原則，例如多重要素驗證或裝置合規性原則，可能會封鎖透過此連接器存取資料。 如需詳細資訊，請參閱 Microsoft Entra ID 條件式存取檔 。
• 如果您取得不完整的資料集，或無法從 SharePoint 清單傳回正確的結果，可能是因為委派限制。 欲了解更多詳情，請 在此處了解更多。
• 對於使用「針對選取的專案」或「針對選取的檔案」觸發程序的流程，只有屬於 Power Automate 預設 環境 一部分的流程會列在 SharePoint Automate 功能表中。
• 某些內建的 SharePoint 流程 （例如要求簽核） 不會列在 Power Automate 入口網站中，也無法編輯。
• 無法透過此連接器在檔案上 設定敏感度標籤 。
• 如果您在流程中使用 SharePoint 觸發程式時看到錯誤 “CannotDisableTriggerConcurrency”，請注意，一旦您啟用和停用並行控制項，就無法復原它，如 這裡所述。 若要解決此問題，請匯出流程並編輯 JSON 檔案以移除「並行控制」部分。 如此一來，在重新匯入流程期間，並行選項就會停用。
• 來賓使用者帳戶無法在連接器作業中檢視或擷取下拉式清單資訊。
• 字詞集標籤的更新不會自動反映在連線的流程或應用程式中。 若要解決此問題，請直接從清單中編輯受影響的清單項目，以強制重新整理字詞集標籤。
• 當涉及特殊字元時，「擷取資料夾 V2」動作可能會導致擷取程序期間字元失真。 為避免此問題，請使用符合標準 zip 規範的現代 zip 存檔工具或庫。 這意味著它應該使用 UTF-8 編碼過程，並在構建 zip 文件時設置語言編碼標頭標誌。 （此類庫的示例 - 。NET 的 Zip 封存 SDK） 請注意，這不是連接器在作業中支援特殊字元 zip 的能力限制，而是導致此問題的封存工具問題。
• 對於清單名稱內任何位置包含句點的清單或文件庫 （例如：MySharePoint.List），使用此清單的名稱做為動態值，並將其傳入為「清單名稱」參數會導致錯誤。 在此情況下，請從 Power Automate 的下拉式功能表中選取清單，或者如果必須使用動態值，請改為在「清單名稱」值中輸入清單的識別碼。
• 清單項目附件的大小上限為 90MB。

Power Apps 限制中的 SharePoint 影像欄

• SharePoint 影像類型可能會以 [完整]、[大]、[中] 和 [小] 修飾詞顯示。 （例如，ThisItem.'項目照片'。Small） 小型、中型和大型影像是隨需建立並暫時快取。  快取時間過長的影像將會被移除，並視需要重新產生。
• 僅支援 此處 列出的下列影像格式。
• 支援大小不超過 90MB 的影像檔案透過 Power Apps 上傳至清單。
• Power Apps 通常每 30 秒重新整理一次影像中繼資料。  如果您正在編寫應用程式並想要立即重新整理影像，請選擇「...」專案以重新整理資料。
• 儲存在集合中的影像將無法正確呈現。  最好直接使用篩選運算式存取它們。
• 如果您從 SharePoint 建立應用程式，或新增連結至具有影像欄的 SharePoint 清單的資源庫控制項，即使影像資料行隱藏在清單中，影像也可能會出現在資源庫中。 您可以使用 Power Apps 欄位清單來顯示或隱藏任何影像欄位。

Power Apps 資料類型對應

請參閱 Power Apps SharePoint 檔

Power Apps 函式和作業可委派至 SQL Server

請參閱 Power Apps SharePoint 委派檔

代表團說明

• 以 And 或 Or 聯結的運算式可委派給 SharePoint。 不是 不可授權的。
• SharePoint 會將委派的決策延遲至所涉及的子欄位，以支援委派複雜類型。 檢查複雜類型上使用的子欄位類型，然後檢查此表格是否有委派功能。 請注意，在 Person 資料類型中只有 Email 和 DisplayName 是可委派的。
• 資料表的 SharePoint ID 欄位是 Power Apps 中的數字欄位。 不過，SharePoint 僅支援識別碼欄位委派的相等 （'='） 作業。
• Filter（...， IsBlank（CustomerId）） 之類的公式不會委派給 SharePoint。 不過，該公式在語意上接近 Filter（...， CustomerId = Blank（）），它會委派給 SharePoint。 這些公式並不相等，因為第二個公式不會將空字串 （“”） 視為空。 但是，第二個公式可能適合您的目的。 在 SharePoint 上，此方法適用於等於運算子 （“=”），但不適用於不等於 （“<>”） 的運算子。
• SharePoint 系統欄位不可委派。 這些欄位包括：
  • 識別碼
  • Is資料夾
  • 縮圖
  • 連接
  • 名稱
  • 檔案名稱與副檔名
  • 路徑
  • 完整路徑
  • 審核狀態
  • 審核評論
  • 內容類型
  • 是簽出
  • 版本編號
  • 觸發視窗啟動權杖
  • 觸發窗口結束令牌

一般限制

名稱	價值觀
在頻寬時間間隔內傳輸至/從連接器傳輸的 MB 數目上限 （每個連線）	1000
頻寬時間間隔 （以毫秒為單位）	60000

正在建立連線

連接器支援下列驗證類型：

預設值	建立連線的參數。	所有區域	不可共享

預設

適用：所有地區

建立連線的參數。

這不是可共用的連線。 如果 Power App 與其他使用者共用，系統會明確提示其他使用者建立新連線。

名稱	類型	Description	為必填項目
Gateway	閘道設定	內部部署閘道 （請參閱更多 https://docs.microsoft.com/data-integration/gateway 詳細資料
驗證類型	字串	連線至資料庫的驗證類型
用戶名稱	securestring	使用者名稱認證	對
密碼	securestring	密碼認證	對

節流限制

名稱	呼叫	續約期間
每個連線的 API 呼叫	600	60 秒

動作

使用 AI Builder 模型結果更新檔案屬性	更新儲存在 ModelId 所指定模型所分析之檔案的資源庫欄中的值。
使用 Microsoft Syntex 產生文件 （預覽版）	使用此動作，可根據 Microsoft Syntex 的新式範本建立檔。 此預覽版需要 Syntex 授權。 定價可能會發生變化。 如需詳細資訊，請參閱： https://docs.microsoft.com/en-us/microsoft-365/contentunderstanding/content-assembly。
使用路徑取得檔案中繼資料	取得檔案的相關資訊，例如大小、etag、建立日期等。使用檔案路徑來挑選檔案。 使用「取得檔案屬性」動作來取得儲存在程式庫中資料行中的值。
使用路徑取得檔案內容	使用檔案路徑取得檔案內容。
使用路徑取得資料夾中繼資料	取得資料夾的相關資訊。 使用資料夾路徑來挑選資料夾。
停止共用項目或檔案	刪除所有授予項目或檔案存取權的連結，並移除所有具有直接存取權的人員 （擁有者除外）。
刪除檔案	刪除檔案識別碼所指定的檔案。
刪除附件	刪除指定的附件。
刪除項目	從 SharePoint 清單中刪除項目。
加入中樞網站	將要求的站台加入中樞站台。 如果該中心需要核准，則需要核准權杖才能成功完成聯結。 如果適用，您應該指定與「將中樞網站加入狀態設定為擱置中」動作中使用的相同核准相互關聯識別碼。
取出檔案	取出文件庫中的檔案，以防止其他人編輯文件，也不會看到您的變更，直到簽入文件為止。
取得所有清單和文件庫	取得所有清單和程式庫。
取得檔案 （僅限屬性）	取得儲存在文件庫中所有資料夾和檔案的文件庫中資料行中的屬性。 您也可以篩選至符合條件的項目。 「套用至每個」區段通常用於處理此動作的輸出。 將此功能與內部部署資料閘道搭配使用時，可能需要手動輸入要連線的程式庫名稱。
取得檔案中繼資料	取得檔案的相關資訊，例如大小、etag、建立日期等。使用檔案識別碼來挑選檔案。 使用「取得檔案屬性」動作來取得儲存在程式庫中資料行中的值。
取得檔案內容	使用檔案識別碼取得檔案內容。 內容可以複製到其他地方，或用作附件。
取得檔案屬性	取得儲存在專案識別碼所指定專案的程式庫中資料行中的屬性。您可以新增「取得檔案內容」步驟，並使用此動作傳回的「檔案識別碼」屬性來取得檔案的內容。 將此功能與內部部署資料閘道搭配使用時，可能需要手動輸入要連線的程式庫名稱。
取得清單	從網站取得 SharePoint 清單。
取得清單檢視	從 SharePoint 清單取得檢視。
取得物品	從 SharePoint 清單取得專案。
取得物品	從 SharePoint 清單依其識別碼取得單一專案。
取得資料夾中繼資料	取得資料夾的相關資訊。 使用檔案識別碼來挑選資料夾。
取得附件	傳回指定清單項目的附件清單。 您可以新增「取得附件內容」步驟，並使用此動作傳回的「檔案識別碼」屬性來取得檔案的內容。
取得附件內容	使用檔案識別碼傳回檔案內容。 內容可以複製到其他地方，或用作附件。
取得項目或檔案的變更 （僅限屬性）	傳回在指定時間範圍內已變更之資料行的相關資訊。 附註： 清單必須開啟版本控制。
取消中樞網站加入要求	取消中樞加入要求。 如果適用，您應該指定與「將中樞網站加入狀態設定為擱置中」動作中使用的相同核准相互關聯識別碼。
合約解決方案 — 在合約解決方案工作區內產生文件	使用此動作，可根據合約解決方案工作區中的新式範本建立文件。 這是目前正在規劃的支付牆（許可證或 PayG）後面。
將 HTTP 要求傳送至 SharePoint	建構要叫用的 SharePoint REST API。 附註 – 此動作可能會執行您有權存取的任何 SharePoint REST API。 請謹慎行事。
將中樞網站加入狀態設定為擱置中	將所要求網站的中樞加入要求狀態設定為擱置中。 核准相互關聯識別碼是選擇性參數，可協助 SharePoint 識別特定的中樞加入要求。 要求網站在指定時間只能有一個擱置中的要求。
建立新的文件集	建立新的文件集清單項目。
建立新資料夾	建立新的資料夾或資料夾路徑。
建立檔案	將檔案上傳至 SharePoint 網站。 請務必挑選現有的程式庫。
建立檔案或資料夾的共用連結	建立檔案或資料夾的共用連結。
建立項目	在 SharePoint 清單中建立新專案。
建立項目或檔案的核准要求	建立項目或檔案的核准要求。
捨棄簽出	如果您簽出檔案但未對其進行變更，或您進行了不想保留的變更，您可以簡單地捨棄簽出，而不是儲存檔案。 如果您的組織追蹤版本，則每次將檔案存回文件庫時都會建立新版本。 透過捨棄簽出，您可以避免在未對檔案進行任何變更時建立新版本。
授與項目或資料夾的存取權	將 SharePoint 中項目或資料夾的存取權授與特定人員。
新增附件	將新的附件新增至指定的清單項目。
更新檔案	更新檔案識別碼所指定之檔案內容。
更新檔案屬性	更新儲存在資源庫中項目 ID 所指定項目的欄中的屬性。使用「更新檔案」動作來更新檔案內容。 將此功能與內部部署資料閘道搭配使用時，可能需要手動輸入要連線的程式庫名稱。
更新項目	更新 SharePoint 清單中的項目。
核准中樞網站加入要求	核准中樞網站加入要求。 這會傳回核准權杖，可用來使用加入中樞網站動作完成加入要求。
檢查項目的排程版本是否已發佈 [已棄用]	在輸出變數 IsFilePublished 中傳回結果。
清單根資料夾	傳回根 SharePoint 資料夾中的檔案。
清單資料夾	傳回 SharePoint 資料夾中包含的檔案。
移動檔案	移動檔案。 其運作方式與 SharePoint 文件庫中的「移至」命令類似。 傳回移動後新檔案的相關資訊。
移動資料夾	移動資料夾。 其運作方式與 SharePoint 文件庫中的「移至」命令類似。 傳回移動後新資料夾的相關資訊。
簽入檔案	在文件庫中簽入已簽出的檔案，讓其他人可以使用文件的版本。
複製檔案	複製檔案。 其運作方式與 SharePoint 文件庫中的「複製到」命令類似。 傳回複製後新檔案的相關資訊。
複製檔案 （已淘汰）	將檔案複製到 SharePoint 網站。
複製資料夾	複製資料夾。 其運作方式與 SharePoint 文件庫中的「複製到」命令類似。 傳回複製後新資料夾的相關資訊。
解壓縮資料夾	將封存檔案解壓縮到 SharePoint 資料夾中 （例如：.zip）。
解決人員	傳回單一相符的使用者值，以便將其指派給類型為 person 的資料行。 如果沒有相符項或多個相符項，則此動作將會出錯。
設定內容核准狀態	設定清單或文件庫中已開啟內容核准之項目的內容核准狀態。 您必須為頁面和檔案提供 ETag。 您可以使用 [取得檔案中繼資料] 動作來取得 ETag。 此動作僅適用於 SharePoint Online 和 SharePoint 2019。

使用 AI Builder 模型結果更新檔案屬性

作業識別碼：

PatchFileItemWithPredictedValues

更新儲存在 ModelId 所指定模型所分析之檔案的資源庫欄中的值。

參數

名稱	機碼	必要	類型	Description
網站地址	dataset	True	string	範例： https://contoso.sharepoint.com/sites/sitename.
圖書館名稱	table	True	string	程式庫名稱。
Id	id	True	integer	要更新的項目的唯一識別碼。
ModelId	modelId		string	輸入用於預測的模型的 modelId
預測結果	predictResult		string	在 JSON 中輸入請求內容

傳回

此作業會輸出隨機的結果。

使用 Microsoft Syntex 產生文件 （預覽版）

作業識別碼：

CreateContentAssemblyDocument

使用此動作，可根據 Microsoft Syntex 的新式範本建立檔。 此預覽版需要 Syntex 授權。 定價可能會發生變化。 如需詳細資訊，請參閱： https://docs.microsoft.com/en-us/microsoft-365/contentunderstanding/content-assembly。

參數

名稱	機碼	必要	類型	Description
網站地址	dataset	True	string	範例： https://contoso.sharepoint.com/sites/sitename.
文件庫名稱	table	True	string	SharePoint 文件庫名稱。
文件範本	template	True	string	文件範本。
佔位符	item	True	dynamic	文件預留位置值。
資料夾路徑	folderPath		string	必須從現有的程式庫開始。
檔案名稱	fileName		string	文件檔名。
檢視 （無效果）	view		string	此參數不會執行任何動作。 請不要使用。

傳回

SharePoint 版本的 BlobMetadataResponse 會藉由新增一些我們想要序列化的其他欄位來擴充物件

身體

SPBlobMetadataResponse

使用路徑取得檔案中繼資料

作業識別碼：

GetFileMetadataByPath

取得檔案的相關資訊，例如大小、etag、建立日期等。使用檔案路徑來挑選檔案。 使用「取得檔案屬性」動作來取得儲存在程式庫中資料行中的值。

參數

名稱	機碼	必要	類型	Description
網站地址	dataset	True	string	範例： https://contoso.sharepoint.com/sites/sitename.
檔案路徑	path	True	string	選取檔案。

傳回

SharePoint 版本的 BlobMetadataResponse 會藉由新增一些我們想要序列化的其他欄位來擴充物件

身體

SPBlobMetadataResponse

使用路徑取得檔案內容

作業識別碼：

GetFileContentByPath

使用檔案路徑取得檔案內容。

參數

名稱	機碼	必要	類型	Description
網站地址	dataset	True	string	範例： https://contoso.sharepoint.com/sites/sitename.
檔案路徑	path	True	string	選取檔案。
推斷內容類型	inferContentType		boolean	根據擴充功能推斷內容類型。

傳回

檔案的內容。

檔案內容

binary

使用路徑取得資料夾中繼資料

作業識別碼：

GetFolderMetadataByPath

取得資料夾的相關資訊。 使用資料夾路徑來挑選資料夾。

參數

名稱	機碼	必要	類型	Description
網站地址	dataset	True	string	範例： https://contoso.sharepoint.com/sites/sitename.
資料夾路徑	path	True	string	選取資料夾。

傳回

SharePoint 版本的 BlobMetadataResponse 會藉由新增一些我們想要序列化的其他欄位來擴充物件

身體

SPBlobMetadataResponse

停止共用項目或檔案

作業識別碼：

UnshareItem

刪除所有授予項目或檔案存取權的連結，並移除所有具有直接存取權的人員 （擁有者除外）。

參數

名稱	機碼	必要	類型	Description
網站地址	dataset	True	string	範例： https://contoso.sharepoint.com/sites/sitename.
清單或文件庫名稱	table	True	string	SharePoint 清單或文件庫名稱。
Id	id	True	integer	您要停止共用之項目或檔案的唯一識別碼。

刪除檔案

作業識別碼：

DeleteFile

刪除檔案識別碼所指定的檔案。

參數

名稱	機碼	必要	類型	Description
網站地址	dataset	True	string	範例： https://contoso.sharepoint.com/sites/sitename.
檔案識別碼	id	True	string	選取檔案。

刪除附件

作業識別碼：

DeleteAttachment

刪除指定的附件。

參數

名稱	機碼	必要	類型	Description
網站地址	dataset	True	string	範例： https://contoso.sharepoint.com/sites/sitename.
清單名稱	table	True	string	SharePoint 清單名稱。
Id	itemId	True	integer	檔案附加之清單項目的 ID。
檔案識別碼	attachmentId	True	string	附件的檔案識別碼。

刪除項目

作業識別碼：

DeleteItem

從 SharePoint 清單中刪除項目。

參數

名稱	機碼	必要	類型	Description
網站地址	dataset	True	string	範例：https://contoso.sharepoint.com/sites/sitename
清單名稱	table	True	string	SharePoint 清單名稱
Id	id	True	integer	要刪除的項目的唯一識別碼

加入中樞網站

作業識別碼：

JoinHubSite

將要求的站台加入中樞站台。 如果該中心需要核准，則需要核准權杖才能成功完成聯結。 如果適用，您應該指定與「將中樞網站加入狀態設定為擱置中」動作中使用的相同核准相互關聯識別碼。

參數

名稱	機碼	必要	類型	Description
請求站點地址	dataset	True	string	範例： https://contoso.sharepoint.com/sites/sitename.
中樞網站識別碼	hubSiteId	True	string	中樞站台的標識碼。
核准權杖	approvalToken		string	此要求的核准權杖。
核准相互關聯識別碼	approvalCorrelationId		string	此要求的核准相互關聯識別碼。

取出檔案

作業識別碼：

CheckOutFile

取出文件庫中的檔案，以防止其他人編輯文件，也不會看到您的變更，直到簽入文件為止。

參數

名稱	機碼	必要	類型	Description
網站地址	dataset	True	string	範例： https://contoso.sharepoint.com/sites/sitename.
圖書館名稱	table	True	string	SharePoint 文件庫名稱。
Id	id	True	integer	檔案附加之清單項目的 ID。

取得所有清單和文件庫

作業識別碼：

GetAllTables

取得所有清單和程式庫。

參數

名稱	機碼	必要	類型	Description
網站地址	dataset	True	string	範例： https://contoso.sharepoint.com/sites/sitename.

傳回

代表表格清單。

身體

TablesList

取得檔案 （僅限屬性）

作業識別碼：

GetFileItems

取得儲存在文件庫中所有資料夾和檔案的文件庫中資料行中的屬性。 您也可以篩選至符合條件的項目。 「套用至每個」區段通常用於處理此動作的輸出。 將此功能與內部部署資料閘道搭配使用時，可能需要手動輸入要連線的程式庫名稱。

參數

名稱	機碼	必要	類型	Description
網站地址	dataset	True	string	範例：https://contoso.sharepoint.com/sites/sitename
圖書館名稱	table	True	string	SharePoint 文件庫名稱
篩選查詢	$filter		string	ODATA 篩選查詢，以限制傳回的專案 （例如 stringColumn eq 'string' OR numberColumn lt 123）。
排序方式	$orderby		string	ODATA orderBy 查詢，用於指定項目順序。
最高計數	$top		integer	要擷取的項目總數 （預設值 = 全部）。
將條目限制為資料夾	folderPath		string	選取資料夾，或將整個文件庫留空
包含巢狀項目	viewScopeOption		string	傳回子資料夾中包含的專案 （預設值 = true）
依檢視限制欄	view		string	僅使用檢視中定義的資料行，避免資料行臨界值問題

傳回

此作業會輸出隨機的結果。

取得檔案中繼資料

作業識別碼：

GetFileMetadata

取得檔案的相關資訊，例如大小、etag、建立日期等。使用檔案識別碼來挑選檔案。 使用「取得檔案屬性」動作來取得儲存在程式庫中資料行中的值。

參數

名稱	機碼	必要	類型	Description
網站地址	dataset	True	string	範例： https://contoso.sharepoint.com/sites/sitename.
檔案識別碼	id	True	string	選取檔案。

傳回

SharePoint 版本的 BlobMetadataResponse 會藉由新增一些我們想要序列化的其他欄位來擴充物件

身體

SPBlobMetadataResponse

取得檔案內容

作業識別碼：

GetFileContent

使用檔案識別碼取得檔案內容。 內容可以複製到其他地方，或用作附件。

參數

名稱	機碼	必要	類型	Description
網站地址	dataset	True	string	範例： https://contoso.sharepoint.com/sites/sitename.
檔案識別碼	id	True	string	選取檔案。
推斷內容類型	inferContentType		boolean	根據擴充功能推斷內容類型。

傳回

檔案的內容。

檔案內容

binary

取得檔案屬性

作業識別碼：

GetFileItem

取得儲存在專案識別碼所指定專案的程式庫中資料行中的屬性。您可以新增「取得檔案內容」步驟，並使用此動作傳回的「檔案識別碼」屬性來取得檔案的內容。 將此功能與內部部署資料閘道搭配使用時，可能需要手動輸入要連線的程式庫名稱。

參數

名稱	機碼	必要	類型	Description
網站地址	dataset	True	string	範例：https://contoso.sharepoint.com/sites/sitename
圖書館名稱	table	True	string	SharePoint 文件庫名稱
Id	id	True	integer	要擷取的項目的唯一識別碼
依檢視限制欄	view		string	僅使用檢視中定義的資料行，避免資料行臨界值問題

傳回

此作業會輸出隨機的結果。

取得清單

作業識別碼：

GetTables

從網站取得 SharePoint 清單。

參數

名稱	機碼	必要	類型	Description
網站地址	dataset	True	string	範例：https://contoso.sharepoint.com/sites/sitename

傳回

代表表格清單。

身體

TablesList

取得清單檢視

作業識別碼：

GetTableViews

從 SharePoint 清單取得檢視。

參數

名稱	機碼	必要	類型	Description
網站地址	dataset	True	string	範例： https://contoso.sharepoint.com/sites/sitename.
清單名稱	table	True	string	SharePoint 清單名稱。

傳回

表格列表

array of Table

取得物品

作業識別碼：

GetItems

從 SharePoint 清單取得專案。

參數

名稱	機碼	必要	類型	Description
網站地址	dataset	True	string	範例：https://contoso.sharepoint.com/sites/sitename
清單名稱	table	True	string	SharePoint 清單名稱
篩選查詢	$filter		string	ODATA 篩選查詢，以限制傳回的專案 （例如 stringColumn eq 'string' OR numberColumn lt 123）。
排序方式	$orderby		string	ODATA orderBy 查詢，用於指定項目順序。
最高計數	$top		integer	要擷取的項目總數 （預設值 = 全部）。
將條目限制為資料夾	folderPath		string	選取資料夾，或將整個清單留空
包含巢狀項目	viewScopeOption		string	傳回子資料夾中包含的專案 （預設值 = true）
依檢視限制欄	view		string	僅使用檢視中定義的資料行，避免資料行臨界值問題

傳回

此作業會輸出隨機的結果。

取得物品

作業識別碼：

GetItem

從 SharePoint 清單依其識別碼取得單一專案。

參數

名稱	機碼	必要	類型	Description
網站地址	dataset	True	string	範例：https://contoso.sharepoint.com/sites/sitename
清單名稱	table	True	string	SharePoint 清單名稱
Id	id	True	integer	要擷取的項目的唯一識別碼
依檢視限制欄	view		string	僅使用檢視中定義的資料行，避免資料行臨界值問題

傳回

此作業會輸出隨機的結果。

取得資料夾中繼資料

作業識別碼：

GetFolderMetadata

取得資料夾的相關資訊。 使用檔案識別碼來挑選資料夾。

參數

名稱	機碼	必要	類型	Description
網站地址	dataset	True	string	範例： https://contoso.sharepoint.com/sites/sitename.
檔案識別碼	id	True	string	選取資料夾。

傳回

SharePoint 版本的 BlobMetadataResponse 會藉由新增一些我們想要序列化的其他欄位來擴充物件

身體

SPBlobMetadataResponse

取得附件

作業識別碼：

GetItemAttachments

傳回指定清單項目的附件清單。 您可以新增「取得附件內容」步驟，並使用此動作傳回的「檔案識別碼」屬性來取得檔案的內容。

參數

名稱	機碼	必要	類型	Description
網站地址	dataset	True	string	範例： https://contoso.sharepoint.com/sites/sitename.
清單名稱	table	True	string	SharePoint 清單名稱。
Id	itemId	True	string	要從中取得附件的清單項目的識別碼。

傳回

response

array of SPListItemAttachment

取得附件內容

作業識別碼：

GetAttachmentContent

使用檔案識別碼傳回檔案內容。 內容可以複製到其他地方，或用作附件。

參數

名稱	機碼	必要	類型	Description
網站地址	dataset	True	string	範例： https://contoso.sharepoint.com/sites/sitename.
清單名稱	table	True	string	SharePoint 清單名稱。
Id	itemId	True	integer	檔案附加之清單項目的 ID。
檔案識別碼	attachmentId	True	string	附件的檔案識別碼。

傳回

附件的內容。

附件內容

binary

取得項目或檔案的變更 （僅限屬性）

作業識別碼：

GetItemChanges

傳回在指定時間範圍內已變更之資料行的相關資訊。 附註： 清單必須開啟版本控制。

參數

名稱	機碼	必要	類型	Description
網站地址	dataset	True	string	範例： https://contoso.sharepoint.com/sites/sitename.
清單或文件庫名稱	table	True	string	SharePoint 清單或文件庫名稱。
Id	id	True	integer	您要擷取變更之專案的識別碼。
既	since	True	string	觸發視窗開始權杖或項目版本標籤 （例如：3.0） 或 ISO 8601 日期 （YYYY-MM-DDThh：mmZ）。
Until	until		string	觸發時段結束權杖或項目版本標籤 （例如：3.0） 或 ISO 8601 日期 （YYYY-MM-DDThh：mmZ）。 如果空白，則預設為最新版本。
包括次要版本	includeDrafts		boolean	布林值，用於是否考慮從次要 （草稿） 版本進行變更。
依檢視限制欄	view		string	僅傳回檢視中定義的資料行。

傳回

此作業會輸出隨機的結果。

取消中樞網站加入要求

作業識別碼：

CancelHubSiteJoinApproval

取消中樞加入要求。 如果適用，您應該指定與「將中樞網站加入狀態設定為擱置中」動作中使用的相同核准相互關聯識別碼。

參數

名稱	機碼	必要	類型	Description
請求站點地址	dataset	True	string	範例： https://contoso.sharepoint.com/sites/sitename.
核准相互關聯識別碼	approvalCorrelationId		string	此要求的核准相互關聯識別碼。

合約解決方案 — 在合約解決方案工作區內產生文件

作業識別碼：

CreateAgreementsSolutionDocument

使用此動作，可根據合約解決方案工作區中的新式範本建立文件。 這是目前正在規劃的支付牆（許可證或 PayG）後面。

參數

名稱	機碼	必要	類型	Description
合約解決方案工作區	dataset	True	string	範例： https://contoso.sharepoint.com/sites/sitename.
合約解決方案範本	template	True	string	合約解決方案範本。
Fields	item	True	dynamic	文件預留位置值。
檔案名稱	documentName		string	文件檔名。
表格 （無效果）	table		string	此參數不會執行任何動作。 請不要使用。
檢視 （無效果）	view		string	此參數不會執行任何動作。 請不要使用。

傳回

SharePoint 版本的 BlobMetadataResponse 會藉由新增一些我們想要序列化的其他欄位來擴充物件

身體

SPBlobMetadataResponse

將 HTTP 要求傳送至 SharePoint

作業識別碼：

HttpRequest

建構要叫用的 SharePoint REST API。 附註 – 此動作可能會執行您有權存取的任何 SharePoint REST API。 請謹慎行事。

參數

名稱	機碼	必要	類型	Description
網站地址	dataset	True	string	範例： https://contoso.sharepoint.com/sites/sitename.
方法	method	True	string	Http 方法
Uri	uri	True	string	範例：_api/web/lists/getbytitle（'文件'）
Headers	headers		object	輸入請求標頭的 JSON 對象
身體	body		string	在 JSON 中輸入請求內容

將中樞網站加入狀態設定為擱置中

作業識別碼：

NotifyHubSiteJoinApprovalStarted

將所要求網站的中樞加入要求狀態設定為擱置中。 核准相互關聯識別碼是選擇性參數，可協助 SharePoint 識別特定的中樞加入要求。 要求網站在指定時間只能有一個擱置中的要求。

參數

名稱	機碼	必要	類型	Description
請求站點地址	dataset	True	string	範例： https://contoso.sharepoint.com/sites/sitename.
核准相互關聯識別碼	approvalCorrelationId		string	此要求的核准相互關聯識別碼。

建立新的文件集

作業識別碼：

CreateNewDocumentSet

建立新的文件集清單項目。

參數

名稱	機碼	必要	類型	Description
網站地址	dataset	True	string	範例： https://contoso.sharepoint.com/sites/sitename.
圖書館	table	True	string	SharePoint 文件庫名稱。
文件集路徑	path	True	string	範例：folder1/folder2/dsName
內容類型識別碼	contentTypeId	True	string	範例：0x0120D520
動態屬性	DynamicProperties		object

傳回

此作業會輸出隨機的結果。

建立新資料夾

作業識別碼：

CreateNewFolder

建立新的資料夾或資料夾路徑。

參數

名稱	機碼	必要	類型	Description
網站地址	dataset	True	string	範例： https://contoso.sharepoint.com/sites/sitename.
清單或文件庫	table	True	string	SharePoint 清單或文件庫名稱。
資料夾路徑	path	True	string	範例：folder1/folder2/folder3
依檢視限制欄	view		string	僅使用檢視中定義的資料行，避免資料行臨界值問題。

傳回

此作業會輸出隨機的結果。

建立檔案

作業識別碼：

CreateFile

將檔案上傳至 SharePoint 網站。 請務必挑選現有的程式庫。

參數

名稱	機碼	必要	類型	Description
網站地址	dataset	True	string	範例： https://contoso.sharepoint.com/sites/sitename.
資料夾路徑	folderPath	True	string	必須從現有的程式庫開始。 如有需要，請新增資料夾。
檔案名稱	name	True	string	檔案名稱。
檔案內容	body	True	binary	檔案的內容。

傳回

SharePoint 版本的 BlobMetadataResponse 會藉由新增一些我們想要序列化的其他欄位來擴充物件

身體

SPBlobMetadataResponse

建立檔案或資料夾的共用連結

作業識別碼：

CreateSharingLink

建立檔案或資料夾的共用連結。

參數

名稱	機碼	必要	類型	Description
網站地址	dataset	True	string	範例： https://contoso.sharepoint.com/sites/sitename.
圖書館名稱	table	True	string	SharePoint 文件庫名稱。
項目識別碼	id	True	integer	檔案或資料夾項目的識別碼。
連結類型	type	True	string	要建立的共用連結類型
連結範圍	scope	True	string	選擇您的共享鏈接授予誰訪問權限。 「任何人」選項只有在您的管理員啟用時才有效。
連結到期	expirationDateTime		date-time	連結到期的日期，格式為yyyy-MM-dd。 僅適用於匿名連結。

傳回

共用連結的內部結構

身體

SharingLinkPermission

建立項目

作業識別碼：

PostItem

在 SharePoint 清單中建立新專案。

參數

名稱	機碼	必要	類型	Description
網站地址	dataset	True	string	範例：https://contoso.sharepoint.com/sites/sitename
清單名稱	table	True	string	SharePoint 清單名稱
項目	item	True	dynamic	要建立的項目
依檢視限制欄	view		string	僅使用檢視中定義的資料行，避免資料行臨界值問題

傳回

此作業會輸出隨機的結果。

建立項目或檔案的核准要求

作業識別碼：

CreateApprovalRequest

建立項目或檔案的核准要求。

參數

名稱	機碼	必要	類型	Description
網站地址	dataset	True	string	範例： https://contoso.sharepoint.com/sites/sitename.
清單或文件庫	table	True	string	SharePoint 清單或文件庫名稱。
Id	id	True	integer	正在為其建立核准請求的專案的 ID。
核准類型	approvalType	True	integer	選取核准類型。
核准結構描述	approvalSchema	True	dynamic	所選核准型別的結構描述。

傳回

新核准請求的輸出物件

身體

ApprovalData

捨棄簽出

作業識別碼：

DiscardFileCheckOut

如果您簽出檔案但未對其進行變更，或您進行了不想保留的變更，您可以簡單地捨棄簽出，而不是儲存檔案。 如果您的組織追蹤版本，則每次將檔案存回文件庫時都會建立新版本。 透過捨棄簽出，您可以避免在未對檔案進行任何變更時建立新版本。

參數

名稱	機碼	必要	類型	Description
網站地址	dataset	True	string	範例： https://contoso.sharepoint.com/sites/sitename.
圖書館名稱	table	True	string	SharePoint 文件庫名稱。
Id	id	True	integer	檔案附加之清單項目的 ID。

授與項目或資料夾的存取權

作業識別碼：

GrantAccess

將 SharePoint 中項目或資料夾的存取權授與特定人員。

參數

名稱	機碼	必要	類型	Description
網站地址	dataset	True	string	範例： https://contoso.sharepoint.com/sites/sitename.
清單或文件庫名稱	table	True	string	SharePoint 清單或文件庫名稱。
Id	id	True	integer	您要授與存取權之項目或資料夾的唯一識別碼。
收件者	recipients	True	email	將收到共用邀請的收件者集合
角色	roleValue	True	string	指定要授與收件者的角色
Message	emailBody		string	共用邀請中包含的純文字格式訊息
通知收件者	sendEmail		boolean	指定收件者是否應該接收電子郵件通知訊息

新增附件

作業識別碼：

CreateAttachment

將新的附件新增至指定的清單項目。

參數

名稱	機碼	必要	類型	Description
網站地址	dataset	True	string	範例： https://contoso.sharepoint.com/sites/sitename.
清單名稱	table	True	string	SharePoint 清單名稱。
Id	itemId	True	integer	要附加檔案的清單項目的 ID。
檔案名稱	displayName	True	string	檔案名稱。
檔案內容	body	True	binary	檔案的內容。

傳回

SharePoint 清單項目附件

身體

SPListItemAttachment

更新檔案

作業識別碼：

UpdateFile

更新檔案識別碼所指定之檔案內容。

參數

名稱	機碼	必要	類型	Description
網站地址	dataset	True	string	範例： https://contoso.sharepoint.com/sites/sitename.
檔案識別碼	id	True	string	選取檔案。
檔案內容	body	True	binary	檔案的內容。

傳回

代表 Blob 資料集中繼資料回應

身體

BlobMetadataResponse

更新檔案屬性

作業識別碼：

PatchFileItem

更新儲存在資源庫中項目 ID 所指定項目的欄中的屬性。使用「更新檔案」動作來更新檔案內容。 將此功能與內部部署資料閘道搭配使用時，可能需要手動輸入要連線的程式庫名稱。

參數

名稱	機碼	必要	類型	Description
網站地址	dataset	True	string	範例：https://contoso.sharepoint.com/sites/sitename
圖書館名稱	table	True	string	SharePoint 文件庫名稱
Id	id	True	integer	要更新的項目的唯一識別碼
項目	item	True	dynamic	屬性已變更的項目
依檢視限制欄	view		string	僅使用檢視中定義的資料行，避免資料行臨界值問題

傳回

此作業會輸出隨機的結果。

更新項目

作業識別碼：

PatchItem

更新 SharePoint 清單中的項目。

參數

名稱	機碼	必要	類型	Description
網站地址	dataset	True	string	範例：https://contoso.sharepoint.com/sites/sitename
清單名稱	table	True	string	SharePoint 清單名稱
Id	id	True	integer	要更新的項目的唯一識別碼
項目	item	True	dynamic	屬性已變更的項目
依檢視限制欄	view		string	僅使用檢視中定義的資料行，避免資料行臨界值問題

傳回

此作業會輸出隨機的結果。

核准中樞網站加入要求

作業識別碼：

ApproveHubSiteJoin

核准中樞網站加入要求。 這會傳回核准權杖，可用來使用加入中樞網站動作完成加入要求。

參數

名稱	機碼	必要	類型	Description
中心站點地址	dataset	True	string	範例： https://contoso.sharepoint.com/sites/sitename.
要求網站識別碼	joiningSiteId	True	string	要求網站的標識碼。

傳回

ApproveHubSiteJoin 動作的結果物件

身體

ApproveHubSiteJoinResponse

檢查項目的排程版本是否已發佈 [已棄用]

作業識別碼：

CheckIfFileIsPublished

在輸出變數 IsFilePublished 中傳回結果。

參數

名稱	機碼	必要	類型	Description
網站地址	dataset	True	string	範例： https://contoso.sharepoint.com/sites/sitename.
圖書館名稱	table	True	string	SharePoint 文件庫名稱。
項目 ID	id	True	integer	檔案的唯一識別碼。
排程版本	scheduledVersion	True	string	排程發佈的檔案版本。

傳回

SPO 連接器填充碼上 CheckIfFileIsPublished 端點的輸出物件

身體

PublishedResult

清單根資料夾

作業識別碼：

ListRootFolder

傳回根 SharePoint 資料夾中的檔案。

參數

名稱	機碼	必要	類型	Description
網站地址	dataset	True	string	範例： https://contoso.sharepoint.com/sites/sitename.

傳回

response

array of BlobMetadata

清單資料夾

作業識別碼：

ListFolder

傳回 SharePoint 資料夾中包含的檔案。

參數

名稱	機碼	必要	類型	Description
網站地址	dataset	True	string	範例： https://contoso.sharepoint.com/sites/sitename.
檔案識別碼	id	True	string	資料夾的唯一識別碼。

傳回

response

array of BlobMetadata

移動檔案

作業識別碼：

MoveFileAsync

移動檔案。 其運作方式與 SharePoint 文件庫中的「移至」命令類似。 傳回移動後新檔案的相關資訊。

參數

名稱	機碼	必要	類型	Description
目前網站地址	dataset	True	string	範例： https://contoso.sharepoint.com/sites/sitename.
要移動的檔案	sourceFileId	True	string	檔案識別碼
目的地站台位址	destinationDataset	True	string	範例：https://contoso.sharepoint.com/sites/sitename
目標資料夾	destinationFolderPath	True	string	目標資料夾
如果另一個檔案已經存在	nameConflictBehavior	True	integer	選擇可用選項之一

傳回

SharePoint 版本的 BlobMetadataResponse 會藉由新增一些我們想要序列化的其他欄位來擴充物件

身體

SPBlobMetadataResponse

移動資料夾

作業識別碼：

MoveFolderAsync

移動資料夾。 其運作方式與 SharePoint 文件庫中的「移至」命令類似。 傳回移動後新資料夾的相關資訊。

參數

名稱	機碼	必要	類型	Description
目前網站地址	dataset	True	string	範例： https://contoso.sharepoint.com/sites/sitename.
要移動的資料夾	sourceFolderId	True	string	檔案識別碼
目的地站台位址	destinationDataset	True	string	範例：https://contoso.sharepoint.com/sites/sitename
目標資料夾	destinationFolderPath	True	string	目標資料夾
如果另一個資料夾已經存在	nameConflictBehavior	True	integer	選擇可用選項之一

傳回

SharePoint 版本的 BlobMetadataResponse 會藉由新增一些我們想要序列化的其他欄位來擴充物件

身體

SPBlobMetadataResponse

簽入檔案

作業識別碼：

CheckInFile

在文件庫中簽入已簽出的檔案，讓其他人可以使用文件的版本。

參數

名稱	機碼	必要	類型	Description
網站地址	dataset	True	string	範例： https://contoso.sharepoint.com/sites/sitename.
圖書館名稱	table	True	string	SharePoint 文件庫名稱。
Id	id	True	integer	檔案附加之清單項目的 ID。
評論	comment	True	string	輸入說明此版本中變更內容的註解
簽入類型	checkinType	True	integer	選取您要簽入的版本類型

複製檔案

作業識別碼：

CopyFileAsync

複製檔案。 其運作方式與 SharePoint 文件庫中的「複製到」命令類似。 傳回複製後新檔案的相關資訊。

參數

名稱	機碼	必要	類型	Description
目前網站地址	dataset	True	string	範例： https://contoso.sharepoint.com/sites/sitename.
要複製的檔案	sourceFileId	True	string	檔案識別碼
目的地站台位址	destinationDataset	True	string	範例：https://contoso.sharepoint.com/sites/sitename
目標資料夾	destinationFolderPath	True	string	目標資料夾
如果另一個檔案已經存在	nameConflictBehavior	True	integer	選擇可用選項之一

傳回

SharePoint 版本的 BlobMetadataResponse 會藉由新增一些我們想要序列化的其他欄位來擴充物件

身體

SPBlobMetadataResponse

複製檔案 （已淘汰）

作業識別碼：

CopyFile

將檔案複製到 SharePoint 網站。

參數

名稱	機碼	必要	類型	Description
網站地址	dataset	True	string	範例： https://contoso.sharepoint.com/sites/sitename.
來源檔案路徑	source	True	string	來源檔案的路徑。
目的地檔案路徑	destination	True	string	目的地檔案的路徑。
覆寫旗標	overwrite		boolean	是否要覆寫目的地檔案（如果存在）。

傳回

Blob 中繼資料

身體

BlobMetadata

複製資料夾

作業識別碼：

CopyFolderAsync

複製資料夾。 其運作方式與 SharePoint 文件庫中的「複製到」命令類似。 傳回複製後新資料夾的相關資訊。

參數

名稱	機碼	必要	類型	Description
目前網站地址	dataset	True	string	範例： https://contoso.sharepoint.com/sites/sitename.
要複製的資料夾	sourceFolderId	True	string	檔案識別碼
目的地站台位址	destinationDataset	True	string	範例：https://contoso.sharepoint.com/sites/sitename
目標資料夾	destinationFolderPath	True	string	目標資料夾
如果另一個資料夾已經存在	nameConflictBehavior	True	integer	選擇可用選項之一

傳回

SharePoint 版本的 BlobMetadataResponse 會藉由新增一些我們想要序列化的其他欄位來擴充物件

身體

SPBlobMetadataResponse

解壓縮資料夾

作業識別碼：

ExtractFolderV2

將封存檔案解壓縮到 SharePoint 資料夾中 （例如：.zip）。

參數

名稱	機碼	必要	類型	Description
網站地址	dataset	True	string	範例： https://contoso.sharepoint.com/sites/sitename.
來源檔案路徑	source	True	string	來源檔案的路徑。
目的地資料夾路徑	destination	True	string	目的地資料夾的路徑。
覆寫旗標	overwrite		boolean	是否要覆寫目的地檔案（如果存在）。

傳回

response

array of BlobMetadata

解決人員

作業識別碼：

SearchForUser

傳回單一相符的使用者值，以便將其指派給類型為 person 的資料行。 如果沒有相符項或多個相符項，則此動作將會出錯。

參數

名稱	機碼	必要	類型	Description
網站地址	dataset	True	string	範例： https://contoso.sharepoint.com/sites/sitename.
清單或文件庫	table	True	string	挑選資料行所在的清單或文件庫。
資料行	entityId	True	string	挑選您要指派值的資料行。
電子郵件或姓名	searchValue	True	string	使用電子郵件地址或使用者的全名。
依檢視限制欄	view		string	僅使用檢視中定義的資料行，避免資料行臨界值問題。

傳回

SharePoint 展開的使用者欄位

身體

SPListExpandedUser

設定內容核准狀態

作業識別碼：

SetApprovalStatus

設定清單或文件庫中已開啟內容核准之項目的內容核准狀態。 您必須為頁面和檔案提供 ETag。 您可以使用 [取得檔案中繼資料] 動作來取得 ETag。 此動作僅適用於 SharePoint Online 和 SharePoint 2019。

參數

名稱	機碼	必要	類型	Description
網站地址	dataset	True	string	範例： https://contoso.sharepoint.com/sites/sitename.
圖書館名稱	table	True	string	SharePoint 文件庫名稱。
Id	id	True	integer	您要設定其狀態之項目的 ID。
行動	approvalAction	True	string	挑選核准動作。
評論	comments		string	新增核准者的註解。
Etag	entityTag		string	新增 ETag （檔案和頁面需要）。

傳回

SetApprovalStatus 輸出

身體

SetApprovalStatusOutput

觸發程序

修改項目或檔案時	修改項目時觸發 （但不會在建立項目時觸發）。
刪除檔案時	在文件庫中刪除檔案時觸發。 您也可以選擇性地指定要監看的資料夾。 刪除資料夾時，觸發程序只會針對已刪除的資料夾觸發一次。 這只能由清單所在網站的網站集合管理員使用。
刪除項目時	在清單中刪除項目時觸發。 這只能由清單所在網站的網站集合管理員使用。
在資料夾中建立或修改檔案時 （已棄用）	在建立檔案時觸發，以及每次在 SharePoint 資料夾中修改檔案時觸發。 如果在子資料夾中新增/更新檔案，則不會觸發觸發程式。 如果需要在子資料夾上觸發，則應建立多個觸發程式。
在資料夾中建立檔案時 （已淘汰）	在 SharePoint 資料夾中建立檔案時觸發。 如果在子資料夾中新增/更新檔案，則不會觸發觸發程式。 如果需要在子資料夾上觸發，則應建立多個觸發程式。
對於所選項目	此觸發程序可讓您啟動 SharePoint 清單或文件庫中所選項目的流程。 您可以使用清單或程式庫的欄作為輸出參數。 對於檔案，您可以使用「識別碼」欄來取得檔案內容。 （僅適用於 Power Automate。
建立或修改檔案時 （僅限屬性）	在文件庫中建立或修改項目時觸發。 只會傳回儲存在資源庫欄中的屬性。 您可以新增「取得檔案內容」步驟，並使用此動作傳回的「檔案識別碼」屬性來取得檔案的內容。 將此功能與內部部署資料閘道搭配使用時，可能需要手動輸入要連線的程式庫名稱。
建立或修改項目時	在建立專案時觸發，以及每次修改專案時觸發。
建立檔案時 （僅限屬性）	在文件庫中建立項目時觸發。 只會傳回儲存在資源庫欄中的屬性。 您可以新增「取得檔案內容」步驟，並使用此動作傳回的「檔案識別碼」屬性來取得檔案的內容。 將此功能與內部部署資料閘道搭配使用時，可能需要手動輸入要連線的程式庫名稱。
建立項目時	建立項目時觸發。
當檔案依 Microsoft Syntex 模型分類時	當 Microsoft Syntex 變更程式庫中任何檔案的分類日期時，觸發流程。 當文件處理模型分類或擷取資訊時，日期會變更。
當網站要求加入中樞網站時	在中樞網站加入核准時觸發流程。 （僅適用於 Power Automate。
針對選取的檔案	此觸發程式可讓您啟動所選檔案的流程。 輸入：站點地址、圖書館名稱。 輸出：名稱、項目連結、ID。 （僅適用於 Power Automate。

修改項目或檔案時

作業識別碼：

GetOnChangedItems

修改項目時觸發 （但不會在建立項目時觸發）。

參數

名稱	機碼	必要	類型	Description
網站地址	dataset	True	string	範例：https://contoso.sharepoint.com/sites/sitename
清單或文件庫名稱	table	True	string	SharePoint 清單名稱
資料夾	folderPath		string	選取資料夾，或將整個文件庫留空
依檢視限制欄	view		string	僅使用檢視中定義的資料行，避免資料行臨界值問題

傳回

此作業會輸出隨機的結果。

刪除檔案時

作業識別碼：

GetOnDeletedFileItems

在文件庫中刪除檔案時觸發。 您也可以選擇性地指定要監看的資料夾。 刪除資料夾時，觸發程序只會針對已刪除的資料夾觸發一次。 這只能由清單所在網站的網站集合管理員使用。

參數

名稱	機碼	必要	類型	Description
網站地址	dataset	True	string	範例：https://contoso.sharepoint.com/sites/sitename
圖書館名稱	table	True	string	SharePoint 文件庫名稱
資料夾	folderPath		string	選取資料夾，或將整個文件庫留空

傳回

已刪除項目列表

身體

DeletedItemList

刪除項目時

作業識別碼：

GetOnDeletedItems

在清單中刪除項目時觸發。 這只能由清單所在網站的網站集合管理員使用。

參數

名稱	機碼	必要	類型	Description
網站地址	dataset	True	string	範例：https://contoso.sharepoint.com/sites/sitename
清單名稱	table	True	string	SharePoint 清單名稱

傳回

已刪除項目列表

身體

DeletedItemList

在資料夾中建立或修改檔案時 （已棄用）

作業識別碼：

OnUpdatedFile

在建立檔案時觸發，以及每次在 SharePoint 資料夾中修改檔案時觸發。 如果在子資料夾中新增/更新檔案，則不會觸發觸發程式。 如果需要在子資料夾上觸發，則應建立多個觸發程式。

參數

名稱	機碼	必要	類型	Description
網站地址	dataset	True	string	範例： https://contoso.sharepoint.com/sites/sitename.
資料夾識別碼	folderId	True	string	選取資料夾。
推斷內容類型	inferContentType		boolean	根據擴充功能推斷內容類型。

傳回

檔案的內容。

檔案內容

binary

在資料夾中建立檔案時 （已淘汰）

作業識別碼：

OnNewFile

在 SharePoint 資料夾中建立檔案時觸發。 如果在子資料夾中新增/更新檔案，則不會觸發觸發程式。 如果需要在子資料夾上觸發，則應建立多個觸發程式。

參數

名稱	機碼	必要	類型	Description
網站地址	dataset	True	string	範例： https://contoso.sharepoint.com/sites/sitename.
資料夾識別碼	folderId	True	string	選取資料夾。
推斷內容類型	inferContentType		boolean	根據擴充功能推斷內容類型。

傳回

檔案的內容。

檔案內容

binary

對於所選項目

作業識別碼：

OnItemSelected

此觸發程序可讓您啟動 SharePoint 清單或文件庫中所選項目的流程。 您可以使用清單或程式庫的欄作為輸出參數。 對於檔案，您可以使用「識別碼」欄來取得檔案內容。 （僅適用於 Power Automate。

參數

名稱	機碼	必要	類型	Description
operationId	operationId	True	string
主持人	host		object
parameters	parameters	True	object
結構描述	schema	True	object
headers架構	headersSchema		object

傳回

名稱	路徑	類型	Description
資料列	body.rows	array of object
ID	body.rows.ID	integer	檔案識別碼
項目網址	body.rows.itemUrl	string	檔案網址
fileName	body.rows.fileName	string	檔案名稱
使用者識別碼	headers.x-ms-user-id-encoded	guid	在 AAD 中觸發流程之使用者的唯一識別碼。
使用者電子郵件	headers.x-ms-user-email-encoded	byte	觸發流程之使用者的電子郵件地址。
使用者名	headers.x-ms-user-name-encoded	byte	觸發流程之使用者的顯示名稱。
時間戳	headers.x-ms-user-timestamp	string	觸發流程的時間。

建立或修改檔案時 （僅限屬性）

作業識別碼：

GetOnUpdatedFileItems

在文件庫中建立或修改項目時觸發。 只會傳回儲存在資源庫欄中的屬性。 您可以新增「取得檔案內容」步驟，並使用此動作傳回的「檔案識別碼」屬性來取得檔案的內容。 將此功能與內部部署資料閘道搭配使用時，可能需要手動輸入要連線的程式庫名稱。

參數

名稱	機碼	必要	類型	Description
網站地址	dataset	True	string	範例：https://contoso.sharepoint.com/sites/sitename
圖書館名稱	table	True	string	SharePoint 文件庫名稱
資料夾	folderPath		string	選取資料夾，或將整個文件庫留空
依檢視限制欄	view		string	僅使用檢視中定義的資料行，避免資料行臨界值問題

傳回

此作業會輸出隨機的結果。

建立或修改項目時

作業識別碼：

GetOnUpdatedItems

在建立專案時觸發，以及每次修改專案時觸發。

參數

名稱	機碼	必要	類型	Description
網站地址	dataset	True	string	範例：https://contoso.sharepoint.com/sites/sitename
清單名稱	table	True	string	SharePoint 清單名稱
依檢視限制欄	view		string	僅使用檢視中定義的資料行，避免資料行臨界值問題

傳回

此作業會輸出隨機的結果。

建立檔案時 （僅限屬性）

作業識別碼：

GetOnNewFileItems

在文件庫中建立項目時觸發。 只會傳回儲存在資源庫欄中的屬性。 您可以新增「取得檔案內容」步驟，並使用此動作傳回的「檔案識別碼」屬性來取得檔案的內容。 將此功能與內部部署資料閘道搭配使用時，可能需要手動輸入要連線的程式庫名稱。

參數

名稱	機碼	必要	類型	Description
網站地址	dataset	True	string	範例：https://contoso.sharepoint.com/sites/sitename
圖書館名稱	table	True	string	SharePoint 文件庫名稱
資料夾	folderPath		string	選取資料夾，或將整個文件庫留空
依檢視限制欄	view		string	僅使用檢視中定義的資料行，避免資料行臨界值問題

傳回

此作業會輸出隨機的結果。

建立項目時

作業識別碼：

GetOnNewItems

建立項目時觸發。

參數

名稱	機碼	必要	類型	Description
網站地址	dataset	True	string	範例：https://contoso.sharepoint.com/sites/sitename
清單名稱	table	True	string	SharePoint 清單名稱
依檢視限制欄	view		string	僅使用檢視中定義的資料行，避免資料行臨界值問題

傳回

此作業會輸出隨機的結果。

當檔案依 Microsoft Syntex 模型分類時

作業識別碼：

GetOnUpdatedFileClassifiedTimes

當 Microsoft Syntex 變更程式庫中任何檔案的分類日期時，觸發流程。 當文件處理模型分類或擷取資訊時，日期會變更。

參數

名稱	機碼	必要	類型	Description
網站地址	dataset	True	string	範例：https://contoso.sharepoint.com/sites/sitename
圖書館名稱	table	True	string	SharePoint 文件庫名稱
資料夾	folderPath		string	選取資料夾，或將整個文件庫留空
依檢視限制欄	view		string	僅使用檢視中定義的資料行，避免資料行臨界值問題

傳回

此作業會輸出隨機的結果。

當網站要求加入中樞網站時

作業識別碼：

OnHubSiteJoinApproval

在中樞網站加入核准時觸發流程。 （僅適用於 Power Automate。

參數

名稱	機碼	必要	類型	Description
operationId	operationId	True	string
主持人	host		object
parameters	parameters	True	object
結構描述	schema	True	object
headers架構	headersSchema		object

傳回

名稱	路徑	類型	Description
資料列	body.rows	array of object
請求網站網址	body.rows.RequestingSiteUrl	string	請求網站 URL
請求 SiteId	body.rows.RequestingSiteId	string	要求網站識別碼
請求網站標題	body.rows.RequestingSiteTitle	string	請求網站標題
ApprovalCorrelationId	body.rows.ApprovalCorrelationId	string	核准相互關聯識別碼
使用者識別碼	headers.x-ms-user-id-encoded	guid	在 AAD 中觸發流程之使用者的唯一識別碼。
使用者電子郵件	headers.x-ms-user-email-encoded	byte	觸發流程之使用者的電子郵件地址。
使用者名	headers.x-ms-user-name-encoded	byte	觸發流程之使用者的顯示名稱。
時間戳	headers.x-ms-user-timestamp	string	觸發流程的時間。

針對選取的檔案

作業識別碼：

OnFileSelected

此觸發程式可讓您啟動所選檔案的流程。 輸入：站點地址、圖書館名稱。 輸出：名稱、項目連結、ID。 （僅適用於 Power Automate。

參數

名稱	機碼	必要	類型	Description
operationId	operationId	True	string
主持人	host		object
parameters	parameters	True	object
結構描述	schema	True	object
headers架構	headersSchema		object

傳回

名稱	路徑	類型	Description
資料列	body.rows	array of object
ID	body.rows.ID	integer	檔案識別碼
項目網址	body.rows.itemUrl	string	檔案網址
fileName	body.rows.fileName	string	檔案名稱
使用者識別碼	headers.x-ms-user-id-encoded	guid	在 AAD 中觸發流程之使用者的唯一識別碼。
使用者電子郵件	headers.x-ms-user-email-encoded	byte	觸發流程之使用者的電子郵件地址。
使用者名	headers.x-ms-user-name-encoded	byte	觸發流程之使用者的顯示名稱。
時間戳	headers.x-ms-user-timestamp	string	觸發流程的時間。

定義

核准資料

新核准請求的輸出物件

名稱	路徑	類型	Description
核准請求ID	ApprovalId	string	已建立核准要求的識別碼

ApproveHubSiteJoinResponse

ApproveHubSiteJoin 動作的結果物件

名稱	路徑	類型	Description
核准權杖	ApprovalToken	string	核准權杖

Blob中繼資料

Blob 中繼資料

名稱	路徑	類型	Description
Id	Id	string	檔案或資料夾的唯一識別碼。
名稱	Name	string	檔案或資料夾的名稱。
顯示名稱	DisplayName	string	檔案或資料夾的顯示名稱。
路徑	Path	string	檔案或資料夾的路徑。
最後修改	LastModified	date-time	上次修改檔案或資料夾的日期和時間。
大小	Size	integer	檔案或資料夾的大小。
媒體類型	MediaType	string	檔案或資料夾的媒體類型。
Is資料夾	IsFolder	boolean	布林值 （true、false） ，指出 Blob 是否為資料夾。
Etag	ETag	string	檔案或資料夾的 etag。
檔案定位器	FileLocator	string	檔案或資料夾的檔案定位器。

BlobMetadata回應

代表 Blob 資料集中繼資料回應

名稱	路徑	類型	Description
Id	Id	string	檔案或資料夾的唯一識別碼。
名稱	Name	string	檔案或資料夾的名稱。
顯示名稱	DisplayName	string	檔案或資料夾的顯示名稱。
路徑	Path	string	檔案或資料夾的路徑。
最後修改	LastModified	date-time	上次修改檔案或資料夾的日期和時間。
大小	Size	integer	檔案或資料夾的大小。
媒體類型	MediaType	string	檔案或資料夾的媒體類型。
Is資料夾	IsFolder	boolean	布林值 （true、false） ，指出 Blob 是否為資料夾。
Etag	ETag	string	檔案或資料夾的 etag。
檔案定位器	FileLocator	string	檔案或資料夾的檔案定位器。

已刪除項目

從 SharePoint 清單或文件庫中刪除的項目

名稱	路徑	類型	Description
ID	ID	integer	清單項目識別碼
名稱	Name	string	文件庫中項目的檔案名稱、清單中項目的顯示名稱
副檔名的檔案名稱	FileNameWithExtension	string	文件庫中具有項目副檔名的檔案名稱，與清單中項目的名稱相同
刪除者	DeletedByUserName	string	刪除此項目的使用者名稱
刪除的時間	TimeDeleted	date-time	刪除此項目的時間
是資料夾	IsFolder	boolean	true/false 值，指出項目是否為資料夾

已刪除項目清單

已刪除項目列表

名稱	路徑	類型	Description
value	value	array of DeletedItem	已刪除項目列表

發佈結果

SPO 連接器填充碼上 CheckIfFileIsPublished 端點的輸出物件

名稱	路徑	類型	Description
IsFile已發布	IsFilePublished	boolean	布林值 （true、false） ，指出檔案的排程版本是否已發佈

SetApprovalStatus輸出

SetApprovalStatus 輸出

名稱	路徑	類型	Description
Etag	ETag	string	設定核准狀態後項目的 ETag
審批連結	ApprovalLink	string	需要核准之項目的連結
發佈開始日期	PublishStartDate	string	項目將發佈的日期時間
內容核准狀態	ContentApprovalStatus	string	清單項目的內容核准狀態
排程版本	ScheduledVersion	string	已排程之項目版本

分享連結

共用連結的內部結構

名稱	路徑	類型	Description
分享連結	webUrl	string	項目的連結

SharingLink權限

共用連結的內部結構

名稱	路徑	類型	Description
連結	link	SharingLink	共用連結的內部結構

SPBlobMetadataResponse

SharePoint 版本的 BlobMetadataResponse 會藉由新增一些我們想要序列化的其他欄位來擴充物件

名稱	路徑	類型	Description
ItemId	ItemId	integer	可用來取得或更新文件庫中檔案屬性的值。
Id	Id	string	檔案或資料夾的唯一識別碼。
名稱	Name	string	檔案或資料夾的名稱。
顯示名稱	DisplayName	string	檔案或資料夾的顯示名稱。
路徑	Path	string	檔案或資料夾的路徑。
最後修改	LastModified	date-time	上次修改檔案或資料夾的日期和時間。
大小	Size	integer	檔案或資料夾的大小。
媒體類型	MediaType	string	檔案或資料夾的媒體類型。
Is資料夾	IsFolder	boolean	布林值 （true、false） ，指出 Blob 是否為資料夾。
Etag	ETag	string	檔案或資料夾的 etag。
檔案定位器	FileLocator	string	檔案或資料夾的檔案定位器。

SPListExpandedUser

SharePoint 展開的使用者欄位

名稱	路徑	類型	Description
Claims	Claims	string	使用者宣告
顯示名稱	DisplayName	string	使用者標題
Email	Email	string	使用者電子郵件
圖片	Picture	string	用戶圖片
部門	Department	string	用戶部門
職稱	JobTitle	string	使用者職稱
@odata.類型	@odata.type	string

SPListItemAttachment

SharePoint 清單項目附件

名稱	路徑	類型	Description
Id	Id	string	檔案識別碼
絕對Uri	AbsoluteUri	string	附件鏈接
顯示名稱	DisplayName	string	名稱

Table

代表一個表格。

名稱	路徑	類型	Description
名稱	Name	string	數據表的名稱。 該名稱在運行時使用。
顯示名稱	DisplayName	string	資料表的顯示名稱。
動態屬性	DynamicProperties	object	連接器提供給用戶端的其他資料表屬性。

表格清單

代表表格清單。

名稱	路徑	類型	Description
value	value	array of Table	表格列表

二進位

這是基本數據類型 『binary』。