Dokumentation Versionshinweise - Juni 2024

Dieser Artikel wurde ursprünglich auf https://www.pubnub.com/docs/release-notes/2024/june veröffentlicht.

Hallo zusammen! Diesen Monat haben wir ein paar neue Updates für Sie.

• Wir haben ein neues Flag für referentielle Integrität eingeführt, um die Konsistenz Ihrer Daten zu gewährleisten.
• Sie können jetzt Channel-Gruppen-Grenzen direkt über das Admin-Portal festlegen.
• Probieren Sie den Import von Daten aus Insights in BizOps aus, um die Funktionen zu testen.
• Außerdem werden Sie feststellen, dass das Erscheinungsbild von Presence Management überarbeitet wurde.

Darüber hinaus haben wir eine Reihe von kleinen, aber wichtigen Verbesserungen in den Dokumenten vorgenommen, die hoffentlich einige Ihrer Fragen beantworten oder Ihre Zweifel bei der Arbeit mit PubNub ausräumen.

Viel Spaß beim Stöbern und vielen Dank, dass Sie Teil unserer Community sind!

Allgemein 🛠️

Benutzerdefinierte Felder in FCM Payloads

Typ: Verbesserung

Wir haben die Dokumente für die Android Mobile Push Notifications korrigiert, indem wir die fehlenden benutzerdefinierten PubNub-Parameter hinzugefügt haben, die Sie zu Ihrem FCM Mobile Push Notification Payload hinzufügen können: pn_debug, pn_exceptions und pn_dry_run.

Damit können Sie Benachrichtigungen testen oder debuggen und ausgewählte Geräte vom Empfang von Benachrichtigungen ausschließen.

Hier ist ein Beispiel für eine FCM-Nutzlast mit unseren benutzerdefinierten Feldern:

{
  "pn_fcm": {
    "notification": {
      "title": "My Title",
      "body": "Message sent at"
 },
    "pn_collapse_id": "collapse-id",
    "pn_exceptions": [
      "optional-excluded-device-token1"
 ]
 },
  "pn_debug": true,
  "pn_dry_run": false
}

Kanalgruppengrenzen

Typ: Neue Funktion

Der Stream Controller im Admin-Portal verfügt über eine neue, konfigurierbare Option zur Begrenzung von Kanalgruppen für Kunden mit kostenpflichtigen Tarifen, mit der Sie die maximale Anzahl von Kanälen festlegen können, die Kanalgruppen in einem Keyset haben können. Sie können entweder das Standardlimit von 1.000 Channels herabsetzen oder es auf 2.000 Channels erhöhen.

Benutzer-Metadaten-Ereignisse im App-Kontext

Typ: Verbesserung

Wir haben die Dokumentation verbessert, um klarzustellen, dass bei aktivierter Option " Benutzer-Metadaten-Ereignisse " jede Änderung an einer Benutzerentität(Setzen und Löschen) dazu führt, dass Ereignisbenachrichtigungen an alle Mitgliedschaftsassoziationen gesendet werden, also sowohl an den Benutzer als auch an jeden Channel, in dem er Mitglied ist. Weitere Details finden Sie in der Dokumentation.

App Context Konfigurationsabhängigkeit

Typ: Verbesserung

Wir haben die Dokumente zu den Konfigurationsoptionen von App Context aktualisiert, um Informationen zu einer kritischen Abhängigkeit aufzunehmen.

Obwohl die Optionen Disallow Get All Channel Metadata und Disallow Get All User Metadata auf den ersten Blick selbsterklärend sind, funktionieren diese Optionen nur bei aktiviertem Access Manager.

Mit anderen Worten: Ohne Access Manager deaktivieren diese aktiven Optionen nicht wirklich den Abruf von Metadaten über Benutzer oder Kanäle auf einem Keyset. Wenn Sie den Zugriffsmanager aktivieren und damit standardmäßig den Zugriff auf alle Objekte in einem Keyset einschränken, können Sie die GET-Beschränkungen des Zugriffsmanagers für Benutzer und Channels leicht umgehen, indem Sie diese beiden Konfigurationsoptionen deaktivieren, ohne ein feinkörniges Berechtigungsschema zu erstellen.

Die Admin Portal UI wird diese Abhängigkeit bald ebenfalls widerspiegeln.

Neues Flag für referenzielle Integrität im App-Kontext

Typ: Neue Funktion

Wir haben eine neue Option Referentielle Integrität für Mitgliedschaften erzwingen hinzugefügt, die standardmäßig aktiviert wird, wenn Sie App Context für das Keyset Ihrer App im Admin Portal aktivieren.

