Share via

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 powiadomienia.
  • XCreateSidePaneActionForDashboard: Dodaje akcję okienka bocznego, która powoduje przejście do strony z typem dashboard w okienku bocznym.
  • XCreateSidePaneActionForEntity: Dodaje akcję okienka bocznego, która powoduje przejście do strony z typem entityrecord w okienku bocznym.
  • XXCreateSidePaneActionForEntityList: Dodaje akcję okienka bocznego, która powoduje przejście do strony z typem entitylist w okienku bocznym.
  • XCreateTeams Chataction: Dodaje akcję czatu Teams do karty powiadomień.

Składnia

XSendAppNotification

XSendAppNotification (Tytuł, Odbiorca, Treść, Akcje, Typ ikony, Typ powiadomienia wyskakującego, 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ł, Adres URL, Cel nawigacyjny)

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: Jest otwierane w oknie dialogowym centrum.
  • inline: domyślnie Otwiera bieżącą stronę.
  • newWindow: otwiera na 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 encji, Identyfikator encji)

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

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, Komunikat wstępny)

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