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

Aplica-se a: Aplicações de tela Aplicações condicionadas 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 para uma página com um tipo de dashboard no painel lateral.
• XCreateSidePaneActionForEntity: adiciona uma ação do painel lateral que navega para uma página com um tipo de entityrecord no painel lateral.
• XCreateSidePaneActionForEntityList: adiciona uma ação do painel lateral que navega para uma página com um tipo de entitylist no 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 Alerta, 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: é aberto no diálogo central. inline: predefinição. Abre-se na página atual. newWindow: abre-se num novo separador do browser.

XCreateSidePaneActionForDashbaord

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

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 Membros, ID do Registo, 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
		)
	]
)