警報中繼（預覽）

Alert Relay 幫助以更豐富、現代化的通知取代逐漸停歇的 SharePoint 通知。它會回傳詳細的現場層級變更，以及現成可用的警示 HTML，讓你能精確顯示哪些變更，而非一般修改的通知。你也可以在流程決策和條件中使用變更和版本資訊。

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

服務	Class	Regions
副駕駛工作室	進階	除以下部分外，所有Power Automate區域： - 美國政府（GCC） - 美國政府（海灣合作委員會高中） - 由 21Vianet 營運的中國雲 - 美國國防部（DoD）
邏輯應用程式	標準	所有 Logic Apps 區域，但下列區域除外： - Azure Government regions - Azure中國地區 - 美國國防部（DoD）
Power Apps	進階	除以下部分外，所有Power Apps區域 - 美國政府（GCC） - 美國政府（海灣合作委員會高中） - 由 21Vianet 營運的中國雲 - 美國國防部（DoD）
Power Automate（自動化服務）	進階	除以下部分外，所有Power Automate區域： - 美國政府（GCC） - 美國政府（海灣合作委員會高中） - 由 21Vianet 營運的中國雲 - 美國國防部（DoD）

聯絡方式
Name	independNET 支援
URL	https://independnet.com.au/alert-relay/support
Email	support@alertbridge.com.au

連接器中繼資料
Publisher	independNET 軟體
網站	https://independnet.com.au/alert-relay/
隱私策略	https://independnet.com.au/alert-relay/privacy
類別	通敵;生產力

警報中繼

Power Platform 與 Microsoft 365 Copilot 的警報中繼

Alert Relay 幫助組織以現代化的 Power Automate 和 Copilot Studio 解決方案取代傳統的 SharePoint 警報。它能將 SharePoint 項目、檔案和頁面與早期版本比較，並回傳結構化變更資訊、版本歷史及現成可用的通知內容，無需製作者建立複雜的 SharePoint 版本比較邏輯。

Overview

SharePoint 觸發器可以識別項目、檔案或頁面的變更，但無法完整比較先前與目前的值。

建立這種比較通常需要製作者檢索版本、解讀變更標記、比較欄位並格式化結果以供通知或後續處理。

Alert Relay 透過可重複使用的動作集中管理 Power Automate 和 Copilot Studio 的工作。

主要特徵

Alert Relay 集中管理可重複使用的動作，可以：

識別詳細的現場層級變更
回傳先前及目前欄位值
產生可用於 SharePoint 警示郵件的即時 HTML
檢索項目、檔案及頁面版本歷史
比較觸發標記、變更標記、版本標籤或日期
格式支援複雜的 SharePoint 欄位類型
回傳 Power Automate 與 Microsoft 365 Copilot 的結構化資訊

Alert Relay 支援 SharePoint 清單、文件庫及網站頁面庫。

使用者入門

典型的 SharePoint 警示流程包括：

一個 SharePoint 觸發器，例如當項目被建立或修改時。
一個警示中繼動作，例如以 警示 HTML 格式取得項目或檔案變更。
電子郵件或其他通知動作，使用回傳的主旨和 HTML 正文。

對於條件、自訂格式或 Microsoft Copilot Studio 代理情境，請使用 Get Detailed Item 或 File Changes，並處理它回傳的結構化變更資訊。

對於歷史上的 SharePoint 版本，請使用「取得項目」或「檔案版本歷史」。

Documentation

文件、行動參考資訊、範例及入門指引可於以下網站取得：

Alert Relay 文件

影片教學課程

Alert Relay YouTube 頻道提供逐步教學、範例與教學影片：

YouTube 上的 Alert Relay

授權與審判

Alert Relay 授權是全租戶的。單一試用或訂閱會適用於整個 Microsoft Entra 租戶，其使用單元由 Alert Relay 流程及該租戶中的使用者共享。

