Referenz
Auf dieser Seite
Vollständige Tabellen für Door & Gate Access: alle Ereignisstatus, Ablehnungsgründe, Einstellungen, Standardwerte, Grenzwerte und Optionswerte an einem Ort. Auf dieser Seite schlagen Sie nach, was ein Wert genau bedeutet; die verlinkten Leitfäden erklären, wie Sie die einzelnen Funktionen nutzen.
Status von Zugriffsereignissen
Angezeigt in den Zugriffsprotokollen:
| Status | Bedeutung |
|---|---|
| Request received | Die Entsperranfrage ist eingegangen und wird ausgewertet (vorübergehend) |
| Pending | Die Anfrage hat die Prüfungen bestanden und wartet auf die Übermittlung (vorübergehend) |
| Unlocked | Die Entsperrung wurde als erfolgreich gemeldet |
| Confirmed unlocked | Die Türsteuerung hat bestätigt, dass das Relais freigegeben hat |
| Admin Unlocked | Ein Administrator hat die Entsperrung über den Performance Hub ausgelöst (Administrator-Überschreibung); wird bei der Übermittlung des Befehls protokolliert |
| Denied | Die Anfrage wurde abgelehnt – siehe den Ablehnungsgrund im Ereignis |
| Timed out | Der Befehl wurde gesendet, aber die Steuerung hat ihn nicht rechtzeitig bestätigt |
| Failed | Die Entsperrung konnte aufgrund eines Fehlers nicht abgeschlossen werden |
| Locked by staff | Mitarbeitende haben Lock now verwendet, während der Zeitplan für automatisches Entsperren die Tür offen hielt (ein Zeitplanereignis, kein Entsperrversuch) |
| Schedule resumed | Der Zeitplan für automatisches Entsperren hat wieder übernommen (ein Zeitplanereignis, kein Entsperrversuch) |
Ereignisablauf: empfangen → übermittelt → bestätigt entsperrt / abgelehnt / Zeitüberschreitung / fehlgeschlagen.
Ablehnungsgründe
Jede abgelehnte oder fehlgeschlagene Entsperrung erfasst einen Grund. Die Tabelle ordnet jedem Grund die Meldung für das Mitglied und die Lösung zu:
| Grund (wie protokolliert) | Meldung für das Mitglied | Ursache | Lösung |
|---|---|---|---|
access_disabled | "Your access has been suspended — please contact the facility" | Der Schalter Access enabled des Benutzers ist ausgeschaltet | Aktivieren Sie ihn im Fenster des Benutzers unter Users wieder |
no_matching_policy_or_grant | "You don't have access to this door" | Keine Access Policy traf mit Who UND Where UND When zu, und kein additiver Berechtigungsweg gewährte Zugriff | Prüfen Sie Access Policies, Benutzerattribute, Ziele/Ausschlüsse, Zeitplan und Berechtigungen |
no_matching_policy_target | "You don't have access to this door" | Keine aktivierte Access Policy zielt für die Anfrage auf diese Tür | Fügen Sie die Tür oder ihren Zugriffsbereich zu einer Richtlinie hinzu oder verwenden Sie ein Ziel für alle Türen |
no_matching_policy_audience | "You don't have access to this door" | Richtlinien zielen auf die Tür, aber keine trifft auf Typ/Status oder Tags der Person zu | Prüfen Sie den Abschnitt Who der Richtlinie und den Eintrag unter Users |
outside_policy_schedule | "Outside allowed access hours" | Who und Where treffen zu, aber alle Zeitpläne der zutreffenden Richtlinien sind inaktiv oder abgelaufen | Prüfen Sie den Abschnitt When der Richtlinie und die Zeitzone der Einrichtung |
outside_geofence | "Move closer — you're outside the location's geofence." | Der gemeldete Standort liegt weiter als Radius + GPS-Genauigkeit + Puffer vom Mittelpunkt des Geofence entfernt | Das Mitglied geht näher heran; oder prüfen Sie Radius bzw. Markierung des Geofence |
gps_too_imprecise | "Couldn't pin down your location accurately. Try again outdoors." | Die GPS-Genauigkeit des Telefons ist schlechter als der Schwellenwert Require GPS accuracy better than | Das Mitglied versucht es im Freien bzw. abseits von Störquellen erneut; oder erhöhen Sie den Schwellenwert |
location_unavailable | "Couldn't read your location. Make sure Location is enabled and set to Precise, then try again." | Das Telefon hat keinen verwendbaren Standort gemeldet | Das Mitglied aktiviert den Standort (Precise) für die App |
geofence_misconfigured | Entsperrung abgelehnt | Der Geofence ist aktiviert, aber Mittelpunkt bzw. Markierung fehlen – das System schlägt sicher fehl | Setzen Sie die Geofence-Markierung unter Settings → Geofencing |
device_offline | "Door is offline. Please contact the facility." | Die Türsteuerung hat sich nicht gemeldet (kein Lebenszeichen innerhalb von 5 Minuten) | Stellen Sie Stromversorgung bzw. Netzwerk der Steuerung wieder her – siehe Fehlerbehebung |
user_deleted | "You don't have access…" | Der Eintrag unter Users wurde gelöscht | Legen Sie den Benutzer neu an oder stellen Sie ihn wieder her |
outside_access_time_window | Tür deaktiviert, mit nächster Verfügbarkeit, sofern bekannt | Ein künftiges Zeitfenster ist der einzige mögliche Zulassungsweg des Benutzers und noch nicht aktiv | Prüfen Sie die gelieferte Verfügbarkeit, Zeitzone, Aktualität der Quelle und Zuordnung; Access Policies und Berechtigungen gelten weiterhin unabhängig davon |
Manche App-Versionen zeigen bei richtlinienspezifischen Ablehnungen die allgemeinere Meldung „You don't have access to this door“ oder „Outside allowed access hours“ an. Die Zugriffsprotokolle enthalten für Administratoren den detaillierten Grund.
Zugriffsrichtlinien
| Eigenschaft | Bedeutung |
|---|---|
| Aufbau einer Richtlinie | Eindeutiger Name, optionale Beschreibung, Aktivierungsstatus, Who-Zielgruppe, Where-Ziele/-Ausschlüsse, When-Zeitplan |
| Zutreffen einer Richtlinie | Who UND Where UND When |
| Mehrere Richtlinien | ODER; jede zutreffende aktivierte Richtlinie erlaubt |
| Who | Personentyp plus optionale Status ODER synchronisierte/benutzerdefinierte Tags; keine Statusangabe = beliebiger Status |
| Where | Alle Türen der Einrichtung, Access Scopes, einzelne Türen oder Kombinationen; Ausschlüsse haben innerhalb dieser Richtlinie Vorrang |
| When | Anytime oder ODER-verknüpfte Zeitfenster vom Typ Weekly/One-time |
| Weitere Zulassungswege | Dauerhafte Berechtigungen und Zeitfenster von Administratoren bzw. Integrationen bleiben separat und additiv |
| Sicherheit | Gelöschte/deaktivierte/durch die Synchronisierung blockierte Benutzer, Löschen/Blockieren von Türen, Wartungsmodus, Geofence, Ratenlimits und Steuerungsprüfungen gelten weiterhin |
| Bestehende Konfiguration | Wird automatisch in gleichwertige benannte Richtlinien mit expliziten Werten für Who, Where und When importiert |
Zuordnung zu Richtlinien
Die Zugriffsprotokolle nennen eine zutreffende Richtlinie mit ihrem Namen und können ihre Zielgruppe, ihr Ziel und ihren Zeitplan anzeigen. Bei geplanten Treffern können zusätzlich der konkrete aktive Beginn und das Ende angegeben werden.
Referenz zu Access Time Windows
| Eigenschaft | Bedeutung |
|---|---|
| Autorisierung | Zeitfenster im Zeitplan einer Richtlinie bilden deren When; Zeitfenster von Administratoren bzw. Integrationen sind separate, additive Zulassungswege |
| Absolute Grenze | Ganzzahlige Unix-Sekunden als UTC-Zeitpunkte, [from, to) |
| Absolute Zeitzone | Metadaten für Anzeige/Prüfung; verschiebt keine Epochenwerte |
| Wöchentliche Grenze | Lokale Blöcke HH:mm mit exklusivem Ende |
| Wöchentliche Zeitzone | Gültige IANA-Zeitzone, die Wochentag/Ortszeit und Sommerzeit bestimmt |
| Wöchentliche Begrenzung | Optionale Unix-Sekunden für aktiv ab/aktiv bis; Ende exklusiv |
| Über Nacht/Überschneidung | Nicht zulässig; teilen Sie Zeiträume über Mitternacht auf mehrere Tage auf und halten Sie die Blöcke überschneidungsfrei |
| Zuständigkeit | Administratoren und jede Integrationsquelle sind voneinander isoliert; eine kann die Einträge einer anderen nicht löschen |
| Integrationsbereich | Stabiler scope_key der Quelle, Standard default, zugeordnet zu PH-Zielen; unbekannte/nicht zugeordnete Schlüssel schlagen sicher fehl |
| Aktualität der Quelle | Pro Integrationsrhythmus konfiguriert; das Verhalten bei veralteten Quellen muss explizit festgelegt sein |
| Sicherheit | Umgeht nie deaktivierte/gelöschte/in Konflikt stehende Benutzer, blockAllAccess, Wartungsmodus, Geofence, Ratenlimits oder Steuerungsprüfungen |
Anfängliche Grenzwerte: 50 Zeitfenster pro Richtlinie, Berechtigung oder Quellcontainer; maximal 90 Tage absolute Zeitspanne; 120 Zeichen für IDs, Bezeichnungen und Bereichsschlüssel; acht wöchentliche Blöcke pro Tag; neu geschriebene Einträge dürfen nicht bereits seit mehr als einer Stunde abgelaufen sein.
Einstellungen, Standardwerte und Bereiche
Türeinstellungen
| Einstellung | Standard | Bereich / Optionen |
|---|---|---|
| Haltezeit | 10 Sekunden | 1–30 Sekunden |
| Wartungsmodus | Normal | Normal / Force open / Force closed |
| Door open sound | Aus | Ein / Aus |
| Standortbezeichnung der Tür | — | Freitext, max. 64 Zeichen |
| Symbol | Door | 10 Optionen (siehe unten) |
| Zeitplan für automatisches Entsperren | Aus | Besetzte Zeiten der Einrichtung oder Custom schedule, Zeitzone der Einrichtung |
| Zeitpunkt für Unlock / Lock beim automatischen Entsperren | At opening / At closing | At opening / At closing oder 5, 10, 15, 30, 45, 60, 90 bzw. 120 Minuten davor oder danach |
| Automatisches Entsperren an Feiertagen | Ignore holidays | Follow the facility's holiday hours / Stay locked all day / Ignore holidays |
| Zugriffsautorisierung (pro Tür) | Access Policies | Listet zutreffende Richtlinien auf und erlaubt blockAllAccess |
| Geofence (pro Tür) | Inherit from facility | Inherit from facility / Override for this door / Disable geofence for this door |
| Online-Schwellenwert | — | Die Steuerung gilt als online, wenn sie innerhalb der letzten 5 Minuten ein Lebenszeichen gesendet hat |
Türsymbole
| Symbol | Vorgesehene Verwendung |
|---|---|
| Door | Standard-Einzeltür (Standard) |
| Sliding door | Schiebetür / automatische Tür |
| Double door | Doppeltür / Flügeltür |
| Garage | Garagentor / Rolltor |
| Boom gate | Schranke / Schrankenarm |
| Pedestrian | Eingang für Mitarbeitende / Fußgänger |
| Security | Zugangsbeschränkte Tür / Sicherheitstür |
| Office | Büro / Raum nur für Mitarbeitende |
| Delivery | Laderampe / Anlieferzone |
| Locker | Schließfach / Lager |
Geofence-Einstellungen
| Einstellung | Standard | Bereich |
|---|---|---|
| Geofence aktiviert | Ein (bei einer neuen Einrichtungskonfiguration) | Ein / Aus |
| Radius | 200 m | 50–5000 m (10-m-Schritte; Vorgaben 50 / 200 / 500 / 1000 m) |
| Genauigkeitspuffer | 25 m | — |
| Require GPS accuracy better than | 100 m | — |
| Formel für den zulässigen Bereich | — | Radius + gemeldete GPS-Genauigkeit + Genauigkeitspuffer |
Kulanzzeiten für den Zugriff
Unter Settings → Access Time Windows:
| Einstellung | Optionen |
|---|---|
| Allow early access | Aus / 5 / 10 / 15 / 30 Minuten |
| Allow access after end | Aus / 5 / 10 / 15 / 30 Minuten |
Einstellungen der App-Sperre
| Einstellung | Standard | Optionen |
|---|---|---|
| Enforce app lock for this facility | Aus | Ein / Aus |
| Grace period before re-prompting | 5 Minuten | Always prompt / 1 min / 5 min / 15 min / 30 min / 1 hour |
| Verhalten bei mehreren Einrichtungen | — | Wird erzwungen, wenn eine beliebige verknüpfte Einrichtung sie erzwingt; es gilt die kürzeste Kulanzzeit unter den erzwingenden Einrichtungen |
Support-Kontakte
| Modus | Verhalten |
|---|---|
| Smart (default) | Wird automatisch angezeigt, wenn eine Tür offline ist oder in der Oberfläche nur wenige Informationen vorliegen |
| Always show | Immer im Dashboard der App |
| Never show | Wird nie angezeigt |
App-Nachrichten
| Feld | Grenzwert / Optionen |
|---|---|
| Notification type | Information / Notice / Urgent |
| Title | 120 Zeichen |
| Body | 2000 Zeichen (Hinweis ab 500) |
| Link URL | Nur http(s), 2000 Zeichen |
| Link label | 80 Zeichen, Standard „More info“ |
| Schedule | Optional Starts at / Ends at |
| Platzhalter (automatische Regeln) | {firstName}, {lastName} |
| Abgleichsfelder automatischer Regeln | Membership status / Person type / Tag (Tags berücksichtigen synchronisierte und benutzerdefinierte Tags, ohne Beachtung der Groß-/Kleinschreibung) / Door visibility |
| Regelpriorität | Die erste aktivierte zutreffende Regel gewinnt (Reihenfolge in der Liste) |
Benutzerfelder
| Feld | Grenzwert / Hinweise |
|---|---|
| Vor- / Nachname | Jeweils 80 Zeichen |
| Mobiltelefon / E-Mail | Mindestens eines erforderlich (für die OTP-Anmeldung); Telefonnummern werden in das internationale Format umgewandelt |
| Tags | 80 Zeichen pro Tag; synchronisierte Tags werden bei der Synchronisierung überschrieben, benutzerdefinierte Tags werden von Administratoren verwaltet |
| Notizen | 2000 Zeichen |
| Access enabled | Standardmäßig ein; aus = alle Entsperrungen werden abgelehnt |
| Berechtigungen | Einrichtungsweit, Türliste, Bereichsliste, optionale Betriebszeiten |
| Access Policies | Ein Benutzer kann von einer oder mehreren benannten Richtlinien abgedeckt sein; Liste/wirksamer Zugriff verwenden Access granted via policy |
| Access Time Windows | Von Administratoren verwaltete, bearbeitbare Zeitfenster plus schreibgeschützte Zeitfenster der Quelle; getrennt von Richtlinien-Zeitplänen |
Quellen, Status und weitere Aufzählungen
| Aufzählung | Werte |
|---|---|
| Benutzerquelle | Manually added / External Integration / CCTV-Computer Vision / Performance Hub staff |
| Benutzerkacheln | All users / Has access / No access / Not synced |
| Einladungsstatus | Not invited / Invited / Send failed |
| Einladungsempfänger | Only users with door access / All eligible synced users |
| Felder für Einladungsregeln | Membership status / Person type / Tag / Sync source / Integration; Operatoren is any of / is not any of |
| Ansichten der Zugriffsprotokolle | Door events / No visit recorded |
| App-Nutzung | Active (hat die App genutzt) / Not yet active |
| Erforderliche Kennung (Synchronisierung) | Email OR phone (Standard) / Email required / Phone required / Both required |
| Ergebnisse im Synchronisierungsprotokoll | Added / Updated / Skipped / Disabled / Processed / Stale snapshot |
| Zeitfensterstatus | Active / Upcoming / Expired / Stale / Unmapped |
| Bezeichnungen für Mitgliedschaftsstatus | Active, Current, Expired, On hold, Cancelled, Pending (plus alle Werte aus Ihrem Quellsystem) |
| Vorlagen für Zugriffsbereiche | Custom, Main entrances, Staff-only, Restricted area, 24/7 access, Business hours, Vehicle access, Service entries |
| Vorlagen für automatische Nachrichten | No door access, Expired membership, Payment overdue, Account on hold / suspended, Welcome (new member), Trial / prospect, Document / waiver required |
Gründe für das Überspringen bei der Synchronisierung
| Im Synchronisierungsprotokoll angezeigter Grund | Bedeutung |
|---|---|
| Integration sync is turned off for this facility | Der Hauptschalter der Quelle ist ausgeschaltet |
| This integration is turned off in sync settings | Die betreffende Integration ist abgewählt |
| No phone or email on the record (a phone or email is required to log in) | Der Eintrag erfüllt die Regel für die erforderliche Kennung nicht |
| Record is decoupled and managed manually | Track source updates ist für diesen Benutzer ausgeschaltet |
| No facility on the source record | Der Quelleintrag ist nicht mit dieser Einrichtung verknüpft |
| No matching user record | Die Änderung bezog sich auf eine Person, für die es hier keine Zeile gibt |
Betriebliche Grenzwerte
| Grenzwert | Wert |
|---|---|
| CSV-Import | 200 Benutzer pro Import |
| Sammeleinladungen | In Stapeln von 50 gesendet |
| Vorschau beim gesammelten Löschen | Die ersten 50 Benutzer werden angezeigt |
| Abfrage der Zugriffsprotokolle | Bis zu 500 neueste Ereignisse pro Zeitraum |
| Aufbewahrung von Zugriffsereignissen | ~13 Monate, danach automatische Entfernung |
| Gültigkeit des Entsperrbefehls durch Administratoren | 30 Sekunden (der Befehl verfällt, wenn er nicht zugestellt wird) |
| Lebenszeichen der Türsteuerung | Etwa alle 30 Sekunden; offline nach 5 Minuten ohne Meldung |
| Anfragen für Anmeldecodes | 5 pro Stunde pro Telefonnummer/E-Mail-Adresse (Sicherheitslimit, kann nicht aufgehoben werden) |
| Wirksamwerden der Abmeldung in der App | Sofort widerrufen; bis zu 15 Minuten, bis eine aktive Sitzung vollständig beendet ist |
| Speichern der Türeinstellungen | Lädt die Steuerung neu – in der Regel 10–15 Sekunden |
| Aufbewahrung von No visit recorded | ~13 Monate |
| Zuordnungen für Access Time Windows | 50 pro Integration |
| Access Time Windows pro Container | 50 |
| Zeitspanne eines One-time-Zeitfensters | 90 Tage |
| Wöchentliche Blöcke | 8 pro Wochentag |
| Zeitfenster-/Quell-ID, Bezeichnung, Bereichsschlüssel | 120 Zeichen |
| Access Policies pro Einrichtung | 100 |
| Richtlinien-Zeitfenster insgesamt | 500 |
| Name/ID einer Access Policy | 120 Zeichen |
| Beschreibung einer Access Policy | 500 Zeichen |
| Konfiguration einer Access Policy | 300 KiB UTF-8 |