Udostępnij za pośrednictwem

XSendAppNotification i pokrewne funkcje akcji w (wersja zapoznawcza)

  • Artykuł

Dotyczy: Aplikacje kanwy Aplikacje oparte na modelu

[Ten artykuł stanowi wstępną wersję dokumentacji i może ulec zmianie.]

Wysłanie powiadomienia w aplikacji z opcjonalnymi akcjami do adresata.

Ważne

  • Jest to funkcja w wersji zapoznawczej.
  • Funkcje w wersji zapoznawczej nie są przeznaczone do użytku w środowiskach produkcyjnych, mogą mieć ograniczoną funkcjonalność i mogą znacznie zmienić się przed wydaniem. Te funkcje są udostępniane przed oficjalnym wydaniem, dzięki czemu klienci mogą szybciej uzyskać do nich dostęp i przekazać opinie na ich temat.
  • Aby pomóc w identyfikowaniu tych funkcji jako funkcji w wersji zapoznawczej, każda funkcja ma prefiks X. Po wydaniu należy usunąć znak X ze wszystkich formuł, w których są używane te funkcje i argumenty, zaktualizowane do wszelkich zmian funkcji.
  • Te funkcje mogą być używane tylko w przypadku dodatków niskokodowych plug-in Dataverse.

opis

Funkcja XSendAppNotification jest używana do wysyłania powiadomień z aplikacji do adresata. Te powiadomienia są wyświetlane jako powiadomienia w centrum powiadomień użytkownika aplikacji lub w Centrum powiadomień. Aby uzyskać więcej informacji, zobacz Wysyłanie powiadomień w aplikacji w aplikacjach opartych na modelu.

Ponadto powiadomienie w aplikacji może zawierać od zera do wielu akcji na karcie powiadomień. Aby dodać akcje do karty powiadomień aplikacji, w funkcji XSendAppNotification jako parametry są używane następujące funkcje. Aby uzyskać więcej informacji dotyczących poszczególnych typów akcji, zobacz informacje o akcjach powiadomień.

  • XCreateUrlAction: dodaje akcję adresu URL do karty powiadomień.
  • XCreateSidePaneActionForDashboard: dodaje akcję okienka bocznego, która przechodzi do strony z typem w dashboard okienku bocznym.
  • XCreateSidePaneActionForEntity: dodaje akcję okienka bocznego, która przechodzi do strony z typem entityrecord w okienku bocznym.
  • XCreateSidePaneActionForEntityList: Dodaje akcję okienka bocznego, która przechodzi do strony z typem entitylist w okienku bocznym.
  • XCreateTeamsChatAction: dodaje akcję czatu usługi Teams do karty powiadomień.

Składnia

XSendAppNotification

XSendAppNotification(Tytuł, Odbiorca , Treść, Działania, Typ ikony, Typ wyskakującego powiadomienia, Wygaśnięcie, Priorytet)

Parametr Type Wymagania opis
Nazwa String Tak Tytuł powiadomienia aplikacji.
Odbiorca Jednostka Tak Obiekt systemuser, który jest adresatem powiadomienia.
Body String Nie. Treść powiadomienia.
Czynności Function Nie. Tablica funkcji akcji, w których można dodać akcje powiadomienia.
Typ ikony Int Nie. Wartość listy wyboru dla typu ikony (Informacje, Sukces, Niepowodzenie, Ostrzeżenie, Wzmianka, Niestandardowy).
Typ wyskakiwania Int Nie. Wartość listy wyboru dla typu wyskakującego okienka (okresowe versus ukryte).
Wygaśnięcie Int Nie. Liczba sekund, po upływie której powiadomienie ma zostać usunięte, jeśli nie zostało jeszcze odrzucone.
Priorytet Int Nie. Wartość listy wyboru dla priorytetu powiadomienia (Normalny lub Wysoki).

XCreateUrlAction

XCreateUrlAction (Tytuł,URL,Cel nawigacji)

Parametr Type Wymagania opis
Nazwa String Tak Tytuł wyświetlany dla akcji.
URL String Tak Adres URL, który należy otworzyć po wybraniu akcji.
Cel nawigacyjny String Nie. Określa miejsce, w którym będzie otwierane łącze nawigacyjne. Dostępne opcje:
  • dialog: Otwiera się w środkowym oknie dialogowym.
  • inline:Domyślny. Otwiera bieżącą stronę.
  • newWindow: Otwiera się w nowej karcie przeglądarki.

