Como criar Campos de Dados Formulados no PMS da Cloudbeds (CDCs)

Objetivo Criar e usar Campos de Dados da Cloudbeds (CDFs) formulados para calcular ou classificar dados de relatórios.
Ideal para Gerentes/Gerentes Gerais, Administradores e Proprietários que personalizam relatórios.
Use quando Você precisar de uma métrica calculada, campo descritivo, indicador condicional ou classificação personalizada que um relatório padrão não forneça.
Requisitos Um relatório que você possa personalizar ou um relatório personalizado salvo com pelo menos uma coluna adicionada antes de criar um CDF formulado.
Resultado esperado Um CDF formulado salvo, adicionado ao relatório e visível quando você executá-lo.
Limitações Os CDFs formulados pertencem ao relatório onde são criados. CDFs de tipos diferentes de relatório não podem ser combinados.

Introdução

Os Campos de Dados da Cloudbeds (CDFs) formulados criam colunas personalizadas a partir de campos existentes no relatório. Eles podem calcular valores a partir de dados numéricos ou retornar resultados descritivos, incluindo resultados condicionais usando Fórmulas Avançadas. Isso permite que você analise dados dentro de um relatório sem precisar exportá-los primeiro.

O tipo de cálculo importa: algumas fórmulas processam cada registro individual antes que os totais sejam calculados, enquanto outras calculam a partir dos totais depois que o relatório agrupa e filtra os registros. Escolha o tipo que corresponde à pergunta que você quer que o relatório responda.

Neste artigo

Entenda os CDFs formulados

Um CDF formulado usa campos existentes dentro de um tipo de relatório para criar um novo campo calculado ou descritivo. Métricas são campos numéricos que podem ser somados, contados ou calculados pela média. Dimensões descrevem ou classificam registros. Para uma referência mais ampla dos campos, consulte Campos de Dados da Cloudbeds (CDFs).

Você pode criar CDFs formulados ao personalizar Relatórios Cloudbeds ou editar um Relatório Salvo. Um CDF formulado é específico para o relatório onde você o cria, e não é possível juntar campos de diferentes tipos de relatório.

Escolha o tipo de cálculo correto

Ao selecionar Tipo em Colunas Formuladas, escolha se os cálculos devem ocorrer antes ou depois do relatório resumir os registros. Essas duas opções podem produzir resultados diferentes, especialmente para razões e médias.

CDF calculado no nível da linha CDF calculado por agregação
Definição Calcula um valor para cada registro individual antes de resumir os resultados. Calcula um valor usando dados resumidos de múltiplos registros.
Como funciona Calcula primeiro, depois agrega os resultados. Agrega primeiro, depois calcula o resultado.
Ideal para Cálculos baseados em transações, reservas ou registros individuais. Razões, percentuais, médias e KPIs baseados em totais.
Exemplo Calcular o número de noites para cada reserva, depois somá-las. Calcular a Tarifa Média Diária dividindo a Receita de Hospedagem Total pelo Total de Quartos Vendidos.

Como decidir: Escolha um cálculo no nível da linha quando o valor depender de cada registro individual. Escolha um cálculo por agregação quando sua pergunta depender dos totais após o agrupamento e filtro do relatório. Um cálculo por agregação reflete automaticamente o agrupamento e os filtros do relatório.

Outras opções de tipo: String combina múltiplas dimensões em uma coluna. Fórmula no nível da linha é uma opção separada para Fórmulas Avançadas com lógica condicional, como regras CASE. Veja Usar fórmulas avançadas e exemplos.

Criar um CDF formulado

Comece com um relatório que possa ser editado. Se você estiver visualizando um Relatório padrão da Cloudbeds, primeiro selecione Salvar como para personalizar uma cópia. Se estiver criando um novo relatório, adicione pelo menos uma coluna à Estrutura da tabela e salve o relatório antes de continuar.

  1. Dentro do relatório, abra CDF formulado. Você também pode selecionar +Adicionar na seção Colunas e escolher Adicionar formulado.

Ferramenta CDF formulada e opção Adicionar formulada no painel de colunas do relatório

  1. Clique em Adicionar + em Colunas formuladas.

Botão Adicionar no painel de Colunas formuladas

  1. Insira um Nome e uma Descrição para o novo CDF formulado.
  2. Selecione o Tipo e, para um CDF calculado, o Formato (Número, Porcentagem ou Moeda). Use os símbolos matemáticos para construir sua equação.
  3. Encontre o CDF que deseja usar no campo de busca ou na lista de campos.
  4. Clique em Inserir para adicionar o campo selecionado à fórmula. Repita conforme necessário para completar o cálculo.
  5. Clique em Salvar.

