Użytkownicy
Na tej stronie
Karta Users zawiera listę wszystkich osób, które mogą (lub mogły) korzystać z aplikacji mobilnej do otwierania drzwi w tym obiekcie. Ta strona omawia dodawanie użytkowników, import i eksport CSV, przypisanie Access Policy, stałe uprawnienia, osobne okna Access Time Windows administratora i integracji, wyłącznik awaryjny dostępu, aktywność w aplikacji, sesje i usuwanie.


Rysunek 1: Karta Users
Skąd pochodzą użytkownicy
Każdy wiersz ma źródło, które informuje, jak został utworzony:
| Źródło | Plakietka | Jak pojawiają się wiersze | Kto utrzymuje dane |
|---|---|---|---|
| Manually added | Manual | Administrator kliknął Add user lub użył opcji Import (CSV) | Administratorzy |
| External Integration | Integration (lub nazwa partnera) | Synchronizowane automatycznie z integracji do zarządzania członkami | Synchronizacja — zsynchronizowane pola są nadpisywane przy każdym przebiegu |
| CCTV/Computer Vision | CCTV/Computer Vision | Synchronizowane ze zidentyfikowanych osób w module CCTV | Synchronizacja |
| Performance Hub staff | Performance Hub staff | Synchronizowane automatycznie z Performance Hub IAM dla personelu, którego role obejmują ten obiekt | Performance Hub IAM |
Synchronizacja personelu Performance Hub jest domyślnie włączona; synchronizacja z integracji i Computer Vision jest domyślnie wyłączona. Konfiguruje się je w obszarze Settings → Sync settings — zobacz Synchronizacja i integracje.
Wiersz wymaga co najmniej numeru telefonu komórkowego lub adresu e-mail — to za ich pomocą osoba loguje się do aplikacji mobilnej jednorazowym kodem.
Statystyki i filtry


Rysunek 2: Kafelki statystyk
| Kafelek | Pokazuje |
|---|---|
| All users | Wszystkich użytkowników w tym obiekcie |
| Has access | Użytkowników, którzy mogą obecnie otworzyć co najmniej jedne drzwi |
| No access | Użytkowników, którzy nie mogą obecnie otworzyć żadnych drzwi |
| Not synced | Rekordy wstrzymane przez synchronizację, na przykład duplikaty |
Kliknij kafelek, aby przefiltrować listę. (Wybranie kafelka resetuje też filtr Source).


Rysunek 3: Wyszukiwanie, Eksportuj CSV, Import, Add user, filtry i sortowanie
- Search — dopasowuje imię i nazwisko, telefon lub adres e-mail.
- Eksportuj CSV — pobiera bieżącą przefiltrowaną listę. Na przykład siłownia może wyeksportować użytkowników No access przed kampanią odzyskiwania klientów.
- Import i Add user — zobacz poniżej.
- Filtry:
| Filtr | Opcje |
|---|---|
| Source | All sources, Manually added, External Integration, CCTV/Computer Vision, Performance Hub staff |
| Access | Any status, Has access, No access, Disabled, Without grants |
| Membership status | Any membership + statusy występujące w Twoich danych |
| Person type | Any type + typy występujące w Twoich danych |
| Tag | Any tag + tagi występujące w Twoich danych |
| Invitation | Any invitation, Invited, Not invited, Send failed |
| App adoption | Any adoption, Active (korzystał z aplikacji), Not yet active |
| Sync status | Any status lub tylko rekordy wstrzymane przez synchronizację (na przykład duplikaty) |
- Sort by — Name, Recently added, Recently updated, Last used, Last synced; z przełącznikiem rosnąco/malejąco.
- Clear filters pojawia się, gdy aktywne jest wyszukiwanie lub filtr.
Odczytywanie wiersza użytkownika


