Compartir por

XSendAppNotification e funcións de acción relacionadas (versión preliminar)

  • Artigo

Aplícase a: Aplicacións de lenzo Aplicacións baseadas en modelos

[Este artigo é a documentación de prelanzamento e está suxeito a cambios.]

Envía unha notificación na aplicación con accións opcionais a un destinatario.

Importante

  • Esta é unha funcionalidade de vista previa.
  • As funcións versión preliminar non están pensadas para uso en produción, poden ter unha funcionalidade restrinxida e poden cambiar significativamente antes do lanzamento. Estas funcionalidades están dispoñibles antes da versión oficial para que os clientes poidan obter acceso a elas rápido e fornecer comentarios.
  • Para axudar a identificalas como funcións versión preliminar, cada función leva un prefixo X. Despois do lanzamento, o X terá que eliminarse de calquera fórmula que utilice estas funcións e os argumentos actualizados para calquera cambio de función.
  • Estas funcións só se poden usar cos complementos Dataverse con pouco código.

Descripción

A función XSendAppNotification utilízase para enviar notificacións dentro dunha aplicación a un destinatario. Estas notificacións aparecen como un brinde ou dentro do centro de notificacións para o usuario da aplicación. Para obter máis información, consulta Enviar notificacións na aplicación en aplicacións baseadas en modelos.

Ademais, unha notificación na aplicación pode incluír de cero a moitas accións na notificación cartón. Para engadir accións á notificación da aplicación cartón, utilízanse as seguintes funcións como parámetros na función XSendAppNotification . Para obter máis información sobre cada tipo de acción, consulte Accións de notificación.

  • XCreateUrlAction: engade unha acción URL á notificación cartón.
  • XCreateSidePaneActionForDashboard: engade unha acción do panel lateral que navega ata unha páxina cun tipo de dashboard dentro do panel lateral.
  • XCreateSidePaneActionForEntity: engade unha acción do panel lateral que navega ata unha páxina cun tipo de entityrecord dentro do panel lateral.
  • XCreateSidePaneActionForEntityList: engade unha acción do panel lateral que navega ata unha páxina cun tipo de entitylist dentro do panel lateral.
  • XCreateTeamsChatAction: engade unha acción de chat de Teams á notificación cartón.

Sintaxe

XSendAppNotification

XSendAppNotification (Título, Destinatario, Corpo, Accións, Tipo de icona, Tipo de brindis, Caducidade, Prioridade)

Parámetro Tipo Obrigatorio Descripción
Cargo String Si O título da notificación da aplicación.
Destinatario Entidad Si Unha entidade de systemuser que é o destinatario da notificación.
Corpo String No O órgano de notificación.
Accións Function No Unha serie de funcións de acción para engadir accións á notificación.
Tipo de icona Int No Valor da lista de selección para o tipo de icona (información, éxito, fracaso, aviso, mención, personalizado).
Tipo de notificación Int No Valor da lista de selección para o tipo de brindis (temporizado versus oculto).
Caducidade Int No Número de segundos a partir do que se debe eliminar a notificación se aínda non se rexeitou.
Prioridade Int No Valor da lista de selección para a prioridade da notificación (normal ou alta).

XCreateUrlAction

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

Parámetro Tipo Obrigatorio Descripción
Cargo String Si O título que se mostra para a acción.
Enderezo URL String Si O URL que se abrirá cando se seleccione a acción.
Obxectivo de navegación String No Define onde se abre a ligazón de navegación. As opcións son:
  • dialog: ábrese no diálogo central.
  • inline: Por defecto. Ábrese na páxina actual.
  • newWindow: ábrese nunha nova pestana do navegador.

XCreateSidePaneActionForDashbaord

XCreateSidePaneActionForDashboard (Título, ID do panel, Panel Título, ID do panel)

Parámetro Tipo Obrigatorio Descripción
Cargo String Si O título que se mostra para a acción.
ID do panel String Si O ID do novo panel lateral.
Título do panel String Si O título que se mostrará no panel lateral.
ID do panel GUID Si O ID do panel que se abrirá no panel lateral.

XCreateSidePaneActionForEntity

XCreateSidePaneActionForEntity (Título, ID do panel, Panel Título, Nome da entidade, ID da entidade)

Parámetro Tipo Obrigatorio Descripción
Cargo String Si O título que se mostra para a acción.
ID do panel String Si O ID do novo panel lateral.
Título do panel String Si O título que se mostrará no panel lateral.
Nome de entidade String Si Nome lóxico da entidade.
ID da entidade String Si O ID do rexistro de entidade que se vai abrir no panel lateral.

XCreateSidePaneActionForEntityList

XCreateSidePaneActionForEntityList (Título, ID do panel, Panel Título, Nome da entidade)

Parámetro Tipo Obrigatorio Descripción
Cargo String Si O título que se mostra para a acción.
ID do panel String Si O ID do novo panel lateral.
Título do panel String Si O título que se mostrará no panel lateral.
Nome de entidade String Si O nome lóxico da entidade que se vai abrir como lista no panel lateral.

XCreateTeamsChatAction

XCreateTeamsChatAction (Título, ID do chat, Membro ID, ID de rexistro, Nome da entidade, Mensaxe inicial)

Parámetro Tipo Obrigatorio Descripción
Cargo String Si O título que se mostra para a acción.
ID do chat String No Se se abre un chat existente, o ID da sesión de chat que se vai abrir.
Identificadores de membros GUID No Se creas un novo chat, hai unha matriz de Microsoft Entra valores de ID de obxecto dos participantes que se incluirán no chat.
ID de rexistro GUID No Se se vincula a un rexistro de Dynamics 365, o ID do rexistro ao que se debe vincular o chat.
Nome de entidade String No Se se vincula a un rexistro de Dynamics 365, o nome lóxico da entidade do rexistro á que se debe ligar o chat.
Mensaxe inicial String No Unha mensaxe de presentación do novo chat.

Exemplos

Notificación na aplicación cun título, destinatario e corpo

O seguinte envía unha notificación simple na aplicación a un destinatario cun título e corpo. Non inclúe ningunha acción e utiliza valores predeterminados para todos os demais parámetros.

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

Notificación na aplicación con dúas accións

A seguinte fórmula de exemplo pódese usar cun complemento automático cando se crea un novo rexistro de tarefas. A fórmula está deseñada para enviar unha notificación na aplicación ao propietario do rexistro de tarefas. A notificación cartón contén dúas accións que o propietario pode realizar:

  • Unha acción panel lateral abre o novo rexistro de tarefas nun panel lateral.
  • Unha acción Chat de Teams inicia un chat de Teams co propietario do rexistro da conta que está asignado como Con respecto a rexistro de táboa para a nova tarefa. É importante ter en conta que isto supón que se seleccionou un rexistro de conta no campo da tarefa.
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
		)
	]
)