90 天試用期自租戶首次執行 Alert Relay 動作時自動開始，包含 300 個共用的使用單元。有關最新方案及更多細節，請參閱 Alert Relay 價格與授權。

行動

取得詳細的項目或檔案變更

回傳 SharePoint 項目、檔案或頁面目前版本與早期版本之間的詳細欄位層級變更。

該動作回傳結構化資訊，包括先前與當前值、格式化值及比較元資料。當流程或 Microsoft Copilot Studio 代理需要檢查、摘要或對個別變更採取行動時，請使用此功能。

將項目或檔案變更作為提醒 HTML

產生現成可用的 HTML，顯示 SharePoint 項目、檔案或頁面的變更內容。

此動作同時會回傳建議的電子郵件主旨、物品名稱及物品連結。利用它來建立更豐富的 SharePoint 通知郵件，而不必在每個流程中建立複雜的 HTML 和版本比較表達式。

取得項目或檔案版本歷史

回傳 SharePoint 項目、檔案或頁面的有界且可分頁的版本歷史。

此動作可回傳選定的 SharePoint 欄位，並支援版本、日期及 SharePoint 觸發權杖邊界。它可用於歷史審查、稽核、報告、核准以及版本感知的工作流程場景。

解析 SharePoint 版本資訊

解碼 SharePoint 觸發視窗與變更權杖資訊。

使用此動作取得標記時間戳，套用日期或版本決策，並過濾不想要的次要或草稿版本觸發，然後再呼叫詳細變更動作。

典型用途

Alert Relay 能協助您：

用 Power Automate 流程取代傳統的 SharePoint 警示
發送格式化通知，清楚顯示具體變更內容
比較重要商業領域的過去與現行數值
追蹤文件元資料與 SharePoint 頁面的變更
檢索 SharePoint 項目及檔案版本歷史
建置審核、審查、治理與稽核工作流程
提供結構化的 SharePoint 變更資訊給 Microsoft 365 Copilot

驗證與存取

Alert Relay 採用 Microsoft Entra ID 委派認證。

SharePoint 存取是在已登入使用者的情境中進行的。 Alert Relay 不會授予使用者額外的 SharePoint 權限，因此使用者必須已經擁有相關的 SharePoint 網站、清單、函式庫、項目或檔案的存取權。

需求與支援範圍

Alert Relay 支援 SharePoint Online。本地不支援 SharePoint Server。
當 Power Automate 或其他支援的用戶端呼叫時，動作會執行。對於變更通知，請使用適當的 SharePoint 觸發器來啟動流程。
使用 SharePoint 觸發標記進行比較時，是根據 SharePoint 觸發視窗進行。所得基線可能與項目特定的版本邊界不同。
支援的 SharePoint 欄位類型提供詳細格式化。請參閱 Alert Relay 文件以獲取目前的欄位類型參考資料。

Support

網站： https://independnet.com.au/alert-relay/

支援： https://independnet.com.au/alert-relay/support

電子郵件：support@alertrelay.com.au

隱私政策： https://independnet.com.au/alert-relay/privacy

正在建立連線

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


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

預設

適用：所有地區

建立連線的參數。

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

節流限制

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

動作

取得詳細的項目或檔案變更	檢索 SharePoint list 項目或檔案的詳細格式化欄位層級變更，並將當前版本與先前版本進行比較。當你想要豐富的變更資料時，不只是內建的 SharePoint 真假變更指示器，就用這個。結果可能包含重要的 Alert Relay 試用、訂閱或使用者使用通知。
取得項目或檔案版本歷史	回傳 SharePoint list 項目或檔案的版本數，從最新開始。每個版本包含版本細節、欄位值、格式化文字值，以及顯示哪些欄位與前一版本變更的指示器。在設定此動作時選擇網站與列表或函式庫，使其欄位作為動態內容可用。結果可能包含重要的 Alert Relay 試用、訂閱或使用者使用通知。
將項目或檔案變更作為提醒 HTML	回傳可用於 SharePoint 項目變更的 Alert Relay HTML，主要用於提醒郵件，但也可在支援 HTML 的任何地方使用。結果可能包含重要的 Alert Relay 試用、訂閱或使用者使用通知。
解析 SharePoint 版本資訊	解碼 SharePoint 從 token 比較。當同時提供版本號和修改日期時，會判斷該項目或檔案是否為新版本。在呼叫 Alert Relay 計費行動前，請先在流程條件下使用此非計費動作。

