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 |
| カテゴリ | コラボレーション;生産性 |
アラート リレー
Alert Relay は、廃止された SharePoint アラートを、Microsoft 365 環境向けのより充実した最新の通知に置き換えるのに役立ちます。 書式設定されたフィールド レベルの比較やすぐに使用できる HTML アラート出力など、SharePoint アイテムとドキュメントの変更に関する詳細な情報が提供されます。
概要
Alert Relay は、既定の "アイテムが変更されました" エクスペリエンスよりも便利な SharePoint 通知を必要とする作成者向けに設計されています。
以下がサポートされています。
- 詳細なフィールドレベルの変更検査
- アラート メール用のすぐに使用できる HTML 出力
- ベースラインと初回実行時の決定に対するトークン解析をトリガーする
- SharePoint リスト
- ドキュメント ライブラリ
- サイト ページ/ページ ライブラリ
主な機能
1. 詳細な変更追跡
コネクタは、SharePoint アイテムまたはドキュメントの現在のバージョンを以前のバージョンと比較し、構造化された変更の詳細を返すことができます。
2. すぐに使用できる HTML アラートの出力
コネクタは、書式設定された HTML を生成できるため、複雑な HTML 式を手動で作成しなくても、フローで便利なアラート 電子メールを送信できます。
3. トリガー トークンの解析
Parse Compare From アクションは、TriggerWindowStartTokenなどの SharePoint 変更トークンをデコードし、フローでの意思決定のために埋め込まれたタイムスタンプとトークンの詳細を返します。
4. 動的ドロップダウン
コネクタには、次の動的ドロップダウン サポートが含まれています。
- sites
- リストとライブラリ
- 日付形式
- 時間形式
- タイムゾーン
5. 柔軟な比較基準
コネクタでは、次の比較がサポートされています。
- SharePoint トリガー トークン
- 生の SharePoint 変更トークン
- バージョン ラベル
- ISO 8601 日付/日時ベースライン
サポートされているアクション
詳細な変更を取得する
前と現在の書式設定された値を含む、変更されたフィールドを記述する構造化 JSON を返します。
アラート HTML として詳細な変更を取得する
すぐに使用できる HTML 出力と、電子メールまたはその他の HTML 対応の宛先の関連アラート メタデータを返します。
比較の解析
SharePoint トリガー/変更トークンをデコードし、埋め込まれたタイムスタンプとトークンの詳細を返します。
一般的なユース ケース
- リスト アイテムが変更されたときに、より適切な SharePoint アラート メールを送信する
- 重要なビジネス フィールドの前と現在の値を表示する
- ドキュメント ライブラリメタデータの変更を追跡する
- 承認、コンプライアンス、または監査通知フローを構築する
- 選択したベースラインに対してトリガー トークンの日付を評価して、ノイズの多い初回実行アラートを抑制する
Authentication
Alert Relay では、API サブスクリプション キーと共に Microsoft Entra ID 認証が使用されます。
コネクタを使用するには、ユーザーが次の操作を行う必要があります。
- 関連する SharePoint サイト、リスト、またはライブラリへのアクセス
- 有効なアラート リレー接続
- 有効な Alert Relay API サブスクリプション キー
テナントが最初に Alert Relay を使用すると、自動的に試用モードになります。 試用モードから移行するには、 support@alertbridge.com.auにお問い合わせください。
はじめに
一般的な検証フローでは、次を使用します。
- 次のような SharePoint トリガー
When an item is created or modified - アラート リレー アクション (例:
Get Detailed Changes as Alert HTML - 返された件名と HTML 出力を使用する電子メールまたは作成ステップ
構造化ダウンストリーム処理の場合は、 Get Detailed Changes を使用し、返された changedFields 配列を反復処理します。
既知の問題と制限事項
- SharePoint Online がサポートされています。オンプレミスの SharePoint Server はサポートされていません。
- SharePoint トリガーのタイミングは、アイテムごとのアラート履歴ではなく SharePoint トリガー ウィンドウがトリガー トークンに反映されるため、初回実行時の比較に影響を与える可能性があります。
Support
ウェブサイト：
プライバシー ポリシー:
サポート：
サポートメール:
- support@alertbridge.com.au
追加メモ
Alert Relay は、フローに必要なカスタム式の作業量 (特に HTML メールの書式設定やフィールド レベルの変更検査) を減らすことで、SharePoint ベースの通知シナリオの使いやすさを向上させることを目的としています。
接続を作成する
コネクタでは、次の認証の種類がサポートされています。
| デフォルト | 接続を作成するためのパラメーター。 | すべてのリージョン | 共有不可 |
デフォルト
適用対象: すべてのリージョン
接続を作成するためのパラメーター。
これは共有可能な接続ではありません。 電源アプリが別のユーザーと共有されている場合、別のユーザーは新しい接続を明示的に作成するように求められます。
調整制限
| 名前 | 呼び出し | 更新期間 |
|---|---|---|
| 接続ごとの 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 |
解析が失敗したときのエラーの詳細。 |