Informacje o wersji dokumentacji - czerwiec 2024 r.

Ten artykuł został pierwotnie opublikowany na stronie https://www.pubnub.com/docs/release-notes/2024/june

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, 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:

{
  "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 kanałów dla klientów korzystających z płatnych planów cenowych, 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.

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.

Zależność konfiguracji App Context

Typ: Ulepszenie

Zaktualizowaliśmy dokumentację dotyczącą opcji konfiguracji App Context, aby uwzględnić informacje o krytycznej zależności.

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, która jest domyślnie włączona po włączeniu App Context w zestawie kluczy aplikacji w portalu administracyjnym.

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 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ę i przenieść ją do sekcji 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 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 do usługi zewnętrznej.

Insights 📊

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

Typ: Ulepszenie

W zeszłym miesiącu 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 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).

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.

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ą 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.

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