取得詳細的項目或檔案變更

作業識別碼：: AlertBridgeGetDetailedChanges

檢索 SharePoint list 項目或檔案的詳細格式化欄位層級變更，並將當前版本與先前版本進行比較。當你想要豐富的變更資料時，不只是內建的 SharePoint 真假變更指示器，就用這個。結果可能包含重要的 Alert Relay 試用、訂閱或使用者使用通知。

參數

名稱	機碼	必要	類型	Description
網站 URL	siteUrl	True	string	選擇 SharePoint 網站或輸入網站網址。
清單或文件庫	listId	True	string	選擇清單或函式庫，或輸入其標題或 GUID。
品項識別碼	itemId	True	integer	用來分析變更的 SharePoint 項目或檔案的 ID。
比較來源	triggerWindowStartToken		string	比較的起點。如果有的話，請使用 SharePoint 觸發器的 TriggerWindowStartToken。你也可以輸入版本標籤、原始變更代幣或基準日期/時間。僅日期值則使用所選時區的午夜，若未選擇時區則使用UTC時間。留空以便與先前版本比較。
包括次要版本	includeMinorVersions		boolean	比較變更時，是否包含小版本或草稿版本。預設為 false，因此只比較主要版本。
包含未更改欄位	includeUnchangedFields		boolean	是否應將未更改欄位納入回應中。預設設置為 true。
日期格式	dateFormat		string	用於DateTime欄位的格式（例如，'yyyy-MM-dd'、'dd/MM/yyyy'、'MM/dd/yyyy'）。預設是「yyyy-mm-dd」。
時間格式	timeFormat		string	DateTime 欄位中時間部分的格式（例如 HH：mm：ss、HH：mm、hh：mm tt）。預設為 HH：mm：ss。
Timezone	timezone		string	用於格式化日期和時間時區（例如美國/New_York、歐洲/倫敦、澳洲/雪梨）。預設為 UTC。

傳回

