XSendAppNotification ja siihen liittyvät toimintofunktiot (esiversio)

Koskee seuraavia: pohjaan perustuvat sovellukset Mallipohjaiset sovellukset

[Tämä artikkeli sisältää julkaisua edeltävää materiaalia ja voi muuttua.]

Lähetä vastaanottajalle sovelluksensisäinen ilmoitus, joka sisältää valinnaisia toimintoja.

Tärkeää

• Tämä on esiversiotoiminto.
• Esiversion ominaisuuksia ei ole tarkoitettu tuotantokäyttöön, niiden toiminnallisuus voi olla rajallinen ja ne voivat muuttua merkittävästi ennen julkaisua. Nämä toiminnot ovat käytettävissä ennen virallista julkaisua, jotta asiakkaat voivat käyttää niiden ennakkojulkaisua ja antaa palautetta.
• Jotta nämä funktiot olisi helpompi tunnistaa esiversio-ominaisuuksiksi, kullakin niistä on etuliitteenä X. Julkaisun jälkeen x on poistettava kaikista kaavoista, jotka käyttävät näitä funktiomuutoksia vastaavasti päivitettyjä funktioita ja argumentteja.
• Näitä funktioita voi käyttää vain yhdessä Dataversen vähäisen koodin laajennusten kanssa.

Description

Funktiota XSendAppNotification käytetään lähettämään vastaanottajille ilmoituksia sovelluksen sisällä. Nämä ilmoitukset näkyvät sovelluksen käyttäjälle joko ruutuina tai ilmoituskeskuksessa. Lisätietoja on ohjeaiheessa Sovelluksen sisäisten ilmoitusten lähettäminen mallipohjaisissa sovelluksissa.

Lisäksi sovelluksen sisäisen ilmoituksen ilmoituskortissa voi olla useita toimintoja tai ei toimintoja lainkaan. Toimintoja lisätään sovelluksen ilmoituskorttiin käyttämällä seuraavia funktioita parametreina XSendAppNotification-funktiossa. Lisätietoja kustakin toimintotyypistä: Ilmoitustoiminnot.

• XCreateUrlAction: Lisää URL-toiminnon ilmoituksen kortti.
• XCreateSidePaneActionForDashboard: Lisää sivuruututoiminnon, joka siirtyy sivulle, jonka tyyppi on sivuruudussa dashboard .
• XCreateSidePaneActionForEntity: Lisää sivuruututoiminnon, joka siirtyy sivulle, jonka tyyppi on sivuruudussa entityrecord .
• XCreateSidePaneActionForEntityList: Lisää sivuruututoiminnon, joka siirtyy sivulle, jonka tyyppi on sivuruudussa entitylist .
• XCreateTeamsChatAction: Lisää Teams-keskustelutoiminnon ilmoitus kortti.

Syntaksi

XSendAppNotification

XSendAppNotification (otsikko, vastaanottaja, runko, toiminnot, kuvakkeen tyyppi, ilmoitusruudun tyyppi, vanhentuminen, prioriteetti)

Parametri	Type	Pakolliset	Description
Title	String	Kyllä	Sovellusilmoituksen otsikko.
Vastaanottaja	Entity	Kyllä	Ilmoituksen vastaan ottavan systemuser-käyttäjän entiteetti.
Body	String	No	Ilmoituksen teksti.
Toiminnot	Function	No	Niiden toimintofunktioiden matriisi, joilla ilmoitukseen lisätään toimintoja.
Kuvakkeen tyyppi	Int	No	Kuvaketyypin valintaluetteloarvo (tiedot, onnistuminen, virhe, varoitus, maininta, mukautettu).
Ilmoitusruudun tyyppi	Int	No	Ruututyypin valintaluettelon arvo (ajoitettu tai piilotettu).
Vanhentuminen	Int	No	Aika (sekunteina), jonka kuluttua ilmoitus on poistettava, jos sitä ei ole vielä ohitettu.
Prioriteetti	Int	No	Ilmoituksen prioriteetin valintaluetteloarvo (normaali tai korkea).

XCreateUrlAction

XCreateUrlAction (otsikko,URL,siirtymiskohde )

Parametri	Type	Pakolliset	Description
Title	String	Kyllä	Toiminnolle näytettävä otsikko.
URL	String	Kyllä	URL-osoite, joka avataan, kun toiminto valitaan.
Siirtymisen kohde	String	No	Määrittää, missä siirtymislinkki avautuu. Vaihtoehdot ovat seuraavat: dialog: Avaa keskimmäisessä valintaikkunassa. inline:Laiminlyönti. Avautuu kulloisellakin sivulla. newWindow: Avautuu uuteen selaimen välilehteen.

