Riferimento
In questa pagina
Tabelle complete per Door & Gate Access: ogni stato degli eventi, motivo di diniego, impostazione, valore predefinito, limite e valore delle opzioni in un unico posto. Usa questa pagina per verificare esattamente il significato di un valore; le pagine delle guide collegate spiegano come usare ciascuna funzionalità.
Stati degli eventi di accesso
Mostrati nei Registri di accesso:
| Stato | Significato |
|---|---|
| Request received | La richiesta di sblocco è arrivata ed è in corso di valutazione (transitorio) |
| Pending | La richiesta ha superato i controlli ed è in attesa di invio (transitorio) |
| Unlocked | Lo sblocco è stato segnalato come riuscito |
| Confirmed unlocked | Il controller della porta ha confermato il rilascio del relè |
| Admin Unlocked | Un amministratore ha attivato lo sblocco dal Performance Hub (deroga dell'amministratore); registrato quando il comando viene inviato |
| Denied | La richiesta è stata rifiutata: vedi il motivo del diniego nell'evento |
| Timed out | Il comando è stato inviato ma il controller non ha confermato in tempo |
| Failed | Non è stato possibile completare lo sblocco a causa di un errore |
| Locked by staff | Il personale ha usato Lock now mentre la pianificazione dello sblocco automatico manteneva aperta la porta (un evento della pianificazione, non un tentativo di sblocco) |
| Schedule resumed | La pianificazione dello sblocco automatico ha ripreso il controllo (un evento della pianificazione, non un tentativo di sblocco) |
Ciclo di vita dell'evento: ricevuto → inviato → confirmed unlocked / denied / timed out / failed.
Motivi di diniego
Ogni sblocco negato o non riuscito registra un motivo. La tabella associa il motivo al messaggio visualizzato dal membro e alla relativa soluzione:
| Motivo (come registrato) | Messaggio per il membro | Causa | Soluzione |
|---|---|---|---|
access_disabled | "Your access has been suspended — please contact the facility" | L'interruttore Access enabled dell'utente è disattivato | Riattivalo nel pannello dell'utente in Users |
no_matching_policy_or_grant | "You don't have access to this door" | Nessuna Access Policy ha soddisfatto Who E Where E When e nessun percorso di autorizzazione cumulativo ha consentito l'accesso | Verifica le Access Policies, gli attributi dell'utente, le destinazioni/esclusioni, la pianificazione e le autorizzazioni |
no_matching_policy_target | "You don't have access to this door" | Nessuna Access Policy attivata ha come destinazione questa porta per la richiesta | Aggiungi la porta o il suo Access Scope a una policy oppure usa una destinazione che comprende tutte le porte |
no_matching_policy_audience | "You don't have access to this door" | Alcune policy hanno come destinazione la porta, ma nessuna corrisponde al tipo/stato o ai tag della persona | Verifica la sezione Who della policy e il record in Users |
outside_policy_schedule | "Outside allowed access hours" | Who e Where corrispondono, ma tutte le pianificazioni delle policy corrispondenti sono inattive o scadute | Verifica la sezione When della policy e il fuso orario della struttura |
outside_geofence | "Move closer — you're outside the location's geofence." | La posizione segnalata si trova oltre raggio + precisione GPS + margine dal centro del geofence | Il membro si avvicina; oppure verifica il raggio/segnaposto del geofence |
gps_too_imprecise | "Couldn't pin down your location accurately. Try again outdoors." | La precisione GPS del telefono è peggiore della soglia Require GPS accuracy better than | Il membro riprova all'aperto / lontano da interferenze; oppure aumenta la soglia |
location_unavailable | "Couldn't read your location. Make sure Location is enabled and set to Precise, then try again." | Il telefono non ha segnalato una posizione utilizzabile | Il membro attiva la posizione (Precise) per l'app |
geofence_misconfigured | Sblocco negato | Il geofence è attivato ma ne manca il centro/segnaposto: il sistema adotta un comportamento fail-closed | Posiziona il segnaposto del geofence in Settings → Geofencing |
device_offline | "Door is offline. Please contact the facility." | Il controller della porta non ha inviato segnali (nessun heartbeat negli ultimi 5 minuti) | Ripristina l'alimentazione/la rete del controller: vedi Risoluzione dei problemi |
user_deleted | "You don't have access…" | Il record in Users è stato eliminato | Ricrea o ripristina l'utente |
outside_access_time_window | Porta disattivata con la disponibilità successiva, se nota | Una finestra futura è l'unico potenziale percorso di autorizzazione dell'utente e non è ancora attiva | Controlla la disponibilità fornita, il fuso orario, l'aggiornamento dell'origine e la mappatura; le Access Policies e le autorizzazioni continuano ad applicarsi in modo indipendente |
Alcune versioni dell'app mostrano il messaggio più generico "You don't have access to this door" o "Outside allowed access hours" per i dinieghi specifici delle policy. I Registri di accesso conservano il motivo dettagliato per gli amministratori.
Criteri di accesso
| Proprietà | Significato |
|---|---|
| Struttura della policy | Nome univoco, descrizione facoltativa, indicatore di attivazione, destinatari Who, destinazioni/esclusioni Where, pianificazione When |
| Corrispondenza della policy | Who E Where E When |
| Più policy | OR; qualsiasi policy attivata corrispondente consente l'accesso |
| Who | Tipo di persona più stati facoltativi, OPPURE tag sincronizzati/personalizzati; nessuno stato indicato = qualsiasi stato |
| Where | Tutte le porte della struttura, Access Scopes, singole porte o combinazioni; all'interno di quella policy prevalgono le esclusioni |
| When | Anytime, oppure finestre Weekly/One-time in OR |
| Altri percorsi di autorizzazione | Le autorizzazioni permanenti e le finestre di amministratori/integrazioni restano separate e cumulative |
| Sicurezza | Continuano ad applicarsi utenti eliminati/disattivati/bloccati dalla sincronizzazione, eliminazione/blocco della porta, manutenzione, geofence, limiti di frequenza e controlli del controller |
| Configurazione esistente | Importata automaticamente in policy denominate equivalenti con Who, Where e When espliciti |
Attribuzione della policy
I Registri di accesso identificano una policy corrispondente per nome e possono mostrarne destinatari, destinazione e pianificazione. Le corrispondenze pianificate possono includere anche l'inizio e la fine concreti attivi.
Riferimento delle Access Time Windows
| Proprietà | Significato |
|---|---|
| Autorizzazione | Le finestre della pianificazione di una policy costituiscono il When della policy; le finestre di amministratori/integrazioni sono percorsi di autorizzazione cumulativi separati |
| Limite assoluto | Istanti UTC interi in secondi Unix, [from, to) |
| Fuso orario assoluto | Metadati di visualizzazione/verifica; non sposta i valori epoch |
| Limite settimanale | Blocchi locali HH:mm con fine esclusa |
| Fuso orario settimanale | Fuso orario IANA valido che determina giorno/ora civile e ora legale |
| Limiti settimanali | Inizio/fine validità facoltativi in secondi Unix; fine esclusa |
| Notturne/sovrapposte | Non accettate; suddividi i periodi notturni su più giorni e mantieni i blocchi senza sovrapposizioni |
| Proprietà dell'utente | L'amministratore e ciascuna origine di integrazione sono isolati; nessuno può cancellare le finestre di un altro |
| Ambito dell'integrazione | scope_key di origine stabile, valore predefinito default, mappato a destinazioni PH; se sconosciuto/non mappato, comportamento fail-closed |
| Aggiornamento dell'origine | Configurato in base alla cadenza di ogni integrazione; il comportamento con origine non aggiornata deve essere esplicito |
| Sicurezza | Non aggira mai utenti disattivati/eliminati/in conflitto, blockAllAccess, manutenzione, geofence, limiti di frequenza o controlli del controller |
Limiti iniziali: 50 finestre per contenitore di policy/autorizzazione/origine; durata assoluta massima di 90 giorni; 120 caratteri per ID/etichette/chiavi di ambito; otto blocchi settimanali al giorno; le voci appena scritte non possono essere già scadute da più di un'ora.
Impostazioni, valori predefiniti e intervalli
Impostazioni delle porte
| Impostazione | Valore predefinito | Intervallo / opzioni |
|---|---|---|
| Tempo di apertura | 10 secondi | 1–30 secondi |
| Modalità di manutenzione | Normal | Normal / Force open / Force closed |
| Suono di apertura della porta | Off | On / Off |
| Etichetta di posizione della porta | — | Testo libero, massimo 64 caratteri |
| Icona | Door | 10 opzioni (vedi sotto) |
| Pianificazione dello sblocco automatico | Off | Orari con personale della struttura o Custom schedule, fuso orario della struttura |
| Orari Unlock / Lock dello sblocco automatico | At opening / At closing | At opening / At closing, oppure 5, 10, 15, 30, 45, 60, 90 o 120 minuti prima o dopo |
| Sblocco automatico nei giorni festivi | Ignore holidays | Follow the facility's holiday hours / Stay locked all day / Ignore holidays |
| Autorizzazione all'accesso (per porta) | Access Policies | Elenca le policy corrispondenti e consente blockAllAccess |
| Geofence (per porta) | Inherit from facility | Inherit from facility / Override for this door / Disable geofence for this door |
| Soglia di stato online | — | Il controller è considerato online se ha inviato un heartbeat negli ultimi 5 minuti |
Icone delle porte
| Icona | Uso previsto |
|---|---|
| Door | Porta singola standard (predefinita) |
| Sliding door | Porta scorrevole / automatica |
| Double door | Porta doppia / porta finestra |
| Garage | Garage / serranda avvolgibile |
| Boom gate | Sbarra / barriera automatica |
| Pedestrian | Ingresso pedonale / per il personale |
| Security | Porta ad accesso limitato / di sicurezza |
| Office | Ufficio / locale riservato al personale |
| Delivery | Banchina di carico / area consegne |
| Locker | Armadietto / deposito |
Impostazioni del geofence
| Impostazione | Valore predefinito | Intervallo |
|---|---|---|
| Geofence attivato | On (per una nuova configurazione della struttura) | On / Off |
| Raggio | 200 m | 50–5000 m (incrementi di 10 m; valori preimpostati 50 / 200 / 500 / 1000 m) |
| Margine di precisione | 25 m | — |
| Require GPS accuracy better than | 100 m | — |
| Formula della tolleranza | — | raggio + precisione GPS segnalata + margine di precisione |
Periodi di tolleranza per l'accesso
In Settings → Access Time Windows:
| Impostazione | Opzioni |
|---|---|
| Allow early access | Off / 5 / 10 / 15 / 30 minuti |
| Allow access after end | Off / 5 / 10 / 15 / 30 minuti |
Impostazioni del blocco dell'app
| Impostazione | Valore predefinito | Opzioni |
|---|---|---|
| Enforce app lock for this facility | Off | On / Off |
| Grace period before re-prompting | 5 minuti | Always prompt / 1 min / 5 min / 15 min / 30 min / 1 ora |
| Comportamento con più strutture | — | Imposto se una qualsiasi struttura collegata lo impone; prevale il periodo di tolleranza più breve tra le strutture che lo impongono |
Contatti dell'assistenza
| Modalità | Comportamento |
|---|---|
| Smart (default) | Mostrati automaticamente quando una porta è offline o le informazioni nell'interfaccia sono limitate |
| Always show | Sempre visibili nella dashboard dell'app |
| Never show | Mai mostrati |
Messaggi nell'app
| Campo | Limite / opzioni |
|---|---|
| Tipo di notifica | Information / Notice / Urgent |
| Titolo | 120 caratteri |
| Testo | 2000 caratteri (avviso non bloccante a 500) |
| URL del link | Solo http(s), 2000 caratteri |
| Etichetta del link | 80 caratteri, valore predefinito "More info" |
| Pianificazione | Starts at / Ends at facoltativi |
| Segnaposto (regole automatiche) | {firstName}, {lastName} |
| Campi di corrispondenza delle regole automatiche | Membership status / Person type / Tag (i tag corrispondono a quelli sincronizzati + personalizzati, senza distinzione tra maiuscole e minuscole) / Door visibility |
| Priorità delle regole | Prevale la prima regola attivata corrispondente (ordine dell'elenco) |
Campi dell'utente
| Campo | Limite / note |
|---|---|
| Nome / cognome | 80 caratteri ciascuno |
| Cellulare / email | Almeno uno obbligatorio (usato per l'accesso con OTP); i numeri di telefono vengono normalizzati nel formato internazionale |
| Tag | 80 caratteri per tag; i tag sincronizzati vengono sovrascritti dalla sincronizzazione, i tag personalizzati sono gestiti dagli amministratori |
| Note | 2000 caratteri |
| Access enabled | Attivato per impostazione predefinita; disattivato = tutti gli sblocchi negati |
| Autorizzazioni | Intera struttura, elenco di porte, elenco di ambiti, orari di apertura facoltativi |
| Access Policies | Un utente può essere coperto da una o più policy denominate; l'elenco/l'accesso effettivo usa Access granted via policy |
| Access Time Windows | Finestre modificabili gestite dagli amministratori più finestre di sola lettura gestite dall'origine; separate dalle pianificazioni delle policy |
Origini, stati e altre enumerazioni
| Enumerazione | Valori |
|---|---|
| Origine dell'utente | Manually added / External Integration / CCTV-Computer Vision / Performance Hub staff |
| Riquadri degli utenti | All users / Has access / No access / Not synced |
| Stato dell'invito | Not invited / Invited / Send failed |
| Destinatari degli inviti | Only users with door access / All eligible synced users |
| Campi delle regole degli inviti | Membership status / Person type / Tag / Sync source / Integration; operatori is any of / is not any of |
| Viste dei Registri di accesso | Door events / No visit recorded |
| Adozione dell'app | Active (ha usato l'app) / Not yet active |
| Identificativo obbligatorio (sincronizzazione) | Email OR phone (predefinito) / Email required / Phone required / Both required |
| Esiti del registro di sincronizzazione | Added / Updated / Skipped / Disabled / Processed / Stale snapshot |
| Stati delle finestre | Active / Upcoming / Expired / Stale / Unmapped |
| Etichette dello stato dell'iscrizione | Active, Current, Expired, On hold, Cancelled, Pending (più eventuali valori del tuo sistema di origine) |
| Modelli di Access Scope | Custom, Main entrances, Staff-only, Restricted area, 24/7 access, Business hours, Vehicle access, Service entries |
| Modelli di messaggi automatici | No door access, Expired membership, Payment overdue, Account on hold / suspended, Welcome (new member), Trial / prospect, Document / waiver required |
Motivi di esclusione dalla sincronizzazione
| Motivo mostrato nel registro di sincronizzazione | Significato |
|---|---|
| Integration sync is turned off for this facility | L'interruttore principale dell'origine è disattivato |
| This integration is turned off in sync settings | L'integrazione specifica è stata esclusa |
| No phone or email on the record (a phone or email is required to log in) | Il record non soddisfa la regola Require identifier |
| Record is decoupled and managed manually | Track source updates è disattivato per questo utente |
| No facility on the source record | Il record di origine non è collegato a questa struttura |
| No matching user record | La modifica si riferiva a una persona senza riga qui |
Limiti operativi
| Limite | Valore |
|---|---|
| Importazione CSV | 200 utenti per importazione |
| Inviti in blocco | Inviati in lotti da 50 |
| Campione dell'anteprima di eliminazione in blocco | Vengono mostrati i primi 50 utenti |
| Query dei Registri di accesso | Fino ai 500 eventi più recenti per finestra |
| Conservazione degli eventi di accesso | ~13 mesi, poi rimossi automaticamente |
| Validità del comando di sblocco da amministratore | 30 secondi (il comando scade se non viene recapitato) |
| Heartbeat del controller della porta | Ogni ~30 secondi; offline dopo 5 minuti di silenzio |
| Richieste di codice di accesso | 5 all'ora per telefono/email (limite di sicurezza, non può essere rimosso) |
| Propagazione della disconnessione dall'app | Revoca immediata; fino a 15 minuti perché una sessione attiva termini completamente |
| Salvataggio delle impostazioni della porta | Ricarica il controller, in genere 10–15 secondi |
| Conservazione di No visit recorded | ~13 mesi |
| Mappature delle Access Time Windows | 50 per integrazione |
| Access Time Windows per contenitore | 50 |
| Durata della finestra One-time | 90 giorni |
| Blocchi settimanali | 8 per giorno della settimana |
| ID, etichetta e chiave di ambito di finestra/origine | 120 caratteri |
| Access Policies per struttura | 100 |
| Finestre totali delle policy | 500 |
| Nome/ID della Access Policy | 120 caratteri |
| Descrizione della Access Policy | 500 caratteri |
| Configurazione della Access Policy | 300 KiB UTF-8 |