Deli putem

KSSendAppNotification i srodne akcione funkcije (verzija za pregled)

  • Članak

Odnosi se na: Canvas aplikacije Aplikacije zasnovane na modelu

[Ovaj članak predstavlja preliminarnu dokumentaciju i može se promeniti.]

Pošaljite obaveštenje u aplikaciji sa opcionim akcijama primaocu.

Važno

  • Ovo je preliminarna funkcija.
  • Funkcije verzija za pregled nisu namenjene za upotrebu u proizvodnji, mogu imati ograničenu funkcionalnost i mogu se značajno promeniti pre objavljivanja. Ove funkcije su dostupne pre zvaničnog objavljivanja kako bi klijenti mogli ranije da im pristupe i pruže povratne informacije.
  • Da biste ih identifikovali kao verzija za pregled, svaka funkcija ima prefiks sa X. Nakon objavljivanja , Ks će morati da bude uklonjen iz bilo koje formule koja koristi ove funkcije i argumente ažurirane za bilo kakve promene funkcije.
  • Ove funkcije se mogu koristiti samo sa Dataverse dodatcima sa nisko kodiranje.

Opis

Funkcija KSSendAppNotification se koristi za slanje obaveštenja unutar aplikacije primaocu. Ova obaveštenja se pojavljuju ili kao tost ili u centru za obaveštenja za korisnika aplikacije. Za više informacija, pogledajte Slanje obaveštenja u aplikaciji u okviru aplikacija zasnovanih na modelu.

Pored toga, obaveštenje u aplikaciji može uključivati nula do mnogih akcija na kartici obaveštenja. Da biste dodali akcije na kartica obaveštenja aplikacije, sledeće funkcije se koriste kao parametri u funkciji KSSendAppNotification . Za više informacija o svakom tipu akcije, pogledajte Akcije obaveštenja.

  • XCreateUrlAction: Dodaje URL akciju na kartica obaveštenja.
  • XCreateSidePaneActionForDashboard: Dodaje akciju bočnog okna koja se kreće na stranicu sa tipom dashboard unutar bočnog okna.
  • XCreateSidePaneActionForEntity: Dodaje akciju bočnog okna koja navigira na stranicu sa tipom entityrecord unutar bočnog okna.
  • XCreateSidePaneActionForEntityList: Dodaje akciju bočnog okna koja navigira na stranicu sa tipom entitylist unutar bočnog panela.
  • KSCreateTeamsChatAction: Dodaje akciju ćaskanja Teams na kartica obaveštenja.

Sintaksa

XSendAppNotification

KSSendAppNotification(Naslov, Primalac , Telo, Akcije, Tip ikone, Tip tosta, Istek, Prioritet)

Parametar Tip Zahtevano Opis
Titula String Da Naslov obaveštenja aplikacije.
Primalac Entity Da Entitet systemuser koji je primalac obaveštenja.
Body String No Telo za obaveštenje.
Akcije Function No Niz akcionih funkcija za dodavanje akcija ot obaveštenja.
Tip ikone Int No Vrednost liste za izbor za tip ikone (informacije, uspeh, neuspeh, upozorenje, pominjanje, običaj).
Tip kratke poruke Int No Vrednost liste za izbor za vrstu tosta (vremenski u odnosu na skriveno).
Rok važenja Int No Broj sekundi od kada bi obaveštenje trebalo izbrisati ako već nije odbačeno.
Prioritet Int No Vrednost liste za izbor za prioritet obaveštenja (normalno ili visoko).

Srpskohrvatski / srpskohrvatski

XCreateUrlAction (Title,URL,Navigation Target)

Parametar Tip Zahtevano Opis
Titula String Da Naslov koji se prikazuje za akciju.
URL adresa String Da URL koji će se otvoriti kada je akcija izabrana.
Navigacija Meta String No Definiše gde se otvara navigaciona veza. Opcije su:
  • dialog: Otvara se u dijalogu centra.
  • inline:Podrazumevani. Otvara se na trenutnoj stranici.
  • newWindow: Otvara se na novoj kartici pregledača.

Srpskohrvatski / srpskohrvatski

KSCreateSidePaneActionForDashboard (Naslov, ID okna, Naslov okna, ID kontrolne table)

Parametar Tip Zahtevano Opis
Titula String Da Naslov koji se prikazuje za akciju.
Panel ID String Da ID novog bočnog okna.
Pane Naslov String Da Naslov koji se prikazuje za bočni panel.
ID kontrolne table GUID Da ID kontrolne table za otvaranje u bočnom oknu.

XCreateSidePaneActionForEntity

XCreateSidePaneActionForEntity (Naslov, ID okna, Naslov okna, Ime entiteta, ID entiteta)

Parametar Tip Zahtevano Opis
Titula String Da Naslov koji se prikazuje za akciju.
Panel ID String Da ID novog bočnog okna.
Pane Naslov String Da Naslov koji se prikazuje za bočni panel.
Naziv entiteta String Da Logičko ime entiteta.
ID entiteta String Da ID zapisa entiteta koji se otvara u bočnom oknu.

XCreateSidePaneActionForEntityList

XCreateSidePaneActionForEntityList (Title,Pane ID,Pane Title,Naziv entiteta)

Parametar Tip Zahtevano Opis
Titula String Da Naslov koji se prikazuje za akciju.
Panel ID String Da ID novog bočnog okna.
Pane Naslov String Da Naslov koji se prikazuje za bočni panel.
Naziv entiteta String Da Logičko ime entiteta koji se otvara kao lista u bočnom panelu.

Srpskohrvatski / srpskohrvatski

KSCreateTeamsChatAction (Naslov, ID za ćaskanje, ID članova, ID zapisa, ime entiteta, početna poruka)

Parametar Tip Zahtevano Opis
Titula String Da Naslov koji se prikazuje za akciju.
ID ćaskanja String No Ako otvarate postojeći ćaskanje, ID sesije ćaskanja da se otvori.
ID član-ova GUID No Ako kreirate novi chat, niz Microsoft Entra vrednosti ID objekta učesnika koji će biti uključeni u ćaskanje.
ID zapisa GUID No Ako se povežete sa Dynamics 365 zapisom, ID zapisa na koji treba da bude povezan ćaskanje.
Naziv entiteta String No Ako se povežete sa zapisom Dynamics 365, logičko ime entiteta zapisa na koji treba da bude povezano ćaskanje.
Inicijalna poruka String No Uvodna poruka novog ćaskanja.

Primeri

Obaveštenje u aplikaciji sa naslovom, primaocem i telom

Sledeće šalje jednostavno obaveštenje u aplikaciji primaocu sa naslovom i telom. Ne uključuje nikakve akcije i koristi podrazumevane vrednosti za sve ostale parametre.

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

Obaveštenje u aplikaciji sa dve akcije

Sledeći primer formule može se koristiti sa automatizovanim dodatkom kada se kreira novi zapis zadatka. Formula je dizajnirana da pošalje obaveštenje u aplikaciji vlasniku zapisa zadatka. Obaveštenje kartica sadrži dve radnje koje vlasnik može da preduzme:

  • Akcija bočnog panela , otvara novi zapis zadatka u bočnom oknu.
  • Akcija ćaskanja Teams-a , pokreće Teams ćaskanje sa vlasnikom zapisa računa koji je dodeljen kao U vezi sa zapisom tabele za novi zadatak. Važno je napomenuti da ovo pretpostavlja da je zapis računa izabran u polju zadataka.
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
		)
	]
)