Compartilhar via

XSendAppNotification e funções de ação relacionadas (versão preliminar)

  • Artigo

Aplica-se a: Aplicativos de tela Aplicativos baseados em modelo

[Este artigo faz parte da documentação de pré-lançamento e está sujeito a alterações.]

Enviar uma notificação no aplicativo com ações opcionais para um destinatário.

Importante

  • Esse é um recurso de versão preliminar.
  • Os recursos de versão preliminar não foram criados para uso em ambientes de produção e podem ter funcionalidade restrita e podem ser alterados significantemente antes da versão. Esses recursos são disponibilizados antes de um lançamento oficial para que os clientes possam ter acesso antecipado e forneçam comentários.
  • Para ajudar a identificá-los como recursos de visualização, cada função é prefixada com um X. Após a liberação, o X precisará ser removido de todas as fórmulas que usam essas funções e argumentos atualizados para quaisquer alterações de função.
  • Estas funções só podem ser usadas com os plug-ins low-code do Dataverse.

Description

A função XSendAppNotification é usada para enviar notificações dentro de um aplicativo para um destinatário. Essas notificações aparecem como uma notificação do sistema ou no centro de notificações para o usuário do aplicativo. Para obter mais informações, consulte Enviar notificações no aplicativo em aplicativos baseados em modelo.

Além disso, uma notificação no aplicativo pode incluir de zero a muitas ações no cartão de notificação. Para adicionar ações ao cartão de notificação do aplicativo, as funções a seguir são usadas como parâmetros na função XSendAppNotification. Para obter mais informações sobre cada tipo de ação, consulte Ações de notificação.

  • XCreateUrlAction: adiciona uma ação de URL ao cartão de notificação.
  • XCreateSidePaneActionForDashboard: Adiciona uma ação de painel lateral que navega para uma página com um tipo de dashboard dentro do painel lateral.
  • XCreateSidePaneActionForEntity: Adiciona uma ação de painel lateral que navega para uma página com um tipo de entityrecord dentro do painel lateral.
  • XCreateSidePaneActionForEntityList: Adiciona uma ação de painel lateral que navega para uma página com um tipo de entitylist dentro do painel lateral.
  • XCreateTeamsChatAction: Adiciona uma ação de chat do Teams ao cartão de notificação.

Sintaxe

XSendAppNotification

XSendAppNotification (Título, Destinatário, Corpo, Ações, Tipo de Ícone, Tipo de Sistema, Expirar, Prioridade)

Parâmetro Type Obrigatória Description
Tĩtulo String Sim O título da notificação do aplicativo.
Destinatário Entity Sim Uma entidade de systemuser quem é o destinatário da notificação.
Body String No O corpo da notificação.
Ações Função No Uma matriz das funções de ação para adicionar ações à notificação.
Tipo de Ícone Int No Valor de lista de seleção para o tipo de ícone (informações, êxito, falha, aviso, menção, personalizado).
Tipo de Sistema Int No Valor da lista de opções para o tipo de sistema (temporizado versus oculto).
Vencimento Int No O número de segundos para que a notificação seja excluída se ainda não tiver sido descartada.
Prioridade Int No Valor da lista de seleção para a prioridade da notificação (normal ou alta).

XCreateUrlAction

XCreateUrlAction (Título, URL, Destino de Navegação)

Parâmetro Type Obrigatória Description
Tĩtulo String Sim O título exibido para a ação.
URL String Sim A URL a ser aberta quando a ação for selecionada.
Destino de Navegação String No Define onde o link de navegação será aberto. As opções são:
  • dialog: Será aberto na caixa de diálogo central.
  • inline: Padrão. Abre na página atual.
  • newWindow: Será aberto em uma nova guia do navegador.

XCreateSidePaneActionForDashbaord

XCreateSidePaneActionForDashboard (Título, ID do Painel, Título do Painel, ID do Painel)

Parâmetro Type Obrigatória Description
Tĩtulo String Sim O título exibido para a ação.
ID do Painel String Sim A ID do novo painel lateral.
Título do Painel String Sim O título a ser exibido para o painel lateral.
ID do Painel GUID Sim A ID do painel a ser aberta no painel lateral.

XCreateSidePaneActionForEntity

XCreateSidePaneActionForEntity (Título, ID do Painel, Título do Painel, Nome da Entidade, ID da Entidade)

Parâmetro Type Obrigatória Description
Tĩtulo String Sim O título exibido para a ação.
ID do Painel String Sim A ID do novo painel lateral.
Título do Painel String Sim O título a ser exibido para o painel lateral.
Nome da Entidade String Sim O nome lógico da entidade.
ID da Entidade String Sim A ID do registro da entidade a ser aberta no painel lateral.

XCreateSidePaneActionForEntityList

XCreateSidePaneActionForEntityList (Título, ID do Painel, Título do Painel, Nome da Entidade)

Parâmetro Type Obrigatória Description
Tĩtulo String Sim O título exibido para a ação.
ID do Painel String Sim A ID do novo painel lateral.
Título do Painel String Sim O título a ser exibido para o painel lateral.
Nome da Entidade String Sim O nome lógico da entidade a ser aberta como uma lista no painel lateral.

XCreateTeamsChatAction

XCreateTeamsChatAction (Título, ID do Chat, IDs do Membro, ID do Registro, Nome da Entidade, Mensagem Inicial)

Parâmetro Type Obrigatória Description
Tĩtulo String Sim O título exibido para a ação.
ID do Chat String No Se estiver abrindo um chat existente, a ID da sessão de chat a ser aberta.
IDs de membro GUID No Se estiver criando um novo chat, uma matriz de valores do ID do Objeto do Microsoft Entra dos participantes a serem incluídos no chat.
ID de Registro GUID No Se estiver vinculando a um registro do Dynamics 365, a ID do registro ao qual o chat deve ser vinculado.
Nome da Entidade String No Se estiver vinculando a um registro do Dynamics 365, o nome lógico da entidade do registro ao qual o chat deve ser vinculado.
Mensagem Inicial String No Uma mensagem introdutória do novo chat.

Exemplos

Notificação no aplicativo com título, destinatário e corpo

O seguinte envia uma notificação simples no aplicativo para um destinatário com um título e um corpo. Ele não inclui nenhuma ação e utiliza valores padrão para todos os outros parâmetros.

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

Notificação no aplicativo com duas ações

A fórmula de exemplo a seguir pode ser usada com um plug-in automatizado quando um novo registro de Tarefa é criado. A fórmula foi projetada para enviar uma notificação no aplicativo ao proprietário do registro da tarefa. O cartão de notificação contém duas ações que o proprietário pode realizar:

  • Uma ação do painel lateral abre o novo registro de tarefa em um painel lateral.
  • Uma ação de Bate-papo do Teams inicia um bate-papo do Teams com o proprietário do registro da conta que é atribuído como o registro da tabela Referente a da nova tarefa. É importante observar que isso pressupõe que um registro de conta foi selecionado no campo de 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
		)
	]
)