XSendAppNotification és kapcsolódó műveleti függvények (előzetes verzió)
A következőkre vonatkozik:
Vászonalapú alkalmazások Modellvezérelt alkalmazások
[Ez a cikk egy előzetes kiadási dokumentáció, amely a későbbiekben változhat.]
Alkalmazáson belüli értesítés küldése opcionális műveletekkel a címzettnek.
Fontos
- Ez egy előnézeti funkció.
- Előzetes verzió funkciók nem éles környezetben használhatók, korlátozott funkciókkal rendelkezhetnek, és jelentősen változhatnak a kiadás előtt. Ezek a funkciók a hivatalos kiadás előtt érhetők el, hogy az ügyfelek korán megismerkedhessenek velük, és visszajelzést adhassanak róluk.
- Annak érdekében, hogy ezeket előzetes verzió jellemzőkként lehessen azonosítani, minden függvény előtagja egy X. Kiadáskor az X-et el kell távolítani minden olyan képletből, amely ezeket a függvényeket használja, és frissíteni kell a függvények módosításaihoz frissített argumentumokat.
- Ezek a funkciók csak a Dataverse kevés kódolást igénylő beépülő modulokkal használhatók.
Description
Az XSendAppNotification függvény segítségével értesítéseket küldhet egy alkalmazáson belül a címzettnek. Ezek az értesítések bejelentésként vagy az alkalmazás felhasználójának értesítési központjában jelennek meg. További információkért lásd: Alkalmazáson belüli értesítések küldése modellvezérelt alkalmazásokon belül.
Ezenkívül az alkalmazáson belüli értesítés nullától több műveletig terjedhet az értesítési kártya. Ha műveleteket szeretne hozzáadni az alkalmazásértesítési kártya, a következő függvények használhatók paraméterként az XSendAppNotification függvényben. Az egyes művelettípusokkal kapcsolatos további információkért lásd: Értesítési műveletek.
- XCreateUrlAction: URL-műveletet ad hozzá az értesítési kártya.
- XCreateSidePaneActionForDashboard: Hozzáad egy oldalsó panel műveletet, amely az oldalsó ablaktáblán belül egy olyan típusú
dashboardoldalra navigál. - XCreateSidePaneActionForEntity: Hozzáad egy oldalsó panel műveletet, amely az oldalsó ablaktáblán belül egy olyan
entityrecordtípusú oldalra navigál. - XCreateSidePaneActionForEntityList: Hozzáad egy oldalsó panel műveletet, amely az oldalsó ablaktáblán belül egy olyan típusú
entitylistoldalra navigál. - XCreateTeamsChatAction: Hozzáad egy Teams csevegési műveletet az értesítési kártya.
Szintaxis
XSendAppNotification
XSendAppNotification (Title, Recipient, Body, Actions, Icon Type, Toast Type, Expiry, Priority)
| Paraméter | Type | Szükséges | Description |
|---|---|---|---|
| Title | Sztring | Igen | Az alkalmazásértesítés címe. |
| Címzett | Entity | Igen | Annak jogi személye systemuser , hogy ki az értesítés címzettje. |
| Body | Sztring | No | A bejelentő szerv. |
| Műveletek | Function | No | A műveletfüggvények tömbje, amellyel műveleteket adhat hozzá az értesítéshez. |
| Ikon típusa | Int | No | Az ikon típusának választási listája (információ, siker, hiba, figyelmeztetés, említés, egyéni). |
| Bejelentés típusa | Int | No | A bejelentés típusának választási lista értéke (időzített vagy rejtett). |
| Lejárat | Int | No | Ennyi másodperc után kell törölni az értesítést, ha még nem vetették el. |
| Prioritás | Int | No | Az értesítés prioritásának választási listájának értéke (normál vagy magas). |
XCreateUrlAction
XCreateUrlAction (cím; URL; navigációs cél)
| Paraméter | Type | Szükséges | Description |
|---|---|---|---|
| Title | Sztring | Igen | A művelethez megjelenő cím. |
| URL-cím | Sztring | Igen | A művelet kiválasztásakor megnyitandó URL-cím. |
| Navigációs cél | Sztring | No | Meghatározza, hogy hol nyíljon meg a navigációs hivatkozás. A lehetőségek a következők:
|
XCreateSidePaneActionForDashbaord
XCreateSidePaneActionForDashboard (Cím, Panelazonosító, Panelcím, Irányítópultazonosító)
| Paraméter | Type | Szükséges | Description |
|---|---|---|---|
| Title | Sztring | Igen | A művelethez megjelenő cím. |
| Ablaktábla azonosítója | Sztring | Igen | Az új oldalpanel azonosítója. |
| Ablaktábla címe | Sztring | Igen | Az oldalsó ablaktáblán megjelenítendő cím. |
| Irányítópult azonosítója | GUID-azonosító | Igen | Az oldalsó panelen megnyitni kívánt irányítópult azonosítója. |
XCreateSidePaneActionForEntity
XCreateSidePaneActionForEntity (Cím, Panelazonosító, Panelcím, Entitásnév, Entitásazonosító)
| Paraméter | Type | Szükséges | Description |
|---|---|---|---|
| Title | Sztring | Igen | A művelethez megjelenő cím. |
| Ablaktábla azonosítója | Sztring | Igen | Az új oldalpanel azonosítója. |
| Ablaktábla címe | Sztring | Igen | Az oldalsó ablaktáblán megjelenítendő cím. |
| Entitásnév | Sztring | Igen | Az entitás logikai neve. |
| Entitásazonosító | Sztring | Igen | Az oldalsó ablaktáblán megnyitandó entitásrekord azonosítója. |
XCreateSidePaneActionForEntityList
XCreateSidePaneActionForEntityList (Cím, Panelazonosító, Panelcím, Entitásnév)
| Paraméter | Type | Szükséges | Description |
|---|---|---|---|
| Title | Sztring | Igen | A művelethez megjelenő cím. |
| Ablaktábla azonosítója | Sztring | Igen | Az új oldalpanel azonosítója. |
| Ablaktábla címe | Sztring | Igen | Az oldalsó ablaktáblán megjelenítendő cím. |
| Entitásnév | Sztring | Igen | Az oldalsó ablaktáblán listaként megnyitni kívánt entitás logikai neve. |
XCreateTeamsChatAction
XCreateTeamsChatAction (Cím, csevegésazonosító, tagazonosítók, rekordazonosító, entitásnév, kezdeti üzenet)
| Paraméter | Type | Szükséges | Description |
|---|---|---|---|
| Title | Sztring | Igen | A művelethez megjelenő cím. |
| Csevegés azonosítója | Sztring | No | Meglévő csevegés megnyitásakor a megnyitandó csevegési munkamenet azonosítója. |
| Tagok azonosítói | GUID-azonosító | No | Új csevegés létrehozásakor a csevegésbe felvenni kívánt résztvevők objektumazonosító értékeinek tömbje Microsoft Entra . |
| Rekordazonosító | GUID-azonosító | No | Ha Dynamics 365 rekordhoz csatol, annak a rekordnak az azonosítója, amelyhez a csevegést csatolni kell. |
| Entitásnév | Sztring | No | Ha Dynamics 365 rekordhoz kapcsolódik, annak a rekordnak az entitásának logikai neve, amelyhez a csevegést csatolni kell. |
| Kezdeti üzenet | Sztring | No | Az új csevegés bevezető üzenete. |
Példák
Alkalmazáson belüli értesítés címmel, címzettel és szövegszabállyal
Az alábbiakban egy egyszerű, alkalmazáson belüli értesítést küld a címzettnek címmel és szöveggel. Nem tartalmaz műveleteket, és az összes többi paraméter alapértelmezett értékeit használja.
XSendAppNotification(
"Welcome",
LookUp(Users, 'Primary Email'="<User's email address>"),
"Welcome to the world of in-app notifications!"
)
Alkalmazáson belüli értesítés két művelettel
A következő példaképlet használható egy automatikus beépülő modullal új feladatrekord létrehozásakor. A képlet célja, hogy alkalmazáson belüli értesítést küldjön a feladatrekord tulajdonosának. Az értesítési kártya két műveletet tartalmaz, amelyeket a tulajdonos elvégezhet:
- Az oldalsó ablaktábla művelete megnyitja az új feladatrekordot egy oldalsó ablaktáblán.
- A Teams csevegési művelet, Teams-csevegést kezdeményez az új feladat Kapcsolódó elemek táblarekordjaként hozzárendelt partnerrekord tulajdonosával. Fontos megjegyezni, hogy ez feltételezi, hogy partnerrekord van kiválasztva a tevékenységmezőben.
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
)
]
)