名稱	路徑	類型	Description
Success	success	boolean	當行動成功完成時，這是正確的;當驗證或處理失敗時，為假。
Message	message	string	面向使用者的訊息，描述操作的結果。當訊息包含試用、訂閱、使用、警告或版本處理資訊時，代理與副駕駛應向使用者顯示此訊息。
顯示用戶通知	shouldDisplayUserNotice	boolean	顯示 Alert Relay 是否回覆了重要的試用、訂閱或使用通知。
使用者通知代碼	userNoticeCode	string	穩定且機器可讀的理由讓使用者注意到。
使用者注意事項嚴重程度	userNoticeSeverity	string	使用者通知的呈現嚴重性：資訊、警告或關鍵。
使用者通知	userNotice	string	關於 Alert Relay 試用、訂閱或使用的重要資訊。
使用者通知行動呼籲	userNoticeCallToAction	string	使用者接下來可以做什麼，包括 Alert Relay 網站和客服電子郵件。
換過的領域	changedFields	array of object	比較過的 SharePoint 欄位清單，包括每個欄位的名稱、先前的值、目前值，以及是否更改。
欄位值已變更	changedFields.hasChanged	boolean	如果該欄位的值在前一個版本和現在版本之間有變動，則為真
上一欄值（文字）	changedFields.previousAsString	string	將先前的值格式化為人類可讀字串
田內名稱	changedFields.internalName	string	內部 SharePoint 欄位名稱
欄位名稱	changedFields.displayName	string	場地的友好展示名稱
前一欄數值（詳細）	changedFields.previous		原始的先前價值。此屬性是動態的，依 SharePoint 欄位類型不同，可能是字串、數字、布林值、物件、陣列或空值。
目前欄位值（文字）	changedFields.currentAsString	string	格式化為人類可讀字串的當前值
目前欄位值（詳細）	changedFields.current		原始的當前值。此屬性是動態的，依 SharePoint 欄位類型不同，可能是字串、數字、布林值、物件、陣列或空值。
有比較基準	hasComparisonBaseline	boolean	如果是針對明確的基線版本進行比較，這是正確的。
這是第一版的基礎	isBaselineFirstVersion	boolean	如果解析基線版本是該項目或檔案首次被記錄的版本，那就成立。
是新商品	isNewItem	boolean	當該項目或檔案在解析比較視窗中應被視為新資料，而非更新時，這點是正確的。
現行版本標籤	currentVersionLabel	string	目前版本的版本標籤（例如，'2.0'， '5.0'）
先前版本標籤	previousVersionLabel	string	用於比較的版本標籤（例如「1.0」、「4.0」）
項目或檔案名稱	itemTitle	string	變更項目或檔案的標題或檔名。
項目或檔案網址	itemUrl	string	直接連結到已更改的 SharePoint 項目或檔案。
修改日期	modifiedDate	date-time	最新修改的日期和時間。
修改者	modifiedBy	string	最後修改該項目的使用者顯示名稱
錯誤	error	string	如果成功為假，則有錯誤細節

取得項目或檔案版本歷史

作業識別碼：: GetItemOrFileVersionHistory

回傳 SharePoint list 項目或檔案的版本數，從最新開始。每個版本包含版本細節、欄位值、格式化文字值，以及顯示哪些欄位與前一版本變更的指示器。在設定此動作時選擇網站與列表或函式庫，使其欄位作為動態內容可用。結果可能包含重要的 Alert Relay 試用、訂閱或使用者使用通知。

參數

名稱	機碼	必要	類型	Description
網站 URL	siteUrl	True	string	選擇 SharePoint 網站或輸入網站網址。
清單或文件庫	listId	True	string	選擇該列表或函式庫，其版本欄位應該在流程中作為動態內容可用。
品項識別碼	itemId	True	integer	SharePoint list 項目 ID。這可以在執行時動態提供，例如從 SharePoint 觸發器或早期的流程動作中提供。
最大使用單位	maximumUsageUnits	True	integer	必須由來電者選擇使用單位上限，該通話可佔用的單位。預設值為 1。這是計費守護，而非版本數量限制;一個使用單元可以回傳多個完整版本。使用最大版本來限制版本列的數量。
最大版本	maximumVersions		integer	所有頁面中回傳的完整版本行數上限。請留空，直到所選範圍、可用歷史或使用單位預算結束為止。每個回應不超過100個版本。
待歸田	fieldsToReturn		array of string	每個版本中要包含的 SharePoint 欄位。每一項新增一欄。將欄位留空以返回所有支援欄位。選擇較少欄位可減少響應規模與使用單位工作量。
比較來源	fromVersion		string	版本歷史範圍的起點。如果有的話，請使用 SharePoint 觸發器的 TriggerWindowStartToken。你也可以輸入版本標籤、原始變更代幣或基準日期/時間。僅日期值則使用所選時區的午夜，若未選擇時區則使用UTC時間。不要留空，不要為舊的界線留白。
比較	toVersion		string	版本歷史範圍的結束點。如果有的話，請使用 SharePoint 觸發器的 TriggerWindowEndToken。你也可以輸入版本標籤、原始變更代幣或日期/時間。僅日期值則使用所選時區的午夜，若未選擇時區則使用UTC時間。不要留空，不要有新的界線。
分頁令牌	continuationToken		string	若先前呼叫回傳版本歷史下一頁，則用 Token 來檢索下一頁版本歷史。
包括次要版本	includeMinorVersions		boolean	在取得版本歷史時，是否應該包含次要版本或草稿版本。預設為 false，因此只會回傳主要版本。
日期格式	dateFormat		string	用於DateTime欄位的格式（例如，'yyyy-MM-dd'、'dd/MM/yyyy'、'MM/dd/yyyy'）。預設是「yyyy-mm-dd」。
時間格式	timeFormat		string	DateTime 欄位中時間部分的格式（例如 HH：mm：ss、HH：mm、hh：mm tt）。預設為 HH：mm：ss。
Timezone	timezone		string	用於格式化日期和時間時區（例如美國/New_York、歐洲/倫敦、澳洲/雪梨）。預設為 UTC。

