Partilhar via

XSendAppNotification e funções de ação relacionadas (pré-visualização)

  • Artigo

Aplica-se a: Aplicativos de tela Aplicativos controlados por modelo

[Este artigo inclui documentação pré-versão e está sujeito a alterações.]

Enviar uma notificação na aplicação com ações opcionais a um destinatário.

Importante

  • Esta é uma caraterística de pré-visualização.
  • As funcionalidades de pré-visualização não se destinam à utilização em produção, podem ter funcionalidades restritas e podem mudar significativamente antes do lançamento. Estas caraterísticas estão disponíveis antes do lançamento oficial, para que os clientes possam ter acesso antecipadamente e enviar comentários.
  • Para ajudar a identificar estas como funcionalidades de pré-visualização, cada função é antecedida de um X. Após o lançamento, o X terá de ser removido de quaisquer fórmulas que utilizem estas funções e argumentos atualizados para quaisquer alterações de funções.
  • Estas funções só podem ser utilizadas com os plug-ins low-code do Dataverse.

Descrição

A função XSendAppNotification é utilizada para enviar notificações dentro de uma aplicação para um destinatário. Estas notificações aparecem como um alerta ou no centro de notificações do utilizador da aplicação. Para obter mais informações, consulte Enviar notificações na aplicação dentro de aplicações condicionadas por modelo.

Além disso, uma notificação na aplicação pode incluir de zero a muitas ações no cartão de notificação. Para adicionar ações ao cartão de notificação da aplicação, as funções seguintes são utilizadas como parâmetros na função XSendAppNotification. Para 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 do painel lateral que navega até uma página com um tipo de dentro do dashboard painel lateral.
  • XCreateSidePaneActionForEntity: adiciona uma ação do painel lateral que navega até uma página com um tipo de entityrecord dentro do painel lateral.
  • XCreateSidePaneActionForEntityList: adiciona uma ação do painel lateral que navega para uma página com um tipo de dentro do entitylist 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 do sistema,Expiração,Prioridade)

Parâmetro Type Obrigatório Descrição
Title Cadeia (de carateres) Sim O título da notificação da aplicação.
Destinatário Entity Sim Uma entidade do systemuser que é o destinatário da notificação.
Body Cadeia (de carateres) Não O corpo da notificação.
Ações Function Não Uma matriz das funções de ação para adicionar ações à notificação.
Tipo de Ícone Int Não Valor da lista de opções para o tipo de ícone (informações, sucesso, falha, aviso, menção, personalizado).
Tipo de Alerta Int Não Valor da lista de opções para o tipo de alerta (temporizado versus oculto).
Expiração Int Não O número de segundos a partir do qual a notificação deve ser eliminada, caso ainda não tenha sido dispensada.
Prioridade Int Não Valor da lista de opções da prioridade de notificação (normal ou alta).

XCreateUrlAction

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

Parâmetro Type Obrigatório Descrição
Title Cadeia (de carateres) Sim O título apresentado para a ação.
URL Cadeia (de carateres) Sim O URL a ser aberto quando a ação é selecionada.
Destino de Navegação Cadeia (de carateres) Não Define o local onde a ligação de navegação é aberta. As opções são:
  • dialog: Abre na caixa de diálogo central.
  • inline: Padrão. Abre-se na página atual.
  • newWindow: Abre num novo separador do browser.

XCreateSidePaneActionForDashbaord

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

Parâmetro Type Obrigatório Descrição
Title Cadeia (de carateres) Sim O título apresentado para a ação.
ID do Painel Cadeia (de carateres) Sim O ID do novo painel lateral.
Título do Painel Cadeia (de carateres) Sim O título a apresentar para o painel lateral.
ID do Dashboard GUID Sim O ID do dashboard a ser aberto no painel lateral.

XCreateSidePaneActionForEntity

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

Parâmetro Type Obrigatório Descrição
Title Cadeia (de carateres) Sim O título apresentado para a ação.
ID do Painel Cadeia (de carateres) Sim O ID do novo painel lateral.
Título do Painel Cadeia (de carateres) Sim O título a apresentar para o painel lateral.
Nome da Entidade Cadeia (de carateres) Sim O nome lógico da entidade.
ID da Entidade Cadeia (de carateres) Sim O ID do registo 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ório Descrição
Title Cadeia (de carateres) Sim O título apresentado para a ação.
ID do Painel Cadeia (de carateres) Sim O ID do novo painel lateral.
Título do Painel Cadeia (de carateres) Sim O título a apresentar para o painel lateral.
Nome da Entidade Cadeia (de carateres) Sim O nome lógico da entidade a ser aberta como uma lista no painel lateral.

XCreateTeamsChatAction

XCreateTeamsChatAction (Título,ID do chat,IDs de membro,ID do registro,Nome da entidade,Mensagem inicial)

Parâmetro Type Obrigatório Descrição
Title Cadeia (de carateres) Sim O título apresentado para a ação.
ID do Chat Cadeia (de carateres) Não Se abrir um chat existente, será aberto o ID da sessão de chat.
IDs de Membro GUID Não Se criar um novo chat, será incluída uma matriz dos valores do ID de Objeto do Microsoft Entra dos participantes no chat.
ID de Registo GUID Não Se estiver a ligar a um registo do Dynamics 365, o ID do registo ao qual o chat deve ser ligado.
Nome da Entidade Cadeia (de carateres) Não Se estiver a ligar a um registo do Dynamics 365, o nome lógico da entidade do registo ao qual o chat deve ser ligado.
Mensagem Inicial Cadeia (de carateres) Não Uma mensagem introdutória do novo chat.

Exemplos

Notificação na aplicação com título, destinatário e corpo

O seguinte envia uma simples notificação na aplicação para um destinatário com título e corpo. Não inclui nenhuma ação e utiliza valores predefinidos 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 na aplicação com duas ações

A fórmula de exemplo a seguir pode ser utilizada com um plug-in automatizado quando um novo registo Tarefa é criado. A fórmula foi concebida para enviar uma notificação na aplicação ao proprietário do registo de 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 registo de tarefa num painel lateral.
  • Uma ação do chat do Teams, inicia um chat do Teams com o proprietário do registo de conta atribuído como o registo de tabela Relativo a para a nova tarefa. É importante observar que isso pressupõe que um registo 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
		)
	]
)