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 Software |
| ウェブサイト | 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
接続を作成する
コネクタでは、次の認証の種類がサポートされています。
| デフォルト | 接続を作成するためのパラメーター。 | すべてのリージョン | 共有不可 |
デフォルト
適用対象: すべてのリージョン
接続を作成するためのパラメーター。
これは共有可能な接続ではありません。 電源アプリが別のユーザーと共有されている場合、別のユーザーは新しい接続を明示的に作成するように求められます。
調整制限
| Name | 呼び出し | 更新期間 |
|---|---|---|
| 接続ごとの API 呼び出し | 100 | 60 秒 |
アクション
| アイテムまたはファイルのバージョン履歴を取得する |
SharePoint listアイテムまたはファイルに対して要求されたバージョンの数までを返します。最新のバージョンが最初に返されます。 各バージョンには、バージョンの詳細、列の値、書式設定されたテキスト値、および前の使用可能なバージョンから変更された列を示すインジケーターが含まれています。 このアクションを構成するときに、サイトとリストまたはライブラリを選択して、列を動的コンテンツとして使用できるようにします。 結果には、ユーザーの重要な Alert Relay 試用版、サブスクリプション、または使用状況に関する通知が含まれる場合があります。 |
| アイテムまたはファイルの変更をアラート HTML として取得する |
SharePoint項目の変更に対してすぐに使用できる Alert Relay HTML を返します。主にアラート メール用に設計されていますが、HTML がサポートされている任意の場所でも使用できます。 結果には、ユーザーの重要な Alert Relay 試用版、サブスクリプション、または使用状況に関する通知が含まれる場合があります。 |
|
バージョン情報Share |
SharePoint比較トークンをデコードします。 バージョン番号と変更日も指定されると、項目またはファイルが新しいバージョンであるかどうかを判断します。 アラート リレーの課金対象アクションを呼び出す前に、フロー条件でこの課金対象ではないアクションを使用します。 |
| 詳細なアイテムまたはファイルの変更を取得する |
現在のバージョンと以前のバージョンを比較して、SharePoint list項目またはファイルの詳細な書式設定されたフィールド レベルの変更を取得します。 これは、組み込みのSharePoint true/false 変更インジケーターだけでなく、豊富な変更データが必要な場合に使用します。 結果には、ユーザーの重要な Alert Relay 試用版、サブスクリプション、または使用状況に関する通知が含まれる場合があります。 |
アイテムまたはファイルのバージョン履歴を取得する
SharePoint listアイテムまたはファイルに対して要求されたバージョンの数までを返します。最新のバージョンが最初に返されます。 各バージョンには、バージョンの詳細、列の値、書式設定されたテキスト値、および前の使用可能なバージョンから変更された列を示すインジケーターが含まれています。 このアクションを構成するときに、サイトとリストまたはライブラリを選択して、列を動的コンテンツとして使用できるようにします。 結果には、ユーザーの重要な Alert Relay 試用版、サブスクリプション、または使用状況に関する通知が含まれる場合があります。
パラメーター
| Name | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
サイトの URL
|
siteUrl | True | string |
SharePoint サイトを選択するか、サイトの URL を入力します。 |
|
リストまたはライブラリ
|
listId | True | string |
フローで動的コンテンツとしてバージョン列を使用できるようにするリストまたはライブラリを選択します。 |
|
アイテム ID
|
itemId | True | integer |
アイテム ID をSharePoint listします。 これは、SharePoint トリガーや以前のフロー アクションなど、実行時に動的に指定できます。 |
|
最大使用ユニット数
|
maximumUsageUnits | True | integer |
この呼び出しで使用される可能性がある使用単位に対して、呼び出し元が選択した必要な制限。 既定値は 1 です。 これは、バージョン数の制限ではなく、課金ガードです。1 つの使用単位は、複数の完全なバージョンを返すことができます。 [最大バージョン] を使用して、バージョン行の数を制限します。 |
|
最大バージョン
|
maximumVersions | integer |
すべてのページで返される完全なバージョン行の最大数。 選択した範囲、使用可能な履歴、または使用量単位の予算が終了するまで続行するには、空白のままにします。 各応答に含まれるバージョンは 100 個以下です。 |
|
|
返すフィールド
|
fieldsToReturn | array of string |
各バージョンに含める列をSharePointします。 項目ごとに 1 つの列を追加します。 サポートされているすべての列を返すには、[フィールド] を [戻る] を空のままにします。 列を少なく選択すると、応答サイズと使用量単位の作業が減る可能性があります。 |
|
|
比較の結果
|
fromVersion | string |
バージョン履歴範囲の開始点。 使用可能な場合は、SharePoint トリガーの TriggerWindowStartToken を使用します。 バージョン ラベル、未加工の変更トークン、またはベースラインの日付/時刻を入力することもできます。 日付のみの値は、選択したタイムゾーンで午前 0 時を使用し、タイムゾーンが選択されていない場合は UTC を使用します。 古い境界がない場合は空白のままにします。 |
|
|
比較する
|
toVersion | string |
バージョン履歴範囲の終了ポイント。 使用可能な場合は、SharePoint トリガーの TriggerWindowEndToken を使用します。 バージョン ラベル、未加工の変更トークン、日付/時刻を入力することもできます。 日付のみの値は、選択したタイムゾーンで午前 0 時を使用し、タイムゾーンが選択されていない場合は UTC を使用します。 新しい境界がない場合は空白のままにします。 |
|
|
ページング トークン
|
continuationToken | string |
以前の呼び出しによって返されたバージョン履歴の次のページを取得するために使用されるトークン。 |
|
|
マイナー バージョンを含める
|
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 として取得する
SharePoint項目の変更に対してすぐに使用できる Alert Relay HTML を返します。主にアラート メール用に設計されていますが、HTML がサポートされている任意の場所でも使用できます。 結果には、ユーザーの重要な Alert Relay 試用版、サブスクリプション、または使用状況に関する通知が含まれる場合があります。
パラメーター
| Name | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
サイトの URL
|
siteUrl | True | string |
SharePoint サイトを選択するか、サイトの URL を入力します。 |
|
リストまたはライブラリ
|
listId | True | string |
リストまたはライブラリを選択するか、タイトルまたは GUID を入力します。 |
|
アイテム ID
|
itemId | True | integer |
変更を分析する SharePoint アイテムまたはファイルの ID。 |
|
比較の結果
|
triggerWindowStartToken | string |
比較の開始点。 使用可能な場合は、SharePoint トリガーの TriggerWindowStartToken を使用します。 バージョン ラベル、未加工の変更トークン、またはベースラインの日付/時刻を入力することもできます。 日付のみの値は、選択したタイムゾーンで午前 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 など)。 既定値は HH:mm:ss です。 |
|
|
Timezone
|
timezone | string |
日付と時刻を書式設定するときに使用されるタイムゾーン (たとえば、アメリカ/New_York、ヨーロッパ/ロンドン、オーストラリア/シドニー)。 既定値は UTC です。 |
返品
| Name | パス | 型 | 説明 |
|---|---|---|---|
|
Success
|
success | boolean |
True アクションが正常に完了したとき。検証または処理に失敗した場合は false。 |
|
メッセージ
|
message | string |
操作の結果を説明するユーザー向けのメッセージ。 エージェントと副操縦士は、試用版、サブスクリプション、使用状況、警告、またはバージョン処理の情報が含まれている場合に、このメッセージをユーザーに表示する必要があります。 |
|
ユーザー通知の表示
|
shouldDisplayUserNotice | boolean |
Alert Relay がユーザーの重要な試用版、サブスクリプション、または使用状況に関する通知を返したかどうかを示します。 |
|
ユーザー通知コード
|
userNoticeCode | string |
ユーザーが通知する安定したマシン読み取り可能な理由。 |
|
ユーザー通知の重大度
|
userNoticeSeverity | string |
ユーザー通知のプレゼンテーションの重大度: 情報、警告、または重大。 |
|
ユーザーに関する通知
|
userNotice | string |
Alert Relay の試用版、サブスクリプション、または使用状況に関する重要な情報。 |
|
ユーザー通知のアクションの呼び出し
|
userNoticeCallToAction | string |
Alert Relay Web サイトやサポート メールなど、ユーザーが次にできること。 |
|
HTML 本文
|
htmlBody | string |
電子メールまたは任意の場所で使用できるアラート メッセージの HTML 本文がサポートされています。 |
|
生成されたアラートの件名
|
subject | string |
アラートの推奨される件名行 |
|
アイテムまたはファイル名
|
itemTitle | string |
変更されたアイテムまたはファイルのタイトルまたはファイル名。 |
|
アイテムまたはファイルの URL
|
itemUrl | string |
変更されたSharePoint項目またはファイルへの直接リンク。 |
|
新しい項目
|
isNewItem | boolean |
生成されたアラートが項目またはファイルを追加または変更済みとして記述するかどうかを決定します。 |
|
エラー
|
error | string |
成功が false の場合のエラーの詳細 |
バージョン情報SharePoint解析する
SharePoint比較トークンをデコードします。 バージョン番号と変更日も指定されると、項目またはファイルが新しいバージョンであるかどうかを判断します。 アラート リレーの課金対象アクションを呼び出す前に、フロー条件でこの課金対象ではないアクションを使用します。
パラメーター
| Name | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
比較の結果
|
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 値のみが返されます。 |
返品
| Name | パス | 型 | 説明 |
|---|---|---|---|
|
Success
|
success | boolean |
バージョン情報が正常に解析された場合は True。検証または処理に失敗した場合は false。 |
|
メッセージ
|
message | string |
操作の結果を説明するユーザー向けのメッセージ。 エージェントと副操縦士は、試用版、サブスクリプション、使用状況、警告、またはバージョン処理の情報が含まれている場合に、このメッセージをユーザーに表示する必要があります。 |
|
トークン日時 (UTC)
|
tokenDateTimeUTC | date-time |
Compare From トークンからの日付と時刻 (UTC で返されます)。 |
|
トークンの日付と時刻 (ローカル)
|
tokenDateTimeLocal | date-time |
Compare From トークンの日付と時刻。選択したタイムゾーンに変換されます。 |
|
デコードされたトークン
|
decodedToken | string |
デコード後の未加工SharePoint変更トークン。 Compare From が既に生のトークンであった場合、これは指定された値と一致します。 |
|
Base64 トークンです
|
isBase64Token | boolean |
True の 場合、受信トークンが base64 でエンコードされました。 |
|
Sequence
|
sequence | integer |
トークンに埋め込まれている SharePoint の変更シーケンス値。 |
|
GUID の一覧表示
|
listGuid | uuid |
トークンに埋め込まれたリストまたはライブラリ GUID。 |
|
トークンのバージョン
|
tokenVersion | integer |
トークンのバージョン番号。 |
|
トークンの種類
|
tokenType | integer |
SharePoint トークンの種類番号。 |
|
新しいバージョンが検出されましたか
|
isNewVersionDetected | boolean |
True の 場合は、指定されたトリガー/アクションのメタデータが表示される新しいSharePointバージョンを処理する必要があります。 False バージョンをスキップする必要がある場合。 判断するのに十分なメタデータがない場合は Null。 |
|
マイナー バージョン
|
isMinorVersion | boolean |
指定されたバージョン番号がマイナー/ドラフト バージョンの場合は True。 バージョン番号が指定されていない場合は Null。 |
|
最初のマイナー バージョン
|
isFirstMinorVersion | boolean |
指定されたバージョン番号が最初のマイナー/ドラフト バージョン (通常は 0.1) の場合は True。 バージョン番号が指定されていない場合は Null。 |
|
最初のメジャー バージョン
|
isFirstMajorVersion | boolean |
指定されたバージョン番号が最初のメジャー/公開バージョン (通常は 1.0) の場合は True。 バージョン番号が指定されていない場合は Null。 |
|
更新日 (UTC)
|
modifiedDateUtc | date-time |
UTC に正規化された、指定された変更日。 変更日が指定されていない場合は Null。 |
|
変更日ローカル
|
modifiedDateLocal | date-time |
指定された変更日が、選択したタイムゾーンに変換されます。 変更日またはタイムゾーンが指定されていない場合は Null。 |
|
エラー
|
error | string |
成功が false の場合のエラーの詳細。 |
詳細なアイテムまたはファイルの変更を取得する
現在のバージョンと以前のバージョンを比較して、SharePoint list項目またはファイルの詳細な書式設定されたフィールド レベルの変更を取得します。 これは、組み込みのSharePoint true/false 変更インジケーターだけでなく、豊富な変更データが必要な場合に使用します。 結果には、ユーザーの重要な Alert Relay 試用版、サブスクリプション、または使用状況に関する通知が含まれる場合があります。
パラメーター
| Name | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
サイトの URL
|
siteUrl | True | string |
SharePoint サイトを選択するか、サイトの URL を入力します。 |
|
リストまたはライブラリ
|
listId | True | string |
リストまたはライブラリを選択するか、タイトルまたは GUID を入力します。 |
|
アイテム ID
|
itemId | True | integer |
変更を分析する SharePoint アイテムまたはファイルの ID。 |
|
比較の結果
|
triggerWindowStartToken | string |
比較の開始点。 使用可能な場合は、SharePoint トリガーの TriggerWindowStartToken を使用します。 バージョン ラベル、未加工の変更トークン、またはベースラインの日付/時刻を入力することもできます。 日付のみの値は、選択したタイムゾーンで午前 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 |
日付と時刻を書式設定するときに使用されるタイムゾーン (たとえば、アメリカ/New_York、ヨーロッパ/ロンドン、オーストラリア/シドニー)。 既定値は UTC です。 |
返品
| Name | パス | 型 | 説明 |
|---|---|---|---|
|
Success
|
success | boolean |
True アクションが正常に完了したとき。検証または処理に失敗した場合は false。 |
|
メッセージ
|
message | string |
操作の結果を説明するユーザー向けのメッセージ。 エージェントと副操縦士は、試用版、サブスクリプション、使用状況、警告、またはバージョン処理の情報が含まれている場合に、このメッセージをユーザーに表示する必要があります。 |
|
ユーザー通知の表示
|
shouldDisplayUserNotice | boolean |
Alert Relay がユーザーの重要な試用版、サブスクリプション、または使用状況に関する通知を返したかどうかを示します。 |
|
ユーザー通知コード
|
userNoticeCode | string |
ユーザーが通知する安定したマシン読み取り可能な理由。 |
|
ユーザー通知の重大度
|
userNoticeSeverity | string |
ユーザー通知のプレゼンテーションの重大度: 情報、警告、または重大。 |
|
ユーザーに関する通知
|
userNotice | string |
Alert Relay の試用版、サブスクリプション、または使用状況に関する重要な情報。 |
|
ユーザー通知のアクションの呼び出し
|
userNoticeCallToAction | string |
Alert Relay Web サイトやサポート メールなど、ユーザーが次にできること。 |
|
変更されたフィールド
|
changedFields | array of object |
各フィールドの名前、前の値、現在の値、および変更されたかどうかなど、比較されたSharePointフィールドの一覧。 |
|
列の値が変更されました
|
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 の 場合、解決された基準バージョンは、アイテムまたはファイルに記録された最初のバージョンです。 |
|
新しい項目
|
isNewItem | 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 の場合のエラーの詳細 |