Synchronizacja i integracje

Synchronizacja automatycznie odzwierciedla osoby z innych systemów na liście Users, dzięki czemu dostęp do drzwi podąża za danymi ze źródeł zewnętrznych bez ręcznego wprowadzania. Ta strona omawia trzy źródła synchronizacji, synchronizację personelu Performance Hub, identyfikatory, okna Access Time Windows należące do źródła, aktualność danych i mapowanie zakresów, usuwanie, rozwiązywanie duplikatów, panel aktywności synchronizacji, zaproszenia i zbiorcze usuwanie. Wszystko konfiguruje się w obszarze Settings → Sync settings.

Synchronizacja Performance Hub staff jest domyślnie włączona. Synchronizacja z integracji i Computer Vision jest domyślnie wyłączona, aby istniejące obiekty zachowały ręcznie zarządzaną listę; nic nie jest z nich synchronizowane, dopóki nie włączysz źródła.

Źródła synchronizacji

Rysunek 1: Ustawienia synchronizacji

Każdy blok ma własny przełącznik włączania i pokazuje czas ostatniego uruchomienia oraz liczniki (lub Never run).

W przypadku źródła Integrations można też włączać lub wyłączać poszczególne integracje w sekcji Sync from these integrations — "Turn off an integration to stop mirroring its people. People already synced stay until you remove them." Opcja Show all integrations rozwija pełną listę.

Wymagany identyfikator

Osoby logują się do aplikacji mobilnej za pomocą jednorazowego kodu wysłanego na telefon lub adres e-mail, więc rekord bez żadnego z nich jest bezużyteczny dla dostępu do drzwi. Lista rozwijana Require identifier określa, które rekordy są synchronizowane:

Rekordy, które nie spełniają wymagania, są pomijane (i pojawiają się w panelu aktywności synchronizacji jako pominięte z powodu braku identyfikatora).

Mapowanie Access Time Windows i aktualność źródła

Każda integracja dostarczająca okna Access Time Windows ma własne ustawienia:

• Access Time Window mapping — "Map each partner scope key to facility doors or Access Scopes. Unknown and unmapped keys fail closed." Każda integracja może mieć do 50 mapowań, w tym klucz default. Klucz dodaje się w sekcji Add partner scope key.
• Source freshness policy — ustawienie bezpieczeństwa: "Choose how old a partner snapshot may be before all of its windows fail closed." Ustaw je zgodnie z tym, jak często integracja deklaruje wysyłanie aktualizacji, aby okna z integracji, która przestała się aktualizować, nie przyznawały dalej dostępu.

Informacje o tym, jak aktualizowane są okna z integracji, znajdziesz w sekcji Migawki Access Time Windows.

Personel Performance Hub

Rysunek 2: Źródło Performance Hub staff

"Anyone whose Performance Hub roles cover this facility is added to Users automatically and kept in step with Performance Hub IAM." Na przykład personel sklepów sieci handlowej otrzymuje dostęp do drzwi zaplecza, bez konieczności ręcznego dodawania pracowników.

• Personel (użytkownicy Performance Hub) jest synchronizowany z tagami Performance Hub staff, Role: … (po jednym dla każdej roli) oraz, w przypadku administratorów organizacji, Organisation admin.
• Edytowalna zasada Access Policy Performance Hub staff jest tworzona jednorazowo dla każdego obiektu i przepuszcza ten tag przez wszystkie drzwi o dowolnej porze. Karta pokazuje, czy zasada jest aktywna, wraz z opcją Edit policy. Zasadę można edytować lub wyłączyć jak każdą inną Access Policy.
• Role pokazuje, które role są uwzględnione. Role do uwzględnienia lub wykluczenia ustawia administrator organizacji w Organisation Settings; pozostali administratorzy widzą komunikat "Ask an organisation admin to change this in Organisation Settings."
• Wyłączenie synchronizacji wymaga potwierdzenia ("Turn off Performance Hub staff sync?").

Dane personelu są zarządzane w Performance Hub IAM i są tylko do odczytu na liście Users. Aby odebrać pracownikowi dostęp do drzwi, zobacz Users → Performance Hub staff.

Kiedy działa synchronizacja

Co aktualizuje synchronizacja — i czego nigdy nie zmienia

Przy każdym przebiegu zsynchronizowane wiersze są odświeżane ze źródła:

Możesz więc bezpiecznie wyłączyć zsynchronizowanego użytkownika, nadać mu uprawnienia lub oznaczyć go tagiem — synchronizacja tego nie cofnie.

Odłączanie: wyłączenie opcji Track source updates w panelu użytkownika sprawia, że synchronizacja całkowicie pomija ten wiersz — zmiany imienia i nazwiska oraz danych kontaktowych pozostają, a usunięcia w źródle przestają mieć na niego wpływ. Zobacz Użytkownicy.

W przypadku źródła dostarczającego okna Access Time Windows odłączenie usuwa też okna tego źródła po wyraźnym potwierdzeniu. Ponowne połączenie przywraca je przy następnej udanej, kompletnej migawce; nie przywraca okien z pamięci podręcznej po nieudanym pobraniu.

Usuwanie

Gdy członek zostanie usunięty w integracji, jego dostęp do drzwi jest odbierany (Removed by integration). Jego wiersz na liście Users nie jest usuwany, więc historia zostaje zachowana.

