XSendAppNotification en gerelateerde actiefuncties (preview)

  • Artikel

Van toepassing op: Canvas-apps Modelgestuurde apps

[Dit artikel maakt deel uit van de voorlopige documentatie en kan nog veranderen.]

Verzend een in-app-melding met optionele acties naar een ontvanger.

Belangrijk

  • Dit is een preview-functie.
  • Preview-functies zijn niet bedoeld voor productiegebruik, bieden mogelijk alleen beperkte functionaliteit en kunnen ingrijpende wijzigingen ondergaan vóór vrijgave. Deze functies zijn beschikbaar vóór een officiële release zodat klanten vroeg toegang kunnen krijgen en feedback kunnen geven.
  • Om deze te helpen identificeren als preview-functies, wordt elke functie voorafgegaan door een X. Bij de vrijgave moet de X worden verwijderd uit alle formules die deze functies gebruiken en moeten argumenten worden bijgewerkt voor eventuele functiewijzigingen.
  • Deze functies zijn alleen te gebruiken met de Dataverse-invoegtoepassingen met weinig code.

Omschrijving

De functie XSendAppNotification wordt gebruikt om meldingen binnen een app naar een ontvanger te verzenden. Deze meldingen worden weergegeven als een pop-up of in het meldingencentrum voor de app-gebruiker. Zie In-app-meldingen sturen binnen modelgestuurde apps voor meer informatie.

Bovendien kan een in-app-melding nul tot veel acties op de meldingskaart bevatten. Om acties toe te voegen aan de app-meldingskaart, worden de volgende functies gebruikt als parameters in de functie XSendAppNotification. Zie Meldingsacties voor meer informatie over elk actietype.

  • XCreateUrlAction: voegt een URL-actie toe aan de meldingskaart.
  • XCreateSidePaneActionForDashboard: voegt een zijvensteractie toe die naar een pagina met een type dashboard navigeert binnen het zijvenster.
  • XCreateSidePaneActionForEntity: voegt een zijvensteractie toe die naar een pagina met een type entityrecord navigeert binnen het zijvenster.
  • XCreateSidePaneActionForEntityList: voegt een zijvensteractie toe die naar een pagina met een type entitylist navigeert binnen het zijvenster.
  • XCreateTeamsChatAction: voegt een Teams-chatactie toe aan de meldingskaart.

Syntaxis

XSendAppNotification

XSendAppNotification (Titel, Ontvanger, Hoofdgedeelte, Acties, Pictogramtype, Type pop-up, Vervaldatum, Prioriteit)

Parameter Type Vereist Omschrijving
Title String Ja De titel van de app-melding.
Ontvanger Entity Ja Een entiteit van systemuser die de ontvanger van de melding is.
Hoofdgedeelte String Nee Het hoofdgedeelte van de melding.
Acties Functie Nee Een matrix van de actiefuncties om acties toe te voegen aan de melding.
Pictogramtype Int Nee Selectielijstwaarde voor het type pictogram (informatie, geslaagd, fout, waarschuwing, vermelding, aangepast).
Type pop-up Int Nee Selectielijstwaarde voor het type pop-up (getimed versus verborgen).
Verval Int Nee Het aantal seconden vanaf het moment waarop de melding moet worden verwijderd, als deze nog niet is gesloten.
Prioriteit Int Nee Selectielijstwaarde voor de prioriteit van de melding (normaal of hoog).

XCreateUrlAction

XCreateUrlAction (Titel, URL, Navigatiedoel)

Parameter Type Vereist Omschrijving
Title String Ja De titel die wordt weergegeven voor de actie.
URL String Ja De URL die moet worden geopend wanneer de actie wordt geselecteerd.
Navigatiedoel String Nee Definieert waar de navigatiekoppeling wordt geopend. De opties zijn:
  • dialog: wordt geopend in het middelste dialoogvenster.
  • inline: standaard. Wordt geopend op de huidige pagina.
  • newWindow: wordt geopend op een nieuw browsertabblad.

XCreateSidePaneActionForDashbaord

XCreateSidePaneActionForDashboard (Titel, Deelvenster-id, Titel deelvenster, Dashboard-id)

Parameter Type Vereist Omschrijving
Title String Ja De titel die wordt weergegeven voor de actie.
Deelvenster-id String Ja De id van het nieuwe zijvenster.
Titel deelvenster String Ja De titel die moet worden weergegeven voor het zijvenster.
Dashboard-id GUID Ja De id van het dashboard dat moet worden geopend in het zijvenster.

XCreateSidePaneActionForEntity

XCreateSidePaneActionForEntity (Titel, Deelvenster-id, Titel deelvenster, Entiteitsnaam, Entiteits-id)

Parameter Type Vereist Omschrijving
Title String Ja De titel die wordt weergegeven voor de actie.
Deelvenster-id String Ja De id van het nieuwe zijvenster.
Titel deelvenster String Ja De titel die moet worden weergegeven voor het zijvenster.
De naam van de entiteit String Ja De logische naam van de entiteit.
Entiteits-id String Ja De id van de entiteitsrecord die moet worden geopend in het zijvenster.

XCreateSidePaneActionForEntityList

XCreateSidePaneActionForEntityList (Titel, Deelvenster-id, Titel deelvenster, Entiteitsnaam)

Parameter Type Vereist Omschrijving
Title String Ja De titel die wordt weergegeven voor de actie.
Deelvenster-id String Ja De id van het nieuwe zijvenster.
Titel deelvenster String Ja De titel die moet worden weergegeven voor het zijvenster.
De naam van de entiteit String Ja De logische naam van de entiteit die moet worden geopend als een lijst in het zijvenster.

XCreateTeamsChatAction

XCreateTeamsChatAction (Titel, Chat-id, Lid-id's, Record-id, Entiteitsnaam, Oorspronkelijk bericht)

Parameter Type Vereist Omschrijving
Title String Ja De titel die wordt weergegeven voor de actie.
Chat-id String Nee Bij het openen van een bestaande chat: de id van de chatsessie die moet worden geopend.
Lid-id's GUID Nee Bij het maken van een nieuwe chat: een matrix van Microsoft Entra-object-id-waarden van de deelnemers die in de chat moeten worden opgenomen.
Record-id GUID Nee Bij koppeling naar een Dynamics 365-record: de id van de record waaraan de chat moet worden gekoppeld.
De naam van de entiteit String Nee Bij koppeling naar een Dynamics 365-record: de logische naam van de entiteit waaraan de chat moet worden gekoppeld.
Oorspronkelijk bericht String Nee Een introductiebericht voor de nieuwe chat.

Voorbeelden

Melding in de app met een titel, ontvanger en hoofdgedeelte

Het volgende stuurt een eenvoudige in-app-melding naar een ontvanger met een titel en hoofdgedeelte. Het bevat geen acties en maakt gebruik van standaardwaarden voor alle andere parameters.

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

In-app-melding met twee acties

De volgende voorbeeldformule kan worden gebruikt met een geautomatiseerde invoegtoepassing wanneer een nieuwe record Taak wordt gemaakt. De formule is ontworpen om een in-app-melding naar de eigenaar van de taakrecord te sturen. De meldingskaart bevat twee acties die de eigenaar kan uitvoeren:

  • Een actie zijvenster, waarmee de nieuwe taakrecord in een zijvenster wordt geopend.
  • Een actie Teams-chat, die een Teams-chat start met de eigenaar van de accountrecord die is toegewezen als de tabelrecord Betreft voor de nieuwe taak. Het is belangrijk op te merken dat er hierbij vanuit wordt gegaan dat een accountrecord is geselecteerd in het taakveld.
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
		)
	]
)