Compartir a través de

XSendAppNotification y funciones de acción relacionadas (versión preliminar)

  • Artículo

Se aplica a: Aplicaciones de Canvas Aplicaciones basadas en modelos

[Este artículo es documentación preliminar y está sujeto a modificaciones].

Envíe una notificación en la aplicación con acciones opcionales a un destinatario.

Importante

  • Esta es una característica en versión preliminar.
  • Las versiones preliminares de características no se han diseñado para un uso de producción, pueden tener una funcionalidad restringida y pueden cambiar en gran medida antes de su lanzamiento. Estas características están disponibles antes del lanzamiento oficial para que los clientes puedan tener un acceso anticipado y proporcionar comentarios.
  • Para ayudar a identificarlas como características en versión preliminar, cada función tiene el prefijo X. Tras el lanzamiento, será necesario eliminar X de cualquier fórmula que use estas funciones y actualizar los argumentos para cualquier cambio de función.
  • Estas funciones solo se pueden usar con los complementos con poco código de Dataverse.

Description

La función XSendAppNotification se usa para enviar notificaciones dentro de una aplicación a un destinatario. Estas notificaciones aparecen como una notificación o dentro del centro de notificaciones para el usuario de la aplicación. Para más información, consulte Enviar notificaciones en aplicación en aplicaciones basadas en modelos.

Además, una notificación en la aplicación puede incluir de cero a muchas acciones en la tarjeta de notificación. Para agregar acciones a la tarjeta de notificación de la aplicación, las siguientes funciones se utilizan como parámetros en la función XSendAppNotification. Para obtener más información sobre cada tipo de acción, consulte Acciones de notificación.

  • XCreateUrlAction: agrega una acción de URL a la notificación tarjeta.
  • XCreateSidePaneActionForDashboard: agrega una acción del panel lateral que navega a una página con un tipo de dashboard dentro del panel lateral.
  • XCreateSidePaneActionForEntity: agrega una acción del panel lateral que navega a una página con un tipo de entityrecord dentro del panel lateral.
  • XCreateSidePaneActionForEntityList: agrega una acción del panel lateral que navega a una página con un tipo de entitylist dentro del panel lateral.
  • XCreateTeamsChatAction: agrega una acción de chat de Teams a la notificación tarjeta.

Sintaxis

XSendAppNotification

XSendAppNotification (Título, Destinatario, Cuerpo, Acciones, Tipo de icono, Tipo de mensaje emergente, Caducidad, Prioridad)

Parámetro Type Obligatorio Description
Nombre String Sí El título de la notificación de la aplicación.
Destinatario Entity Sí Una entidad de systemuser que es el destinatario de la notificación.
Body String No El cuerpo de la notificación.
Acciones Function No Una matriz de funciones de acción para agregar acciones a la notificación.
Tipo de icono Int No Valor de la lista desplegable para el tipo de icono (información, éxito, error, advertencia, mención, personalizado).
Tipo de notificación Int No Valor de lista de selección para el tipo de notificación (cronometrado frente a oculto).
Expiración Int No La cantidad de segundos desde que se debe eliminar la notificación si aún no se descartó.
Prioridad Int No Valor de la lista desplegable para la prioridad de la notificación (normal o alta).

XCreateUrlAcción

XCreateUrlAction (Título, URL, Objetivo de navegación)

Parámetro Type Obligatorio Description
Nombre String Sí El título que se muestra para la acción.
Dirección URL String Sí La URL que se abrirá cuando se seleccione la acción.
Objetivo de navegación String No Define dónde se abre el vínculo de navegación. Las opciones son:
  • dialog:Se abre en el cuadro de diálogo central.
  • inline: Por defecto. Se abre en la página actual.
  • newWindow:Se abre en una nueva pestaña del navegador.

XCreateSidePaneActionForDashbaord

XCreateSidePaneActionForDashboard (Título, ID del panel, Título del panel, ID del panel)

Parámetro Type Obligatorio Description
Nombre String Sí El título que se muestra para la acción.
Id. del panel String Sí El id. del nuevo panel lateral.
Título del panel String Sí El título que se mostrará para el panel lateral.
Id. de panel GUID Sí Identificador del panel que se abrirá en el panel lateral.

XCreateSidePaneActionForEntity

XCreateSidePaneActionForEntity (Título, ID del panel, Título del panel, Nombre de la entidad, ID de la entidad)

Parámetro Type Obligatorio Description
Nombre String Sí El título que se muestra para la acción.
Id. del panel String Sí El id. del nuevo panel lateral.
Título del panel String Sí El título que se mostrará para el panel lateral.
Nombre de entidad String Sí Nombre lógico de la entidad.
Id. de entidad String Sí Identificador del registro de entidad que se abrirá en el panel lateral.

XCreateSidePaneActionForEntityList

XCreateSidePaneActionForEntityList (Título, ID del panel, Título del panel, Nombre de la entidad)

Parámetro Type Obligatorio Description
Nombre String Sí El título que se muestra para la acción.
Id. del panel String Sí El id. del nuevo panel lateral.
Título del panel String Sí El título que se mostrará para el panel lateral.
Nombre de entidad String Sí El nombre lógico de la entidad para abrir como una lista en el panel lateral.

XCreateTeamsChatAction

XCreateTeamsChatAction (Título, ID de chat, ID de miembros, ID de registro, Nombre de entidad, Mensaje inicial)

Parámetro Type Obligatorio Description
Nombre String Sí El título que se muestra para la acción.
Id. de chat String No Si abre un chat existente, el id. de la sesión de chat que se abrirá.
Identificadores de miembro GUID No Si se crea un chat nuevo, una matriz de identificador de objeto de Microsoft Entra de los participantes que se incluirán en el chat.
Identificador de registro GUID No Si se vincula a un registro de Dynamics 365, el id. del registro al que se debe vincular el chat.
Nombre de entidad String No Si se vincula a un registro de Dynamics 365, el nombre lógico de la entidad al que se debe vincular el chat.
Mensaje inicial String No Un mensaje introductorio del nuevo chat.

Ejemplos

Notificación en aplicación con un título, un destinatario y un cuerpo

Lo siguiente envía una simple notificación en aplicación a un destinatario con un título y un cuerpo. No incluye ninguna acción y utiliza valores predeterminados para todos los demás parámetros.

XSendAppNotification(
    "Welcome", 
    LookUp(Users, 'Primary Email'="<User's email address>"), 
    "Welcome to the world of in-app notifications!"
)

Notificación en aplicación con dos acciones

La siguiente fórmula de ejemplo se puede utilizar con un complemento automatizado cuando se crea un nuevo registro de Tarea. La fórmula está diseñada para enviar una notificación en aplicación al propietario del registro de tareas. La tarjeta de notificación contiene dos acciones que el propietario puede realizar:

  • Una acción de panel lateral, abre el nuevo registro de tarea en un panel lateral.
  • Una acción de chat de Teams, inicia un chat de Teams con el propietario del registro de cuenta que se asigna como el registro de tabla Referente a de la tabla para la nueva tarea. Es importante tener en cuenta que esto supone que se ha seleccionado un registro de cuenta en el campo de tareas.
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
		)
	]
)