XCreateSidePaneActionForDashbaord

XCreateSidePaneActionForDashboard (Tytuł, Identyfikator okienka, Tytuł okienka, Identyfikator pulpitu nawigacyjnego)

Parametr Type Wymagania opis
Nazwa String Tak Tytuł wyświetlany dla akcji.
Identyfikator okienka String Tak Identyfikator nowego okienka bocznego.
Tytuł okienka String Tak Tytuł wyświetlany w okienku bocznym.
Identyfikator pulpitu nawigacyjnego Identyfikator GUID Tak Identyfikator pulpitu nawigacyjnego do otwarcia w okienku bocznym.

XCreateSidePaneActionForEntity

XCreateSidePaneActionForEntity (Tytuł,Identyfikator okienka,Tytuł okienka,Nazwa jednostki,Identyfikator jednostki)

Parametr Type Wymagania opis
Nazwa String Tak Tytuł wyświetlany dla akcji.
Identyfikator okienka String Tak Identyfikator nowego okienka bocznego.
Tytuł okienka String Tak Tytuł wyświetlany w okienku bocznym.
Nazwa encji String Tak Nazwa logiczna encji.
Identyfikator encji String Tak Identyfikator rekordu encji do otwarcia w okienku bocznym.

XCreateSidePaneActionForEntityList

XCreateSidePaneActionForEntityList(Tytuł, Identyfikator okienka, Tytuł okienka, Nazwa jednostki)

Parametr Type Wymagania opis
Nazwa String Tak Tytuł wyświetlany dla akcji.
Identyfikator okienka String Tak Identyfikator nowego okienka bocznego.
Tytuł okienka String Tak Tytuł wyświetlany w okienku bocznym.
Nazwa encji String Tak Logiczna nazwa encji, która ma być otwierana jako lista w okienku bocznym.

XCreateTeamsChatAction

XCreateTeamsChatAction (Tytuł,Identyfikator czatu,Identyfikatory członków,Identyfikator rekordu,Nazwa encji,Wiadomość początkowa)

Parametr Type Wymagania opis
Nazwa String Tak Tytuł wyświetlany dla akcji.
Identyfikator czatu String Nie. Jeśli otworzysz istniejący czat, identyfikator sesji czatu zostanie otwarty.
Identyfikatory użytkowników Identyfikator GUID Nie. Przy tworzeniu nowego czatu będzie dostępna tablica wartości identyfikatorów Microsoft Entra obiektów uczestników do dołączenia w czacie.
Identyfikator rekordu Identyfikator GUID Nie. Jeśli jest łączone z rekordem usługi Dynamics 365, jest to identyfikator rekordu, z którym ma być połączony czat.
Nazwa encji String Nie. Jeśli jest łączone z rekordem usługi Dynamics 365, jest to nazwa logiczna encji rekordu, z którym ma być połączony czat.
Komunikat wstępny String Nie. Komunikat wstępny nowego czatu.

Przykłady

Powiadomienie w aplikacji z tytułem, adresatem i treścią

Poniższe powiadomienie w aplikacji jest wysyłane do adresata z tytułem i treścią. Nie obejmuje żadnych akcji i wykorzystuje wartości domyślne wszystkich innych parametrów.

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

Powiadomienie w aplikacji z dwiema akcjami

Poniższe przykładowe formuły mogą być używane razem z automatycznymi dodatkami plug-in podczas tworzenia nowego rekordu Zadanie. Formułę można wysyłać do właściciela rekordu zadania powiadomienie w aplikacji. Karta powiadomienia zawiera dwie akcje, które może podjąć właściciel:

  • Akcja w okienku bocznym otwiera nowy rekord zadania w okienku bocznym.
  • Akcja Czat Teamsinicjuje czat Teams z właścicielem rekordu konta przypisanego jako rekord tabeli Dotyczy dla nowego zadania. Należy pamiętać, że przyjęto założenie, że w polu zadania został wybrany rekord klienta.
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
		)
	]
)