XSendAppNotification in povezane funkcije dejanj (predogledna različica)
Velja za: Aplikacije Canvas Aplikacije, ki temeljijo na modelu
[Ta članek je del predizdajne dokumentacije in se lahko spremeni.]
Pošljite obvestilo v aplikaciji z izbirnimi dejanji prejemniku.
Pomembno
- To je funkcija predogleda.
- Funkcije predogledna različica niso namenjene produkcijski uporabi, morda imajo omejeno funkcionalnost in se lahko bistveno spremenijo pred izdajo. Te funkcije so na voljo še pred uradno izdajo, da lahko stranke predčasno dostopajo do njih in posredujejo povratne informacije.
- Za lažjo identifikacijo teh funkcij predogledna različica ima vsaka funkcija predpono X. Po izdaji bo treba X odstraniti iz vseh formul, ki uporabljajo te funkcije, in argumente posodobiti za morebitne spremembe funkcij.
- Te funkcije je mogoče uporabljati samo z vtičniki Dataverse z malo programske kode.
Description
Funkcija XSendAppNotification se uporablja za pošiljanje obvestil prejemniku znotraj aplikacije. Ta obvestila se uporabniku aplikacije prikažejo kot zdravica ali znotraj centra za obvestila. Za več informacij glejte Pošiljanje obvestil v aplikaciji znotraj aplikacij, ki temeljijo na modelu.
Poleg tega lahko obvestilo v aplikaciji vključuje od nič do veliko dejanj na obvestilu kartica. Za dodajanje dejanj k obvestilu aplikacije kartica se naslednje funkcije uporabljajo kot parametri v funkciji XSendAppNotification . Za več informacij o vsaki vrsti dejanj glejte Dejanja obveščanja.
- XCreateUrlAction: obvestilu kartica doda dejanje URL.
-
XCreateSidePaneActionForDashboard: doda dejanje stranskega podokna, ki se pomakne na stran z vrsto
dashboard
znotraj stranskega podokna. -
XCreateSidePaneActionForEntity: doda dejanje stranskega podokna, ki se pomakne na stran z vrsto
entityrecord
znotraj stranskega podokna. -
XCreateSidePaneActionForEntityList: doda dejanje stranskega podokna, ki se pomakne na stran z vrsto
entitylist
znotraj stranskega podokna. - XCreateTeamsChatAction: obvestilu kartica doda dejanje klepeta Teams.
Sintaksa
XSendAppNotification
XSendAppNotification (Naslov, Prejemnik, Telo, Dejanja, Vrsta ikone, Vrsta zdravice, Iztek, Prednost)
Parameter | Vnesi | Zahtevano | Description |
---|---|---|---|
Naziv | String | Da | Naslov obvestila aplikacije. |
Prejemnik | Entity | Da | Subjekt systemuser ki je prejemnik obvestila. |
Telo | String | No | Priglasitveni organ. |
Dejanja | Function | No | Niz funkcij dejanj za dodajanje dejanj k obvestilu. |
Vrsta ikone | Int | No | Vrednost izbirnega seznama za vrsto ikone (informacije, uspeh, neuspeh, opozorilo, omemba, po meri). |
Vrsta pojavnega obvestila | Int | No | Vrednost izbirnega seznama za vrsto zdravice (časovno ali skrito). |
Potek | Int | No | Število sekund od takrat, ko naj se obvestilo izbriše, če še ni opuščeno. |
Prednost | Int | No | Vrednost izbirnega seznama za prioriteto obvestila (normalna ali visoka). |
XCreateUrlAction
XCreateUrlAction (Naslov, URL, Navigacijski cilj )
Parameter | Vnesi | Zahtevano | Description |
---|---|---|---|
Naziv | String | Da | Naslov, ki se prikaže za dejanje. |
URL | String | Da | URL, ki se odpre, ko je izbrano dejanje. |
Navigacijski cilj | String | No | Določa, kje se odpre navigacijska povezava. Možnosti so:
|
XCreateSidePaneActionForDashbaord
XCreateSidePaneActionForDashboard (Naslov, ID podokna, Podokno Naslov, ID nadzorne plošče)
Parameter | Vnesi | Zahtevano | Description |
---|---|---|---|
Naziv | String | Da | Naslov, ki se prikaže za dejanje. |
ID podokna | String | Da | ID novega stranskega podokna. |
Naslov podokna | String | Da | Naslov za prikaz stranskega podokna. |
ID nadzorne plošče | GUID | Da | ID nadzorne plošče, ki se odpre v stranskem podoknu. |
XCreateSidePaneActionForEntity
XCreateSidePaneActionForEntity (Naslov, ID podokna, Podokno Naslov, Ime subjekta, ID subjekta)
Parameter | Vnesi | Zahtevano | Description |
---|---|---|---|
Naziv | String | Da | Naslov, ki se prikaže za dejanje. |
ID podokna | String | Da | ID novega stranskega podokna. |
Naslov podokna | String | Da | Naslov za prikaz stranskega podokna. |
Ime entitete | String | Da | Logično ime entitete. |
ID entitete | String | Da | ID zapisa entitete, ki se odpre v stranskem podoknu. |
XCreateSidePaneActionForEntityList
XCreateSidePaneActionForEntityList (Naslov, ID podokna, Podokno Naslov, Ime subjekta)
Parameter | Vnesi | Zahtevano | Description |
---|---|---|---|
Naziv | String | Da | Naslov, ki se prikaže za dejanje. |
ID podokna | String | Da | ID novega stranskega podokna. |
Naslov podokna | String | Da | Naslov za prikaz stranskega podokna. |
Ime entitete | String | Da | Logično ime entitete, ki se odpre kot seznam v stranskem podoknu. |
XCreateTeamsChatAction
XCreateTeamsChatAction (Naziv, ID klepeta, Član ID-ji, ID zapisa, Ime entitete, Začetno sporočilo)
Parameter | Vnesi | Zahtevano | Description |
---|---|---|---|
Naziv | String | Da | Naslov, ki se prikaže za dejanje. |
ID klepeta | String | No | Če odprete obstoječi klepet, ID klepeta, ki ga želite odpreti. |
ID-ji članov | GUID | No | Če ustvarite nov klepet, niz vrednosti Microsoft Entra Object ID udeležencev, ki bodo vključeni v klepet. |
ID zapisa | GUID | No | Pri povezovanju z zapisom Dynamics 365 ID zapisa, s katerim naj bo klepet povezan. |
Ime entitete | String | No | Pri povezovanju z zapisom Dynamics 365 logično ime entitete zapisa, s katerim naj bo klepet povezan. |
Začetno sporočilo | String | No | Uvodno sporočilo novega klepeta. |
Primeri
Obvestilo v aplikaciji z naslovom, prejemnikom in telesom
Naslednje pošlje preprosto obvestilo v aplikaciji prejemniku z naslovom in telesom. Ne vključuje nobenih dejanj in uporablja privzete vrednosti za vse druge parametre.
XSendAppNotification(
"Welcome",
LookUp(Users, 'Primary Email'="<User's email address>"),
"Welcome to the world of in-app notifications!"
)
Obvestilo v aplikaciji z dvema dejanjema
Naslednji primer formule je mogoče uporabiti s samodejnim vtičnikom, ko je ustvarjen nov zapis opravila. Formula je zasnovana za pošiljanje obvestila v aplikaciji lastniku zapisa opravila. Obvestilo kartica vsebuje dve dejanji, ki ju lahko izvede lastnik:
- Dejanje stranskega podokna odpre nov zapis opravila v stranskem podoknu.
- A Dejanje klepeta Teams , sproži klepet Teams z lastnikom zapisa računa, ki je dodeljen kot Glede zapis tabele za novo nalogo. Pomembno je vedeti, da to predpostavlja, da je bil v polju opravil izbran zapis računa.
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
)
]
)