Bendrinti naudojant

XSendAppNotification ir susijusios veiksmų funkcijos (peržiūros versija)

  • Straipsnis

Taikoma: drobės programoms Modeliu pagrįstoms programoms

[Šis straipsnis yra negalutinio leidimo dokumentacija ir gali keistis.]

Siųskite gavėjui pranešimą programoje su pasirenkamais veiksmais.

Svarbu

  • Tai yra peržiūros versijos funkcija.
  • Peržiūros versija funkcijos nėra skirtos naudoti gamybai, jų funkcijos gali būti ribotos ir gali labai pasikeisti prieš išleidžiant. Šias funkcijas galima naudoti prieš oficialų išleidimą, kad klientai galėtų gauti ankstyvą prieigą ir pateikti atsiliepimų.
  • Kad būtų lengviau jas identifikuoti kaip peržiūros versija funkcijas, kiekviena funkcija yra priešdėlis X . Išleidus, X reikės pašalinti iš visų formulių, kuriose naudojamos šios funkcijos, ir argumentų, atnaujintų dėl bet kokių funkcijų pakeitimų.
  • Šias funkcijas galima naudoti tik su Dataverse bazinės programavimo žinios papildiniais.

Aprašą

" XSendAppNotification " funkcija naudojama pranešimams programoje siųsti gavėjui. Šie pranešimai rodomi kaip tostas arba programos naudotojo pranešimų centre. Daugiau informacijos rasite Pranešimų programoje siuntimas modeliu pagrįstose programose.

Be to, pranešime programoje pranešimų kortelė gali būti nuo nulio iki daugelio veiksmų. Norėdami pridėti veiksmų prie programos pranešimų kortelė, šios funkcijos naudojamos kaip parametrai XSendAppNotification funkcijoje. Daugiau informacijos apie kiekvieną veiksmo tipą rasite Pranešimo veiksmai.

  • "XCreateUrlAction": prie pranešimų kortelė pridedamas URL veiksmas.
  • "XCreateSidePaneActionForDashboard": įtraukia šoninės srities veiksmą, kuris pereina į puslapį, kurio tipas yra šoninėje dashboard srityje.
  • XCreateSidePaneActionForEntity: įtraukia šoninės srities veiksmą, kuris pereina į puslapį, kurio tipas yra šoninėje entityrecord srityje.
  • XCreateSidePaneActionForEntityList: įtraukia šoninės srities veiksmą, kuris pereina į puslapį, kurio tipas yra šoninėje entitylist srityje.
  • "XCreateTeamsChatAction": prie pranešimų kortelė prideda "Teams" pokalbio veiksmą.

Sintaksė

XSendAppNotification

XSendAppNotification(pavadinimas, gavėjas , kūnas, veiksmai, piktogramos tipas, skrudintos duonos tipas , galiojimo laikas, prioritetas)

Parametras Tipas Privalomas Aprašą
Antraštė String Taip Programos pranešimo pavadinimas.
Gavėjas Entity Taip Subjektas, kuris systemuser yra pranešimo gavėjas.
Pranešimo tekstas String No Notifikavimo įstaiga.
Veiksmai Funkcija No Veiksmų funkcijų masyvas, skirtas pridėti veiksmus prie pranešimo.
Piktogramos tipas Int No Piktogramos tipo pasirinkimo sąrašo reikšmė (informacija, sėkmė, nesėkmė, įspėjimas, paminėjimas, pasirinktinis).
Programos tipas Int No Skrebučio tipo išrinkimo sąrašo reikšmė (laikas ir paslėptas).
Galiojimo laikas Int No Sekundžių, nuo kurių turi būti panaikintas pranešimas, skaičius, jei jis dar neatmestas.
Pirmumas Int No Pranešimo prioriteto išrinkimo sąrašo reikšmė (įprasta arba didelė).

XCreateUrlAction

XCreateUrlAction(pavadinimas, URL, naršymo tikslas)

