XSendAppNotification 和相关操作函数（预览）
适用于：
画布应用模型驱动应用
[本文为预发布文档，可能会发生变化。]
向收件人发送包含可选操作的应用内通知。
重要提示
- 这是一项预览功能。
- 预览功能不适合生产使用，功能可能有限，并且可能在发布前发生重大更改。 这些功能在正式发布之前推出，以便客户可以提前使用并提供反馈。
- 为了帮助将这些功能识别为预览功能，每个函数都以 X 为前缀。发布后，需要从使用为任何函数更改更新的这些函数和参数的任何公式中删除 X。
- 这些函数只能用于 Dataverse 低代码插件。
说明
XSendAppNotification 函数用于在应用中向收件人发送通知。 这些通知要么作为 toast 显示，要么显示在应用用户的通知中心内。 有关详细信息，请参阅在模型驱动应用中发送应用内通知。
此外，应用内通知可以在通知卡上包含零到多个操作。 要将操作添加到应用通知卡，使用以下函数作为 XSendAppNotification 函数中的参数。 有关每个操作类型的详细信息，请参阅通知操作。
- XCreateUrlAction：将 URL 操作添加到通知卡片。
-
XCreateSidePaneActionForDashboard：添加一个侧窗格操作，该操作导航到侧窗格内类型为的
dashboard页面。 -
XCreateSidePaneActionForEntity：添加一个侧窗格操作，该操作导航到侧窗格中类型为的
entityrecord页面。 -
XCreateSidePaneActionForEntityList：添加一个侧窗格操作，该操作导航到侧窗格内类型为的
entitylist页面。 - XCreateTeamsChatAction：将 Teams 聊天操作添加到通知卡片。
语法
XSendAppNotification
XSendAppNotification （标题， 收件人， 正文， 操作， 图标类型， Toast 类型， 过期时间， 优先级）
| 参数 | 类型 | 必需 | 说明 |
|---|---|---|---|
| 称谓 | String | 是 | 应用通知的标题。 |
| 收件人 | Entity | 是 | 作为通知收件人的 systemuser 的实体。 |
| Body | String | 否 | 通知正文。 |
| 操作 | 函数 | 否 | 向通知中添加操作的操作函数数组。 |
| 图标类型 | Int | 否 | 图标类型的选择列表值（信息、成功、失败、警告、提及、自定义）。 |
| Toast 类型 | Int | 否 | Toast 类型的选择列表值（定时与隐藏）。 |
| 到期 | Int | 否 | 如果尚未关闭通知，则在相应时间之后删除通知的秒数。 |
| 优先级 | Int | 否 | 通知的优先级的选择列表值（正常或高）。 |
XCreateUrlAction
XCreateUrlAction （标题， URL， 导航目标）
| 参数 | 类型 | 必需 | 说明 |
|---|---|---|---|
| 称谓 | String | 是 | 为操作显示的标题。 |
| URL | String | 是 | 选择操作时要打开的 URL。 |
| 导航目标 | String | 否 | 定义导航链接打开的位置。 选项包括：
|
XCreateSidePaneActionForDashbaord
XCreateSidePaneActionForDashboard（标题，窗格 ID ，窗格标题， 仪表板 ID）
| 参数 | 类型 | 必需 | 说明 |
|---|---|---|---|
| 称谓 | String | 是 | 为操作显示的标题。 |
| 窗格 ID | String | 是 | 新侧窗格的 ID。 |
| 窗格标题 | String | 是 | 要为侧窗格显示的标题。 |
| 仪表板 ID | GUID | 是 | 要在侧窗格中打开的仪表板的 ID。 |
XCreateSidePaneActionForEntity
XCreateSidePaneActionForEntity（标题，窗格 ID ，窗格标题， 实体名称， 实体 ID）
| 参数 | 类型 | 必需 | 说明 |
|---|---|---|---|
| 称谓 | String | 是 | 为操作显示的标题。 |
| 窗格 ID | String | 是 | 新侧窗格的 ID。 |
| 窗格标题 | String | 是 | 要为侧窗格显示的标题。 |
| 实体名称 | String | 是 | 实体的逻辑名称。 |
| 实体 ID | String | 是 | 要在侧窗格中打开的实体记录的 ID。 |
XCreateSidePaneActionForEntityList
XCreateSidePaneActionForEntityList（标题，窗格 ID ，窗格标题， 实体名称）
| 参数 | 类型 | 必需 | 说明 |
|---|---|---|---|
| 称谓 | String | 是 | 为操作显示的标题。 |
| 窗格 ID | String | 是 | 新侧窗格的 ID。 |
| 窗格标题 | String | 是 | 要为侧窗格显示的标题。 |
| 实体名称 | String | 是 | 要作为侧窗格中的列表打开的实体的逻辑名称。 |
XCreateTeamsChatAction
XCreateTeamsChatAction （标题、 聊天 ID、 成员 ID、 记录 ID、 实体名称、 初始消息）
| 参数 | 类型 | 必需 | 说明 |
|---|---|---|---|
| 称谓 | String | 是 | 为操作显示的标题。 |
| 聊天 ID | String | 否 | 如果打开现有聊天，将打开的聊天会话的 ID。 |
| 成员 ID | GUID | 否 | 如果创建新聊天，聊天中将包含的参与者的 Microsoft Entra 对象 ID 值的数组。 |
| 记录 ID | GUID | 否 | 如果链接到 Dynamics 365 记录，聊天应链接到的记录的 ID。 |
| 实体名称 | 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
)
]
)