Sdílet prostřednictvím

Funkce XSendAppNotification a související akce (Preview)

  • Článek

Platí pro: aplikace plátna modelem řízené aplikace

[Tento článek představuje předběžnou dokumentaci a může se změnit.]

Odešlete příjemci oznámení v aplikaci s volitelnými akcemi.

Důležité

  • Toto je funkce Preview.
  • Funkce Preview nejsou určené pro normální používání, mohou mít omezené fungování a před vydáním se mohou výrazně změnit. Jsou to funkce, které jsou poskytnuté před svým oficiálním vydáním, aby si je zákazníci mohli co nejdříve vyzkoušet a mohli nám napsat své názory.
  • Aby bylo možné tyto funkce identifikovat jako funkce Preview, každá funkce má předponu X. Po vydání bude X nutné odstranit ze všech vzorců, které používají tyto funkce a argumenty aktualizované pro jakékoli změny funkcí.
  • Tyto funkce lze použít pouze s moduly plug-in Dataverse s minimálním psaním kódu.

Description

Funkce XSendAppNotification se používá k odesílání oznámení v rámci aplikace příjemci. Tato oznámení se uživateli aplikace zobrazují buď jako informační zpráva, nebo v oznamovacím centru. Další informace viz Odeslání oznámení v aplikacích v modelem řízených aplikacích.

Kromě toho může oznámení v aplikaci obsahovat nula až mnoho akcí na kartě oznámení. Chcete-li přidat akce na kartu oznámení aplikace, jako parametry ve funkci XSendAppNotification se používají následující funkce. Další informace o jednotlivých typech akcí naleznete v části Akce oznámení.

  • XCreateUrlAction: Přidá akci URL na kartu oznámení.
  • XCreateSidePaneActionForDashboard: Přidá akci bočního panelu, která přejde na stránku s typem dashboard v postranním panelu.
  • XCreateSidePaneActionForEntity: Přidá akci bočního panelu, která přejde na stránku s typem entityrecord v postranním panelu.
  • XCreateSidePaneActionForEntityList: Přidá akci bočního panelu, která přejde na stránku s typem entitylist v postranním panelu.
  • XCreateTeamsChatAction: Přidá akci chatu Teams na kartu oznámení.

Syntaxe

XSendAppNotification

XSendAppNotification (Název, Příjemce, Tělo, Akce, Typ ikony, Typ informační zprávy, Vypršení platnosti, Priorita)

Parametr Type Požadováno Description
Titulek Řetězcové Ano Název oznámení aplikace.
Příjemce Entity Ano Entita systemuser, kdo je příjemcem oznámení.
Body Řetězcové No Text oznámení.
Akce Function No Pole funkcí akcí pro přidání akcí k oznámení.
Typ ikony Celé číslo No Hodnota výběrového seznamu pro typ ikony (informace, úspěch, chyba, upozornění, zmínka, vlastní)
Typ informační zprávy Celé číslo No Hodnota seznamu pro typ informační zprávy (načasovaná versus skrytá).
Vypršení platnosti Celé číslo No Počet sekund, po kterých má být oznámení odstraněno, pokud ještě nebylo zrušeno
Priorita Celé číslo No Hodnota výběrového seznamu pro prioritu oznámení (normální nebo vysoká)

XCreateUrlAction

XCreateUrlAction (Název, URL, Cíl navigace)

Parametr Type Požadováno Description
Titulek Řetězcové Ano Název, který se zobrazuje pro akci.
URL Řetězcové Ano Adresa URL, která se má otevřít při výběru akce.
Cíl navigace Řetězcové No Definuje, kde se otevře navigační odkaz. Možnosti jsou:
  • dialog: Otevře se v prostředním dialogu.
  • inline: Výchozí. Otevře se na aktuální stránce.
  • newWindow: Otevře se na nové kartě prohlížeče.

XCreateSidePaneActionForDashbaord

XCreateSidePaneActionForDashboard (Název, ID podokna, Název podokna, ID řídicího panelu)

Parametr Type Požadováno Description
Titulek Řetězcové Ano Název, který se zobrazuje pro akci.
ID podokna Řetězcové Ano ID nového bočního panelu.
Název podokna Řetězcové Ano Název, který se má zobrazit pro boční podokno.
ID řídicího panelu Identifikátor GUID Ano ID řídicího panelu, který se má otevřít v bočním podokně.

XCreateSidePaneActionForEntity

XCreateSidePaneActionForEntity (Název, ID podokna, Název podokna, Název entity, ID entity)

Parametr Type Požadováno Description
Titulek Řetězcové Ano Název, který se zobrazuje pro akci.
ID podokna Řetězcové Ano ID nového bočního panelu.
Název podokna Řetězcové Ano Název, který se má zobrazit pro boční podokno.
Název entity Řetězcové Ano Logický název entity.
ID entity Řetězcové Ano ID záznamu entity, která se má otevřít v bočním podokně.

XCreateSidePaneActionForEntityList

XCreateSidePaneActionForEntityList (Název, ID podokna, Název podokna, Název entity)

Parametr Type Požadováno Description
Titulek Řetězcové Ano Název, který se zobrazuje pro akci.
ID podokna Řetězcové Ano ID nového bočního panelu.
Název podokna Řetězcové Ano Název, který se má zobrazit pro boční podokno.
Název entity Řetězcové Ano Logický název entity, která se má otevřít jako seznam v postranním podokně.

XCreateTeamsChatAction

XCreateTeamsChatAction (Název, ID chatu, ID členů, ID záznamu, Název entity, Počáteční zpráva)

Parametr Type Požadováno Description
Titulek Řetězcové Ano Název, který se zobrazuje pro akci.
ID chatu Řetězcové No Pokud otevíráte existující chat, ID relace chatu, která se má otevřít.
ID členů Identifikátor GUID No Pokud vytváříte nový chat, pole hodnot ID objektů Microsoft Entra účastníků, kteří mají být zahrnuti do chatu.
ID záznamu Identifikátor GUID No Při propojování se záznamem Dynamics 365 ID záznamu, ke kterému má být chat propojen.
Název entity Řetězcové No Při propojování se záznamem Dynamics 365 logický název entity záznamu, ke kterému má být chat propojen.
Úvodní zpráva Řetězcové No Úvodní zpráva nového chatu.

Příklady

Oznámení v aplikaci s názvem, příjemcem a tělem

Následující odešle jednoduché oznámení v aplikaci příjemci s názvem a tělem. Nezahrnuje žádné akce a používá výchozí hodnoty pro všechny ostatní parametry.

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

Oznámení v aplikaci se dvěma akcemi

Následující vzorový příklad lze použít s automatickým modulem plug-in při vytvoření nového záznamu úkolu. Vzorec je navržen tak, aby odeslal oznámení v aplikaci vlastníkovi záznamu úkolu. Karta oznámení obsahuje dvě akce, které může vlastník provést:

  • Akce postranní podokno otevře nový záznam úlohy v postranním podokně.
  • Akce Chat Teams zahájí chat Teams s vlastníkem záznamu účtu, který je přiřazen jako záznam tabulky Ohledně pro nový úkol. Je důležité poznamenat, že to předpokládá, že byl v poli úkolu vybrán záznam účtu.
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
		)
	]
)