Rysunek 4: Wiersze użytkowników z plakietkami
| Plakietka | Znaczenie |
|---|---|
| Manual / Integration / CCTV/Computer Vision (lub nazwa partnera) | Źródło wiersza |
| Performance Hub staff | Wiersz jest synchronizowany z Performance Hub IAM |
| Message | Użytkownik ma aktywną wiadomość w aplikacji (kolor zależy od ważności) |
| Disabled | Opcja Access enabled jest wyłączona — użytkownik nie może niczego otworzyć; wiersz jest przyciemniony |
| Access granted via policy | Co najmniej jedna włączona zasada Access Policy może dopasować tego użytkownika i skonfigurowane drzwi teraz lub w przyszłym oknie zasady |
| Access via time windows | Użytkownik ma okna Access Time Windows należące do administratora lub integracji; otwórz wiersz, aby sprawdzić, czy są aktywne, nadchodzące, wygasłe, nieaktualne czy niezmapowane |
| Grants | Użytkownik ma osobne stałe uprawnienia indywidualne |
| Not synced – duplicate | Inny rekord z tym samym adresem e-mail lub telefonem zachował miejsce; ten nie jest synchronizowany. Zobacz Rozwiązywanie duplikatów |
| Invited | Wysłano e-mail z zaproszeniem, a użytkownik nie skorzystał jeszcze z aplikacji |
| Status członkostwa (np. Current, Expired) | Status członkostwa użytkownika z systemu źródłowego |
Zsynchronizowane wiersze pokazują też pod imieniem i nazwiskiem External ID lub Computer Vision ID. Wiersze personelu pokazują zamiast tego role w Performance Hub.
Duże listy ładują się stopniowo: podczas ładowania reszty listy na jej dole wyświetla się N more users loading….
Ręczne dodawanie użytkownika
- Kliknij Add user.


Rysunek 5: Okno dialogowe Add user
- Wypełnij pola First name, Last name oraz co najmniej jedno z pól Mobile phone lub Email — "At least one of mobile phone or email is required for OTP login." Numery telefonów są normalizowane do formatu międzynarodowego.
- Opcjonalnie ustaw Person type (np. Gold, Trial, Staff), Custom tags (rozdzielone przecinkami; istniejące tagi są wymienione pod polem) i Notes.
- Zaznacz Send email invitation, aby od razu wysłać tej osobie e-mailem linki do pobrania aplikacji (wymaga adresu e-mail; bez niego pole wyboru jest nieaktywne).
- Kliknij Add user.
Jeśli użytkownik z tym samym telefonem lub adresem e-mail już istnieje w tym obiekcie, okno dialogowe o tym informuje i zamiast tworzyć duplikat proponuje Open existing user.
Samo dodanie użytkownika nie umożliwia mu przejścia przez żadne drzwi. Nadal potrzebuje pasującej zasady Access Policy, stałego uprawnienia lub osobnego okna Access Time Window administratora lub integracji.
Importowanie użytkowników z pliku CSV
Kliknij Import, aby zbiorczo utworzyć użytkowników z arkusza kalkulacyjnego. Maksymalnie 200 użytkowników na import.


Rysunek 6: Kreator importu CSV
Krok 1 — Prześlij plik CSV. Przeciągnij plik .csv lub kliknij, aby go wybrać. Download template udostępnia plik startowy z prawidłowymi nagłówkami.
Krok 2 — Zmapuj pola. Każda kolumna CSV jest mapowana na pole: First name, Last name, Mobile phone, Email, Person type, Tags, Notes, Access enabled, Door grants, Scope grants — lub Do not import. Typowe nazwy nagłówków (np. mobile, phone, groups) są mapowane automatycznie. Musisz zmapować co najmniej kolumnę telefonu komórkowego lub adresu e-mail.
- Access enabled akceptuje
true/yes/enabled/1/on/y/activeorazfalse/no/disabled/0/off/n/inactive. - Door grants / Scope grants przyjmują nazwy drzwi lub Access Scopes; niedopasowane nazwy są oznaczane w podglądzie.
Krok 3 — Podgląd i import. Przejrzyj pierwsze wiersze, zdecyduj, czy włączyć Send invitation email to imported users (zapraszani są tylko użytkownicy z adresem e-mail), a następnie kliknij Import. Wyniki pokazują liczniki Imported, Skipped (already exist) i Errors.
Panel szczegółów użytkownika
Kliknij dowolny wiersz, aby otworzyć panel użytkownika.