Diese Option stellt sicher, dass Sie nur dann eine neue Mitgliedschaft einrichten können, wenn sowohl die Benutzer-ID als auch die Channel-ID, für die Sie die Mitgliedschaft erstellt haben, existieren. Gleichzeitig werden durch das Löschen einer übergeordneten Benutzer- oder Channel-Metadaten-Entität automatisch alle untergeordneten Mitgliedschaftszuordnungen für diese gelöschte Entität gelöscht. Auf diese Weise stellen Sie sicher, dass es keine fehlerhaften oder verwaisten Mitgliedschaftsobjekte in Ihrem Schlüsselsatz gibt.

SDKs 📦

Verbesserungen der Python-Dokumente

Typ: Verbesserung

Aufgrund des Feedbacks, das wir erhalten haben, haben wir die Informationen über die Verwendung und Ausführung von Methoden erweitert. Infolgedessen beschreibt jeder Abschnitt "Returns" in den Python SDK-Dokumenten nun die Datenfelder, die von jeder Methode zurückgegeben werden. Außerdem wird erklärt, wie die Ausführung von sync (.sync()) und async (.pn_async(callback)) Anfragen die zurückgegebenen Daten für jede Methode beeinflusst.

React SDK wurde veraltet

Typ: Verwerfungshinweis

Da wir das React SDK seit einiger Zeit nicht mehr aktiv weiterentwickelt haben, haben wir uns entschlossen, seine Dokumente offiziell abzulehnen und sie in den Abschnitt Call For Contributions in unseren Dokumenten zu verschieben.

Wenn Sie einen Fehler im React SDK finden oder seine Funktionalität erweitern wollen, können Sie gerne einen Pull Request im Repo erstellen und auf unser Feedback warten!

Funktionen

Exportieren von Funktionsprotokollen durch Events & Actions

Typ: Neue Funktion

Jede PubNub-Funktion speichert Logs im internen blocks-output-* Kanal, wie blocks-output-NSPiAuYKsWSxJl4yBn30, der bis zu 250 Zeilen Logs speichern kann, bevor neue sie überschreiben. Wenn Sie den Überblick über alte Protokolle nicht verlieren wollen, können Sie diese Protokolle jetzt mit Events & Actions an einen externen Dienst exportieren.

Einblicke 📊.

Benutzerdauer und Gerätemetriken in den REST-API-Dokumenten

Typ: Verbesserung

Letzten Monat haben wir die Gerätemetriken in das User Behavior Dashboard in den PubNub Insights auf dem Admin Portal eingeführt. Diesen Monat haben wir die REST-API-Dokumente aktualisiert, um sowohl die Benutzerdauer als auch die Gerätemetriken aufzunehmen, so dass Sie die PubNub Insights API direkt aufrufen können, um die Metriken zu erhalten, die Sie interessieren.

BizOps Arbeitsbereich 🏢

Top 20 Nutzer/Kanäle

Typ: Neue Funktion

Wenn Sie App Context nicht zum Speichern und Verwalten von Benutzern und Kanälen verwenden, können Sie die entsprechenden Funktionen von BizOps Workspace dennoch testen, indem Sie Testdaten importieren.

Wenn Sie Zugang zu PubNub Insights haben, können Sie darauf zugreifen, indem Sie zu den Modulen User Management und Channel Management in BizOps Workspace im Admin Portal gehen und auf die Schaltfläche Import from Insights klicken.

Als Ergebnis importieren Sie aus dem Keyset Ihrer App maximal 20 Benutzer, die innerhalb des letzten Tages die meisten Nachrichten veröffentlicht haben (wenn gestern keine Nachrichten gesendet wurden, werden die Benutzer anhand der Daten vom Vortag importiert).

Ähnlich wie bei den Nutzern können Sie aus dem Keyset Ihrer App bis zu 20 Kanäle mit der höchsten Anzahl an Nachrichten importieren, die innerhalb des letzten Tages veröffentlicht wurden.

Nutzen Sie diese Testdaten, um herauszufinden, was BizOps Workspace zu bieten hat.

Überarbeitetes Präsenzmanagement UX

Typ: Verbesserung

Wir haben vor kurzem das gesamte Präsenzmanagement-Modul in BizOps Workspace überarbeitet, um den Assistenten für die Regelerstellung zu vereinfachen, die Farben der Abzeichen in umfassendere Farben zu ändern und eine "Catch All"-Musterkonfiguration hinzuzufügen, die die Standardeinstellung "Präsenz auf allen Kanälen aktivieren" der Präsenzkonfiguration auf dem Keyset widerspiegelt.

Wir hoffen, dass Ihnen das neue Aussehen und die Bedienung gefällt!