Поділитися через

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

  • Стаття

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

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

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

Важливо

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

Опис

Функція 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 Так ID приладової панелі для відкриття в бічній панелі.

XCreateSidePaneActionForEntity

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

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

XCreateSidePaneActionForEntityList

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

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

XCreateTeamsChatAction

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

Параметр Ввести Обов'язковий Опис
Звання String Так Заголовок, який відображається для дії.
Ідентифікатор чату String No Якщо ви відкриваєте існуючий чат, ID сеансу чату, який потрібно відкрити.
Ідентифікатори учасників 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!"
)

Сповіщення в додатку з двома діями

Наведений нижче приклад формули можна використовувати з автоматизованим плагіном під час створення нового запису завдання. Формула призначена для надсилання сповіщення в додатку власнику запису завдання. Tкартка сповіщень містить дві дії, які може зробити власник:

  • Дія на бічній панелі відкриває новий запис завдання в бічній панелі.
  • Дія чату 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
		)
	]
)