XSendAppNotification 與相關動作函式 (預覽版)
適用於：
畫布應用 模型驅動應用
[本文章是發行前版本文件，且隨時可能變更。]
向收件者傳送包含選擇性動作的應用程式內通知。
重要
- 這是預覽功能。
- 預覽功能不供生產時使用，其功能可能受限，且可能在發行前發生重大變化。 這些功能是在正式發行前先行推出，讓客戶能夠搶先體驗並提供意見反應。
- 為了協助將這些功能識別為預覽功能，每個函式都以 X 為首碼。發行後，將需要從使用這些函式的任何公式中移除 X，並為任何函式變更更新引數。
- 這些函式只能與 Dataverse 低程式碼外掛程式一起使用。
描述:
XSendAppNotification 函式可用來將應用程式中的通知傳送給收件者。 這些通知會顯示為 toast 或在應用程式使用者的通知中心內。 如需詳細資訊，請參閱在模型導向應用程式中傳送應用程式內通知。
此外，應用程式內通知可在通知卡上包括零到多個動作。 若要將動作新增至應用程式通知卡，請在 XSendAppNotification 函式中使用下列函式做為參數。 如需每個動作類型的詳細資訊，請參閱通知動作。
- XCreateUrlAction：將 URL 操作添加到通知卡片。
- XCreateSidePaneActionForDashboard：添加一個側窗格操作，該操作導航到側窗格內類型為的
dashboard頁面。 - XCreateSidePaneActionForEntity：添加一個側窗格操作，該操作導航到側窗格中類型為的
entityrecord頁面。 - XCreateSidePaneActionForEntityList：添加一個側窗格操作，該操作導航到側窗格內類型為的
entitylist頁面。 - XCreateTeamsChatAction：將 Teams 聊天操作添加到通知卡片。
語法
XSendAppNotification
XSendAppNotification （標題， 收件者， 正文， 操作， 圖示類型， Toast 類型， 過期時間， 優先順序）
| 參數 | 類型 | 必要 | 描述: |
|---|---|---|---|
| 名稱 | 字串 | .是 | 應用程式通知標題。 |
| 收件者 | Entity | .是 | 通知收件者的 systemuser 實體。 |
| Body | 字串 | 無 | 通知內容。 |
| 動作 | 函式 | 無 | 動作函式的陣列，用來新增通知的動作。 |
| 圖示類型 | Int | 無 | 圖示類型的挑選清單值 (資訊、成功、失敗、警告、提及、自訂)。 |
| 快顯類型 | Int | 無 | Toast 類型的挑選清單值 (定時與隱藏)。 |
| 到期日 | Int | 無 | 如果尚未關閉通知，則在刪除通知前等待的秒數。 |
| 優先順序 | Int | 無 | 通知優先順序的挑選清單值 (標準或高)。 |
XCreateUrlAction
XCreateUrlAction （標題， URL， 導航目標）
| 參數 | 類型 | 必要 | 描述: |
|---|---|---|---|
| 名稱 | 字串 | .是 | 為動作顯示的標題。 |
| URL | 字串 | .是 | 選取動作時要打開的 URL。 |
| 瀏覽目標 | 字串 | 無 | 定義瀏覽連結打開的位置。 選項有：
|
XCreateSidePaneActionForDashbaord
XCreateSidePaneActionForDashboard（標題，窗格 ID ，窗格標題，儀錶板 ID）
| 參數 | 類型 | 必要 | 描述: |
|---|---|---|---|
| 名稱 | 字串 | .是 | 為動作顯示的標題。 |
| 窗格識別碼 | 字串 | .是 | 新側窗格的識別碼。 |
| 窗格標題 | 字串 | .是 | 要為側窗格顯示的標題。 |
| 儀表板識別碼 | GUID | .是 | 要在側窗格中打開之儀表板的識別碼。 |
XCreateSidePaneActionForEntity
XCreateSidePaneActionForEntity（標題，窗格 ID ，窗格標題，實體名稱 ，實體 ID）
| 參數 | 類型 | 必要 | 描述: |
|---|---|---|---|
| 名稱 | 字串 | .是 | 為動作顯示的標題。 |
| 窗格識別碼 | 字串 | .是 | 新側窗格的識別碼。 |
| 窗格標題 | 字串 | .是 | 要為側窗格顯示的標題。 |
| 實體名稱 | 字串 | .是 | 實體的邏輯名稱。 |
| 實體識別碼 | 字串 | .是 | 要在側窗格中打開之實體記錄的識別碼。 |
XCreateSidePaneActionForEntityList
XCreateSidePaneActionForEntityList（標題，窗格 ID ，窗格標題，實體名稱）
| 參數 | 類型 | 必要 | 描述: |
|---|---|---|---|
| 名稱 | 字串 | .是 | 為動作顯示的標題。 |
| 窗格識別碼 | 字串 | .是 | 新側窗格的識別碼。 |
| 窗格標題 | 字串 | .是 | 要為側窗格顯示的標題。 |
| 實體名稱 | 字串 | .是 | 要在側窗格中以清單方式打開之實體的邏輯名稱。 |
XCreateTeamsChatAction
XCreateTeamsChatAction （標題、 聊天 ID、 成員 ID、 記錄 ID、 實體名稱、 初始消息）
| 參數 | 類型 | 必要 | 描述: |
|---|---|---|---|
| 名稱 | 字串 | .是 | 為動作顯示的標題。 |
| 聊天識別碼 | 字串 | 無 | 若要打開現有的聊天，則打開要打開之聊天會話的識別碼。 |
| 成員識別碼 | GUID | 無 | 若要建立新的聊天，請在聊天中加入參與者的 Microsoft Entra 物件識別碼值陣列。 |
| 記錄識別碼 | GUID | 無 | 若連結至 Dynamics 365 記錄，則為聊天應連結到之記錄的識別碼。 |
| 實體名稱 | 字串 | 無 | 若連結至 Dynamics 365 記錄，則為聊天應連結到之記錄實體的邏輯名稱。 |
| 初始訊息 | 字串 | 無 | 新聊天的介紹訊息。 |
範例
具有標題、收件者和本文的應用程式內通知
以下動作會向收件者傳送一個簡單的應用程式內通知，其中包含標題和本文。 它不包含任何動作，並使用所有其他參數的預設值。
XSendAppNotification(
"Welcome",
LookUp(Users, 'Primary Email'="<User's email address>"),
"Welcome to the world of in-app notifications!"
)
包含兩個動作的應用程式內通知
建立新工作記錄時，可以將以下範例公式與自動化外掛程式一起使用。 該公式的設計目的是要傳送應用程式內通知給工作記錄的負責人。 通知卡包含負責人可以執行的兩個動作：
- 側窗格動作會在側窗格中打開新的工作記錄。
- Teams 聊天動作會啟動與指派為新工作相關表記錄的客戶記錄負責人的 Teams 聊天。 請務必注意，這是假設已在 [工作] 欄位中選取了客戶記錄。
XSendAppNotification(
"New task assigned",
AsType(ThisRecord.Owner, Users),
"A new task has been assigned to you to follow up with your customer",
[XCreateSidePaneActionForEntity(
"View task",
1123,
"Your task",
"task",
ThisRecord.Task
),
XCreateTeamsChatAction(
"Chat with account manager",
[AsType(AsType(ThisRecord.Regarding, Accounts).Owner, Users).'Microsoft Entra Object ID'],
AsType(ThisRecord.Regarding, Accounts).Account,
"account",
ThisRecord.Description
)
]
)