Notes de mise à jour de la documentation - juin 2024
Tags: pubnub, documentation, releases, releasenotes
Published: 2024-07-08 13:01:31

Cet article a été publié à l'origine sur [https://www.pubnub.com/docs/release-notes/2024/june](https://www.pubnub.com/docs/release-notes/2024/june?utm_source=devto&utm_medium=syndication&utm_campaign=off_domain&utm_content=fr)

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](https://pubnub.com/docs/general/push/android#step-5-construct-the-push-payload) 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 :

```js
{
  "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](https://pubnub.com/docs/general/metadata/basics#configuration) canaux pour les clients bénéficiant de [plans tarifaires payants](https://www.pubnub.com/pricing/?utm_source=devto&utm_medium=syndication&utm_campaign=off_domain&utm_content=fr), 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.

![Channel group limits](https://pubnub.com/assets/images/channel-group-limit-0dce418184343bd3e6e213b7f21f2038.png)

### É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](https://pubnub.com/docs/general/metadata/basics#app-context-events) pour plus de détails.

![User metadata events](https://pubnub.com/assets/images/user-metadata-events-2774cded452142e6d79bdf1a92e95174.png)

### 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](https://pubnub.com/docs/general/metadata/basics#configuration) atif afin d'inclure des informations sur une dépendance critique.

![Get all user or channel metadata](https://pubnub.com/assets/images/get-all-metadata-bf21a99e67f554e65c818b7b71fb9011.png)

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**](https://pubnub.com/docs/general/metadata/basics#configuration) ", 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.

![Referential integrity flag](https://pubnub.com/assets/images/referential-integrity-2288af8171ffc0c8a5c8b67d82106247.png)

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](https://pubnub.com/docs/sdks/python/api-reference/publish-and-subscribe) 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](https://pubnub.com/docs/sdks/react) et de la déplacer dans la section [Call For Contributions (appel à contribution](https://pubnub.com/docs/sdks#call-for-contributions) ) 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](https://github.com/pubnub/react) 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](https://pubnub.com/docs/general/portal/functions#export-logs-through-events--actions) vers un service externe.

![Functions log](https://pubnub.com/assets/images/functions-log-c9c6bfa2ae883d738837c6fee563167d.png)

Perspectives 📊
---------------

### Durée de l'utilisateur et métriques de l'appareil dans les documents de l'API REST

**Type**: Amélioration

Le[mois dernier](https://pubnub.com/docs/release-notes/2024/may#device-metrics-dashboard), 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](https://pubnub.com/docs/sdks/rest-api/introduction-16) 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).

![Top 20 users](https://pubnub.com/assets/images/top-20-users-346c252e218d37df861ff5ac04538f48.png)

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.

![Top 20 channels](https://pubnub.com/assets/images/top-20-channels-53fad13cd8e1f9a7619aee7330b2fffa.png)

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](https://pubnub.com/docs/bizops-workspace/presence-management) 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.

![Presence Management](https://pubnub.com/assets/images/presence-management-7799538afb99b2c891fc6d957737d819.png)

Nous espérons que vous apprécierez sa nouvelle apparence et sa nouvelle convivialité !