Jeśli synchronizacja miałaby jednocześnie usunąć nietypowo dużą liczbę osób, te usunięcia są wstrzymywane do przeglądu (N removals held back for review). Usunięcia wynikające z integracji powyżej limitu bezpieczeństwa czekają na przegląd przez administratora przed zastosowaniem, aby błędne pobranie danych z integracji nie mogło odebrać dostępu wszystkim naraz.

Migawki Access Time Windows

Każda integracja aktualizuje wyłącznie własną partycję źródła. Jej aktualizacja członka to kompletna migawka okien z monotonicznie rosnącym numerem rewizji:

• Pominięcie danych okien pozostawia bieżącą migawkę źródła bez zmian.
• Nowsza migawka zastępuje pełną listę danego źródła.
• Ta sama rewizja z tymi samymi znormalizowanymi danymi to idempotentne powtórzenie.
• Ta sama rewizja z innymi danymi to konflikt; starsza rewizja jest pomijana jako nieaktualna.
• Nowsza pusta migawka jawnie odwołuje okna danego źródła.
• Nieudane lub niekompletne pobranie danych ze źródła nie może wysłać żadnej migawki, nigdy pustej ani częściowej.

Każdy stały klucz źródła scope_key (w tym default) jest mapowany na cele obejmujące cały obiekt, drzwi lub Access Scope w sekcji Access Time Window mapping. Nieznane lub wyłączone mapowania domyślnie blokują dostęp. Ustawienia pokazują też wiek źródła i zasadę aktualności źródła danej integracji.

Rozwiązywanie duplikatów

Rysunek 3: Rozwiązywanie duplikatów

"Gdy dwie osoby mają ten sam adres e-mail lub numer telefonu, tylko jedna z nich może zostać zsynchronizowana w sekcji Użytkownicy. Wybierz, kto zachowuje miejsce; druga osoba zostanie oznaczona jako konflikt i nie zostanie zsynchronizowana."

• Prefer the active person — "A person with an active status always wins over an expired one. Turn off to apply the tiebreaker regardless of status."
• Tiebreaker — używane, gdy status nie rozstrzyga, np. Oldest By Date Of Birth, Then Earliest Start Date.

Drugi rekord wyświetla na liście Users stan Not synced – duplicate i jest liczony w kafelku Not synced. Na przykład przychodnia może zachować jeden rekord, gdy lekarz jest jednocześnie pracownikiem i członkiem-pacjentem.

Automatyczne zaproszenia do aplikacji

W sekcji App invitations opcja Auto-send app invitations wysyła e-mail do uprawnionych zsynchronizowanych użytkowników, którzy nie otrzymali jeszcze zaproszenia, a Advanced recipient rules pozwalają ograniczyć, kto je otrzymuje. Send invitations… wysyła zaproszenia zbiorczo do istniejących użytkowników po przejrzeniu listy odbiorców. Szczegóły znajdziesz w sekcji Zaproszenia.

Aktywność synchronizacji i rozwiązywanie problemów

Rozwiń Sync activity & troubleshooting, aby "see why recent records did or did not sync." Możesz wyszukiwać według imienia i nazwiska, identyfikatora lub powodu oraz odświeżyć listę przyciskiem Refresh. Każdy wpis ma plakietkę wyniku:

Możliwe powody pominięcia:

Kliknięcie wpisu otwiera Sync activity detail z pełnym rekordem: imieniem i nazwiskiem, identyfikatorem zewnętrznym, źródłem, integracją, powodem oraz identyfikatorami do przekazania zespołowi wsparcia.

Zbiorcze usuwanie zsynchronizowanych użytkowników

Aby usunąć użytkowników pochodzących z integracji (np. po jej odłączeniu), użyj opcji Bulk delete synced users. Przed usunięciem czegokolwiek przeglądasz dokładną listę.

1. W sekcji Bulk delete synced users kliknij Bulk delete…
2. Wybierz zakres: All integration-synced users lub pojedynczą integrację. Kliknij Preview.
3. Przejrzyj: okno dialogowe pokazuje dokładnie, ilu użytkowników zostanie usuniętych (wraz z przykładową listą). Zwróć uwagę na ostrzeżenie — This cannot be undone, a wszystkie dostosowania administratora w tych wierszach (uprawnienia, tagi niestandardowe, notatki) zostaną utracone. Historia rejestru dostępu użytkowników jest zachowywana.
4. Opcja Also turn off syncing from this integration (recommended) jest domyślnie zaznaczona — pozostaw ją włączoną, w przeciwnym razie ci sami użytkownicy zostaną odtworzeni przy następnym przebiegu synchronizacji (bez dawnych dostosowań).
5. Zaznacz I understand this is permanent and customisations will be lost, a następnie kliknij Delete N.

Jeśli zestaw użytkowników zmienił się między podglądem a potwierdzeniem, zostaniesz poproszony o ponowne uruchomienie podglądu — gwarantuje to usunięcie dokładnie tego, co zostało przejrzane.

Powiązane strony

• Użytkownicy — źródła, odłączanie, panel użytkownika
• Harmonogramy Access Policies — harmonogramy i ustawienia Access Time Windows
• Zaproszenia
• Rozwiązywanie problemów — instrukcje dla problemów typu "brakujący / nieaktualny użytkownik"