Kopīgot, izmantojot

XSendAppNotification un saistītās darbības funkcijas (priekšskatījums)

  • Raksts

Attiecas uz: Pamatnes programmām Modeļa vadītas programmas

[Šis raksts ir pirmsizlaides dokumentācija, kas var mainīties.]

Nosūtiet adresātam paziņojumu lietotnē ar neobligātajām darbībām.

Svarīgi

  • Šis ir priekšskatījuma līdzeklis.
  • Priekšskatījums līdzekļi nav paredzēti ražošanas vajadzībām, tiem var būt ierobežota funkcionalitāte un tie var tikt būtiski mainīti pirms izlaišanas. Šie līdzekļi ir pieejami pirms oficiālā laidiena, lai klienti varētu priekšlaikus piekļūt līdzeklim un sniegt atsauksmes.
  • Lai palīdzētu tos identificēt kā priekšskatījums līdzekļus, katras funkcijas prefikss ir X. Pēc izlaišanas X būs jānoņem no visām formulām, kas izmanto šīs funkcijas, un argumenti, kas atjaunināti visām funkciju izmaiņām.
  • Šīs funkcijas var izmantot tikai ar Dataverse mazkoda spraudņiem.

Apraksts

Funkcija XSendAppNotification tiek izmantota, lai nosūtītu paziņojumus lietotnē adresātam. Šie paziņojumi tiek rādīti kā tosts vai lietotnes lietotāja paziņojumu centrā. Papildinformāciju skatiet rakstā Paziņojumu sūtīšana lietotnēs modeļa vadītās programmās.

Turklāt paziņojumā lietotnē var iekļaut nulli līdz daudzām darbībām paziņojumu karte. Lai pievienotu darbības programmas paziņojumu karte, tālāk norādītās funkcijas tiek izmantotas kā parametri funkcijā XSendAppNotification . Papildinformāciju par katru darbības veidu skatiet rakstā Paziņojumu darbības.

  • XCreateUrlAction: pievieno URL darbību paziņojumu karte.
  • XCreateSidePaneActionForDashboard: pievieno sānu rūts darbību, kas naviģē uz lapu, kuras tips dashboard atrodas sānu rūtī.
  • XCreateSidePaneActionForEntity: pievieno sānu rūts darbību, kas naviģē uz lapu, kuras tips entityrecord atrodas sānu rūtī.
  • XCreateSidePaneActionForEntityList: pievieno sānu rūts darbību, kas naviģē uz lapu, kuras tips entitylist atrodas sānu rūtī.
  • XCreateTeamsChatAction: pievieno Teams tērzēšanas darbību paziņojumu karte.

Sintakse

XSendAppNotification

XSendAppNotification(nosaukums, saņēmējs , pamatteksts, darbības, ikonas veids, grauzdiņa veids, derīguma termiņš, prioritāte)

Parametrs Tipi Obligāti Apraksts
Amats String Jā Lietotnes paziņojuma nosaukums.
Adresāts Tabula Jā Struktūra systemuser , kas ir paziņojuma saņēmējs.
Pamatteksts String Nē. Pilnvarotā iestāde.
Darbības Function Nē. Darbību masīvs, kas darbojas, lai pievienotu darbības, kas nav saistītas ar paziņojumu.
Ikonas tips Int Nē. Piksaraksta vērtība ikonas tipam (informācija, veiksme, kļūme, brīdinājums, pieminēšana, pielāgota).
Uznirstošā paziņojuma tips Int Nē. Picklist vērtība grauzdiņa tipam (laiks pret slēpto).
Derīguma beigu laiks Int Nē. Sekunžu skaits, pēc kura ir jādzēš paziņojums, ja tas vēl nav noraidīts.
Prioritāte Int Nē. Paziņojuma prioritātes salasīšanas saraksta vērtība (parasta vai augsta).

XCreateUrlAction

XCreateUrlAction(nosaukums, URL, navigācijas mērķis)

Parametrs Tipi Obligāti Apraksts
Amats String Jā Nosaukums, kas tiek rādīts darbībai.
Vietrādis URL String Jā Vietrādis URL, kas jāatver, atlasot darbību.
Navigācijas mērķis String Nē. Definē, kur tiek atvērta navigācijas saistīt. Iespējas ir šādas:
  • dialog: tiek atvērts centrālajā dialoglodziņā.
  • inline:Noklusējuma. Tiek atvērts pašreizējā lapā.
  • newWindow: tiek atvērts jaunā pārlūkprogrammas cilnē.

