Udostępnij za pośrednictwem

Wyrażenia routingu i tagu

  • Artykuł

Wyrażenia tagów umożliwiają określanie określonych zestawów urządzeń lub w szczególności rejestracji podczas wysyłania powiadomień wypychanych za pośrednictwem usługi Notification Hubs.

Określanie wartości docelowej określonych rejestracji

Jedynym sposobem określania celu określonych rejestracji jest skojarzenie ich z tagiem, a następnie określenie wartości docelowej tego tagu. Zgodnie z opisem w zarządzanie rejestracją, aby otrzymywać powiadomienia wypychane, aplikacja musi zarejestrować uchwyt urządzenia w centrum powiadomień. Po utworzeniu rejestracji w centrum powiadomień zaplecze aplikacji może wysyłać do niego powiadomienia wypychane.

Zaplecze aplikacji może wybrać rejestracje docelowe z określonym powiadomieniem w następujący sposób:

  1. rozgłaszaj: wszystkie rejestracje w centrum powiadomień otrzymują powiadomienie.

  2. Tag: wszystkie rejestracje zawierające określony tag otrzymują powiadomienie.

  3. wyrażenie tagu: wszystkie rejestracje, których zestaw tagów jest zgodny z określonym wyrażeniem, otrzymuje powiadomienie.

Nuta

Podczas wysyłania ładunku specyficznego dla platformy (na przykład powiadomienia specyficznego dla Sklepu Windows) powiadomienia będą otrzymywać tylko rejestracje dla tej konkretnej platformy. Podczas wysyłania powiadomienia szablonu docelowe są tylko rejestracje określające szablon. Aby uzyskać więcej informacji, zobacz Registration Management.

Tagi

Tag może być dowolnym ciągiem, maksymalnie 120 znaków, zawierającym alfanumeryczne i następujące znaki inne niż alfanumeryczne: "_", "@", "#", ".", ":", "-". W poniższym przykładzie pokazano aplikację, z której można otrzymywać wyskakujące powiadomienia dotyczące określonych grup muzycznych. W tym scenariuszu prostym sposobem kierowania powiadomień jest oznaczanie rejestracji tagami reprezentującymi różne przedziały, jak na poniższej ilustracji.

wyrażenia tagów

Na tym obrazie komunikat oznaczony Beatles dociera tylko do tabletu zarejestrowanego przy użyciu tagu Beatles.

Aby uzyskać więcej informacji na temat tworzenia rejestracji tagów, zobacz Registration Management.

Powiadomienia do tagów można wysyłać przy użyciu wysyłania powiadomień metod Microsoft.ServiceBus.Notifications.NotificationHubClient w zestawie SDK. Możesz również użyć Node.jslub interfejsów API REST powiadomień wypychanych .

Zwróć uwagę na następujące przykłady:

await hub.SendWindowsNativeNotificationAsync(wnsToast, "tag");

notificationHubService.wns.sendToastText01('tag', {
            text1: 'Hello World!'
        }, callback);

Tagi nie muszą być wstępnie aprowidowane i mogą odwoływać się do wielu pojęć specyficznych dla aplikacji. Na przykład użytkownicy tej przykładowej aplikacji mogą komentować zespoły i chcą otrzymywać wyskaki, nie tylko dla komentarzy na temat swoich ulubionych zespołów, ale także dla wszystkich komentarzy od znajomych, niezależnie od zespołu, na którym komentują. Na poniższej ilustracji przedstawiono przykład tego scenariusza:

wyrażenia tagów

Na tym zdjęciu Alice jest zainteresowana aktualizacjami Beatlesów, a Bob jest zainteresowany aktualizacjami dla Wailers. Bob jest również zainteresowany komentarzami Charliego, a Charlie jest zainteresowany Wailers. Po wysłaniu powiadomienia o komentarzu Charliego do Beatlesów, zarówno Alice, jak i Bob otrzymają go.

Ważny

Chociaż można kodować wiele problemów w tagach (na przykład "band_Beatles" lub "follows_Chanrlie"), tagi są prostymi ciągami, a nie właściwościami z wartościami. Rejestracja jest dopasowywana tylko w przypadku obecności lub braku określonego tagu.

Aby zapoznać się z pełnym samouczkiem krok po kroku dotyczącym używania tagów do wysyłania do grup zainteresowań, zobacz Breaking News.

Nuta

W poprzednim przykładzie należy wysłać jedno powiadomienie do dwóch tagów (podając tablicę tagów lub używając wyrażenia tagu z funkcją OR), zamiast dwóch powiadomień. Wysyłanie dwóch powiadomień do poszczególnych tagów powoduje zduplikowanie rejestracji, które mają oba tagi, podczas gdy używanie wyrażeń tagów nie będzie.

Używanie tagów do użytkowników docelowych

Innym sposobem użycia tagów jest zidentyfikowanie wszystkich urządzeń określonego użytkownika. Rejestracje można oznaczyć tagiem zawierającym identyfikator użytkownika, jak na poniższej ilustracji:

wyrażenia tagów

Na tym obrazie komunikat otagowany uid:Alice osiąga wszystkie rejestracje oznaczone uid:Alice; w związku z tym wszystkie urządzenia Alicji.

Wyrażenia tagów

Istnieją przypadki, w których powiadomienie musi dotyczyć zestawu rejestracji, które nie są identyfikowane przez pojedynczy tag, ale przez wyrażenie logiczne tagów.

Rozważ aplikację sportową, która wysyła przypomnienie wszystkim w Bostonie o grze między Red Sox i Cardinals. Jeśli aplikacja kliencka rejestruje tagi dotyczące zainteresowania zespołami i lokalizacją, powiadomienie powinno być kierowane do wszystkich osób w Bostonie, którzy są zainteresowani albo Red Sox lub Cardinals. Ten warunek można wyrazić za pomocą następującego wyrażenia logicznego:

(follows_RedSox || follows_Cardinals) && location_Boston

wyrażenia tagów

Wyrażenia tagów mogą zawierać wszystkie operatory logiczne, takie jak AND (&&), OR (||) i NOT (!). Mogą również zawierać nawiasy. Wyrażenia tagów są ograniczone do 20 tagów, jeśli zawierają tylko jednostki ORS; w przeciwnym razie są one ograniczone do 6 tagów.

Powiadomienia można wysyłać do wyrażeń tagów przy użyciu wysyłania powiadomień metod Microsoft.ServiceBus.Notifications.NotificationHubClient klasy w zestawie SDK. Możesz również użyć Node.jslub interfejsów API REST powiadomień wypychanych . Zwróć uwagę na następujące przykłady:

await hub.SendWindowsNativeNotificationAsync(wnsToast, "(tagA && !tagB)");

notificationHubService.wns.sendToastText01('(tagA && !tagB)', {
            text1: 'Hello World!'
        }, callback);

Zobacz też

Inne zasoby

Dokumentacja interfejsu API
samouczek Breaking News
samouczek Wysyłanie powiadomień do użytkowników