Informacje o wersji dokumentacji - czerwiec 2024 r.
Tags: pubnub, documentation, releases, releasenotes
Published: 2024-07-08 12:36:46

Ten artykuł został pierwotnie opublikowany na stronie [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=pl)

Cześć! W tym miesiącu mamy dla Ciebie kilka nowych aktualizacji.

-   Wprowadziliśmy nową flagę integralności referencyjnej, która pomaga zachować spójność danych.
-   Limity grup kanałów można teraz ustawiać bezpośrednio z portalu administracyjnego.
-   Spróbuj zaimportować dane z Insights do BizOps, aby przetestować jego funkcje.
-   Ponadto zauważysz odświeżony wygląd i sposób działania Presence Management.

Poza tym wprowadziliśmy kilka drobnych, ale znaczących ulepszeń w dokumentacji, które, miejmy nadzieję, odpowiedzą na niektóre pytania lub rozwieją wszelkie wątpliwości podczas pracy z PubNub.

Miłego odkrywania i dziękujemy za bycie częścią naszej społeczności!

Ogólne 🛠️
----------

### Pola niestandardowe w ładunkach FCM

**Typ**: Ulepszenie

Poprawiliśmy dokumentację dla [Android Mobile Push Notifications](https://pubnub.com/docs/general/push/android#step-5-construct-the-push-payload), dodając brakujące niestandardowe parametry PubNub, które można dodać do ładunku FCM Mobile Push Notification: `pn_debug`, `pn_exceptions` i `pn_dry_run`.

Umożliwiają one testowanie lub debugowanie powiadomień oraz wykluczanie wybranych urządzeń z otrzymywania powiadomień.

Oto przykładowy ładunek FCM z naszymi niestandardowymi polami:

```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
}
```

### Limity grupy kanałów

**Typ**: Nowa funkcja

Kontroler strumienia w portalu administracyjnym ma nową, konfigurowalną opcję [limitu grupy](https://pubnub.com/docs/general/metadata/basics#configuration) kanałów dla klientów korzystających z [płatnych planów cenowych](https://www.pubnub.com/pricing/?utm_source=devto&utm_medium=syndication&utm_campaign=off_domain&utm_content=pl), która pozwala ustawić limity maksymalnej liczby kanałów, które mogą mieć grupy kanałów w zestawie kluczy. Można obniżyć domyślny limit 1000 kanałów lub zwiększyć go do 2000 kanałów.

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

### Zdarzenia metadanych użytkownika w kontekście aplikacji

**Typ**: Ulepszenie

Poprawiliśmy dokumentację, aby wyjaśnić, że przy włączonej opcji **User Metadata Events** każda modyfikacja jednostki użytkownika`(ustawienie` i `usunięcie`) powoduje wysłanie powiadomień o zdarzeniach do wszystkich stowarzyszeń członkowskich, a więc zarówno tego użytkownika, jak i każdego kanału, którego jest członkiem. Szczegółowe informacje można znaleźć w [dokumentacji](https://pubnub.com/docs/general/metadata/basics#app-context-events).

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

### Zależność konfiguracji App Context

**Typ**: Ulepszenie

Zaktualizowaliśmy dokumentację dotyczącą [opcji konfiguracji](https://pubnub.com/docs/general/metadata/basics#configuration) App Context, aby uwzględnić informacje o krytycznej zależności.

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

Chociaż opcje Disallow Get **All Channel Metadata** i **Disallow Get All User Metadata** wydają się dość oczywiste, zastrzeżenie polega na tym, że opcje te działają tylko z włączonym Menedżerem dostępu.

Innymi słowy, bez Menedżera dostępu te aktywne opcje nie wyłączają pobierania metadanych o użytkownikach lub kanałach na zestawie klawiszy. Jednocześnie po włączeniu Menedżera dostępu, który domyślnie ogranicza dostęp do wszystkich obiektów w zestawie kluczy, można łatwo ominąć ograniczenia GET Menedżera dostępu dla użytkowników i kanałów, usuwając zaznaczenie obu tych opcji konfiguracji bez tworzenia szczegółowego schematu uprawnień.

Interfejs użytkownika portalu administracyjnego wkrótce również odzwierciedli tę zależność.

### Nowa flaga integralności referencyjnej w App Context

**Typ**: Nowa funkcja

Dodaliśmy nową opcję [**Wymuś integralność referencyjną dla członkostwa**](https://pubnub.com/docs/general/metadata/basics#configuration), która jest domyślnie włączona po włączeniu App Context w zestawie kluczy aplikacji w portalu administracyjnym.

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

Flaga ta zapewnia, że można ustawić nowe członkostwo tylko wtedy, gdy istnieje zarówno identyfikator użytkownika, jak i identyfikator kanału, dla którego utworzono członkostwo. Jednocześnie usunięcie nadrzędnej jednostki metadanych użytkownika lub kanału automatycznie usuwa wszelkie podrzędne skojarzenia członkostwa dla tej usuniętej jednostki. W ten sposób można upewnić się, że w zestawie kluczy nie ma nieprawidłowo działających lub osieroconych obiektów członkowskich.

SDK 📦
------

### Ulepszenia dokumentacji Python

**Typ**: Ulepszenie

Po otrzymaniu informacji zwrotnych rozszerzyliśmy informacje na temat użycia i wykonywania metod. W rezultacie każda sekcja Returns w [dokumentacji Python SDK](https://pubnub.com/docs/sdks/python/api-reference/publish-and-subscribe) opisuje teraz pola danych zwracane przez każdą metodę. Wyjaśnia również, w jaki sposób wykonanie żądania synchronicznego (`.``sync()`) i asynchronicznego (`.pn_async(callback)`) wpływa na zwracane dane dla każdej metody.

### React SDK został przestarzały

**Typ**: Powiadomienie o deprecjacji

Ponieważ od jakiegoś czasu nie rozwijamy aktywnie React SDK, zdecydowaliśmy się w końcu oficjalnie zdeprecjonować jego [dokumentację](https://pubnub.com/docs/sdks/react) i przenieść ją do sekcji [Call For Contributions](https://pubnub.com/docs/sdks#call-for-contributions) w naszych dokumentach.

Jeśli znajdziesz błąd w React SDK lub chcesz rozszerzyć jego funkcjonalność, możesz utworzyć pull request w [repozytorium](https://github.com/pubnub/react) i poczekać na naszą opinię!

Funkcje
-------

### Eksportowanie logów funkcji poprzez zdarzenia i akcje

**Typ**: Nowa funkcja

Każda funkcja PubNub zapisuje logi w wewnętrznym kanale `blocks-output-*`, takim jak `blocks-output-NSPiAuYKsWSxJl4yBn30`, który może przechowywać do 250 wierszy logów, zanim nowe je nadpiszą. Jeśli nie chcesz stracić starych dzienników, możesz teraz użyć funkcji Events & Actions, aby [wyeksportować te dzienniki](https://pubnub.com/docs/general/portal/functions#export-logs-through-events--actions) do usługi zewnętrznej.

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

Insights 📊
-----------

### Czas trwania użytkownika i metryki urządzeń w dokumentacji interfejsu API REST

**Typ**: Ulepszenie

[W zeszłym miesiącu](https://pubnub.com/docs/release-notes/2024/may#device-metrics-dashboard) wprowadziliśmy metryki urządzeń do pulpitu nawigacyjnego `Zachowanie użytkownika` w PubNub Insights na portalu administratora. W tym miesiącu zaktualizowaliśmy dokumentację interfejsu [API R](https://pubnub.com/docs/sdks/rest-api/introduction-16) EST, aby uwzględnić zarówno czas trwania użytkownika, jak i metryki urządzenia, dzięki czemu można bezpośrednio wywołać interfejs API PubNub Insights, aby uzyskać interesujące metryki.

BizOps Workspace 🏢
-------------------

### Top 20 użytkowników/kanałów

**Typ**: Nowa funkcja

Jeśli nie używasz App Context do przechowywania i zarządzania użytkownikami i kanałami, nadal możesz przetestować powiązane funkcje BizOps Workspace, importując dane testowe.

Jeśli masz dostęp do PubNub Insights, możesz uzyskać do niego dostęp, przechodząc do modułów **User Management** i **Channel Management** w BizOps Workspace w Admin Portal i klikając przycisk **Import from Insights**.

W rezultacie zaimportujesz z zestawu kluczy aplikacji maksymalnie 20 użytkowników, którzy opublikowali największą liczbę wiadomości w ciągu ostatniego dnia (jeśli wczoraj nie wysłano żadnych wiadomości, użytkownicy zostaną zaimportowani na podstawie danych z poprzedniego dnia).

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

Podobnie jak w przypadku użytkowników, można zaimportować z zestawu kluczy aplikacji do 20 kanałów z największą liczbą wiadomości opublikowanych w ciągu ostatniego dnia.

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

Użyj tych danych testowych, aby poznać możliwości BizOps Workspace.

### Odświeżony interfejs zarządzania obecnością

**Typ**: Ulepszenie

Niedawno przeprojektowaliśmy cały moduł zarządzania [obecnością](https://pubnub.com/docs/bizops-workspace/presence-management) w BizOps Workspace, aby uprościć kreator tworzenia reguł, zmienić kolory odznak na bardziej integracyjne i dodać konfigurację wzorca "catch all", która odzwierciedla domyślną konfigurację "włącz obecność na wszystkich kanałach" konfiguracji obecności w zestawie kluczy.

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

Mamy nadzieję, że spodoba ci się jego nowy wygląd!