Editor de Colunas formuladas mostrando Nome, Tipo, Formato, campos selecionados, editor de expressão e Salvar

Resultado esperado: O novo campo é salvo na lista de Colunas formuladas do relatório. Você ainda precisa adicioná-lo à Estrutura da tabela para vê-lo nos resultados do relatório.

Adicione o CDF formulado ao seu relatório

Um CDF formulado salvo não aparece na tabela do relatório até que você o selecione como uma coluna. Adicione o campo à Estrutura da tabela e, em seguida, execute o relatório para revisar seus valores.

  1. Abra a Estrutura.
  2. Em Colunas, clique em +Adicionar.

Estrutura da tabela mostrando o controle Adicionar colunas

  1. Em Formuladas, marque a caixa ao lado do campo que você criou.

Campo formulado selecionado no seletor de colunas

  1. Clique em Executar para atualizar o relatório e confirmar que a nova coluna aparece.

Controle de execução e coluna formulada resultante na tabela do relatório

Use fórmulas avançadas e exemplos

Fórmulas avançadas usam fórmula em nível de registro e lógica condicional para retornar um valor para cada registro. Elas são úteis para indicadores de chegada ou saída, contagens condicionais e classificações operacionais personalizadas. Expanda o exemplo relevante abaixo quando precisar dessa lógica.

 Procurando uma fórmula ou condição específica? Expanda todos os exemplos e depois use Ctrl+F no Windows ou Cmd+F no Mac para buscar nesta página.

Criar uma fórmula CASE com lógica no nível da linha

Crie uma fórmula CASE quando precisar que o relatório retorne um resultado diferente dependendo se cada registro atende às condições definidas.

  1. Abra Colunas Formuladas e clique em Adicionar +.
  2. Insira o Nome e a Descrição opcional.
  3. Em Tipo, selecione Fórmula em nível de linha.

Fórmula em nível de linha selecionada como Tipo no editor de Colunas Formuladas

  1. Em Retornar resultado em, escolha Número para um resultado numérico ou Texto para um valor descritivo.
  2. Em Fórmula, escolha Case para exibir QUANDO, ENTÃO e SENÃO.
  3. Clique em Adicionar para incluir outra condição QUANDO, se necessário.

Construtor de fórmula CASE mostrando controles QUANDO ENTÃO SENÃO e Adicionar

  1. Use Corresponder tudo ou Corresponder qualquer para controlar como múltiplas condições são avaliadas:
    • Corresponder tudo: Todas as condições devem ser verdadeiras para que o resultado se aplique.
    • Corresponder qualquer: Pelo menos uma condição deve ser verdadeira para que o resultado se aplique.
  2. Defina os valores a retornar:
    • QUANDO: Especifique a(s) condição(ões) que devem ser atendidas.
    • ENTÃO: Defina o resultado a retornar quando a condição for atendida.
    • SENÃO: Defina o resultado a retornar quando nenhuma condição QUANDO for atendida.
  3. Adicione regras de condição selecionando um campo de dados, um operador e um valor. Clique em Adicionar Regra para incluir outra condição dentro do mesmo bloco QUANDO.
  4. Clique em Salvar para criar a Fórmula Avançada.

Editor CASE com múltiplas condições QUANDO e seleção de regras

 Importante: Sempre defina um valor SENÃO. Isso evita resultados em branco (nulos) para linhas que não correspondem a nenhuma condição QUANDO.

Resultados numéricos podem ser somados ou calculados como média nos relatórios. Resultados em texto funcionam como dimensões descritivas.

Use lógica de data relativa

A lógica de data relativa pode classificar registros com base em condições temporais para que a classificação mude automaticamente, sem a necessidade de ajustar manualmente os filtros do relatório. Por exemplo, um relatório pode categorizar estadias que ocorreram há mais de sete dias a partir de hoje.

Usos comuns incluem análise de saldos envelhecidos, análise da janela de reserva e agrupamento de estadias históricas versus futuras.

  1. Acesse Relatórios > Cloudbeds Insights e crie um relatório usando Adicionar > Relatório, ou abra um relatório que você possa editar.
  2. Escolha o tipo de relatório apropriado e adicione um campo de data, como Data da Estadia ou Data do Serviço, junto com quaisquer métricas necessárias.
  3. Salve o relatório e, em seguida, adicione um CDC formulado.
  4. Use uma fórmula condicional suportada para comparar o campo de data com uma data relativa, como sete dias antes de hoje.
  5. Adicione o CDC formulado ao relatório como uma coluna, agrupamento ou filtro.

Resultado esperado: Quando a fórmula de data relativa for suportada, o relatório categoriza os registros com base na condição de data sem exigir ajuste diário do filtro.