XCreateSidePaneActionForDashbaord

XCreateSidePaneActionForDashboard(nosaukums, rūts ID, rūts nosaukums, informācijas paneļa ID)

Parametrs Tipi Obligāti Apraksts
Amats String Jā Nosaukums, kas tiek rādīts darbībai.
Rūts ID String Jā Jaunās sānu rūts ID.
Rūts virsraksts String Jā Virsraksts, kas jārāda sānu rūtī.
Informācijas paneļa ID GUID Jā Tā informācijas paneļa ID, kas jāatver sānu rūtī.

XCreateSidePaneActionForEntity

XCreateSidePaneActionForEntity(nosaukums, rūts ID, rūts nosaukums, entītijas nosaukums, entītijas ID)

Parametrs Tipi Obligāti Apraksts
Amats String Jā Nosaukums, kas tiek rādīts darbībai.
Rūts ID String Jā Jaunās sānu rūts ID.
Rūts virsraksts String Jā Virsraksts, kas jārāda sānu rūtī.
Elementa nosaukums String Jā Entītijas loģiskais nosaukums.
Entītijas ID String Jā Sānu rūtī atveramā entītijas ieraksta ID.

XCreateSidePaneActionForEntityList

XCreateSidePaneActionForEntityList(title, rūts ID, rūts nosaukums, entītijas nosaukums)

Parametrs Tipi Obligāti Apraksts
Amats String Jā Nosaukums, kas tiek rādīts darbībai.
Rūts ID String Jā Jaunās sānu rūts ID.
Rūts virsraksts String Jā Virsraksts, kas jārāda sānu rūtī.
Elementa nosaukums String Jā Entītijas loģiskais nosaukums, kas jāatver kā saraksts sānu rūtī.

XCreateTeamsChatAction

XCreateTeamsChatAction(nosaukums, tērzēšanas ID, dalībnieku ID, ieraksta ID, entītijas nosaukums, sākotnējais ziņojums)

Parametrs Tipi Obligāti Apraksts
Amats String Jā Nosaukums, kas tiek rādīts darbībai.
Tērzēšanas ID String Nē. Ja atverat esošu tērzēšanu, atveramās tērzēšanas sesijas ID.
Dalībnieku ID GUID Nē. Ja izveidojat jaunu tērzēšanu, tērzēšanā iekļaujamo dalībnieku objektu ID vērtību masīvs Microsoft Entra .
Ieraksta ID GUID Nē. Ja veidojat saiti ar Dynamics 365 ierakstu, tā ieraksta ID, ar kuru tērzēšana ir jāsaista.
Elementa nosaukums String Nē. Ja ir saite uz Dynamics 365 ierakstu, tā ieraksta entītijas loģiskais nosaukums, ar kuru tērzēšana ir jāsaista.
Sākotnējais ziņojums String Nē. Jaunās tērzēšanas ievadziņojums.

Piemēri

Lietotnē ietverts paziņojums ar nosaukumu, adresātu un pamattekstu

Tālāk adresātam tiek nosūtīts vienkāršs paziņojums lietotnē ar nosaukumu un pamattekstu. Tas neietver nekādas darbības un izmanto noklusējuma vērtības visiem pārējiem parametriem.

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

Paziņojums lietotnē ar divām darbībām

Tālāk sniegto piemēra formulu var izmantot ar automatizētu spraudni, kad tiek izveidots jauns uzdevuma ieraksts. Formula ir paredzēta, lai nosūtītu paziņojumu lietojumprogrammā uzdevuma ieraksta īpašniekam. Paziņojumā karte ietvertas divas darbības, ko īpašnieks var veikt:

  • Sānu rūts darbība, atver jauno uzdevuma ierakstu sānu rūtī.
  • Teams tērzēšanas darbība, uzsāk Teams tērzēšanu ar tā uzņēmuma ieraksta īpašnieku, kas jaunajam uzdevumam ir piešķirts kā tabulas ieraksts Attiecībā uz. Ir svarīgi atzīmēt, ka tādējādi tiek pieņemts, ka uzdevuma laukā ir atlasīts konta ieraksts.
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
		)
	]
)