Share via

XSendAppNotification та пов’язані з ним функції дій (попередній перегляд)

  • Стаття

Застосовується до: програм Canvas Програм на основі моделі

[Ця стаття стосується попередньої версії, і її буде змінено.]

Надішліть одержувачу сповіщення в додатку з необов’язковими діями.

Важливо

  • Це функція попереднього перегляду.
  • Функції попереднього перегляду не призначені для промислового використання, можуть мати обмежену функціональність і можуть значно змінюватися перед випуском. Ці функції доступні до офіційного випуску, щоб клієнти могли ознайомитися з ними заздалегідь і залишити відгуки.
  • Щоб допомогти ідентифікувати їх як функції попереднього перегляду, кожна функція має префікс X . Після випуску X потрібно буде видалити з будь-яких формул, які використовують ці функції та аргументи, оновлені для будь-яких змін у функції.
  • Ці функції можна використовувати лише з Dataverse low-code плагінами.

Опис

Функція XSendAppNotification використовується для надсилання сповіщень у програмі одержувачу. Ці сповіщення відображаються або у вигляді тостів, або в центрі сповіщень для користувача програми. Щоб дізнатися більше, перегляньте статтю Надсилання сповіщень у програмі на основі моделі.

Крім того, сповіщення в додатку може містити від нуля до багатьох дій на картці сповіщень. Щоб додати дії до картки сповіщень програми, у функції XSendAppNotification як параметри використовуються такі функції. Щоб дізнатися більше про кожен тип дії, перегляньте статтю Дії зі сповіщеннями.

  • XCreateUrlAction: додає дію URL-адреси до картки сповіщень.
  • XCreateSidePaneActionForDashboard: додає дію бічної панелі, яка переходить на сторінку з типом dashboard на бічній панелі.
  • XCreateSidePaneActionForEntity: додає дію бічної панелі, яка переходить на сторінку з типом entityrecord на бічній панелі.
  • XCreateSidePaneActionForEntityList: додає дію бічної панелі, яка переходить на сторінку з типом entitylist на бічній панелі.
  • XCreateTeamsChatAction: додає дію чату Teams до картки сповіщень.

Синтаксис

XSendAppNotification

XSendAppNotification (Заголовок,Одержувач,Тіло,Дії,Тип піктограми,Тип тосту,Термін дії,Пріоритет)

Параметр Ввести Обов'язковий Опис
Звання String Так Назва сповіщення додатка.
Одержувач Об'єкт Так Суб’єкт systemuser господарювання, який є одержувачем сповіщення.
Основний текст String No Тіло сповіщення.
Дії Function No Масив функцій дій для додавання дій до сповіщення.
Тип піктограми Int No Значення списку вибору для типу піктограми (інформація, успіх, невдача, попередження, згадка, нетиповий).
Тип спливання Int No Значення списку вибору для типу тосту (за часом чи приховано).
Термін дії Int No Час у секундах перед видаленням сповіщення, якщо його не було відхилено раніше.
Пріоритет Int No Значення списку вибору для пріоритету сповіщень (нормальний або високий).

XCreateUrlAction

XCreateUrlAction (Заголовок,URL,Ціль навігації)

Параметр Ввести Обов'язковий Опис
Звання String Так Заголовок, який відображається для дії.
URL-адреса String Так URL-адреса, яку буде відкрито після вибору дії.
Навігаційна ціль String No Визначає, де відкривається навігаційне посилання. Можливі варіанти:
  • dialog: відкриється в центральному діалоговому вікні.
  • inline:За промовчанням. Відкривається на поточній сторінці.
  • newWindow: відкриється в новій вкладці веб-переглядача.

XCreateSidePaneActionForDashbaord

XCreateSidePaneActionForDashboard (Заголовок,Ідентифікатор панелі,Заголовок панелі,Ідентифікатор інформаційної панелі)

Параметр Ввести Обов'язковий Опис
Звання String Так Заголовок, який відображається для дії.
Ідентифікатор панелі String Так Ідентифікатор нової бічної панелі.
Заголовок панелі String Так Заголовок, який буде показано на бічній панелі.
Ідентифікатор приладної дошки GUID Так Ідентифікатор приладової панелі для відкриття на бічній панелі.

XCreateSidePaneActionForEntity

XCreateSidePaneActionForEntity (Заголовок,Ідентифікатор панелі,Заголовок панелі,Ім’я сутності,Ідентифікатор сутності)

Параметр Ввести Обов'язковий Опис
Звання String Так Заголовок, який відображається для дії.
Ідентифікатор панелі String Так Ідентифікатор нової бічної панелі.
Заголовок панелі String Так Заголовок, який буде показано на бічній панелі.
Ім’я сутності String Так Логічне ім’я сутності.
Ідентифікатор сутності String Так Ідентифікатор запису сутності, який потрібно відкрити на бічній панелі.

XCreateSidePaneActionForEntityList

XCreateSidePaneActionForEntityList (заголовок,ідентифікатор панелі,заголовок панелі,ім’я сутності)

Параметр Ввести Обов'язковий Опис
Звання String Так Заголовок, який відображається для дії.
Ідентифікатор панелі String Так Ідентифікатор нової бічної панелі.
Заголовок панелі String Так Заголовок, який буде показано на бічній панелі.
Ім’я сутності String Так Логічне ім’я сутності, яку буде відкрито у вигляді списку на бічній панелі.

XCreateTeamsChatAction

XCreateTeamsChatAction (Назва,Ідентифікатор чату,Ідентифікатори учасників,Ідентифікатор запису,Назва сутності,Початкове повідомлення)

Параметр Ввести Обов'язковий Опис
Звання String Так Заголовок, який відображається для дії.
Ідентифікатор чату String No Якщо ви відкриваєте існуючий чат, ідентифікатор сеансу чату, який потрібно відкрити.
Ідентифікатори учасників GUID No При створенні нового чату, масив Microsoft Entra значень Object ID учасників, які будуть включені в чат.
Ідентифікатор запису GUID No Якщо зв’язується із записом Dynamics 365, ідентифікатор запису, з яким має бути пов’язано чат.
Ім’я сутності String No Якщо зв’язується із записом Dynamics 365, логічне ім’я сутності запису, з яким має бути пов’язаний чат.
Початкове повідомлення String No Вступне повідомлення нового чату.

Приклади

Сповіщення в додатку з назвою, одержувачем і тілом

Наведене нижче надсилає одержувачу просте сповіщення в додатку із заголовком і текстом. Він не містить жодних дій і використовує значення за замовчуванням для всіх інших параметрів.

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
		)
	]
)