Alternativa: Se os CDCs formulados não estiverem habilitados para sua conta, use os filtros de data relativa disponíveis na interface do relatório.

Quer ver uma fórmula em ação? Expanda Exemplo: Criar um indicador de chegada abaixo para um exemplo passo a passo com capturas de tela numeradas. Ele demonstra condições no nível da linha baseadas em CASE, em vez de um cálculo de data relativa.

Exemplo: Criar um indicador de chegada

Este exemplo mostra como criar um indicador de Chegada usando uma Fórmula Avançada. Um indicador de chegada ajuda a identificar e contar reservas que devem chegar em uma data específica de estadia.

Os estabelecimentos costumam usar um indicador de chegada para:

  • Preparar listas diárias de chegadas para a Recepção e Operações, incluindo planejamento de equipe, preparo dos quartos e organização dos hóspedes.
  • Medir tendências de volume de chegadas ao longo do tempo.
  • Construir painéis que separam chegadas de hóspedes hospedados ou em saída.

A fórmula retorna 1 quando uma reserva corresponde às suas regras de chegada e 0 caso contrário. Como o resultado é numérico, a coluna pode ser somada para calcular o total de chegadas.

  1. Crie uma nova coluna formulada chamada Chegada.
  2. Defina o Tipo como Fórmula em nível de linha.
  3. Defina Retornar resultado em como Número.
  4. Em Fórmula, selecione Case e configure a lógica CASE:
    • QUANDO (Corresponder a todos): Adicione as condições que representam uma chegada no seu estabelecimento. Uma abordagem comum é:
      • A data do check-in é igual à Data da estadia (ou ao campo de data selecionado no relatório).
      • O status da reserva está ativo e é relevante para chegadas (por exemplo, Aguardando confirmação, Confirmada e Cliente hospedado).
    • ENTÃO: 1
    • SENÃO: 0
  5. Clique em Salvar.

Fórmula de chegada com configurações numeradas: nome Chegada, fórmula em nível de linha, tipo de retorno Número, condições CASE e Salvar

 Os campos de data exatos e os status de reserva disponíveis podem variar conforme o tipo de relatório. Se seus resultados parecerem inesperados, confirme se você selecionou o campo de data correto (estadia versus reserva) e os status de reserva pretendidos.

Adicionar a fórmula avançada ao relatório

Após salvar a fórmula Chegada, adicione-a à tabela do relatório para visualizar os valores que ela retorna.

  1. Abra o Esboço.
  2. Na seção Colunas, clique em +Adicionar.
  3. Em Formuladas, marque a caixa de seleção para Chegada.
  4. Clique em Executar para confirmar que a coluna Chegada aparece e retorna valores.

Esquema da tabela com passos numerados para adicionar o campo Chegada, com valores de Chegada visíveis no relatório

Excluir um CDF formulado

Um CDF formulado existe apenas dentro do relatório onde foi criado. Se o campo ainda estiver sendo usado em qualquer lugar do relatório, o sistema impede a exclusão.

  1. Remova o CDF formulado de todos os elementos do relatório onde ele é usado.
  2. Salve o relatório.
  3. Retorne para Colunas Formuladas e exclua o CDF.

Perguntas frequentes

Expanda uma pergunta para revisar a formatação da saída, nomenclatura, referências de fórmula e histórico de alterações.

Posso controlar o formato de um CDC formulado?

Sim. Ao criar um Campo de Dados da Cloudbeds (CDC) formulado, você pode escolher seu formato de saída.

Os formatos de saída suportados incluem:

  • Número
  • Porcentagem
  • Moeda

Os administradores podem configurar uma precisão global de arredondamento de moeda em Insights > Gerenciar.

No momento, você não pode definir casas decimais para cada CDC individualmente.

O editor de fórmulas detecta referências circulares?

Não. O editor de fórmulas não detecta automaticamente referências circulares.

Posso usar o mesmo nome de um campo do sistema?

Sim, mas você deve distinguir manualmente o campo formulado do campo do sistema existente.

Para facilitar a identificação do seu campo personalizado, considere um prefixo como:

  • Personalizado
  • Calculado
  • Derivado

Existe um registro de auditoria para alterações em CDCs formulados?

Não. O Cloudbeds Insights atualmente não rastreia:

  • Quem modificou uma fórmula.
  • A lógica da fórmula anterior.

Depois que o CDC formulado for salvo e exibir os valores esperados, estes guias fornecem contexto relacionado sobre campos disponíveis, criação de relatórios personalizados e gerenciamento de relatórios no Cloudbeds Insights.

Esse artigo foi útil?
Usuários que acharam isso útil: 1 de 1

Comentários

0 comentário

Por favor, entre para comentar.