Informacje referencyjne
Na tej stronie
Kompletne tabele dla Door & Gate Access: wszystkie stany zdarzeń, powody odmowy, ustawienia, wartości domyślne, limity i wartości opcji w jednym miejscu. Na tej stronie sprawdzisz, co dokładnie oznacza dana wartość; powiązane przewodniki wyjaśniają, jak korzystać z poszczególnych funkcji.
Stany zdarzeń dostępu
Wyświetlane w Rejestrach dostępu:
| Stan | Znaczenie |
|---|---|
| Request received | Żądanie otwarcia dotarło i jest oceniane (stan przejściowy) |
| Pending | Żądanie przeszło kontrole i oczekuje na wysłanie (stan przejściowy) |
| Unlocked | Otwarcie zostało zgłoszone jako udane |
| Confirmed unlocked | Kontroler drzwi potwierdził zwolnienie przekaźnika |
| Admin Unlocked | Administrator wywołał otwarcie z Performance Hub (nadpisanie przez administratora); zapisywane w momencie wysłania polecenia |
| Denied | Żądanie zostało odrzucone — zobacz powód odmowy w zdarzeniu |
| Timed out | Polecenie zostało wysłane, ale kontroler nie potwierdził go na czas |
| Failed | Otwarcia nie udało się zakończyć z powodu błędu |
| Locked by staff | Personel użył Lock now, gdy harmonogram automatycznego otwierania utrzymywał drzwi otwarte (zdarzenie harmonogramu, a nie próba otwarcia) |
| Schedule resumed | Harmonogram automatycznego otwierania ponownie przejął kontrolę (zdarzenie harmonogramu, a nie próba otwarcia) |
Cykl życia zdarzenia: odebrane → wysłane → potwierdzone otwarcie / odmowa / przekroczenie czasu / niepowodzenie.
Powody odmowy
Każde odrzucone lub nieudane otwarcie zapisuje powód. Tabela przypisuje każdemu powodowi komunikat widoczny dla członka i sposób rozwiązania problemu:
| Powód (w rejestrze) | Komunikat dla członka | Przyczyna | Rozwiązanie |
|---|---|---|---|
access_disabled | "Your access has been suspended — please contact the facility" | Przełącznik Access enabled użytkownika jest wyłączony | Włącz go ponownie w panelu użytkownika na liście Users |
no_matching_policy_or_grant | "You don't have access to this door" | Żadna zasada Access Policy nie spełniła warunków Who ORAZ Where ORAZ When i żadna sumująca się ścieżka uprawnień nie przyznała dostępu | Przejrzyj Access Policies, atrybuty użytkownika, cele/wykluczenia, harmonogram i uprawnienia |
no_matching_policy_target | "You don't have access to this door" | Żadna włączona zasada Access Policy nie obejmuje tych drzwi dla danego żądania | Dodaj drzwi lub ich Access Scope do zasady albo użyj celu obejmującego wszystkie drzwi |
no_matching_policy_audience | "You don't have access to this door" | Zasady obejmują drzwi, ale żadna nie pasuje do typu/statusu ani tagów osoby | Przejrzyj sekcję Who zasady i rekord na liście Users |
outside_policy_schedule | "Outside allowed access hours" | Who i Where pasują, ale wszystkie harmonogramy pasujących zasad są nieaktywne lub wygasły | Przejrzyj sekcję When zasady i strefę czasową obiektu |
outside_geofence | "Move closer — you're outside the location's geofence." | Zgłoszona lokalizacja jest dalej niż promień + dokładność GPS + bufor od środka geofence | Członek podchodzi bliżej; lub przejrzyj promień/pinezkę geofence |
gps_too_imprecise | "Couldn't pin down your location accurately. Try again outdoors." | Dokładność GPS telefonu jest gorsza niż próg Require GPS accuracy better than | Członek ponawia próbę na zewnątrz lub z dala od zakłóceń; lub zwiększ próg |
location_unavailable | "Couldn't read your location. Make sure Location is enabled and set to Precise, then try again." | Telefon nie zgłosił użytecznej lokalizacji | Członek włącza lokalizację (Precise) dla aplikacji |
geofence_misconfigured | Odmowa otwarcia | Geofence jest włączony, ale brakuje jego środka/pinezki — system domyślnie blokuje dostęp | Umieść pinezkę geofence w Settings → Geofencing |
device_offline | "Door is offline. Please contact the facility." | Kontroler drzwi się nie zgłosił (brak sygnału aktywności w ciągu 5 minut) | Przywróć zasilanie/połączenie sieciowe kontrolera — zobacz Rozwiązywanie problemów |
user_deleted | "You don't have access…" | Rekord Users został usunięty | Utwórz ponownie lub przywróć użytkownika |
outside_access_time_window | Drzwi niedostępne, z następnym terminem dostępności, jeśli jest znany | Przyszłe okno jest jedyną potencjalną ścieżką zezwolenia użytkownika i nie jest jeszcze aktywne | Sprawdź podaną dostępność, strefę czasową, aktualność źródła i mapowanie; Access Policies i uprawnienia nadal obowiązują niezależnie |
Niektóre wersje aplikacji przy odmowach związanych z zasadami wyświetlają ogólniejszy komunikat "You don't have access to this door" lub "Outside allowed access hours". Rejestry dostępu zachowują szczegółowy powód dla administratorów.
Zasady dostępu
| Właściwość | Znaczenie |
|---|---|
| Struktura zasady | Unikatowa nazwa, opcjonalny opis, flaga włączenia, odbiorcy Who, cele/wykluczenia Where, harmonogram When |
| Dopasowanie zasady | Who ORAZ Where ORAZ When |
| Wiele zasad | LUB; dostęp przyznaje dowolna pasująca włączona zasada |
| Who | Typ osoby z opcjonalnymi statusami LUB tagi synchronizowane/niestandardowe; puste statusy = dowolny status |
| Where | Wszystkie drzwi obiektu, Access Scopes, pojedyncze drzwi lub ich kombinacje; w obrębie danej zasady wykluczenia mają pierwszeństwo |
| When | Anytime lub okna Weekly/One-time połączone alternatywą (LUB) |
| Inne ścieżki zezwoleń | Stałe uprawnienia oraz okna nadane przez administratora lub integrację pozostają osobne i sumują się |
| Bezpieczeństwo | Nadal obowiązują: użytkownicy usunięci/wyłączeni/zablokowani przez synchronizację, usunięcie/blokada drzwi, tryb serwisowy, geofence, limity żądań i kontrole kontrolera |
| Istniejąca konfiguracja | Importowana automatycznie do równoważnych nazwanych zasad z jawnymi wartościami Who, Where i When |
Przypisanie do zasad
Rejestry dostępu identyfikują pasującą zasadę po nazwie i mogą pokazywać jej odbiorców, cel i harmonogram. Dopasowania według harmonogramu mogą też zawierać konkretny aktywny początek i koniec.
Informacje o Access Time Windows
| Właściwość | Znaczenie |
|---|---|
| Autoryzacja | Okna harmonogramu zasady stanowią jej When; okna nadane przez administratora lub integrację to osobne, sumujące się ścieżki zezwoleń |
| Granica bezwzględna | Momenty UTC w postaci liczb całkowitych sekund Unix, [from, to) |
| Strefa czasowa (bezwzględna) | Metadane do wyświetlania/audytu; nie przesuwa znaczników czasu |
| Granica Weekly | Lokalne bloki HH:mm z wyłącznym końcem |
| Strefa czasowa Weekly | Prawidłowa strefa czasowa IANA określająca dzień/godzinę zegarową i czas letni |
| Ograniczenia Weekly | Opcjonalne początek i koniec aktywności w sekundach Unix; koniec wyłączny |
| Okresy nocne/nakładanie się | Nieakceptowane; okresy nocne należy podzielić na dni, a bloki nie mogą się nakładać |
| Własność użytkownika | Administrator i każde źródło integracji są od siebie odizolowane; jedno nie może usunąć danych drugiego |
| Zakres integracji | Stały klucz scope_key źródła, domyślnie default, mapowany na cele PH; nieznane/niezmapowane domyślnie blokują dostęp |
| Aktualność źródła | Konfigurowana zgodnie z częstotliwością każdej integracji; zachowanie przy nieaktualnym źródle musi być jawnie określone |
| Bezpieczeństwo | Nigdy nie omija użytkowników wyłączonych/usuniętych/w konflikcie, blockAllAccess, trybu serwisowego, geofence, limitów żądań ani kontroli kontrolera |
Początkowe limity: 50 okien na zasadę/uprawnienie/kontener źródła; maksymalny bezwzględny zakres 90 dni; 120 znaków dla identyfikatorów/etykiet/kluczy zakresu; osiem bloków tygodniowych na dzień; nowo zapisywane wpisy nie mogą być wygasłe o więcej niż godzinę.
Ustawienia, wartości domyślne i zakresy
Ustawienia drzwi
| Ustawienie | Wartość domyślna | Zakres / opcje |
|---|---|---|
| Czas otwarcia (Hold time) | 10 sekund | 1–30 sekund |
| Tryb serwisowy (Maintenance mode) | Normal | Normal / Force open / Force closed |
| Dźwięk otwarcia drzwi (Door open sound) | Wył. | Wł. / Wył. |
| Etykieta lokalizacji drzwi | — | Dowolny tekst, maks. 64 znaki |
| Ikona | Door | 10 opcji (poniżej) |
| Harmonogram automatycznego otwierania | Wył. | Facility staffed hours lub Custom schedule, strefa czasowa obiektu |
| Czas Unlock / Lock automatycznego otwierania | At opening / At closing | At opening / At closing lub 5, 10, 15, 30, 45, 60, 90 albo 120 minut przed lub po |
| Automatyczne otwieranie w święta państwowe | Ignore holidays | Follow the facility's holiday hours / Stay locked all day / Ignore holidays |
| Autoryzacja dostępu (dla drzwi) | Access Policies | Wyświetla pasujące zasady i umożliwia blockAllAccess |
| Geofence (dla drzwi) | Inherit from facility | Inherit from facility / Override for this door / Disable geofence for this door |
| Próg stanu online | — | Kontroler jest uznawany za online, jeśli wysłał sygnał aktywności w ciągu ostatnich 5 minut |
Ikony drzwi
| Ikona | Przeznaczenie |
|---|---|
| Door | Standardowe drzwi jednoskrzydłowe (domyślnie) |
| Sliding door | Drzwi przesuwne / automatyczne |
| Double door | Drzwi dwuskrzydłowe / balkonowe |
| Garage | Brama garażowa / roleta |
| Boom gate | Szlaban / ramię zaporowe |
| Pedestrian | Wejście dla personelu / pieszych |
| Security | Drzwi z ograniczonym dostępem / drzwi bezpieczeństwa |
| Office | Biuro / pomieszczenie tylko dla personelu |
| Delivery | Rampa załadunkowa / strefa dostaw |
| Locker | Szafka / schowek |
Ustawienia geofence
| Ustawienie | Wartość domyślna | Zakres |
|---|---|---|
| Geofence włączony | Wł. (dla nowej konfiguracji obiektu) | Wł. / Wył. |
| Promień (Radius) | 200 m | 50–5000 m (krok 10 m; wartości predefiniowane 50 / 200 / 500 / 1000 m) |
| Bufor dokładności (Accuracy buffer) | 25 m | — |
| Require GPS accuracy better than | 100 m | — |
| Wzór dozwolonej odległości | — | promień + zgłoszona dokładność GPS + bufor dokładności |
Okresy tolerancji dostępu
W Settings → Access Time Windows:
| Ustawienie | Opcje |
|---|---|
| Allow early access | Wył. / 5 / 10 / 15 / 30 minut |
| Allow access after end | Wył. / 5 / 10 / 15 / 30 minut |
Ustawienia blokady aplikacji
| Ustawienie | Wartość domyślna | Opcje |
|---|---|---|
| Enforce app lock for this facility | Wył. | Wł. / Wył. |
| Grace period before re-prompting | 5 minut | Always prompt / 1 min / 5 min / 15 min / 30 min / 1 hour |
| Działanie przy wielu obiektach | — | Wymuszana, jeśli wymusza ją którykolwiek powiązany obiekt; obowiązuje najkrótszy okres tolerancji spośród obiektów, które ją wymuszają |
Kontakty do wsparcia
| Tryb | Działanie |
|---|---|
| Smart (default) | Wyświetlane automatycznie, gdy drzwi są offline lub w interfejsie dostępnych jest niewiele informacji |
| Always show | Zawsze widoczne na panelu aplikacji |
| Never show | Nigdy niewyświetlane |
Wiadomości w aplikacji
| Pole | Limit / opcje |
|---|---|
| Notification type | Information / Notice / Urgent |
| Title | 120 znaków |
| Body | 2000 znaków (łagodne ostrzeżenie przy 500) |
| Link URL | Tylko http(s), 2000 znaków |
| Link label | 80 znaków, domyślnie "More info" |
| Schedule | Opcjonalne Starts at / Ends at |
| Symbole zastępcze (reguły automatyczne) | {firstName}, {lastName} |
| Pola dopasowania reguł automatycznych | Membership status / Person type / Tag (tagi dopasowują synchronizowane + niestandardowe, bez rozróżniania wielkości liter) / Door visibility |
| Priorytet reguł | Wygrywa pierwsza włączona pasująca reguła (kolejność na liście) |
Pola użytkownika
| Pole | Limit / uwagi |
|---|---|
| Imię / nazwisko | Po 80 znaków |
| Telefon komórkowy / e-mail | Wymagane co najmniej jedno (używane do logowania OTP); numery telefonów są normalizowane do formatu międzynarodowego |
| Tagi | 80 znaków na tag; tagi synchronizowane są nadpisywane przez synchronizację, tagi niestandardowe należą do administratora |
| Notatki | 2000 znaków |
| Access enabled | Domyślnie włączone; wyłączone = wszystkie otwarcia są odrzucane |
| Uprawnienia | W całym obiekcie, lista drzwi, lista zakresów, opcjonalne godziny działania |
| Access Policies | Użytkownik może być objęty jedną lub kilkoma nazwanymi zasadami; lista/efektywny dostęp używa Access granted via policy |
| Access Time Windows | Edytowalne okna należące do administratora oraz okna tylko do odczytu należące do źródła; oddzielne od harmonogramów zasad |
Źródła, statusy i inne wyliczenia
| Wyliczenie | Wartości |
|---|---|
| Źródło użytkownika | Manually added / External Integration / CCTV-Computer Vision / Performance Hub staff |
| Kafelki użytkowników | All users / Has access / No access / Not synced |
| Status zaproszenia | Not invited / Invited / Send failed |
| Odbiorcy zaproszeń | Only users with door access / All eligible synced users |
| Pola reguł zaproszeń | Membership status / Person type / Tag / Sync source / Integration; operatory is any of / is not any of |
| Widoki Rejestrów dostępu | Door events / No visit recorded |
| Korzystanie z aplikacji (App adoption) | Active (korzystał z aplikacji) / Not yet active |
| Wymagany identyfikator (synchronizacja) | Email OR phone (domyślnie) / Email required / Phone required / Both required |
| Wyniki w dzienniku synchronizacji | Added / Updated / Skipped / Disabled / Processed / Stale snapshot |
| Stany okien | Active / Upcoming / Expired / Stale / Unmapped |
| Etykiety statusu członkostwa | Active, Current, Expired, On hold, Cancelled, Pending (oraz wszelkie wartości z systemu źródłowego) |
| Szablony Access Scope | Custom, Main entrances, Staff-only, Restricted area, 24/7 access, Business hours, Vehicle access, Service entries |
| Szablony wiadomości automatycznych | No door access, Expired membership, Payment overdue, Account on hold / suspended, Welcome (new member), Trial / prospect, Document / waiver required |
Powody pominięcia przy synchronizacji
| Powód wyświetlany w dzienniku synchronizacji | Znaczenie |
|---|---|
| Integration sync is turned off for this facility | Główny przełącznik źródła jest wyłączony |
| This integration is turned off in sync settings | Konkretna integracja została wyłączona |
| No phone or email on the record (a phone or email is required to log in) | Rekord nie spełnia reguły wymaganego identyfikatora (Require identifier) |
| Record is decoupled and managed manually | Dla tego użytkownika wyłączono Track source updates |
| No facility on the source record | Rekord źródłowy nie jest powiązany z tym obiektem |
| No matching user record | Zmiana dotyczyła osoby, która nie ma tu wiersza |
Limity operacyjne
| Limit | Wartość |
|---|---|
| Import CSV | 200 użytkowników na import |
| Zaproszenia zbiorcze | Wysyłane partiami po 50 |
| Próbka w podglądzie usuwania zbiorczego | Pierwszych 50 użytkowników |
| Zapytanie do Rejestrów dostępu | Do 500 najnowszych zdarzeń na okno |
| Przechowywanie zdarzeń dostępu | ~13 miesięcy, następnie automatyczne usunięcie |
| Ważność polecenia otwarcia przez administratora | 30 sekund (polecenie wygasa, jeśli nie zostanie dostarczone) |
| Sygnał aktywności kontrolera drzwi | Co ~30 sekund; offline po 5 minutach ciszy |
| Żądania kodu logowania | 5 na godzinę na telefon/e-mail (limit bezpieczeństwa, nie można go znieść) |
| Propagacja wylogowania z aplikacji | Unieważnienie natychmiastowe; całkowite zakończenie aktywnej sesji do 15 minut |
| Zapisywanie ustawień drzwi | Ponowne wczytanie kontrolera — zwykle 10–15 sekund |
| Przechowywanie No visit recorded | ~13 miesięcy |
| Mapowania Access Time Window | 50 na integrację |
| Access Time Windows na kontener | 50 |
| Zakres okna One-time | 90 dni |
| Bloki Weekly | 8 na dzień tygodnia |
| Identyfikator okna/źródła, etykieta, klucz zakresu | 120 znaków |
| Access Policies na obiekt | 100 |
| Łączna liczba okien zasad | 500 |
| Nazwa/identyfikator Access Policy | 120 znaków |
| Opis Access Policy | 500 znaków |
| Konfiguracja Access Policy | 300 KiB UTF-8 |