Rysunek 7: Panel zsynchronizowanego członka
Profil i tożsamość
Nagłówek pokazuje źródło, status członkostwa, External ID oraz to, czy zasada przyznaje użytkownikowi dostęp.
- First name / Last name / Mobile phone / Email — w przypadku zsynchronizowanych użytkowników są nadpisywane przy każdym przebiegu synchronizacji, chyba że wiersz jest odłączony (poniżej).
- Person type i Membership status — używane przez warunki Who w Access Policy.
- Synced tags (tylko do odczytu, z systemu źródłowego) i Custom tags (należące do administratora, nigdy nienadpisywane przez synchronizację). Oba rodzaje mogą spełniać warunki tagów zasad.
- Notes — dowolny tekst, do 2000 znaków.
Wiadomość w aplikacji
App messaging ustawia osobistą wiadomość wyświetlaną na pulpicie aplikacji tego użytkownika, nad banerem dla całego obiektu, gdy oba są aktywne. Gdy obowiązuje wiadomość automatyczna, panel pokazuje ją wraz z opcjami wyłączenia automatyzacji dla tego użytkownika. Zobacz Wiadomości w aplikacji.
Track source updates (tylko użytkownicy synchronizowani)
W przypadku użytkowników z Integration/CCTV przełącznik Track source updates określa, czy synchronizacja nadal nadpisuje wiersz:
- Włączony (domyślnie): imię i nazwisko, telefon, adres e-mail, typ, status, zsynchronizowane tagi i okna Access Time Windows należące do źródła są odświeżane przy udanych synchronizacjach.
- Wyłączony (odłączony): po wyraźnym potwierdzeniu okna Access Time Windows należące do źródła są usuwane, a synchronizacja całkowicie pomija ten wiersz. Twoje ręczne zmiany i okna należące do administratora są zachowywane, a usunięcia w źródle przestają mieć na niego wpływ. Wiersz ma plakietkę Decoupled.
Włącz przełącznik ponownie, aby połączyć wiersz ponownie. Bieżąca migawka okien źródła jest przywracana przy następnej udanej, kompletnej synchronizacji, a nie z nieudanego lub częściowego pobrania danych ze źródła.
Panele zsynchronizowanych użytkowników zawierają też linki do rekordu źródłowego (rekordu integracji lub osoby w Computer Vision).
Usunięto przez integrację
Gdy członek zostanie usunięty w integracji, jego dostęp do drzwi jest odbierany, a panel pokazuje Removed by integration. Wiersz pozostaje na liście, więc jego historia jest zachowywana. Zobacz Synchronizacja i integracje.
Kontrola dostępu


