Bloqueios e exceções de horários

Uma exceção de horário é um bloqueio: uma janela durante a qual uma regra de espaço no calendário não oferece disponibilidade, sobreposta à regra sem alterá-la. As exceções são a forma de fechar um feriado, bloquear o horário semanal de limpeza ou parar um edifício para reforma — sem mexer nas regras de horário que você montou com cuidado. Este artigo, escrito para administradores, mostra como adicionar um bloqueio pontual ou recorrente, delimitá-lo desde todas as propriedades até uma só, e entender como uma série recorrente se mantém reabastecida automaticamente. Os bloqueios sempre prevalecem sobre a disponibilidade, então uma exceção bem colocada é a maneira mais limpa de tirar tempo do calendário.

O que é uma exceção

Uma exceção pertence a uma Regras de espaço no calendário e carrega uma janela de bloqueio — um Unavailable From e um Unavailable To. Durante o cálculo das faixas de horário, qualquer exceção cuja janela e cujo escopo se apliquem elimina as faixas que ela cobre. Isso vale tanto para as regras Standard quanto para as Custom, e a regra é simples: um bloqueio sempre prevalece sobre a disponibilidade. Se um horário é oferecido pela regra e ao mesmo tempo coberto por uma exceção, ele some do seletor.

Uma exceção carrega um nome (Exception Subject), a janela, um Unavailable Reason que você pode deixar para a sua equipe, um conjunto de campos de escopo opcionais e — se ela se repetir — uma frequência. Vamos ver cada um deles.

Criar um bloqueio pontual

A exceção mais simples é uma única janela — um feriado, um fechamento de um dia:

A REDA verifica se a janela faz sentido — o fim não pode vir antes do início:

Definir o escopo de um bloqueio

Por padrão, um bloqueio cobre todas as propriedades que usam a regra. Você o delimita com qualquer um dos quatro lookups de escopo — Region, Neighbourhood, Property Type ou uma única Property. Um campo de escopo em branco é um curinga; um campo preenchido precisa corresponder à propriedade que está sendo agendada para que o bloqueio se aplique a ela. Se você preencher mais de um, todos os campos preenchidos precisam corresponder — por exemplo, Region e Property Type juntos atingem apenas as propriedades que estão naquela região e são daquele tipo.

Bloqueios recorrentes

Para um bloqueio que se repete — uma limpeza pesada semanal, um dia de fechamento mensal — defina uma Recurring Frequency e um Advance Recur Instances. A frequência decide a distância entre as ocorrências; a contagem de antecedência decide quantas ocorrências futuras a REDA mantém geradas com antecipação.

Uma exceção recorrente precisa da sua contagem de antecedência, e a REDA exige isso:

Salve o registro pai e a REDA cria imediatamente as ocorrências futuras como registros filhos — um para cada uma das suas instâncias de antecedência, com as janelas deslocadas pela frequência e os nomes carregando um sufixo numerado. Cada filho fica vinculado ao pai, então toda a série é fácil de ver embaixo da regra. Os filhos são cópias do pai, então o escopo e o motivo que você definiu no pai valem para todas as ocorrências — você não precisa defini-los de novo a cada data.

Como a série se mantém reabastecida

Você nunca precisa estender uma série recorrente manualmente. Um trabalho noturno da REDA — executado pouco depois da meia-noite — verifica cada série e regenera as ocorrências consumidas, de modo que a série sempre fique com o número configurado de instâncias à frente. Esse é um dos poucos trabalhos da REDA agendados para rodar automaticamente desde o início; você pode confirmá-lo no console de trabalhos agendados (veja Agendamento de Trabalhos em Segundo Plano).

Editar e excluir uma série

Depois que um registro pai recorrente gerou os seus filhos, a REDA bloqueia alterações na data final do pai — ela impede a edição e informa o motivo, para manter o pai e os filhos consistentes. A forma suportada de alterar uma série em andamento é excluí-la e criá-la novamente com a nova configuração.

Excluir o pai é limpo: isso exclui em cascata toda a série, removendo junto cada filho gerado. Isso é por design — uma única exclusão limpa o bloqueio recorrente inteiro.

Exemplo prático: dois bloqueios

Os dois ficam sobre a regra Residential Showings — Weekdays do exemplo de Regras de espaço no calendário:

A lista de exceções filhas embaixo de uma regra de horário — a exceção pontual Holiday Blackout da regra Harbour Tower Showings, com a sua janela Unavailable From / To, o Unavailable Reason e as colunas de escopo Applicable To.

Uma exceção de horário (Holiday Blackout): a Calendar Slot Rule pai, a janela Unavailable From / To e o Unavailable Reason, os campos de Recurrence e os lookups de escopo Applicable To (Region, Neighbourhood, Property, Property Type).

Referência de campos

O que vem a seguir

1. Regras de espaço no calendário — o objeto pai e como as faixas de horário são calculadas.
2. Reservas de curta duração — onde o bloqueio é sentido do lado das reservas.
3. Agendando visitas — onde o bloqueio é sentido do lado das visitas.
4. Agendamento de Trabalhos em Segundo Plano — o trabalho noturno de reposição e o console de trabalhos.
5. Ordens de serviço — bloqueios de manutenção sobre o mesmo motor.

Perguntas frequentes