Como criar campos de dados formulados da Cloudbeds (CDCs)

Este artigo explica como criar Campos de Dados formulados da Cloudbeds nos Relatórios da Cloudbeds, incluindo tanto campos calculados básicos quanto as Fórmulas Avançadas.

Os CDCs formulados permitem que você crie colunas personalizadas usando os Campos de Dados da Cloudbeds (CDCs) existentes, possibilitando cálculos ou saídas descritivas que não estão disponíveis por padrão nos relatórios padrão.

As Fórmulas Avançadas ampliam essa funcionalidade ao suportar lógica em nível de linha, condições baseadas em CASE e resultados numéricos ou de cadeia de caracteres. Isso permite que você construa uma lógica mais flexível e baseada em regras, como indicadores de chegada ou partida, contagens condicionais ou bandeiras personalizadas, diretamente no relatório, sem a necessidade de exportar dados.

Criar novo CDC formulado

1. No relatório, clique em CDC formulado. 

• • A opção de CDC formulado também pode ser encontrada na seção Colunas clicando em +Adicionar.

2. Clique em Adicionar+;

3. Adicione um nome e descrição para o novo CDC formulado;
4. Selecione o Tipo de Dados:
   • Cadeia de caracteres: Este tipo de dado permite que você combine várias dimensões em uma única coluna.
   • CDC calculado em nível de linha / CDC calculado de agregação: Esses tipos de dados permitem que você crie equações com suas métricas e escolha o formato (número, porcentagem ou moeda). Use os símbolos matemáticos para juntar dois CDCs existentes.

5. Selecione o campo de dados que você deseja usar na barra de pesquisa ou olhando a lista de campos;
6. Clique em Inserir;
7. Clique em Salvar.

Adicionando o CDC formulado à Estrutura da Tabela

1. Clique em Estrutura;
2. Na seção Colunas, clique em +Adicionar;

3. Selecione o novo CDC formulado marcando a caixa;

4. Execute o relatório. Agora você verá a nova coluna com o CDC formulado.

Uso de Fórmulas Avançadas

Uma vez que você tenha criado e adicionado um Campo de Dados Formulado da Cloudbeds ao seu relatório, você pode usar Fórmulas Avançadas para construir lógica baseada em condições adaptada às suas necessidades de relatório.

Esse tipo de lógica é comumente usado para criar indicadores personalizados e colunas calculadas, como:

• Indicadores de chegada ou partida
• Contagens condicionais (por exemplo, contando apenas reservas confirmadas ou com check-in feito)
• Campos de status ou classificação personalizados para relatórios operacionais ou analíticos

Criando uma Fórmula Avançada (Nível de Linha)

Siga os passos abaixo para criar uma Fórmula Avançada usando lógica de nível de linha e condições CASE.

1. Abra as Colunas Formuladas e clique em Adicionar + para criar uma nova coluna formulada;
2. Insira um Nome e uma Descrição opcionais para identificar claramente o propósito da fórmula;
3. Em Tipo, selecione Fórmula de nível de linha. Esta opção permite a lógica baseada em condições, avaliada por linha, no relatório;

4. Em Retornar resultado em, escolha o formato do resultado: Número (para cálculos e agregações) ou Cadeia de Caracteres (para valores descritivos);
5. Em Fórmula, selecione Case. O construtor de fórmulas exibirá uma estrutura CASE com seções WHEN, THEN e ELSE;
6. Clique em Adicionar para definir mais condições;

7. Use Combinar todos ou Combinar qualquer para controlar como várias condições são avaliadas:
   • Combinar todos: Todas as condições devem ser verdadeiras para que o resultado se aplique.
   • Combinar qualquer: Pelo menos uma condição deve ser verdadeira para que o resultado se aplique.

8. Defina os valores a serem retornados:
   • Sob WHEN, especifique a condição(ões) que devem ser atendidas.
   • Sob THEN, defina o resultado de retorno (valor) quando a condição for atendida.
   • Sob ELSE, defina o resultado de retorno (valor) quando a condição não for atendida.
9. Adicione regras de condição selecionando um campo de dados, um operador e um valor. Use Adicionar Regra para incluir condições adicionais no mesmo bloco WHEN;
10. Clique em Salvar para criar a Fórmula Avançada.

Exemplo: Indicador de chegada (1 = chegada, 0 = não é uma chegada)

Este exemplo mostra como criar um indicador de Chegada usando uma Fórmula Avançada. Um indicador de Chegada é útil em relatórios de hotelaria porque permite identificar e contar rapidamente as reservas previstas para chegar em uma data específica de estadia.

As Propriedades costumam usar um indicador de Chegada para:

• Preparar listas diárias de chegadas para a Recepção e Operações (equipe, prontidão dos quartos e planejamento de hóspedes)
• Medir tendências de volume de chegadas ao longo do tempo
• Construir painéis que separam chegadas de clientes hospedados ou em partida

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 em um relatório.

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

Adicionando a Fórmula Avançada ao relatório

Após salvar uma Fórmula Avançada, adicione-a à tabela do relatório para que apareça como nova coluna nos resultados.

1. Abra Estrutura;
2. Na seção Colunas, clique em + Adicionar;
3. Em Formulado, selecione a caixa de seleção da fórmula que você criou (por exemplo, Chegada);
4. Execute o relatório para confirmar que a nova coluna está visível e retorna valores.

Se você precisar de mais assistência ou informações, nossa Equipe de Suporte está aqui para ajudar!