XCreateSidePaneActionForDashbaord

XCreateSidePaneActionForDashboard(otsikko, ruudun tunnus , ruudun otsikko, koontinäytön tunnus)

Parametri	Type	Pakolliset	Description
Title	String	Kyllä	Toiminnolle näytettävä otsikko.
Ruudun tunnus	String	Kyllä	Uuden sivuruudun tunnus.
Ruudun otsikko	String	Kyllä	Sivuruudulle näytettävä otsikko.
Koontinäytön tunnus	GUID	Kyllä	Sivuruudussa avattavan koontinäytön tunnus.

XCreateSidePaneActionForEntity

XCreateSidePaneActionForEntity (otsikko, ruudun tunnus , ruudun otsikko, entiteetin nimi, entiteetin tunnus )

Parametri	Type	Pakolliset	Description
Title	String	Kyllä	Toiminnolle näytettävä otsikko.
Ruudun tunnus	String	Kyllä	Uuden sivuruudun tunnus.
Ruudun otsikko	String	Kyllä	Sivuruudulle näytettävä otsikko.
Entiteetin nimi	String	Kyllä	Entiteetin looginen nimi.
Entiteettitunnus	String	Kyllä	Sivuruudussa avattavan entiteettitietueen tunnus.

XCreateSidePaneActionForEntityList

XCreateSidePaneActionForEntityList (otsikko, ruudun tunnus , ruudun otsikko, entiteetin nimi)

Parametri	Type	Pakolliset	Description
Title	String	Kyllä	Toiminnolle näytettävä otsikko.
Ruudun tunnus	String	Kyllä	Uuden sivuruudun tunnus.
Ruudun otsikko	String	Kyllä	Sivuruudulle näytettävä otsikko.
Entiteetin nimi	String	Kyllä	Sivuruudussa luettelona avattavan entiteetin looginen nimi.

XCreateTeamsChatAction

XCreateTeamsChatAction(otsikko, keskustelutunnus , jäsentunnukset, tietuetunnus, entiteetin nimi, alkuperäinen viesti)

Parametri	Type	Pakolliset	Description
Title	String	Kyllä	Toiminnolle näytettävä otsikko.
Keskustelun tunnus	String	No	Jos avaat olemassa olevan keskustelun, tämä on avattavan keskusteluistunnon tunnus.
Jäsenten tunnukset	GUID	No	Jos luot uuden keskustelun, tämä on keskustelun osallistujien Microsoft Entra -objektitunnusten matriisi.
Tietuetunnus	GUID	No	Jos luot linkin Dynamics 365 -tietueeseen, tämä on sen tietueen tunnus, johon keskustelu linkitetään.
Entiteetin nimi	String	No	Jos luot linkin Dynamics 365 -tietueeseen, tämä on sen tietueen entiteetin looginen nimi, johon keskustelu linkitetään.
Ensimmäinen viesti	String	No	Uuden keskustelun johdantoviesti.

Esimerkkejä

Sovelluksensisäinen ilmoitus, jolla on otsikko, vastaanottaja ja teksti

Seuraava lähettää yksinkertaisen otsikon ja tekstin sisältävän sovelluksensisäisen ilmoituksen vastaanottajalle. Se ei sisällä toimintoja, ja siinä käytetään oletusarvoja kaikkien muiden parametrien osalta.

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

Kaksi toimintoa sisältävä sovelluksensisäinen imoitus

Seuraavaa esimerkkikaavaa voidaan käyttää automaattisen laajennuksen kanssa uutta tehtävätietuetta luotaessa. Kaava on suunniteltu lähettämään sovelluksensisäinen ilmoitus tehtävätietueen omistajalle. Ilmoituskortti sisältää kaksi toimintoa, jotka omistaja voi suorittaa:

• Sivuruutu-toiminto avaa uuden tehtävätietueen sivuruudussa.
• Teams-keskustelu-toiminto käynnistää Teams-keskustelun sen tilitietueen omistajan kanssa, joka on määritetty uuden tehtävän Aihe-taulukoksi. On tärkeää ottaa huomioon, että tässä oletetaan, että tilitietue on valittu tehtäväkentässä.

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
		)
	]
)