Notes de mise à jour de la documentation - juin 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é !