Útválasztási és címkekifejezések

A címkekifejezésekkel meghatározott eszközkészleteket vagy pontosabban regisztrációkat célozhat meg, amikor leküldéses értesítést küld a Notification Hubson keresztül.

Konkrét regisztrációk megcélzása

Az adott regisztrációk megcélzásának egyetlen módja az, ha társítja őket egy címkével, majd megcélz egy címkét. A Regisztrációkezelésben leírtak szerint a leküldéses értesítések fogadásához az alkalmazásnak regisztrálnia kell egy eszközleírót egy értesítési központban. Miután létrehozott egy regisztrációt egy értesítési központban, az alkalmazás háttérrendszere leküldéses értesítéseket küldhet neki.

Az alkalmazás háttérrendszere az alábbi módokon választhatja ki a megcélzott regisztrációkat egy adott értesítéssel:

1. Közvetítés: az értesítési központban található összes regisztráció megkapja az értesítést.

2. Címke: a megadott címkét tartalmazó összes regisztráció megkapja az értesítést.

3. Címkekifejezés: minden olyan regisztráció, amelynek címkéi megegyeznek a megadott kifejezéssel, értesítést kapnak.

Megjegyzés

Platformspecifikus hasznos adat (például egy Windows Store-specifikus értesítés) küldésekor csak az adott platformra vonatkozó regisztrációk kapják meg az értesítést. Sablonértesítés küldésekor a rendszer csak a sablont megadva megadott regisztrációkat célozza meg. További információ: Regisztrációkezelés.

Címkék

A címke bármilyen, legfeljebb 120 karakter hosszúságú karakterlánc lehet, amely alfanumerikus és a következő nem alfanumerikus karaktereket tartalmazza: '_', '@', '#', '.', ':', '-'. Az alábbi példa egy alkalmazást mutat be, amelyből bejelentési értesítéseket kaphat adott zenei csoportokról. Ebben a forgatókönyvben az értesítések átirányításának egyszerű módja a regisztrációk címkézése a különböző sávokat képviselő címkékkel, az alábbi képen látható módon.

Ezen a képen a Beatles címkével ellátott üzenet csak azt a táblagépet éri el, amely regisztrálva van a Beatles címkével.

További információ a címkék regisztrációinak létrehozásáról: Regisztrációkezelés.

Az SDK Microsoft.ServiceBus.Notifications.NotificationHubClient osztályának értesítésküldési módszereivel értesítéseket küldhet címkéknek. Használhatja a Node.js vagy a leküldéses értesítések REST API-jait is.

Figyelje meg a következő példákat:

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

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

A címkéket nem kell előre kiépíteni, és több alkalmazásspecifikus fogalomra is hivatkozhatnak. A példaalkalmazás felhasználói például megjegyzéseket fűzhetnek a sávokhoz, és bejelentéseket is kaphatnak, nem csak a kedvenc zenekaraik megjegyzéseihez, hanem a barátaiktól érkező összes megjegyzéshez is, függetlenül attól, hogy melyik zenekarhoz megjegyzést fűznek. Az alábbi képen egy példa látható erre a forgatókönyvre:

Ezen a képen Alice érdekli frissítések a Beatles, és Bob érdekli frissítéseket a Wailers. Bob is érdekli Charlie megjegyzéseit, és Charlie érdekli a Wailers. Amikor értesítést küldenek Charlie megjegyzéséről a Beatlesről, Alice és Bob is megkapja.

Fontos

Bár a címkékben több szempontot is kódolhat (például "band_Beatles" vagy "follows_Chanrlie"), a címkék egyszerű sztringek, és nem értékekkel rendelkező tulajdonságok. A regisztráció csak egy adott címke jelenlétével vagy hiányával egyezik meg.

A címkék érdeklődési csoportoknak való küldéséhez való használatáról részletes útmutatót a Breaking Newsban talál.

Megjegyzés

Az előző példában két értesítés helyett egyetlen értesítést kell küldenie két címkének (címkékből álló tömböt kell megadnia, vagy egy címkekifejezést kell használnia az OR-val). Ha két értesítést küld az egyes címkéknek, akkor a két címkével rendelkező regisztrációk duplikáltak lesznek, míg a címkekifejezések használata nem.

Címkék használata a felhasználók megcélzásához

A címkék használatának másik módja egy adott felhasználó összes eszközének azonosítása. A regisztrációk címkézhetők felhasználói azonosítót tartalmazó címkével, az alábbi képen látható módon:

Ezen a képen az uid:Alice címkével ellátott üzenet az uid:Alice címkével ellátott összes regisztrációt eléri; ezért Alice összes eszköze.

Címkekifejezések

Vannak olyan esetek, amikor egy értesítésnek olyan regisztrációkészletet kell céloznia, amelyet nem egyetlen címke, hanem egy logikai kifejezés azonosít a címkéken.

Vegyünk egy sportalkalmazást, amely emlékeztetőt küld bostoni mindenkinek a Red Sox és a Cardinals közötti játékról. Ha az ügyfélalkalmazás címkéket regisztrál a csapatok és a hely iránt érdeklődők számára, akkor az értesítést bostoni mindenkinek meg kell célozni, aki vagy a Red Sox vagy a Cardinals iránt érdeklődik. Ez a feltétel a következő logikai kifejezéssel fejezhető ki:

(follows_RedSox || follows_Cardinals) && location_Boston

A címkekifejezések tartalmazhatnak minden logikai operátort, például AND (&&), OR (||) és NOT (!). Zárójeleket is tartalmazhatnak. A címkekifejezések legfeljebb 20 címkét tartalmazhatnak, ha csak ORS-eket tartalmaznak; ellenkező esetben 6 címkére vannak korlátozva.

Az SDK Microsoft.ServiceBus.Notifications.NotificationHubClient osztályának értesítésküldési módszereivel értesítéseket küldhet a címkekifejezésekhez. Használhatja a Node.js vagy a leküldéses értesítések REST API-jait is. Figyelje meg a következő példákat:

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

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

Lásd még:

Egyéb források

API-referenciák
Breaking News oktatóanyag
Értesítések küldése a felhasználóknak – oktatóanyag