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。
瀏覽目標 字串 無 定義瀏覽連結打開的位置。 選項有：
  • dialog: 在中心對話方塊中開啟。
  • inline：預設。 在目前頁面中開啟。
  • newWindow：在新的瀏覽器索引標籤中開啟。

XCreateSidePaneActionForDashbaord

XCreateSidePaneActionForDashboard (標題、窗格識別碼、窗格標題、儀表板識別碼)

參數 類型​ 必要 描述:
名稱 字串 .是 為動作顯示的標題。
窗格識別碼 字串 .是 新側窗格的識別碼。
窗格標題 字串 .是 要為側窗格顯示的標題。
儀表板識別碼 GUID .是 要在側窗格中打開之儀表板的識別碼。

XCreateSidePaneActionForEntity

XCreateSidePaneActionForEntity (標題、窗格識別碼、窗格標題、實體名稱、實體識別碼)

參數 類型​ 必要 描述:
名稱 字串 .是 為動作顯示的標題。
窗格識別碼 字串 .是 新側窗格的識別碼。
窗格標題 字串 .是 要為側窗格顯示的標題。
實體名稱 字串 .是 實體的邏輯名稱。
實體識別碼 字串 .是 要在側窗格中打開之實體記錄的識別碼。

XCreateSidePaneActionForEntityList

XCreateSidePaneActionForEntityList (標題、窗格識別碼、窗格標題、實體名稱)

參數 類型​ 必要 描述:
名稱 字串 .是 為動作顯示的標題。
窗格識別碼 字串 .是 新側窗格的識別碼。
窗格標題 字串 .是 要為側窗格顯示的標題。
實體名稱 字串 .是 要在側窗格中以清單方式打開之實體的邏輯名稱。

XCreateTeamsChatAction

XCreateTeamsChatAction (標題、聊天識別碼、成員識別碼、記錄識別碼、實體名稱、初始訊息)

參數 類型​ 必要 描述:
名稱 字串 .是 為動作顯示的標題。
聊天識別碼 字串 無 若要打開現有的聊天，則打開要打開之聊天會話的識別碼。
成員識別碼 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
		)
	]
)