| Objetivo | Entender o que cada operador de filtro e filtro de data pré-definido significa nos Relatórios e no Cloudbeds Insights, e quando usar cada um. |
| Ideal para | Proprietários de estabelecimentos, gerentes, equipes da recepção e financeira, administradores e autores do Cloudbeds Insights que visualizam, filtram, criam ou solucionam problemas em relatórios. |
| Use quando | Você precisar escolher um filtro, confirmar o que um filtro retorna, comparar filtros de data semelhantes ou entender por que os resultados do relatório mudam após a aplicação de um filtro. |
| Requisitos | As permissões e capacidades do produto necessárias para a ação do relatório que você deseja executar. Veja Acesso e dependências. |
| Resultado esperado | Você poderá interpretar e aplicar corretamente os operadores de filtro e filtros de data pré-definidos, além de reconhecer quando a escolha de um filtro está afetando os resultados do seu relatório. |
Introdução
Os relatórios no Cloudbeds usam filtros para restringir os resultados aos registros que você precisa, seja ao abrir um Relatório Cloudbeds ou ao criar um personalizado no Cloudbeds Insights. Cada filtro é composto por um operador, como igual a ou contém, e para campos de data, um conjunto de filtros pré-definidos como Últimos 7 Dias ou Mês Atual.
Este glossário explica o que cada operador de filtro e filtro de data pré-definido retorna, para que você possa usar os filtros corretamente e entender por que um relatório exibe determinados resultados. Usuários com acesso a Relatórios e a permissão adequada de Visualizador podem aplicar esses filtros nos Relatórios Cloudbeds. Criar e salvar permanentemente novos relatórios filtrados do zero requer o Cloudbeds Insights, capacidades de Criador e a permissão adequada de Autor.
Neste artigo
Quem isso afeta e como
As mesmas definições de filtro se aplicam tanto aos Relatórios quanto ao Cloudbeds Insights, mas a forma como você os utiliza depende do trabalho de relatório pelo qual você é responsável e das permissões disponíveis para você.
| Papel | O que você precisa saber |
|---|---|
| Usuários da recepção e operacionais | Use operadores de filtro e filtros pré-definidos de data para restringir relatórios para perguntas do dia a dia, como chegadas, partidas, detalhes da reserva ou atividade recente. Confirme a definição de um filtro quando os resultados não corresponderem ao período ou aos registros esperados. |
| Gerentes e equipes financeiras | Preste atenção especial aos filtros pré-definidos de data ao comparar períodos operacionais ou financeiros. Filtros baseados no calendário e filtros móveis podem retornar intervalos de datas diferentes, mesmo quando seus nomes parecem semelhantes. |
| Titulares da propriedade | Use as definições de filtro de data para distinguir visualizações de período completo, período até a data, histórico e projeções antes de interpretar os totais do relatório ou comparar desempenho. |
| Administradores e autores do Cloudbeds Insights | Revise Acesso e dependências antes de criar ou salvar permanentemente relatórios filtrados. As permissões de visualizador e autor determinam se você pode apenas visualizar e filtrar temporariamente um relatório ou também usar as capacidades do construtor para criar e salvar conteúdo de relatório. |
Acesso e dependências
Confirme o seguinte antes de aplicar ou criar filtros:
- Acesso a relatórios para visualizar os Relatórios Cloudbeds.
- Permissão de visualizador para o conjunto de dados ou relatório específico que você deseja visualizar. O acesso de visualizador é concedido por conjunto de dados, portanto, tê-lo para um relatório não garante automaticamente acesso a todos os relatórios. Veja Permissões de papéis para entender como funciona o acesso a nível de conjunto de dados.
- Cloudbeds Insights e permissão de autor para o mesmo conjunto de dados, caso você esteja criando um relatório do zero ou salvando alterações permanentemente, como Salvar Como, usando as funcionalidades de criação de relatórios (Construtor) disponíveis para usuários do Cloudbeds Insights com permissão de autor.
- O tipo de campo que você está filtrando. Os operadores e filtros pré-definidos de data disponíveis dependem se o campo selecionado é texto, número ou data.
Com esses pontos confirmados, você está pronto para explorar o próprio glossário. Ele começa com Operadores de filtro, as regras gerais que se aplicam independentemente do tipo de campo, antes de detalhar os Filtros de data, que são os filtros pré-definidos que só ficam disponíveis quando você trabalha com um campo de data.
Operadores de filtro
Os operadores de filtro são as regras gerais de comparação e correspondência que você verá em todo o Cloudbeds Relatórios e Construtor. Eles funcionam da mesma forma independentemente do tipo de campo, então um operador como igual a ou contém se comporta de maneira consistente, seja você filtrando um nome, um número ou uma data.
Alguns operadores fazem mais quando o campo selecionado é uma data. Por exemplo, maior ou igual a desbloqueia um conjunto dedicado de filtros pré-definidos de data, abordados em Filtros de data. Por isso, termos como Todos ou Não é nulo podem aparecer novamente nessa seção com um significado mais específico, orientado por data: a tabela abaixo explica primeiro o comportamento geral, e a versão específica para datas vem em sua própria seção.
| Termo do filtro | Definição | Quando usar |
|---|---|---|
| Todos | Mostra todos os registros para o campo selecionado, incluindo valores nulos (ausentes) ou vazios. | Use quando quiser que o filtro esteja presente sem excluir nenhum resultado, como ao construir um relatório antes de refiná-lo. |
| Nulo | Verifica se o campo não contém nenhum valor. Filtra os registros que possuem dados. | Use para encontrar registros incompletos, como reservas que estão sem um campo obrigatório, para que você possa acompanhar. |
| Não é nulo | Mostra apenas os registros onde o campo selecionado contém um valor; registros sem valor são excluídos. | Use quando quiser apenas registros completos, como reservas com data de check-in confirmada. Para incluir valores nulos ou vazios também, use Todos. |
| igual a | Verifica se um valor corresponde exatamente. Exemplo: número da reserva igual a 1162241480445 retorna apenas essa reserva. | Ideal para buscar um registro específico e conhecido. |
| diferente de | Verifica se um valor não corresponde. Exemplo: número da reserva diferente de 1162241480445 exclui apenas essa reserva. | Use para excluir um registro conhecido mantendo todos os outros. |
| maior ou igual a | Retorna registros na data ou após o valor. Exemplo: Data de Check-in maior ou igual a 2024-11-05 retorna essa data e todas as posteriores. Para um campo de data, esse operador exibe os filtros pré-definidos em Filtros de data. | Use para perguntas abertas e prospectivas, como tudo a partir dessa data em diante. |
| maior que | Retorna registros estritamente após o valor. Exemplo: Data de Check-in maior que 2024-11-05 retorna a partir de 2024-11-06. | Use em vez de maior ou igual a quando a data limite deve ser excluída. |
| menor que | Retorna registros estritamente antes do valor. Exemplo: Data de Check-in menor que 2024-11-05 retorna até 2024-11-04. | Use para revisar histórico até, mas sem incluir, uma data limite. |
| menor ou igual a | Retorna registros na data ou antes do valor. Exemplo: Data de Check-in menor ou igual a 2024-11-05 retorna essa data e as anteriores. | Use para perguntas retrospectivas, como tudo até essa data, incluindo a própria data. |
| em | Verifica se um valor faz parte de uma lista definida. Exemplo: Status da Transação em (Pendente, Lançado) retorna ambos os status. Exibido como lista de caixas de seleção. | Útil para reconciliação, quando você precisa isolar uma combinação específica de status ao mesmo tempo. |
| não está em | Exclui uma lista definida de valores. Exemplo: Status da Transação não está em (Pendente) retorna tudo exceto pendente. Exibido como lista de caixas de seleção. | Útil para excluir status conhecidos que você não quer que poluam um relatório de reconciliação. |
| contém | Corresponde a texto em qualquer parte do campo, sem diferenciar maiúsculas de minúsculas. Exemplo: nome do hóspede contendo "ro" corresponde a Rosie, Ronald e Deborah-Rose. | Útil para buscas parciais ou incertas quando você não sabe a grafia exata ou a posição do texto. |
| não contém | Exclui registros que contenham esse texto, sem diferenciar maiúsculas de minúsculas. Exemplo: nome não contém "ver" exclui Veronica, Oliver e Iver. | Use para excluir registros que contenham um trecho conhecido de texto, sem precisar saber sua posição. |
| começa com | Corresponde a texto no início do campo, sem diferenciar maiúsculas de minúsculas. Exemplo: começa com "Jo" corresponde a John, Joanna e Johnson, mas não a Jeremy ou Juan. | Útil quando você sabe como um valor começa, como um código de origem ou prefixo de ID. |
| não começa com | Exclui registros que começam com esse texto, sem diferenciar maiúsculas de minúsculas. | Use para excluir um prefixo conhecido, como filtrar registros de uma fonte específica. |
| termina com | Corresponde a texto no final do campo, sem diferenciar maiúsculas de minúsculas. Exemplo: termina com "th" corresponde a Elizabeth, não a Luz. | Útil quando você sabe como um valor termina, como um sufixo de documento ou arquivo. |
| não termina com | Exclui registros que terminam com esse texto, sem diferenciar maiúsculas de minúsculas. | Use para excluir registros com um sufixo conhecido. |
| está vazio | Verifica se o campo está vazio ou não contém dados utilizáveis. | Útil para uma verificação mais leve que Null quando você só precisa identificar entradas em branco em um campo de texto. |
| não está vazio | Verifica se o campo contém um valor, incluindo um espaço não visível. | Use para confirmar que um campo de texto tem conteúdo, inclusive nos casos em que foi inserido apenas um espaço oculto. |
Filtros de data
Filtros de data são os filtros pré-definidos e comportamentos disponíveis especificamente quando o campo selecionado é uma data, como Últimos 7 Dias ou Mês Atual.
Esta seção está organizada por opção de data em vez de por operador. Por isso, uma etiqueta já abordada em Operadores de filtro, como Todos ou Não é Nulo, pode reaparecer aqui com um significado específico para campos de data, e não um significado geral.
Cada filtro de data funciona de uma das duas formas: Fixo ou Móvel. Saber qual tipo você está usando explica por que os totais de um relatório mudam, ou não, de um dia para o outro.
| Tipo | Comportamento | Quando usar | Exemplo |
|---|---|---|---|
| Fixo | Sempre corresponde ao mesmo intervalo de datas, independentemente de quando você executar o relatório. | Use quando precisar de resultados consistentes e repetíveis, como relatórios de fechamento mensal ou para comparar o mesmo período em diferentes execuções do relatório. | Último Mês é o mês calendário completo anterior, todas as vezes. |
| Móvel | Recalcula diariamente, em relação ao dia atual. | Use quando quiser um relatório que se mantenha automaticamente atualizado sem precisar editar todos os dias, como um painel que você verifica regularmente. | Últimos 7 Dias sempre inclui hoje e os 6 dias anteriores. A janela se move a cada dia. |
Dia
| Filtro | Retorna | Tipo | Quando usar |
|---|---|---|---|
| Hoje | Apenas a data de hoje. | Dinâmico | Útil para verificações operacionais diárias, como chegadas ou partidas do dia. |
| Ontem | O dia calendário anterior. | Dinâmico | Útil para a reconciliação de fim de dia feita na manhã seguinte. |
| Amanhã | O próximo dia calendário. | Dinâmico | Útil para planejamento de chegadas ou governança do dia seguinte. |
Semana
| Filtro | Retorna | Tipo | Quando usar |
|---|---|---|---|
| Semana Atual | A semana do calendário atual completa, incluindo os dias futuros restantes. | Fixo | Útil para planejamento semanal que precisa considerar o que ainda está por vir. |
| Semana Passada | A semana do calendário anterior completa. | Fixo | Útil para comparações semana a semana de atividades concluídas. |
| Próxima Semana | A próxima semana do calendário completa. | Fixo | Útil para planejamento de equipe ou chegadas futuras. |
| Últimos 7 Dias | Hoje mais os 6 dias anteriores. | Dinâmico | Útil para um panorama sempre atual e dinâmico, em vez de uma semana fixa do calendário. Como é dinâmico, os totais mudam diariamente. |
| Próximos 7 Dias | Hoje mais os 6 dias seguintes. | Dinâmico | Útil para uma previsão dinâmica de curto prazo, como chegadas futuras independentemente do dia da semana. |
Mês
| Filtro | Retorna | Tipo | Quando usar |
|---|---|---|---|
| Mês Atual | O mês calendário atual completo (do dia 1º ao último), incluindo datas futuras. | Fixo | Use para planejamento ou previsão, como planejamento de ocupação. Como inclui datas futuras, os totais podem diferir de relatórios que medem apenas atividades concluídas. |
| Mês Atual MTD | Do dia 1º do mês atual até hoje. | Móvel | Use para acompanhamento de desempenho em andamento, como receita reservada até o momento neste mês. Não corresponderá ao Mês Atual até o mês terminar completamente. |
| Mês Passado | O mês calendário anterior completo. | Fixo | Útil para relatórios de períodos fechados e comparações mês a mês. |
| Próximo Mês | O próximo mês calendário completo. | Fixo | Útil para planejamento futuro, como revisar reservas confirmadas para o mês seguinte. |
| Últimos 30 Dias | Hoje mais os 29 dias anteriores. | Móvel | Útil para uma visão móvel dos últimos 30 dias. Não coincidirá com Mês Passado, então evite misturar os dois na mesma comparação. |
| Próximos 30 Dias | Hoje mais os 29 dias seguintes. | Móvel | Útil para uma previsão móvel de curto prazo não vinculada aos limites do mês calendário. |
Trimestre
| Filtro | Retornos | Tipo | Quando usar |
|---|---|---|---|
| Trimestre Atual | O trimestre civil completo atual (Q1 janeiro a março, Q2 abril a junho, Q3 julho a setembro, Q4 outubro a dezembro), incluindo datas futuras. | Fixo | Use para planejamento de trimestre completo. Como datas futuras estão incluídas, os totais podem superestimar o desempenho até a data atual do trimestre. |
| Trimestre Atual Até a Data (QTD) | Do primeiro dia do trimestre atual até hoje. | Dinâmico | Use para acompanhamento ao vivo e em andamento do trimestre, como o progresso da receita em relação à meta trimestral. |
| Trimestre Anterior | O trimestre civil completo anterior. | Fixo | Útil para relatórios de trimestre fechado e comparações trimestre a trimestre. |
| Próximo Trimestre | O próximo trimestre civil completo. | Fixo | Útil para ciclos de orçamento e planejamento futuros. |
Ano
| Filtro | Retorna | Tipo | Quando usar |
|---|---|---|---|
| Ano Atual | O ano civil completo atual (1º de janeiro a 31 de dezembro), incluindo datas futuras. | Fixo | Use para planejamento anual; os totais incluem reservas ainda não realizadas. |
| Ano Atual Até a Data | De 1º de janeiro do ano atual até hoje. | Móvel | Use para acompanhamento do desempenho no ano até a data e revisões de orçamento versus realizado. |
| Ano Passado | O ano civil completo anterior. | Fixo | Útil para comparações ano a ano de atividades totalmente concluídas. |
| Próximo Ano | O próximo ano civil completo. | Fixo | Útil para previsões de longo prazo e preparação de orçamento. |
Personalizado
| Filtro | Retorna | Tipo | Quando usar |
|---|---|---|---|
| Todos | Qualquer data. Nenhum filtro de data aplicado. | Fixo | Útil como ponto de partida antes de restringir para um período específico. |
| Data Personalizada | Uma única data que você escolher. | Fixo | Ideal para investigar ou reconciliar um dia exato. |
| Intervalo de Datas Personalizado | Um intervalo que você define, usando datas fixas ou relativas. | Fixo ou Dinâmico | Use quando nenhum pré-ajuste nomeado corresponde exatamente ao período que você precisa. Veja Escolhendo entre Data Personalizada e Intervalo de Datas Personalizado. |
O Intervalo de Datas Personalizado possui quatro modos:
| Modo | O que retorna | Quando usar | Exemplo |
|---|---|---|---|
| Datas personalizadas | Uma data de início e uma data de término específicas. Ambas as datas estão incluídas nos resultados. | Use para um período fixo e único de relatório, como um período específico de promoção. | De 10/05/2025 a 19/05/2025 inclui 10/05, 19/05 e todos os dias entre eles. |
| Data até o fim dos dados | Uma data de início sem limite final. Todos os registros a partir dessa data até os dados mais recentes disponíveis. | Use para capturar tudo desde um marco conhecido, como uma mudança no sistema. | A partir de 01/01/2024, para tudo desde então. |
| Início dos dados até a data | Uma data de término sem limite inicial. Todos os registros desde os dados mais antigos disponíveis até essa data, inclusive. | Use para puxar todo o histórico até um prazo conhecido. | Até 31/12/2023, para puxar dados históricos. |
| Datas relativas personalizadas | Um intervalo móvel que você define escolhendo um número, uma unidade de tempo e uma direção. As unidades podem ser dias, semanas, meses ou anos, e a direção pode ser anterior ou posterior. O intervalo atualiza automaticamente a cada dia. | Use quando precisar de um período móvel que nenhum preset nomeado cobre e quiser que o relatório se mantenha atualizado sem alterar as datas manualmente. | 30 dias anteriores, 2 semanas posteriores ou 3 meses anteriores. |
Verificações de nulos (campos de data)
| Filtro | O que retorna | Tipo | Quando usar |
|---|---|---|---|
| É Nulo | Não possui valor de data. | Fixo | Útil para encontrar registros que estão sem uma data esperada, como uma reserva sem finalização da compra registrada. |
| Não é Nulo | Possui valor de data. | Fixo | Útil para limitar um relatório apenas a registros completos e datados. |
Escolhendo entre Data Personalizada e Intervalo de Datas Personalizado
Use esta seção quando nenhum dos filtros pré-definidos em Dia, Semana, Mês, Trimestre ou Ano atender ao que você precisa, e você precisar decidir entre filtrar por uma data exata ou por um período, um intervalo aberto ou uma janela móvel. Comece perguntando que tipo de questão você quer responder:
Use Data Personalizada quando sua pergunta se refere a uma data específica, como verificar o que aconteceu em uma data de check-in particular.
Use Intervalo de Datas Personalizado quando sua pergunta se refere a um período de tempo em vez de uma única data. O Intervalo de Datas Personalizado cobre quatro modos diferentes, dependendo se o período tem início e fim fixos, é aberto em uma das extremidades ou deve avançar automaticamente:
- Datas personalizadas para um intervalo fixo com início e fim específicos. Ambas as datas limites são incluídas.
- Datas relativas personalizadas para um intervalo móvel que nenhum filtro pré-definido cobre, como "45 dias antes" ou "2 semanas depois". Ele atualiza automaticamente a cada dia, para que as visualizações salvas permaneçam atuais sem alterações manuais.
Veja Personalizado para as definições completas dos quatro modos, incluindo os dois modos abertos (data até o fim dos dados e início dos dados até a data).
Qualquer usuário de Relatórios pode aplicar temporariamente um intervalo de datas relativas personalizado ao visualizar um Relatório Cloudbeds. Salvar isso como parte de um relatório novo ou editado requer o Cloudbeds Insights e a permissão de Autor apropriada para usar suas capacidades de criação de relatórios.
Pares comumente confundidos
Esses pares predefinidos parecem semelhantes, mas retornam resultados diferentes. Verificar a diferença aqui pode economizar tempo na solução de problemas depois.
| Par | A diferença | Exemplo |
|---|---|---|
| Semana Atual vs. Últimos 7 Dias | Semana Atual usa a semana do calendário configurado (limites fixos). Últimos 7 Dias é uma janela móvel de 7 dias terminando hoje, então sempre atravessa os limites da semana. | Um agente da recepção que busca chegadas para "esta semana" quer a Semana Atual. Se ele escolher Últimos 7 Dias numa quarta-feira, o relatório abrangerá a semana passada e perderá parte da atual. |
| Mês Atual vs. Mês Atual MTD | Mês Atual é o mês inteiro, incluindo datas futuras. MTD para até hoje, então use para relatórios em andamento. | Um gerente que verifica o desempenho até agora neste mês quer o Mês Atual MTD. Mês Atual incluiria reservas futuras e faria a receita parecer maior do que realmente foi. |
| Trimestre Atual vs. Trimestre Atual QTD | Trimestre Atual é o trimestre completo (datas passadas e futuras). QTD vai do início do trimestre até hoje, então use para acompanhar o desempenho ao vivo. | Um gerente geral que acompanha a ocupação do trimestre até a data quer o QTD. Trimestre Atual incluiria reservas para datas futuras no trimestre e superestimaria a tendência real. |
| Últimos 30 Dias vs. Mês Passado | Mês Passado é um mês calendário limpo, por exemplo, de 1 a 30 de abril. Últimos 30 Dias rola a partir de hoje, então os totais mudam diariamente. | Uma equipe financeira comparando meses calendário completos quer o Mês Passado. Últimos 30 Dias mudaria um dia antes toda vez que o relatório rodar, tornando os períodos desiguais para comparação. |
Artigos relacionados
Agora você deve conseguir interpretar e escolher o filtro certo para sua pergunta de relatório. Para um contexto mais amplo sobre como Relatórios e Cloudbeds Insights se relacionam, e como o acesso aos relatórios é controlado, revise estes recursos adicionais:
Comentários
Por favor, entre para comentar.