警報中繼（預覽）
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 |
| 類別 | 通敵;生產力 |
警報中繼
Alert Relay 幫助以更豐富、現代化的通知取代即將停擺的 SharePoint 警報，適用於 Microsoft 365 環境。 它提供詳細的 SharePoint 項目與文件變更資訊，包括格式化的欄位層級比較及現成可用的 HTML 警示輸出。
Overview
Alert Relay 是為想要比預設「商品已修改」更實用的 SharePoint 通知的創作者設計的。
它支援：
- 詳細的現場變更檢查
- 現成型 HTML 輸出，用於警示郵件
- 觸發標記解析基線與首輪決策
- SharePoint 清單
- 文件庫
- 網站頁面 / 頁面庫
主要特徵
1. 詳細變更追蹤
連接器可以將 SharePoint 項目或文件的當前版本與較舊版本比較，並回傳結構化變更細節。
2. 即用HTML警示輸出
連接器能產生格式化的 HTML，讓流程能發送有用的警示郵件，無需手動建立複雜的 HTML 表達式。
3. 觸發標記解析
此 Parse Compare From 動作解碼 SharePoint 變更權杖（如 ）， TriggerWindowStartToken 並回傳嵌入的時間戳記與權杖細節，用於流程決策。
4. 動態下拉選單
連接器包含動態下拉選單支援：
- 網站
- 列表與圖書館
- 日期格式
- 時間格式
- 時區
5. 彈性比較基準
連接器支援以下比較：
- SharePoint 觸發令牌
- 原始 SharePoint 變更憑證
- 版本標籤
- ISO 8601 日期/日期-時間基準線
支援的動作
取得詳細變更
回傳結構化的 JSON 描述變更欄位，包括先前及目前格式值。
以提醒HTML形式獲得詳細變更
回傳可即時使用的 HTML 輸出及相關警示元資料，供電子郵件或其他支援 HTML 的目的地使用。
解析比較
解碼 SharePoint 觸發/變更令牌，並回傳嵌入的時間戳記和令牌細節。
典型用例
- 當清單項目變更時，發送更好的 SharePoint 警示郵件
- 顯示重要商業領域的過去與現行數值
- 追蹤文件庫的元資料變更
- 建置核准、合規或稽核通知流程
- 透過根據選定基準評估觸發令牌日期，抑制雜訊的首次執行警報
Authentication
Alert Relay 使用 Microsoft Entra ID 驗證與 API 訂閱金鑰。
使用連接器時，使用者需要：
- 存取相關的 SharePoint 網站、清單或函式庫
- 一個有效的警報中繼連線
- 有效的 Alert Relay API 訂閱金鑰
當租戶首次使用 Alert Relay 時，系統會自動進入試用模式。 若要退出試用模式，請聯絡 support@alertbridge.com.au。
使用者入門
典型的驗證流程會使用：
- 像是 SharePoint 觸發器
When an item is created or modified - 警報中繼動作，例如
Get Detailed Changes as Alert HTML - 使用 email 或 Compose 步驟，使用回傳的主旨與 HTML 輸出
對於結構化的下游處理，使用 Get Detailed Changes 並遍歷返回的 changedFields 陣列。
已知問題與限制
- 支援 SharePoint Online;本地不支援 SharePoint Server。
- SharePoint 觸發時間會影響首次執行的比較，因為觸發標記反映的是 SharePoint 觸發視窗，而非每個項目的警示歷史。
Support
網站：
隱私政策：
支援：
支援電子郵件：
- support@alertbridge.com.au
其他附注
Alert Relay 旨在透過減少流程中自訂表達式的工作量，特別是在 HTML 電子郵件格式化與現場層級變更檢查中，提升基於 SharePoint 通知情境的可用性。
正在建立連線
連接器支援下列驗證類型：
| 預設值 | 建立連線的參數。 | 所有地區 | 不可共享 |
預設
適用：所有地區
建立連線的參數。
這不是可共用的連線。 如果 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 |
解析失敗時的錯誤細節。 |