Referência
Nesta página
Tabelas completas do Door & Gate Access: todos os estados de eventos, motivos de negação, configurações, padrões, limites e valores de opções em um só lugar. Use esta página para consultar exatamente o que um valor significa; as páginas de guia vinculadas explicam como usar cada recurso.
Estados dos eventos de acesso
Exibidos nos Registros de acesso:
| Estado | Significado |
|---|---|
| Request received | A solicitação de desbloqueio chegou e está sendo avaliada (transitório) |
| Pending | A solicitação passou nas verificações e aguarda o envio (transitório) |
| Unlocked | O desbloqueio foi informado como bem-sucedido |
| Confirmed unlocked | O controlador de porta confirmou que o relé foi liberado |
| Admin Unlocked | Um administrador acionou o desbloqueio pelo Performance Hub (substituição de administrador); registrado quando o comando é enviado |
| Denied | A solicitação foi rejeitada — consulte o motivo da negação no evento |
| Timed out | O comando foi enviado, mas o controlador não confirmou a tempo |
| Failed | Não foi possível concluir o desbloqueio devido a um erro |
| Locked by staff | A equipe usou Lock now enquanto a programação de desbloqueio automático mantinha a porta aberta (um evento de programação, não uma tentativa de desbloqueio) |
| Schedule resumed | A programação de desbloqueio automático voltou a assumir o controle (um evento de programação, não uma tentativa de desbloqueio) |
Ciclo de vida do evento: recebido → enviado → desbloqueio confirmado / negado / tempo esgotado / com falha.
Motivos de negação
Cada desbloqueio negado/com falha registra um motivo. A tabela relaciona o motivo ao que o membro vê e a como corrigi-lo:
| Motivo (conforme registrado) | Mensagem exibida ao membro | Causa | Correção |
|---|---|---|---|
access_disabled | "Your access has been suspended — please contact the facility" | A chave Access enabled do usuário está desativada | Reative-a no painel do usuário em Users |
no_matching_policy_or_grant | "You don't have access to this door" | Nenhuma Access Policy correspondeu a Who E Where E When, e nenhum caminho de concessão cumulativo permitiu o acesso | Revise as Access Policies, os atributos do usuário, os destinos/exclusões, a programação e as concessões |
no_matching_policy_target | "You don't have access to this door" | Nenhuma Access Policy habilitada tem esta porta como destino para a solicitação | Adicione a porta ou o Escopo de acesso dela a uma política, ou use um destino de todas as portas |
no_matching_policy_audience | "You don't have access to this door" | Há políticas com a porta como destino, mas nenhuma corresponde ao tipo/status ou às tags da pessoa | Revise a seção Who da política e o registro em Users |
outside_policy_schedule | "Outside allowed access hours" | Who e Where correspondem, mas todas as programações das políticas correspondentes estão inativas ou expiradas | Revise a seção When da política e o fuso horário da instalação |
outside_geofence | "Move closer — you're outside the location's geofence." | A localização informada está além de raio + precisão do GPS + margem em relação ao centro da geofence | O membro se aproxima; ou revise o raio/pino da geofence |
gps_too_imprecise | "Couldn't pin down your location accurately. Try again outdoors." | A precisão do GPS do telefone é pior que o limite Require GPS accuracy better than | O membro tenta novamente ao ar livre / longe de interferências; ou aumente o limite |
location_unavailable | "Couldn't read your location. Make sure Location is enabled and set to Precise, then try again." | O telefone não informou uma localização utilizável | O membro ativa a localização (Precise) para o aplicativo |
geofence_misconfigured | Desbloqueio negado | A geofence está habilitada, mas o centro/pino está ausente — o sistema falha de forma fechada | Posicione o pino da geofence em Settings → Geofencing |
device_offline | "Door is offline. Please contact the facility." | O controlador de porta não se comunicou (nenhum sinal de atividade em 5 minutos) | Restaure a alimentação/rede do controlador — consulte Solução de problemas |
user_deleted | "You don't have access…" | O registro em Users foi excluído | Recrie ou restaure o usuário |
outside_access_time_window | Porta desativada, com a próxima disponibilidade quando conhecida | Uma janela futura é o único caminho de permissão possível do usuário e ainda não está ativa | Verifique a disponibilidade fornecida, o fuso horário, a atualização da origem e o mapeamento; as Access Policies e as concessões continuam sendo aplicadas de forma independente |
Algumas versões do aplicativo mostram a mensagem mais genérica "You don't have access to this door" ou "Outside allowed access hours" para negações específicas de políticas. Os Registros de acesso mantêm o motivo detalhado para os administradores.
Políticas de Acesso
| Propriedade | Significado |
|---|---|
| Estrutura da política | Nome exclusivo, descrição opcional, indicador de habilitação, público Who, destinos/exclusões Where, programação When |
| Correspondência da política | Who E Where E When |
| Várias políticas | OU; qualquer política habilitada correspondente permite o acesso |
| Who | Tipo de pessoa com status opcionais, OU tags sincronizadas/personalizadas; status vazios = qualquer status |
| Where | Todas as portas da instalação, Escopos de acesso, portas individuais ou combinações; as exclusões prevalecem dentro daquela política |
| When | Anytime, ou janelas Weekly/One-time combinadas com OU |
| Outros caminhos de permissão | As concessões permanentes e as janelas de administrador/integração permanecem separadas e cumulativas |
| Segurança | Usuários excluídos/desativados/bloqueados pela sincronização, exclusão/bloqueio de portas, manutenção, geofence, limites de taxa e verificações do controlador continuam sendo aplicados |
| Configuração existente | Importada automaticamente para políticas nomeadas equivalentes com Who, Where e When explícitos |
Atribuição de políticas
Os Registros de acesso identificam uma política correspondente pelo nome e podem mostrar o público, o destino e a programação dela. As correspondências programadas também podem incluir o início e o fim concretos ativos.
Referência das Access Time Windows
| Propriedade | Significado |
|---|---|
| Autorização | As janelas de programação de política são o When da política; as janelas de administrador/integração são caminhos de permissão cumulativos separados |
| Limite absoluto | Instantes UTC em segundos Unix inteiros, [from, to) |
| Fuso horário absoluto | Metadados de exibição/auditoria; não desloca os valores de época |
| Limite Weekly | Blocos locais HH:mm com fins exclusivos |
| Fuso horário Weekly | Fuso horário IANA válido que define o dia/hora de relógio e o horário de verão |
| Limites Weekly | Início/fim de vigência opcionais em segundos Unix; fim exclusivo |
| Pernoite/sobreposição | Não aceitos; divida os períodos que atravessam a meia-noite entre os dias e mantenha os blocos sem sobreposição |
| Responsabilidade do usuário | O administrador e cada origem de integração são isolados; um não pode apagar o outro |
| Escopo da integração | scope_key estável da origem, padrão default, mapeado para destinos do PH; desconhecido/sem mapeamento falha de forma fechada |
| Atualização da origem | Configurada conforme a frequência de cada integração; o comportamento para origens desatualizadas deve ser explícito |
| Segurança | Nunca ignora usuários desativados/excluídos/em conflito, blockAllAccess, manutenção, geofence, limites de taxa nem verificações do controlador |
Limites iniciais: 50 janelas por contêiner de política/concessão/origem; intervalo absoluto máximo de 90 dias; 120 caracteres para IDs/rótulos/chaves de escopo; oito blocos semanais por dia; as entradas recém-gravadas não podem estar expiradas há mais de uma hora.
Configurações, padrões e intervalos
Configurações de portas
| Configuração | Padrão | Intervalo / opções |
|---|---|---|
| Tempo de abertura | 10 segundos | 1–30 segundos |
| Modo de manutenção | Normal | Normal / Force open / Force closed |
| Som de abertura da porta | Desativado | Ativado / Desativado |
| Rótulo de local da porta | — | Texto livre, máximo de 64 caracteres |
| Ícone | Door | 10 opções (abaixo) |
| Programação de desbloqueio automático | Desativada | Horário com equipe na instalação ou Custom schedule, fuso horário da instalação |
| Horário de Unlock / Lock do desbloqueio automático | At opening / At closing | At opening / At closing, ou 5, 10, 15, 30, 45, 60, 90 ou 120 minutos antes ou depois |
| Desbloqueio automático em feriados | Ignore holidays | Follow the facility's holiday hours / Stay locked all day / Ignore holidays |
| Autorização de acesso (por porta) | Access Policies | Lista as políticas correspondentes e permite blockAllAccess |
| Geofence (por porta) | Inherit from facility | Inherit from facility / Override for this door / Disable geofence for this door |
| Limite de on-line | — | O controlador é considerado on-line com um sinal de atividade nos últimos 5 minutos |
Ícones de portas
| Ícone | Uso pretendido |
|---|---|
| Door | Porta simples padrão (padrão) |
| Sliding door | Porta de correr / automática |
| Double door | Porta dupla / francesa |
| Garage | Porta de garagem / de enrolar |
| Boom gate | Cancela / braço de barreira |
| Pedestrian | Entrada de equipe / pedestres |
| Security | Porta restrita / de segurança |
| Office | Escritório / sala exclusiva da equipe |
| Delivery | Doca de carga / área de entregas |
| Locker | Armário / depósito |
Configurações de geofence
| Configuração | Padrão | Intervalo |
|---|---|---|
| Geofence habilitada | Ativada (para uma nova configuração de instalação) | Ativada / Desativada |
| Raio | 200 m | 50–5000 m (incrementos de 10 m; predefinições 50 / 200 / 500 / 1000 m) |
| Margem de precisão | 25 m | — |
| Require GPS accuracy better than | 100 m | — |
| Fórmula da tolerância | — | raio + precisão do GPS informada + margem de precisão |
Períodos de tolerância de acesso
Em Settings → Access Time Windows:
| Configuração | Opções |
|---|---|
| Allow early access | Off / 5 / 10 / 15 / 30 minutos |
| Allow access after end | Off / 5 / 10 / 15 / 30 minutos |
Configurações do bloqueio do aplicativo
| Configuração | Padrão | Opções |
|---|---|---|
| Enforce app lock for this facility | Desativado | Ativado / Desativado |
| Grace period before re-prompting | 5 minutos | Always prompt / 1 min / 5 min / 15 min / 30 min / 1 hour |
| Comportamento com várias instalações | — | Exigido se qualquer instalação vinculada o exigir; prevalece o menor período de tolerância entre as instalações que o exigem |
Contatos de suporte
| Modo | Comportamento |
|---|---|
| Smart (default) | Exibidos automaticamente quando uma porta está off-line ou há poucas informações na interface |
| Always show | Sempre no painel do aplicativo |
| Never show | Nunca exibidos |
Mensagens no aplicativo
| Campo | Limite / opções |
|---|---|
| Tipo de notificação | Information / Notice / Urgent |
| Título | 120 caracteres |
| Corpo | 2000 caracteres (aviso leve a partir de 500) |
| URL do link | Somente http(s), 2000 caracteres |
| Rótulo do link | 80 caracteres, padrão "More info" |
| Programação | Starts at / Ends at opcionais |
| Marcadores (regras automáticas) | {firstName}, {lastName} |
| Campos de correspondência das regras automáticas | Membership status / Person type / Tag (as tags correspondem às sincronizadas + personalizadas, sem diferenciar maiúsculas de minúsculas) / Door visibility |
| Prioridade das regras | Prevalece a primeira regra habilitada correspondente (ordem da lista) |
Campos do usuário
| Campo | Limite / observações |
|---|---|
| Nome / sobrenome | 80 caracteres cada |
| Celular / e-mail | Pelo menos um é obrigatório (usado para a entrada com OTP); os telefones são normalizados para o formato internacional |
| Tags | 80 caracteres por tag; as tags sincronizadas são substituídas pela sincronização, as tags personalizadas são de responsabilidade do administrador |
| Observações | 2000 caracteres |
| Access enabled | Ativado por padrão; desativado = todos os desbloqueios negados |
| Concessões | Toda a instalação, lista de portas, lista de escopos, horário de funcionamento opcional |
| Access Policies | O usuário pode ser abrangido por uma ou mais políticas nomeadas; a lista/o acesso efetivo usa Access granted via policy |
| Access Time Windows | Janelas editáveis de responsabilidade do administrador, além de janelas somente leitura de responsabilidade da origem; separadas das programações das políticas |
Origens, status e outras enumerações
| Enumeração | Valores |
|---|---|
| Origem do usuário | Manually added / External Integration / CCTV-Computer Vision / Performance Hub staff |
| Blocos de usuários | All users / Has access / No access / Not synced |
| Status do convite | Not invited / Invited / Send failed |
| Destinatários dos convites | Only users with door access / All eligible synced users |
| Campos das regras de convite | Membership status / Person type / Tag / Sync source / Integration; operadores is any of / is not any of |
| Visualizações dos Registros de acesso | Door events / No visit recorded |
| Adoção do aplicativo | Active (já usou o aplicativo) / Not yet active |
| Identificador obrigatório (sincronização) | Email OR phone (padrão) / Email required / Phone required / Both required |
| Resultados do log de sincronização | Added / Updated / Skipped / Disabled / Processed / Stale snapshot |
| Estados das janelas | Active / Upcoming / Expired / Stale / Unmapped |
| Rótulos de status de associação | Active, Current, Expired, On hold, Cancelled, Pending (além de quaisquer valores do seu sistema de origem) |
| Modelos de Escopo de acesso | Custom, Main entrances, Staff-only, Restricted area, 24/7 access, Business hours, Vehicle access, Service entries |
| Modelos de mensagens automáticas | No door access, Expired membership, Payment overdue, Account on hold / suspended, Welcome (new member), Trial / prospect, Document / waiver required |
Motivos de omissão na sincronização
| Motivo exibido no log de sincronização | Significado |
|---|---|
| Integration sync is turned off for this facility | A chave geral da origem está desativada |
| This integration is turned off in sync settings | A integração específica foi excluída |
| No phone or email on the record (a phone or email is required to log in) | O registro não atende à regra Require identifier |
| Record is decoupled and managed manually | Track source updates está desativado para este usuário |
| No facility on the source record | O registro de origem não está vinculado a esta instalação |
| No matching user record | A alteração fazia referência a uma pessoa sem linha aqui |
Limites operacionais
| Limite | Valor |
|---|---|
| Importação de CSV | 200 usuários por importação |
| Convites em massa | Enviados em lotes de 50 |
| Amostra da prévia de exclusão em massa | Primeiros 50 usuários exibidos |
| Consulta aos Registros de acesso | Até os 500 eventos mais recentes por janela |
| Retenção dos eventos de acesso | ~13 meses; depois, removidos automaticamente |
| Validade do comando de desbloqueio de administrador | 30 segundos (o comando expira se não for entregue) |
| Sinal de atividade do controlador de porta | A cada ~30 segundos; off-line após 5 minutos sem comunicação |
| Solicitações de código de entrada | 5 por hora por telefone/e-mail (limite de segurança, não pode ser removido) |
| Propagação da saída do aplicativo | Revogada imediatamente; até 15 minutos para que uma sessão ativa seja totalmente encerrada |
| Salvar configurações da porta | Recarrega o controlador — normalmente de 10 a 15 segundos |
| Retenção de No visit recorded | ~13 meses |
| Mapeamentos de Access Time Window | 50 por integração |
| Access Time Windows por contêiner | 50 |
| Intervalo da janela One-time | 90 dias |
| Blocos Weekly | 8 por dia da semana |
| ID de janela/origem, rótulo, chave de escopo | 120 caracteres |
| Access Policies por instalação | 100 |
| Total de janelas de políticas | 500 |
| Nome/ID da Access Policy | 120 caracteres |
| Descrição da Access Policy | 500 caracteres |
| Configuração da Access Policy | 300 KiB UTF-8 |