傳回

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

將項目或檔案變更作為提醒 HTML

作業識別碼：: AlertBridgeGetDetailedChangesAsAlertHtml

回傳可用於 SharePoint 項目變更的 Alert Relay HTML，主要用於提醒郵件，但也可在支援 HTML 的任何地方使用。結果可能包含重要的 Alert Relay 試用、訂閱或使用者使用通知。

參數

名稱	機碼	必要	類型	Description
網站 URL	siteUrl	True	string	選擇 SharePoint 網站或輸入網站網址。
清單或文件庫	listId	True	string	選擇清單或函式庫，或輸入其標題或 GUID。
品項識別碼	itemId	True	integer	用來分析變更的 SharePoint 項目或檔案的 ID。
比較來源	triggerWindowStartToken		string	比較的起點。如果有的話，請使用 SharePoint 觸發器的 TriggerWindowStartToken。你也可以輸入版本標籤、原始變更代幣或基準日期/時間。僅日期值則使用所選時區的午夜，若未選擇時區則使用UTC時間。留空以便與先前版本比較。
包括次要版本	includeMinorVersions		boolean	比較變更時，是否包含小版本或草稿版本。預設為 false，因此只比較主要版本。
包含未更改欄位	includeUnchangedFields		boolean	是否應該包含未更改欄位在產生的 HTML 中。預設設置為 true。
日期格式	dateFormat		string	DateTime 欄位的格式（例如 'yyyy-MM-dd'， 'dd/MM/yyyy'）。預設是「yyyy-mm-dd」。
時間格式	timeFormat		string	DateTime 欄位中時間部分的格式（例如 HH：mm：ss、HH：mm、hh：mm tt）。預設為 HH：mm：ss。
Timezone	timezone		string	用於格式化日期和時間時區（例如美國/New_York、歐洲/倫敦、澳洲/雪梨）。預設為 UTC。

傳回

名稱	路徑	類型	Description
Success	success	boolean	當行動成功完成時，這是正確的;當驗證或處理失敗時，為假。
Message	message	string	面向使用者的訊息，描述操作的結果。當訊息包含試用、訂閱、使用、警告或版本處理資訊時，代理與副駕駛應向使用者顯示此訊息。
顯示用戶通知	shouldDisplayUserNotice	boolean	顯示 Alert Relay 是否回覆了重要的試用、訂閱或使用通知。
使用者通知代碼	userNoticeCode	string	穩定且機器可讀的理由讓使用者注意到。
使用者注意事項嚴重程度	userNoticeSeverity	string	使用者通知的呈現嚴重性：資訊、警告或關鍵。
使用者通知	userNotice	string	關於 Alert Relay 試用、訂閱或使用的重要資訊。
使用者通知行動呼籲	userNoticeCallToAction	string	使用者接下來可以做什麼，包括 Alert Relay 網站和客服電子郵件。
HTML 正體	htmlBody	string	提醒訊息的 HTML 正文，隨時可用於電子郵件或任何支援 HTML 的地方。
產生警報主體	subject	string	建議警示主旨
項目或檔案名稱	itemTitle	string	變更項目或檔案的標題或檔名。
項目或檔案網址	itemUrl	string	直接連結到已更改的 SharePoint 項目或檔案。
是新商品	isNewItem	boolean	判斷所產生的警示是否描述該項目或檔案為新增或變更。
錯誤	error	string	如果成功為假，則有錯誤細節