Rysunek 8: Sekcja Access Control
Sekcja Access Control zbiera w jednym miejscu ustawienia autoryzacji użytkownika: wyłącznik awaryjny dostępu, objęcie zasadami, dodatkowy stały dostęp oraz okna Access Time Windows administratora i integracji.
Access enabled (wyłącznik awaryjny)
Przełącznik Access enabled natychmiast blokuje lub przywraca cały dostęp do drzwi dla tego użytkownika. Gdy jest wyłączony:
- Każda próba otwarcia przez członka jest odrzucana (powód: access disabled), niezależnie od zasad, uprawnień czy okien Access Time Windows.
- Wiersz ma plakietkę Disabled i jest przyciemniony na liście.
Użyj tej opcji, aby natychmiast zawiesić dostęp osoby bez usuwania jej rekordu ani zmieniania zasad.
Dodatkowy stały dostęp
Uprawnienia dają tej konkretnej osobie dostęp oprócz tego, na co pozwalają zasady Access Policies obiektu. Gdy zasada już obejmuje użytkownika, sekcja pokazuje Allowed by policy oraz "This user's door access is set by policy — no manual grants are needed." Kliknij Show, aby otworzyć edytor uprawnień:
| Uprawnienie | Efekt |
|---|---|
| Facility-wide | Wszystkie drzwi w obiekcie (gdy włączone, zastępuje listy drzwi i zakresów) |
| Door grants | Zaznacz poszczególne drzwi |
| Scope grants | Zaznacz Access Scopes — użytkownik otrzymuje wszystkie drzwi w zakresie, w tym drzwi dodane do zakresu później |
Drzwi, które są już objęte zasadą, są oznaczone jako Already covered by policy lub Set by policy, dzięki czemu widać, gdzie ręczne uprawnienie nie jest potrzebne. Uprawnienia mogą mieć własne godziny działania, ograniczające, kiedy obowiązują. Clear all usuwa wszystkie uprawnienia naraz. Automatyczny import zasad i późniejsze zmiany zasad nie zmieniają stałych uprawnień.
Wskaźniki zasad i uprawnień są addytywne. Usunięcie zbędnego ręcznego uprawnienia nie usuwa dostępu z zasady, a edycja zasady nie usuwa uprawnienia.
Okna czasowe dostępu
Sekcja Access Time Windows zarządza tymczasowym addytywnym dostępem tej osoby za pomocą opcji Add one-time window i Add weekly window (maksymalnie 50):
- Okna bezwzględne i tygodniowe należące do administratora można edytować; mogą obejmować obiekt, wybrane drzwi lub Access Scopes.
- Okna należące do integracji są tylko do odczytu i pokazują źródło, identyfikator źródła, zadeklarowaną strefę czasową, mapowanie logicznego zakresu, wiek źródła i stan aktualności.
- Stany aktywny, nadchodzący, wygasły, nieaktualny i niezmapowany są pokazywane osobno. Nieaktualne lub niezmapowane okno nie przyznaje dostępu, ale zasady Access Policies i stałe uprawnienia pozostają dostępne jako ścieżki zapasowe.
- Dokładne momenty używają granic
[from, to). Okna tygodniowe używają wyświetlanej strefy czasowej IANA i jej reguł czasu letniego.
Panel zawiera uwagę: "Time windows add access. They do not restrict existing rules or grants." Zobacz Harmonogramy Access Policies.
Zaproszenie
Pokazuje, czy e-mail z zaproszeniem do aplikacji został wysłany, kiedy i czy wysyłka się nie powiodła; przycisk ma etykietę Send invitation email lub Resend invitation email. Zaproszenia są wysyłane wyłącznie e-mailem. Szczegóły znajdziesz w sekcji Zaproszenia.
Sesje i aktywność w aplikacji
- App activity — Last used the app ze znacznikiem czasu (lub "Hasn't used the app yet.") oraz ostatnie adresy IP.
- Sessions — Sign out of app unieważnia sesję aplikacji użytkownika: "This revokes the user's app session. They'll need to sign in again to unlock doors." Uwaga: "Sessions are revoked immediately, but if the user is currently signed in it may take up to 15 minutes before they're fully signed out of the app." Ponieważ sesje są powiązane z telefonem lub adresem e-mail, osoba używająca tego samego telefonu lub adresu e-mail w innym obiekcie zostanie wylogowana również tam.
Usuwanie użytkownika


Rysunek 9: Strefa zagrożenia
Delete user usuwa wiersz z listy Users. "Their access log history is kept for the audit trail." Usunięcie natychmiast wyłącza też dostęp użytkownika. W przypadku zsynchronizowanych użytkowników pamiętaj, że osoba może pojawić się ponownie przy następnej synchronizacji, chyba że wyłączysz też integrację lub odłączysz wiersz — aby usunąć użytkowników z całych integracji, użyj opcji Bulk delete synced users w sekcji Synchronizacja i integracje.
Personel Performance Hub


Rysunek 10: Panel członka personelu Performance Hub
Panel członka personelu ma baner Synced from Performance Hub IAM. Personel jest dodawany automatycznie, ponieważ jego role w Performance Hub obejmują ten obiekt, i usuwany, gdy ten dostęp się kończy. Baner zawiera listę ról.
- Imię i nazwisko, adres e-mail, telefon i typ osoby są zarządzane w Performance Hub IAM i są tu tylko do odczytu.
- Synced tags (takie jak Performance Hub staff i Role: …) są nadpisywane przy każdej synchronizacji. Nadal możesz dodawać Custom tags i Notes.
- Członków personelu nie można tu usunąć. Usuń ich dostęp do obiektu w Performance Hub IAM lub wyłącz Access enabled, aby natychmiast odebrać im dostęp do drzwi.
Zobacz Synchronizacja personelu Performance Hub.