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 | нет | Определяет, где открывается навигационная ссылка. Доступные параметры:
|
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
)
]
)