警報中繼（預覽）
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 |
| 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 YouTube 頻道提供逐步教學、範例與教學影片：
授權與審判
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 秒 |
動作
| 獲取詳細物品提醒 HTML |
回傳可用於 SharePoint 項目變更的 Alert Relay HTML，主要設計用於 SharePoint 類型的警示郵件，但也能用於文件或其他支援 HTML 的目的地。 |
| 獲取詳細的物品變更 |
擷取 SharePoint 清單項目或文件的詳細格式化欄位層級變更，並將當前版本與前一版本比較。 當你想要豐富的變更資料，而非內建的 SharePoint 風格真/假欄位旗標時，請使用此方法。 |
| 解析比較 |
解碼 TriggerWindowStartToken 或原始 SharePoint 變更令牌，並回傳嵌入的時間戳記以顯示流程狀況與基線決策。 此動作不會呼叫 SharePoint。 |
獲取詳細物品提醒 HTML
回傳可用於 SharePoint 項目變更的 Alert Relay HTML，主要設計用於 SharePoint 類型的警示郵件，但也能用於文件或其他支援 HTML 的目的地。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
網站 URL
|
siteUrl | True | string |
包含該清單或函式庫的完整 SharePoint 網站網址。 |
|
清單或文件庫
|
listId | True | string |
GUID 或 SharePoint 清單或函式庫的確切標題。 下拉選單會回傳 GUID 值，但手動輸入可以用 GUID 或精確的清單標題。 |
|
品項識別碼
|
itemId | True | integer |
用來分析變更的 SharePoint 項目或檔案的 ID。 |
|
比較來源
|
triggerWindowStartToken | string |
定義了變化比較的起點。 接受 SharePoint 觸發器的 {TriggerWindowStartToken}（建議）、版本標籤如「5.0」、原始 SharePoint 變更標記，或 ISO 8601 基準日期/日期時間，如「2026-03-30」或「2026-03-30T14：15：00Z」。 僅日期值在所選時區被解讀為午夜，若時區為空白則為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'）。 |
|
|
Timezone
|
timezone | string |
IANA時區ID用於日期/時間轉換（例如「America/New_York」、「Europe/London」、「Australia/Sydney」）。 |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
Success
|
success | boolean |
表示手術是否成功完成 |
|
Message
|
message | string |
描述結果的人類可讀訊息 |
|
HTML 正體
|
htmlBody | string |
完整的 HTML 正文，可用於警示郵件或其他支援 HTML 的目的地 |
|
建議主題
|
subject | string |
建議警示主旨 |
|
項目標題
|
itemTitle | string |
更改項目標題 |
|
項目網址
|
itemUrl | string |
直接連結到已更改的 SharePoint 項目 |
|
是新商品
|
isNewItem | boolean |
如果警報是針對新的 SharePoint 項目或檔案，而非現有的更新，那就成立。 |
|
錯誤
|
error | string |
如果成功為假，則有錯誤細節 |
獲取詳細的物品變更
擷取 SharePoint 清單項目或文件的詳細格式化欄位層級變更，並將當前版本與前一版本比較。 當你想要豐富的變更資料，而非內建的 SharePoint 風格真/假欄位旗標時，請使用此方法。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
網站 URL
|
siteUrl | True | string |
包含該清單或函式庫的 SharePoint 網站完整網址（例如 |
|
清單或文件庫
|
listId | True | string |
GUID 或 SharePoint 清單或函式庫的確切標題。 下拉選單會回傳 GUID 值，但手動輸入可以用 GUID 或精確的清單標題。 |
|
品項識別碼
|
itemId | True | integer |
SharePoint 項目或檔案的 ID（可從觸發輸出取得 ID）。 |
|
比較來源
|
triggerWindowStartToken | string |
定義了變化比較的起點。 接受 SharePoint 觸發器的 {TriggerWindowStartToken}（建議）、版本標籤如「5.0」、原始 SharePoint 變更標記，或 ISO 8601 基準日期/日期時間，如「2026-03-30」或「2026-03-30T14：15：00Z」。 僅日期值在所選時區被解讀為午夜，若時區為空白則為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 |
IANA時區ID用於日期/時間轉換（例如「America/New_York」、「Europe/London」、「Australia/Sydney」）。 如果未指定，則預設為UTC。 |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
Success
|
success | boolean |
表示手術是否成功完成 |
|
Message
|
message | string |
描述結果的人類可讀訊息 |
|
換過的領域
|
changedFields | array of object |
追蹤場以陣列形式呈現。 |
|
欄位值已變更
|
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 |
如果解析基線版本是該項目或檔案首次被記錄的版本，那就成立。 |
|
現行版本標籤
|
currentVersionLabel | string |
目前版本的版本標籤（例如，'2.0'， '5.0'） |
|
先前版本標籤
|
previousVersionLabel | string |
用於比較的版本標籤（例如「1.0」、「4.0」） |
|
項目標題
|
itemTitle | string |
更改項目標題 |
|
項目網址
|
itemUrl | string |
直接連結到已更改的 SharePoint 項目 |
|
修改日期
|
modifiedDate | date-time |
最新修改的時間戳記 |
|
修改者
|
modifiedBy | string |
最後修改該項目的使用者顯示名稱 |
|
錯誤
|
error | string |
如果成功為假，則有錯誤細節 |
解析比較
解碼 TriggerWindowStartToken 或原始 SharePoint 變更令牌，並回傳嵌入的時間戳記以顯示流程狀況與基線決策。 此動作不會呼叫 SharePoint。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
比較來源
|
compareFrom | True | string |
TriggerWindowStartToken 或原始 SharePoint 變更令牌來解碼。 此動作不支援版本標籤及 ISO 日期/日期-時間值。 |
|
Timezone
|
timezone | string |
可選地使用 IANA 時區 ID，作為當地比較值（例如「America/New_York」、「Europe/London」、「Australia/Sydney」）。 若省略，則僅回傳 UTC 值。 |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
Success
|
success | boolean | |
|
Message
|
message | string | |
|
代幣日期時間 UTC
|
tokenDateTimeUTC | date-time |
UTC 時間戳記。 |
|
代幣日期 時間 當地
|
tokenDateTimeLocal | date-time |
代幣時間戳記已轉換為所要求的時區。 |
|
解碼令牌
|
decodedToken | string |
解碼的原始代幣文字。 對於原始代幣輸入，這與原始值相符。 |
|
是 Base64 代幣
|
isBase64Token | boolean |
當輸入的代幣是 base64 編碼時，這點成立。 |
|
Sequence
|
sequence | integer |
SharePoint 變更序列值嵌入在 token 裡。 |
|
列表 GUID
|
listGuid | uuid |
清單或函式庫的 GUID 嵌入在標記中。 |
|
代幣版本
|
tokenVersion | integer |
代幣版本號。 |
|
記號類型
|
tokenType | integer |
SharePoint 令牌類型編號。 |
|
錯誤
|
error | string |
解析失敗時的錯誤細節。 |