XSendAppNotification и связанные функции действий (предварительная версия)

  • Статья

Применимо к: Приложениям Canvas Приложениям, управляемым моделями

[Данная статья посвящена предварительному выпуску и может быть изменена.]

Отправка получателю уведомления в приложении с необязательными действиями.

Внимание

  • Это предварительная версия функции.
  • Предварительные версии функций не предназначены для использования в рабочей среде, их функциональность может быть ограничена и они могут быть значительно изменены перед выпуском. Они доступны перед официальным выпуском, чтобы клиенты могли досрочно получить доступ и предоставить отзывы.
  • Чтобы упростить идентификацию этих предварительных версий функций, каждая функция имеет префикс X. После выпуска X необходимо будет удалить из любых формул, использующих эти функции, и обновить аргументы для любых изменений функций.
  • Эти функции можно использовать только с малокодовыми подключаемыми модулями Dataverse.

Описание:

Функция XSendAppNotification используется для отправки уведомлений в приложении получателю. Эти уведомления отображаются либо в виде всплывающих уведомлений, либо в центре уведомлений для пользователя приложения. Для получения дополнительной информации см. раздел Отправка уведомлений в приложении в приложениях на основе моделей.

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

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

Синтаксис

XSendAppNotification

XSendAppNotification (Заголовок, Получатель, Тело, Действия, Тип значка, Тип уведомления, Срок действия, Приоритет)

Параметр Type Обязательно Описание:
Title String Да Заголовок уведомления приложения.
Получатель Объект Да Объект systemuser, который является получателем уведомления.
Body String нет Тело уведомления.
Действия Function нет Массив функций действия для добавления действий к уведомлению.
Тип значка Int нет Значение списка выбора для типа значка (Информация, Успех, Сбой, Предупреждение, Упоминание, Пользовательский).
Тип всплывающего сообщения Int нет Значение раскрывающегося списка для типа всплывающего уведомления (временное или скрытое).
Окончание срока действия Int нет Число секунд, по истечении которых уведомление должно быть удалено, если не было закрыто.
Приоритет Int нет Значение списка выборов для приоритета уведомления (обычный или высокий).

XCreateUrlAction

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

Параметр Type Обязательно Описание:
Title String Да Заголовок, который будет отображаться для действия.
URL String Да URL-адрес, который будет открыт при выборе действия.
Цель навигации String нет Определяет, где открывается навигационная ссылка. Доступные параметры:
  • dialog: Открывается в центральном диалоговом окне.
  • inline: По умолчанию. Открывается в текущей странице.
  • newWindow: Открывается в новой вкладке браузера.

XCreateSidePaneActionForDashbaord

XCreateSidePaneActionForDashboard (Заголовок, ID панели, Заголовок панели, ID панели)

Параметр Type Обязательно Описание:
Title String Да Заголовок, который будет отображаться для действия.
Идентификатор панели String Да ИД новой боковой панели.
Заголовок панели String Да Заголовок для отображения на боковой панели.
ИД панели мониторинга GUID Да Идентификатор панели мониторинга для отображения на боковой панели.

XCreateSidePaneActionForEntity

XCreateSidePaneActionForEntity (Заголовок, ID панели, Заголовок панели, Имя сущности, ID сущности)

Параметр Type Обязательно Описание:
Title String Да Заголовок, который будет отображаться для действия.
Идентификатор панели String Да ИД новой боковой панели.
Заголовок панели String Да Заголовок для отображения на боковой панели.
Имя сущности String Да Логическое имя сущности.
ИД сущности String Да Идентификатор записи сущности для отображения на боковой панели.

XCreateSidePaneActionForEntityList

XCreateSidePaneActionForEntityList (Заголовок, ID панели, Заголовок панели, Имя сущности)

Параметр Type Обязательно Описание:
Title String Да Заголовок, который будет отображаться для действия.
Идентификатор панели String Да ИД новой боковой панели.
Заголовок панели String Да Заголовок для отображения на боковой панели.
Имя сущности String Да Логическое имя сущности для отображения в виде списка на боковой панели.

XCreateTeamsChatAction

XCreateTeamsChatAction (Заголовок, ID чата, ID участников, ID записи, Имя сущности, Начальное сообщение)

Параметр Type Обязательно Описание:
Title String Да Заголовок, который будет отображаться для действия.
ИД чата String нет При открытии существующего чата идентификатор открываемого сеанса чата.
Идентификаторы участников GUID нет При создании нового чата массив значений ИД объекта Microsoft Entra участников будет добавлен в чат.
ИД записи GUID нет При связывании с записью Dynamics 365 — идентификатор записи, с которой должен быть связан чат.
Имя сущности String нет При связывании с записью Dynamics 365 — логическое имя сущности записи, с которой должен быть связан чат.
Начальное сообщение String нет Вводное сообщение нового чата.

Примеры

Уведомление в приложении с заголовком, получателем и текстом

Следующее отправляет простое уведомление в приложении получателю с заголовком и текстом. Он не включает никаких действий и использует значения по умолчанию для всех остальных параметров.

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