Alert Relay (プレビュー)
Alert Relay は、廃止された SharePoint アラートをより充実した最新の通知に置き換えるのに役立ちます。 フィールド レベルの詳細な変更とすぐに使用できるアラート HTML が返されるため、一般的な変更された通知の代わりに変更された内容を正確に表示できます。
このコネクタは、次の製品とリージョンで使用できます。
| Service | クラス | Regions |
|---|---|---|
| コピロット スタジオ | Premium | 次を除くすべてのPower Automateリージョン: - 米国政府 (GCC) - 米国政府 (GCC High) - 21Vianet が運営する China Cloud - 米国国防総省 (DoD) |
| ロジック アプリ | Standard | 次を除くすべての Logic Apps リージョン : - Azure Government リージョン - 中国リージョンAzure - 米国国防総省 (DoD) |
| Power Apps | Premium | 次を除くすべてのPower Appsリージョン: - 米国政府 (GCC) - 米国政府 (GCC High) - 21Vianet が運営する China Cloud - 米国国防総省 (DoD) |
| Power Automate（パワーオートメート） | Premium | 次を除くすべてのPower Automateリージョン: - 米国政府 (GCC) - 米国政府 (GCC High) - 21Vianet が運営する China Cloud - 米国国防総省 (DoD) |
| 連絡先 | |
|---|---|
| Name | independNET のサポート |
| URL | https://independnet.com.au/alert-relay/support |
| support@alertbridge.com.au |
| コネクタ メタデータ | |
|---|---|
| 発行者 | independNET 製品 |
| ウェブサイト | https://independnet.com.au/alert-relay/ |
| プライバシー ポリシー | https://independnet.com.au/alert-relay/privacy |
| カテゴリ | コラボレーション;生産性 |
アラート リレー
Power Platform と Microsoft 365 Copilot 用アラート リレー
Alert Relay は、組織が従来のSharePointアラートを最新のPower AutomateおよびCopilot Studio ソリューションに置き換えるのに役立ちます。 SharePoint項目、ファイル、ページを以前のバージョンと比較し、構造化された変更情報、バージョン履歴、すぐに使用できる通知コンテンツを返します。複雑なSharePointバージョン比較ロジックを作成する必要はありません。
概要
SharePoint トリガーは、項目、ファイル、またはページが変更されたことを識別できますが、以前の値と現在の値を完全に比較することはできません。
多くの場合、この比較をビルドするには、作成者がバージョンの取得、変更トークンの解釈、通知またはダウンストリーム処理のフィールドと書式の結果の比較を行う必要があります。
Alert Relay は、Power AutomateとCopilot Studioの再利用可能なアクションを通じて動作することを一元化します。
主な機能
アラート リレーは、次のことが可能な再利用可能なアクションを通じて動作することを一元化します。
- フィールド レベルの詳細な変更を識別する
- 前のフィールド値と現在のフィールド値を返す
- SharePointアラート 電子メールにすぐに使用できる HTML を生成する
- アイテム、ファイル、ページのバージョン履歴を取得する
- トリガー トークンからの比較、変更トークン、バージョン ラベルまたは日付
- サポートされている複合SharePoint フィールド型の書式設定
- Power AutomateとMicrosoft 365 Copilotの構造化情報を返す
Alert Relay では、SharePointリスト、ドキュメント ライブラリ、サイト ページ ライブラリがサポートされます。
はじめに
一般的なSharePoint アラート フローには、次のものが含まれます。
- 項目が作成または変更されたときなど、SharePoint トリガー。
- アラート HTML としてアイテムやファイルの変更を取得するなどのアラート リレー アクション。
- 返された件名と HTML 本文を使用する電子メールまたは別の通知アクション。
条件、カスタム書式設定、またはMicrosoft Copilot Studio エージェントのシナリオでは、[アイテムまたはファイルの詳細な変更の取得] を使用し、返される構造化された変更情報を操作します。
履歴SharePointバージョンの場合は、[アイテムの取得] または [ファイルのバージョン履歴] を使用します。
Documentation
ドキュメント、アクション リファレンス情報、例、ファースト ステップ ガイダンスは、次のトピックで入手できます。
ビデオ チュートリアル
アラート リレー YouTube チャンネルでは、ステップ バイ ステップのチュートリアル、例、およびハウツー ビデオを利用できます。
ライセンスと試用版
Alert Relay のライセンスはテナント全体です。 1 つの試用版またはサブスクリプションがMicrosoft Entra テナント全体に適用され、その使用ユニットは、そのテナント内の Alert Relay フローとユーザーによって共有されます。
90 日間の試用版は、アラート リレー アクションがテナントで最初に実行されたときに自動的に開始され、試用版全体で共有される 300 の使用ユニットが含まれます。 現在のプランと詳細については、 Alert Relay の価格とライセンスに関するページを参照してください。
アクション
詳細なアイテムまたはファイルの変更を取得する
SharePointアイテム、ファイル、またはページの現在のバージョンと以前のバージョンとの間のフィールド レベルの詳細な変更を返します。
このアクションは、前の値と現在の値、書式設定された値、および比較メタデータを含む構造化された情報を返します。 フローまたはMicrosoft Copilot Studio エージェントが個々の変更を検査、要約、または対処する必要がある場合に使用します。
アイテムまたはファイルの変更をアラート HTML として取得する
SharePoint項目、ファイル、またはページで何が変更されたかを示す、すぐに使用できる HTML を生成します。
このアクションでは、推奨されるメールの件名、アイテムのタイトル、アイテムのリンクも返されます。 これを使用すると、すべてのフローで複雑な HTML およびバージョン比較式を作成することなく、より豊富なSharePointアラート メールを作成できます。
アイテムまたはファイルのバージョン履歴を取得する
SharePoint項目、ファイル、またはページの境界付きのページング可能なバージョン履歴を返します。
アクションは、選択したSharePointフィールドを返し、バージョン、日付、およびSharePointトリガー トークンの境界をサポートします。 履歴のレビュー、監査、レポート、承認、およびバージョン対応のワークフロー シナリオに使用します。
バージョン情報SharePoint解析する
トリガー ウィンドウと変更トークンの情報SharePointデコードします。
このアクションを使用して、トークンのタイムスタンプを取得し、日付またはバージョンベースの決定を適用し、詳細な変更アクションを呼び出す前に不要なマイナーまたはドラフト バージョンのトリガーをフィルター処理します。
一般的な用途
アラート リレーは、次の場合に役立ちます。
- クラシック SharePoint アラートをPower Automate フローに置き換える
- 変更内容を正確に示す書式設定された通知を送信する
- 重要なビジネス フィールドの以前と現在の値を比較する
- ドキュメント メタデータと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
接続を作成する
コネクタでは、次の認証の種類がサポートされています。
| デフォルト | 接続を作成するためのパラメーター。 | すべてのリージョン | 共有不可 |
デフォルト
適用対象: すべてのリージョン
接続を作成するためのパラメーター。
これは共有可能な接続ではありません。 電源アプリが別のユーザーと共有されている場合、別のユーザーは新しい接続を明示的に作成するように求められます。
調整制限
| 名前 | 呼び出し | 更新期間 |
|---|---|---|
| 接続ごとの API 呼び出し | 100 | 60 秒 |
アクション
| アイテムの詳細な変更を取得する |
SharePoint リスト アイテムまたはドキュメントの詳細な書式設定されたフィールド レベルの変更を取得し、現在のバージョンと以前のバージョンを比較します。 これは、組み込みの SharePoint スタイルの true/false フィールド フラグではなく、豊富な変更データが必要な場合に使用します。 |
| アイテムの詳細アラート HTML を取得する |
SharePoint アイテムの変更に対してすぐに使用できる Alert Relay HTML を返します。これは主に SharePoint スタイルのアラート メール用に設計されていますが、ドキュメントやその他の HTML 対応の宛先でも使用できます。 |
| 比較の解析 |
TriggerWindowStartToken または生の SharePoint 変更トークンをデコードし、フロー条件とベースラインの決定のための埋め込みタイムスタンプを返します。 このアクションは SharePoint を呼び出しません。 |
アイテムの詳細な変更を取得する
SharePoint リスト アイテムまたはドキュメントの詳細な書式設定されたフィールド レベルの変更を取得し、現在のバージョンと以前のバージョンを比較します。 これは、組み込みの SharePoint スタイルの true/false フィールド フラグではなく、豊富な変更データが必要な場合に使用します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
サイトの URL
|
siteUrl | True | string |
リストまたはライブラリを含む SharePoint サイトの完全な URL (たとえば、 |
|
リストまたはライブラリ
|
listId | True | string |
SHAREPoint リストまたはライブラリの GUID または正確なタイトル。 ドロップダウンは GUID 値を返しますが、手動入力では GUID または正確なリスト タイトルを使用できます。 |
|
アイテム ID
|
itemId | True | integer |
変更を分析する SharePoint アイテムまたはファイルの ID (トリガー出力から ID として使用できます)。 |
|
比較の結果
|
triggerWindowStartToken | string |
変更比較の開始点を定義します。 SharePoint トリガーの {TriggerWindowStartToken} (推奨)、'5.0' などのバージョン ラベル、未加工の SharePoint 変更トークン、または '2026-03-30' や '2026-03-30T14:15:00Z' などの ISO 8601 基準の日付/日時を受け入れます。 日付のみの値は、選択したタイムゾーンでは午前 0 時、タイムゾーンが空白の場合は 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 です。 |
返品
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
Success
|
success | boolean |
操作が正常に完了したかどうかを示します |
|
メッセージ
|
message | string |
結果を説明する人間が判読できるメッセージ |
|
変更されたフィールド
|
changedFields | array of object |
追跡対象のフィールドを配列として使用します。 |
|
列の値が変更されました
|
changedFields.hasChanged | boolean |
True の 場合、このフィールドの値は、前のバージョンと現在のバージョンの間で変更されました。 |
|
前の列の値 (テキスト)
|
changedFields.previousAsString | string |
前の値を人間が判読できる文字列として書式設定された |
|
フィールドの内部名
|
changedFields.internalName | string |
内部 SharePoint フィールド名 |
|
フィールド名
|
changedFields.displayName | string |
フィールドの表示名 |
|
前の列の値 (詳細)
|
changedFields.previous |
前の未加工の値。 このプロパティは動的であり、SharePoint フィールドの種類に応じて、文字列、数値、ブール値、オブジェクト、配列、または null を指定できます。 |
|
|
現在の列の値 (テキスト)
|
changedFields.currentAsString | string |
人間が判読できる文字列として書式設定された現在の値 |
|
現在の列の値 (詳細)
|
changedFields.current |
生の現在の値。 このプロパティは動的であり、SharePoint フィールドの種類に応じて、文字列、数値、ブール値、オブジェクト、配列、または null を指定できます。 |
|
|
比較基準を持つ
|
hasComparisonBaseline | boolean |
True の 場合は、現在のバージョンとの比較のために個別のベースライン バージョンが解決されました。 |
|
基準計画の最初のバージョン
|
isBaselineFirstVersion | boolean |
True の 場合、解決された基準バージョンは、アイテムまたはファイルに記録された最初のバージョンです。 |
|
現在のバージョン ラベル
|
currentVersionLabel | string |
現在のバージョンのバージョン ラベル (例: '2.0'、'5.0') |
|
以前のバージョンのラベル
|
previousVersionLabel | string |
比較に使用されるバージョン ラベル (例: '1.0'、'4.0') |
|
項目のタイトル
|
itemTitle | string |
変更されたアイテムのタイトル |
|
アイテムの URL
|
itemUrl | string |
変更された SharePoint アイテムへの直接リンク |
|
更新日
|
modifiedDate | date-time |
最新の変更のタイムスタンプ |
|
[変更者]
|
modifiedBy | string |
アイテムを最後に変更したユーザーの表示名 |
|
エラー
|
error | string |
成功が false の場合のエラーの詳細 |
アイテムの詳細アラート HTML を取得する
SharePoint アイテムの変更に対してすぐに使用できる Alert Relay HTML を返します。これは主に SharePoint スタイルのアラート メール用に設計されていますが、ドキュメントやその他の HTML 対応の宛先でも使用できます。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
サイトの URL
|
siteUrl | True | string |
リストまたはライブラリを含む SharePoint サイトの完全な URL。 |
|
リストまたはライブラリ
|
listId | True | string |
SHAREPoint リストまたはライブラリの GUID または正確なタイトル。 ドロップダウンは GUID 値を返しますが、手動入力では GUID または正確なリスト タイトルを使用できます。 |
|
アイテム ID
|
itemId | True | integer |
変更を分析する SharePoint アイテムまたはファイルの ID。 |
|
比較の結果
|
triggerWindowStartToken | string |
変更比較の開始点を定義します。 SharePoint トリガーの {TriggerWindowStartToken} (推奨)、'5.0' などのバージョン ラベル、未加工の SharePoint 変更トークン、または '2026-03-30' や '2026-03-30T14:15:00Z' などの ISO 8601 基準の日付/日時を受け入れます。 日付のみの値は、選択したタイムゾーンでは午前 0 時、タイムゾーンが空白の場合は 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')。 |
返品
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
Success
|
success | boolean |
操作が正常に完了したかどうかを示します |
|
メッセージ
|
message | string |
結果を説明する人間が判読できるメッセージ |
|
HTML 本文
|
htmlBody | string |
アラート メールやその他の HTML 対応の宛先で使用できる完全な HTML 本文 |
|
推奨される件名
|
subject | string |
アラートの推奨される件名行 |
|
項目のタイトル
|
itemTitle | string |
変更されたアイテムのタイトル |
|
アイテムの URL
|
itemUrl | string |
変更された SharePoint アイテムへの直接リンク |
|
新しい項目
|
isNewItem | boolean |
True の 場合、アラートは、既存のものへの更新ではなく、新しい SharePoint アイテムまたはファイルです。 |
|
エラー
|
error | string |
成功が false の場合のエラーの詳細 |
比較の解析
TriggerWindowStartToken または生の SharePoint 変更トークンをデコードし、フロー条件とベースラインの決定のための埋め込みタイムスタンプを返します。 このアクションは SharePoint を呼び出しません。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
比較の結果
|
compareFrom | True | string |
デコードする TriggerWindowStartToken または生の SharePoint 変更トークン。 バージョン ラベルと ISO 日付/日付/時刻値は、このアクションではサポートされていません。 |
|
Timezone
|
timezone | string |
ローカル比較値の IANA タイムゾーン ID (例: 'America/New_York'、'Europe/London'、'Australia/Sydney')。 省略すると、UTC 値のみが返されます。 |
返品
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
Success
|
success | boolean | |
|
メッセージ
|
message | string | |
|
トークン日時 (UTC)
|
tokenDateTimeUTC | date-time |
トークンのタイムスタンプ (UTC)。 |
|
トークンの日付と時刻 (ローカル)
|
tokenDateTimeLocal | date-time |
要求されたタイムゾーンに変換されたトークンタイムスタンプ。 |
|
デコードされたトークン
|
decodedToken | string |
デコードされた未加工のトークン テキスト。 未加工のトークン入力の場合、これは元の値と一致します。 |
|
Base64 トークンです
|
isBase64Token | boolean |
True の 場合、受信トークンが base64 でエンコードされました。 |
|
Sequence
|
sequence | integer |
トークンに埋め込まれている SharePoint の変更シーケンス値。 |
|
GUID の一覧表示
|
listGuid | uuid |
トークンに埋め込まれたリストまたはライブラリ GUID。 |
|
トークンのバージョン
|
tokenVersion | integer |
トークンのバージョン番号。 |
|
トークンの種類
|
tokenType | integer |
SharePoint トークンの種類番号。 |
|
エラー
|
error | string |
解析が失敗したときのエラーの詳細。 |