解析 SharePoint 版本資訊

作業識別碼：: AlertBridgeParseCompareFrom

解碼 SharePoint 從 token 比較。當同時提供版本號和修改日期時，會判斷該項目或檔案是否為新版本。在呼叫 Alert Relay 計費行動前，請先在流程條件下使用此非計費動作。

參數

名稱	機碼	必要	類型	Description
比較來源	compareFrom	True	string	TriggerWindowStartToken 或原始 SharePoint 變更令牌來解碼。此動作不支援版本標籤及 ISO 日期/日期-時間值。
版本號碼	versionNumber		string	來自 SharePoint 觸發器或動作的版本號，例如 0.1、1.0 或 1.5。用來辨識次要/草稿版本。
修改日期	modifiedDate		date-time	修改日期來自 SharePoint 觸發或動作。用來偵測觸發視窗中可見的 SharePoint 版本是否改變。
包括次要版本	includeMinorVersions		boolean	次要/草稿版本號是否應該算作新版本。預設為 False。
Timezone	timezone		string	可選的時區用於當地比較值，例如「America/New_York」、「Europe/London」或「Australia/Sydney」（IANA 時區 ID）。若省略，則僅回傳 UTC 值。

傳回

名稱	路徑	類型	Description
Success	success	boolean	當版本資訊被成功解析時，這是正確的;當驗證或處理失敗時，為假。
Message	message	string	面向使用者的訊息，描述操作的結果。當訊息包含試用、訂閱、使用、警告或版本處理資訊時，代理與副駕駛應向使用者顯示此訊息。
代幣日期時間 UTC	tokenDateTimeUTC	date-time	來自 Compare From 標記的日期與時間，UTC 時間回傳。
代幣日期時間當地	tokenDateTimeLocal	date-time	從 Compare From 代幣中取得日期與時間，轉換為所選時區。
解碼令牌	decodedToken	string	解碼後的原始 SharePoint 變更令牌。如果 Compare From 已經是原始代幣，這會與提供的價值相符。
是 Base64 代幣	isBase64Token	boolean	當輸入的代幣是 base64 編碼時，這點成立。
Sequence	sequence	integer	SharePoint 變更序列值嵌入在 token 裡。
列表 GUID	listGuid	uuid	清單或函式庫的 GUID 嵌入在標記中。
代幣版本	tokenVersion	integer	代幣版本號。
記號類型	tokenType	integer	SharePoint 令牌類型編號。
偵測到新版本了嗎	isNewVersionDetected	boolean	當所提供的觸發/動作元資料顯示應該處理新的可見 SharePoint 版本時，這是正確的。錯誤，該版本應該跳過。當元資料不足以判定時，則為 null。
是小調版本	isMinorVersion	boolean	當提供的版本號是次要版本或草稿版本時，這點是正確的。當未提供版本號時，為空。
是第一小版本	isFirstMinorVersion	boolean	當提供的版本號是第一個次要/草稿版本，通常是 0.1 版本時，這點成立。當未提供版本號時，為空。
是第一個主要版本	isFirstMajorVersion	boolean	當所提供的版本號是第一個主要/已發佈版本（通常是 1.0）時，這點成立。當未提供版本號時，為空。
修改日期 UTC	modifiedDateUtc	date-time	提供的修改日期已標準化為UTC。當未提供修改日期時，該日期為空。
修改日期當地	modifiedDateLocal	date-time	所提供的修改日期已轉換為所選時區。當未提供修改日期或時區時，則為空。
錯誤	error	string	如果成功為假，請提供錯誤細節。