Notes de mise à jour de la documentation - juin 2024
PubNub Developer Relations
Posted on July 8, 2024
Cet article a été publié à l'origine sur https://www.pubnub.com/docs/release-notes/2024/june
Bonjour à tous ! Nous avons quelques nouvelles mises à jour pour vous ce mois-ci.
- Nous avons introduit un nouveau drapeau d'intégrité référentielle pour aider à garder vos données cohérentes.
- Vous pouvez maintenant définir des limites de groupes de canaux directement à partir du portail d'administration.
- Essayez d'importer des données d'Insights vers BizOps pour tester ses fonctionnalités.
- De plus, vous remarquerez que l'aspect et la convivialité de la gestion de la présence ont été revus.
Par ailleurs, nous avons apporté un certain nombre d'améliorations mineures mais significatives à la documentation qui, nous l'espérons, répondra à certaines de vos questions ou dissipera les doutes que vous aviez lorsque vous travailliez avec PubNub.
Bonne exploration et merci de faire partie de notre communauté !
Généralités 🛠️
Champs personnalisés dans les payloads FCM
Type: Amélioration
Nous avons corrigé la documentation pour les notifications push mobiles Android en ajoutant les paramètres PubNub personnalisés manquants que vous pouvez ajouter à votre payload de notification push mobile FCM : pn_debug
, pn_exceptions
, et pn_dry_run
.
Ils vous permettront de tester ou de déboguer les notifications et d'exclure certains appareils de la réception des notifications.
Voici un exemple de charge utile FCM avec nos champs personnalisés :
{
"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
}
Channel group limits
Type: Nouvelle fonctionnalité
Le contrôleur de flux dans le portail d'administration dispose d'une nouvelle option configurable de limite de groupe de canaux pour les clients bénéficiant de plans tarifaires payants, qui vous permet de définir les limites du nombre maximum de canaux que les groupes de canaux d'un ensemble de clés peuvent avoir. Vous pouvez abaisser la limite par défaut de 1 000 canaux ou l'augmenter jusqu'à 2 000 canaux.
Événements de métadonnées de l'utilisateur dans le contexte de l'application
Type: Amélioration
Nous avons amélioré la documentation pour clarifier qu'avec l'option " User Metadata Events " activée, toute modification d'une entité utilisateur(définition
et suppression
) entraîne l'envoi de notifications d'événements à toutes les associations de membres, donc à la fois à cet utilisateur et à tous les canaux dont il est membre. Se référer à la documentation pour plus de détails.
Dépendance de configuration du contexte d'application
Type: Amélioration
Nous avons mis à jour la documentation sur les options de configuration du contexte applic atif afin d'inclure des informations sur une dépendance critique.
Bien que les options Disallow Get All Channel Metadata et Disallow Get All User Metadata semblent assez explicites, la mise en garde est que ces options ne fonctionnent qu'avec un gestionnaire d'accès activé.
En d'autres termes, sans le gestionnaire d'accès, ces options actives ne désactivent pas réellement l'obtention de métadonnées sur les utilisateurs ou les canaux d'une unité centrale. Parallèlement, lorsque vous activez le gestionnaire d'accès, restreignant ainsi par défaut l'accès à tous les objets d'un jeu de clés, vous pouvez facilement contourner les restrictions GET du gestionnaire d'accès pour les utilisateurs et les canaux en décochant ces deux options de configuration sans créer un schéma de permissions à granularité fine.
L'interface utilisateur du portail d'administration reflétera bientôt cette dépendance.
Nouveau drapeau d'intégrité référentielle dans App Context
Type: Nouvelle fonctionnalité
Nous avons ajouté une nouvelle option " Enforce referential integrity for memberships ", qui est activée par défaut lorsque vous activez App Context sur le jeu de clés de votre application dans le portail d'administration.
Cette option garantit que vous ne pouvez définir une nouvelle adhésion que si l'ID de l'utilisateur et l'ID du canal pour lesquels vous avez créé l'adhésion existent tous les deux. Parallèlement, la suppression d'un utilisateur parent ou d'une entité de métadonnées de canal supprime automatiquement toutes les associations d'affiliation enfant pour l'entité supprimée. De cette façon, vous vous assurez qu'il n'y a pas d'objets d'appartenance dysfonctionnels ou orphelins sur votre ensemble de clés.
SDKs 📦
Amélioration de la documentation Python
Type: Amélioration
Suite aux commentaires que nous avons reçus, nous avons étendu les informations sur l'utilisation et l'exécution des méthodes. Ainsi, chaque section Returns de la documentation du SDK P ython décrit désormais les champs de données renvoyés par chaque méthode. Elle explique également comment l'exécution des requêtes sync (.sync()
) et async (.pn_async(callback)
) influence les données renvoyées pour chaque méthode.
React SDK a été déprécié
Type: Avis de dépréciation
Comme nous n'avons pas développé activement le React SDK depuis un certain temps, nous avons décidé de déprécier officiellement sa documentation et de la déplacer dans la section Call For Contributions (appel à contribution ) de notre documentation.
Si vous trouvez un bug dans le SDK React ou si vous voulez étendre ses fonctionnalités, n'hésitez pas à créer une pull request dans le repo et attendez notre feedback !
Fonctions
Exporter les logs de fonctions à travers Events & Actions
Type: Nouvelle fonctionnalité
Chaque fonction PubNub enregistre les logs dans le canal interne blocks-output-*
, comme blocks-output-NSPiAuYKsWSxJl4yBn30
, qui peut stocker jusqu'à 250 lignes de logs avant que de nouveaux logs ne les écrasent. Si vous ne voulez pas perdre la trace des anciens journaux, vous pouvez désormais utiliser Events & Actions pour exporter ces journaux vers un service externe.
Perspectives 📊
Durée de l'utilisateur et métriques de l'appareil dans les documents de l'API REST
Type: Amélioration
Lemois dernier, nous avons introduit les métriques d'appareils dans le tableau de bord Comportement de l'utilisateur
dans PubNub Insights sur le portail d'administration. Ce mois-ci, nous avons mis à jour la documentation de l'API REST pour inclure à la fois la durée de l'utilisateur et les métriques de l'appareil, de sorte que vous pouvez appeler l'API PubNub Insights directement pour obtenir les métriques qui vous intéressent.
Espace de travail BizOps 🏢
Les 20 premiers utilisateurs/canaux
Type: Nouvelle fonctionnalité
Si vous n'utilisez pas App Context pour stocker et gérer les utilisateurs et les canaux, vous pouvez toujours tester les fonctionnalités connexes de BizOps Workspace en important des données de test.
Si vous avez accès à PubNub Insights, vous pouvez y accéder en allant aux modules Gestion des utilisateurs et Gestion des canaux dans BizOps Workspace dans le portail d'administration et en cliquant sur le bouton Importer à partir d'Insights.
En conséquence, vous importerez depuis le jeu de clés de votre application un maximum de 20 utilisateurs qui ont publié le plus grand nombre de messages au cours de la dernière journée (si aucun message n'a été envoyé hier, les utilisateurs seront importés sur la base des données de la veille).
Comme pour les utilisateurs, vous pouvez importer de l'ensemble de clés de votre application jusqu'à 20 canaux ayant publié le plus grand nombre de messages au cours de la dernière journée.
Utilisez ces données de test pour explorer ce que BizOps Workspace a à offrir.
L'interface utilisateur de la gestion de la présence revue et corrigée
Type: Amélioration
Nous avons récemment redessiné l'ensemble du module de gestion de la présence dans BizOps Workspace afin de simplifier l'assistant de création de règles, de changer les couleurs des badges pour des couleurs plus inclusives et d'ajouter un modèle de configuration " catch all " qui reflète la configuration par défaut " activer la présence sur tous les canaux " de la configuration de la présence sur l'ensemble de clés.
Nous espérons que vous apprécierez sa nouvelle apparence et sa nouvelle convivialité !
Posted on July 8, 2024
Join Our Newsletter. No Spam, Only the good stuff.
Sign up to receive the latest update from our blog.