Testen der Push-Funktionalität
In einem vergangengen Blogartikel wurde beschrieben, wie man Push-Funktionalität in eine hybride Anwendung inkludiert. Der nächste sinnvolle Schritt ist, diese Funktionalität zu testen. Dies möchte ich hier beschreiben.
Was wird benötigt:
- Das Device mit der installierten Applikation Implementierung von Push-Funktionalitäten
- REST-Client (z. B. Postman (Chrome), RESTClient (Firefox))
Rest-Client Postman
Für dieses Beispiel benutze ich als REST-Client die App „Postman“ ( Zur Anwendung). Als Alternative kann man z.B. auch das Tool RESTClient für den Firefox benutzen. Es lässt sich ähnlich bedienen und führt natürlich auch zum Ziel. 
Der linke Teil der Oberfläche enthält die History, bzw die Collections:
- History: Ähnlich wie der Browserverlauf. Speichert alle Aufrufe chronologisch ab.
- Collections: Vergleichbar mit Bookmarks. Hier kann man sich wichtige, mehrfach benötigte Aufrufe abspeichern und mit einem Beschreibungstext versehen.
Der rechte Teil der Oberfläche ist ähnlich zu einem Browser. Man kann mehrere Tabs aufmachen, hat eine Adressleiste wo man eine URL eingeben kann. Darunter kann man u.a. über „Authorization“, „Headers“ und „Body“ Optionen festlegen, die mit dem Aufruf mitgeschickt werden. Die untere Hälfte dient als Platzhalter für die Rückgabe des Aufrufs.
Wie kann ich Push-Nachrichten senden? (Theorie)
Das Senden von Push-Nachrichten erfolgt über einen Aufruf aus dem HCPms heraus. Hierfür gibt es die „restnotification“ API, die mehr Flexibilität für das Senden von Push-Nachrichten bietet als existierende Schnittstellen, die auf HTTP Headers oder URL Parameter basieren.
Die „restnotification“ API wird über folgende URL angesprochen: https://hcpms-<your_id>.hanatrial.ondemand.com/restnotification/
Folgende Möglichkeiten gibt es, Push-Nachrichten zu verschicken:
| application/<applicationId> | Sendet Push-Nachrichten an Devices, welche Applikation <applicationId> registriert hat. |
| <applicationId>/user/<userID> | Sendet eine Push-Nachricht an alle Devices eines bestimmten Benutzern, die die Applikation <applicationId> registriert haben. |
| registration/<applicationRegistrationId> | Sendet eine Push-Nachricht an ein bestimmtes Device. |
| application/<applicationId>/user | Sendet Push-Nachrichten an Devices von bestimmten Benutzern, die die Applikation <applicationId> registriert haben. |
| registration/ | Sendet eine Push-Nachricht an mehrere bestimmte Geräte. |
Je nach Option müssen/können noch weitere Parameter im Body enthalten sein. Des Weiteren steht im Body des Aufrufs auch die eigentliche Nachricht.
Senden von Push-Nachrichten (Praxis)
Zum Testen, ob die Push-Nachrichten am Device ankommen, reicht es aus, einen einfachen Aufruf (ohne Einschränkungen) zu nehmen, und diesen zu verschicken.
So kann man über https://hcpms-<your_id>.hanatrial.ondemand.com/restnotification/applicat... eine Nachricht an alle Geräte verschicken, die die Applikation registriert haben. Im Body geben wir noch folgenden Inhalt mit:
{
"alter": "Hello World!",
"badge": 1,
"data": "testData",
"sound": "soundval"
}
Wichtig an dieser Stelle sind noch die folgenden Header-Angaben:
| Content-Type | application/json |
| Cache-Control | no-cache |
| Authorization | ...... |
Beim Postman wird der Authorization Header über den Reiter „Authorization“ gesetzt. Hier sind die Login-Daten für die HCP anzugeben.
Hier die entsprechenden Screenshots:
Nachdem man auf Senden geklickt hat, bekommt man in der unteren Hälfte des Bildschirms den Response zurück.
Im gleichen Zuge sollte auf dem Gerät eine Push-Nachricht, mit dem Inhalt den wir im Body mitgeschickt haben, erscheinen.
Nachfolgend kann man noch mit den anderen möglichen Aufrufen (im Theorie-Teil beschrieben) experimentieren – die Ausgabe am Gerät bleibt aber natürlich die gleiche.