Parametras Tipas Privalomas Aprašą
Antraštė String Taip Pavadinimas, rodomas veiksmui.
URL String Taip URL, kuris turi būti atidarytas pasirinkus veiksmą.
Navigacijos paskirties vieta String No Nurodo, kur atidaromas naršymo susieti. Parinktys yra šios:
  • dialog: atidaroma centriniame dialogo lange.
  • inline:Numatytasis. Atidaroma dabartiniame puslapyje.
  • newWindow: atidaroma naujame naršyklės skirtuke.

XCreateSidePaneActionForDashbaord

"XCreateSidePaneActionForDashboard "(pavadinimas, srities ID, srities pavadinimas , ataskaitų srities ID)

Parametras Tipas Privalomas Aprašą
Antraštė String Taip Pavadinimas, rodomas veiksmui.
Srities ID String Taip Naujos šoninės srities ID.
Srities pavadinimas String Taip Šoninės srities rodomas pavadinimas.
Ataskaitų srities ID GUID Taip Prietaisų skydelio, kuris atidaromas šoninėje srityje, ID.

XCreateSidePaneActionForEntity

"XCreateSidePaneActionForEntity "(pavadinimas, srities ID, srities pavadinimas, objekto pavadinimas, objekto ID)

Parametras Tipas Privalomas Aprašą
Antraštė String Taip Pavadinimas, rodomas veiksmui.
Srities ID String Taip Naujos šoninės srities ID.
Srities pavadinimas String Taip Šoninės srities rodomas pavadinimas.
Objekto pavadinimas String Taip Loginis objekto pavadinimas.
Objekto ID String Taip Objekto įrašo, kuris turi būti atidarytas šoninėje srityje, ID.

XCreateSidePaneActionForEntityList

XCreateSidePaneActionForEntityList( pavadinimas, srities ID, srities pavadinimas , objekto pavadinimas )

Parametras Tipas Privalomas Aprašą
Antraštė String Taip Pavadinimas, rodomas veiksmui.
Srities ID String Taip Naujos šoninės srities ID.
Srities pavadinimas String Taip Šoninės srities rodomas pavadinimas.
Objekto pavadinimas String Taip Loginis objekto, kuris atidaromas kaip sąrašas šoninėje srityje, pavadinimas.

XCreateTeamsChatAction

"XCreateTeamsChatAction " (pavadinimas, pokalbio ID, nario ID, įrašo ID, objekto pavadinimas, pradinis pranešimas)

Parametras Tipas Privalomas Aprašą
Antraštė String Taip Pavadinimas, rodomas veiksmui.
Pokalbio ID String No Jei atidarote esamą pokalbį, atidaromo pokalbio seanso ID.
Nario ID GUID No Jei kuriate naują pokalbį, į pokalbį bus įtrauktas dalyvių objekto ID reikšmių masyvas Microsoft Entra .
Įrašo ID GUID No Jei susiejama su "Dynamics 365"" įrašu, įrašo, su kuriuo pokalbis turi būti susietas, ID.
Objekto pavadinimas String No Jei susiejama su "Dynamics 365"" įrašu, įrašo objekto, su kuriuo turėtų būti susietas pokalbis, loginis pavadinimas.
Pradinis pranešimas String No Įvadinė naujo pokalbio žinutė.

Pavyzdžiai

Pranešimas programoje su pavadinimu, gavėju ir įstaiga

Toliau pateikiamas paprastas pranešimas programoje gavėjui su pavadinimu ir turiniu. Jame nėra jokių veiksmų ir naudojamos visų kitų parametrų numatytosios reikšmės.

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

Pranešimas programoje su dviem veiksmais

Toliau pateiktą formulės pavyzdį galima naudoti su automatiniu papildiniu, kai sukuriamas naujas užduoties įrašas. Formulė skirta siųsti pranešimą programoje užduoties įrašo savininkui. Pranešimo kortelė yra du veiksmai, kurių savininkas gali imtis:

  • Šoninės srities veiksmas, atidaro naują užduoties įrašą šoninėje srityje.
  • " Teams" pokalbio veiksmas inicijuoja "Teams" pokalbį su paskyros įrašo, priskirto kaip naujos užduoties lentelės įrašui Dėl , savininku. Svarbu įsidėmėti, kad daroma prielaida, jog užduoties lauke pasirinktas kliento įrašas.
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
		)
	]
)