Regras de espaço no calendário
Uma regra de espaço no calendário define quando um espaço está disponível e como essa disponibilidade é oferecida em faixas de horário reserváveis. É o motor único por trás de todos os calendários da REDA — os horários de visita que um agente de locação vê, as janelas de reserva entre as quais um atendente de reservas escolhe e as faixas de visita que quem agenda a manutenção seleciona. Este artigo mostra como criar uma regra, escolher entre uma grade de horários dividida em partes iguais e faixas definidas à mão, vincular regras a propriedades e prever exatamente quais faixas de horário seus usuários vão ver. Ele foi escrito para administradores; quem usa os calendários resultantes não precisa mexer nessas regras diretamente.
Acesso necessário. Configurar regras de faixa de horário exige o conjunto de permissões REDA - Master Data - Admin. O conjunto REDA - Master Data - Read Only permite visualizá-las, mas não alterá-las; quem trabalha com reservas e agendamentos as consulta indiretamente, pelos seletores que usa.
Um motor, três calendários
Toda regra de faixa de horário tem uma configuração Applicable For que decide qual calendário ela comanda — Showing, Booking ou Maintenance. Uma propriedade tem um campo de regra de faixa de horário por caso de uso, e cada campo só aceita uma regra do tipo correspondente: não é possível colocar uma regra Booking no campo de visitas. É isso que mantém os três calendários independentes, mesmo que compartilhem a mesma lógica por trás.
| Caso de uso | Campo na propriedade | Quem usa o seletor | Artigo correspondente |
|---|---|---|---|
| Showings | Showing Slot Rule | Agentes de locação | Agendando visitas |
| Bookings | Booking Slot Rule | Equipe de reservas | Reservas de curta duração |
| Maintenance | Maintenance Slot Rule | Equipes de manutenção | Ordens de serviço |
As regras são reutilizáveis — vincule a mesma regra a várias propriedades. Você só precisa de uma regra separada quando o padrão de disponibilidade realmente for diferente.
Anatomia de uma regra
Uma regra Standard é uma janela diária de disponibilidade fatiada em faixas de horário de tamanho igual. Estes campos a moldam:
Campos opcionais completam a regra: Calendar Id agrupa os eventos gerados em um calendário compartilhado; Record Assignment indica o usuário ou a fila a quem os eventos gerados são atribuídos; Day Label e Time Label definem formatos de exibição (deixe-os no padrão, a menos que você tenha um formato específico em mente); e Region e Description ajudam a classificar e documentar a regra.
Record Assignment cumpre uma função dupla. Além de indicar quem é o proprietário dos eventos gerados, ele também filtra a verificação de ocupação: só os eventos do próprio usuário ou da própria fila atribuída contam contra a disponibilidade desta regra. Assim, duas regras na mesma propriedade atribuídas a equipes diferentes mantêm calendários independentes, e o dia lotado de uma equipe nunca bloqueia as faixas de horário da outra.
Faixas Standard vs. slots personalizados
O campo Slot Type escolhe como a disponibilidade é repartida. Standard — o padrão — corta a janela diária em faixas iguais ao seu Slot Duration. Custom permite definir à mão janelas específicas e nomeadas, com capacidade própria.
| Standard | Custom | |
|---|---|---|
| Como as faixas são criadas | A janela é fatiada automaticamente em passos iguais ao Slot Duration | Você define à mão o início e o fim de cada faixa |
| Capacidade | Uma reserva por faixa | Definida por faixa — um ou vários eventos simultâneos |
| Rótulos | Gerados a partir dos horários | O seu próprio Slot Label (por exemplo, "Tarde", "Noite") |
| Melhor para | Visitas regulares, salas por hora | Sessões fixas, espaços de capacidade compartilhada |
Um slot personalizado é um registro filho da regra, com Start Time e End Time (que precisam ficar dentro do horário disponível da regra), um Slot Label e o Maximum Events Per Slot — um modelo de capacidade. Defina 1 (o padrão) e a faixa é de ocupação única; defina 3 e a faixa continua disponível até que três eventos se sobreponham a ela, que é como você ofereceria, por exemplo, três sessões simultâneas de academia.
A REDA mantém os slots personalizados dentro da janela da regra. Se você ultrapassar qualquer uma das pontas, ela impede:
"Start Time must be after the Available From Time defined in Calendar Slot Rule."
Uma regra Custom precisa de pelo menos um slot personalizado: se nenhum estiver definido, quem abrir o seletor verá um erro, porque não há nada para a REDA oferecer.
Gestão por Property ou por Parent
O campo Slot Management decide contra o calendário de quem a verificação de disponibilidade é feita.
Use Parent quando o recurso for realmente compartilhado — um único agente de visitas cobrindo um edifício, um salão de eventos que atende todas as unidades — para que uma reserva em uma unidade bloqueie corretamente as demais. Use Property quando as unidades forem independentes.
Vinculando uma regra a uma propriedade
Uma regra não faz nada enquanto não estiver vinculada a uma propriedade. No registro da propriedade, preencha o campo do caso de uso que você quer:
Como a REDA calcula o que os usuários veem
Quando um usuário abre um seletor, a REDA monta a lista de faixas de horário oferecidas nesta ordem. Entendê-la responde a quase toda pergunta do tipo "por que vejo estes horários e não aqueles?":
Um exemplo passo a passo
Tome uma regra Standard de visitas: disponível das 09:00 às 17:00, Slot Duration (Minutes) 30, Event Buffer Time (minutes) 10, com uma visita já marcada das 10:00 às 10:45. Veja o que o seletor oferece naquela manhã:
| Faixa | Oferecida? | Por quê |
|---|---|---|
| 09:00 | Sim | Livre; termina às 09:30 |
| 09:30 | Sim | Termina às 10:00, logo antes do evento ocupado |
| 10:00, 10:30 | Não | Sobrepõem-se ao evento das 10:00–10:45 |
| 10:55 | Sim | O evento termina às 10:45, mais o buffer de 10 minutos |
| 11:25, 11:55… | Sim | A grade continua a partir das 10:55 |
Repare que, depois de um evento ocupado, a grade reinicia a partir do horário pós-buffer (10:55), e não volta para a meia hora cheia. Dois casos-limite que vale lembrar: um evento de dia inteiro naquele dia significa nenhuma faixa de horário, e qualquer horário já passado hoje é descartado.
Exemplo prático: duas regras
Duas regras atendem necessidades bem diferentes na Meridian Properties:
Referência de campos
Os campos da própria regra:
| Campo | O que controla | Restrição |
|---|---|---|
| Rule Name | Identifica a regra | É o nome do registro |
| Applicable For | Showing / Booking / Maintenance | Obrigatório; vincula-se ao campo correspondente da propriedade |
| Available From Time / Available To Time | A janela diária de disponibilidade | Ambos obrigatórios |
| Slot Duration (Minutes) | Duração de cada faixa de horário oferecida | Obrigatório, no mínimo 10 |
| Event Buffer Time (minutes) | Intervalo deixado depois de cada evento ocupado | Obrigatório, zero ou mais; mínimo interno de 2 min quando é 0 |
| Week Days | Quais dias oferecem faixas de horário | Obrigatório; seleção múltipla de Sun a Sat |
| Event Days | Quantos dias à frente são exibidos | Obrigatório, no mínimo 1 |
| Default Start Date Days | Quantos dias à frente o calendário começa | O padrão é 0 |
| Slot Type | Grade Standard ou slots Custom | Standard por padrão |
| Slot Management | Property (por unidade) ou Parent (para todo o edifício) | |
| Calendar Id | Calendário compartilhado para os eventos gerados | Opcional |
| Record Assignment | Usuário ou fila que recebe os eventos gerados; também restringe a verificação de ocupação aos eventos da própria equipe | Opcional |
| Day Label / Time Label | Padrões de formato de exibição | Deixe no padrão, salvo necessidade |
| Region / Description | Classificação e observações | Opcional |
O registro filho de slot personalizado:
| Campo | O que controla | Restrição |
|---|---|---|
| Start Time / End Time | A janela da faixa | Obrigatórios; precisam ficar dentro do horário da regra |
| Maximum Events Per Slot | Quantos eventos simultâneos a faixa permite | Padrão 1 (ocupação única) |
| Slot Label | Nome de exibição (por exemplo, "Noite") | Opcional |
| Description | Observações | Opcional |
Três verificações mantêm uma regra Standard válida, e a REDA as apresenta exatamente com o texto abaixo:
"Event Days must be a positive number greater or equal to 1."
"The time between slots must a positive number equal or greater than 0."
O que vem a seguir
- Bloqueios e exceções de horários — feche uma regra em feriados ou paradas, pontualmente ou de forma recorrente.
- Reservas de curta duração — o calendário de Booking em ação.
- Agendando visitas — o calendário de Showing em ação.
- Ordens de serviço — o calendário de Maintenance em ação.
- Disponibilizando uma propriedade para locação e reservas — vincular regras e liberar um espaço.
Perguntas frequentes
As faixas não podem ser menores que dez minutos: "Slot Duration must be a positive number greater than or equal to 10." Aumente o Slot Duration (Minutes) para 10 ou mais.
A REDA mantém um mínimo interno de dois minutos entre eventos mesmo quando o Event Buffer Time (minutes) é 0. O pequeno intervalo que você vê é esse mínimo, não uma configuração que você possa remover.
O Applicable For dela não corresponde. Cada campo da propriedade aceita apenas uma regra do seu próprio tipo — um campo Booking aceita somente regras Booking. Altere o Applicable For da regra ou use uma regra que já corresponda.
O Slot Management da regra está definido como Parent, o que executa a verificação de ocupação em um único calendário compartilhado no nível do edifício. Mude para Property se cada unidade deve manter o próprio calendário independente.
Verifique os suspeitos de sempre, nesta ordem: o dia da semana não está em Week Days; a janela de antecedência de Event Days se esgotou; um evento de dia inteiro cobre o dia; uma exceção de bloqueio cobre a janela; ou, em uma regra Custom, nenhum slot personalizado foi definido ainda.
Sim, quando o Maximum Events Per Slot do slot é maior que 1 — esse é o modelo de capacidade (por exemplo, três sessões simultâneas de academia). As faixas da grade Standard são sempre de ocupação única.
Não — as regras são reutilizáveis, então vincule uma mesma regra a quantas propriedades compartilharem o padrão de disponibilidade dela. Use a gestão Parent ou exceções de faixa de horário para tratar diferenças específicas de um edifício ou pontuais sem clonar a regra.
Isso foi útil?