Expressões

Tipo

Como fazer

Para

Analista

Na tela

DataViz › Aplicação › Editar › Expressões

Percentual de meta, margem e faixa de cliente se calculam na Aplicação, como expressões, e você as cria e confere na aba Expressões. A sintaxe da fórmula (use(), ${...}, funções de data) está em Linguagem de expressões.

Antes de começar

Você precisa editar a Aplicação na Minha Mesa com acesso completo. Quem edita com acesso limitado, sem a permissão de criar Aplicação, não vê a aba Expressões.

Criar uma expressão

1. No editor da Aplicação, abra a aba Expressões e clique em Nova Expressão. Numa Aplicação sem nenhuma, a tela mostra "Nenhuma expressão cadastrada ainda" e o botão Criar primeira expressão.

2. Na aba Editor, preencha os campos:

   Campo	O que pôr
   Rótulo	O nome que aparece nos Widgets. Rótulo repetido é recusado: "Já existe uma expressão com esse rótulo."
   Descrição breve	Até 150 caracteres. A IA lê esse texto para entender o campo
   Tipo	Número, Data ou Texto
   Comportamento	Medida (agrega valores, como uma soma) ou Agrupamento (separa em grupos, como uma faixa)
   Máscara	Formato do número: inteiro, moeda (BRL, USD, GBP, com ou sem centavos), porcentagem, de 1 a 4 casas decimais, segundos, minutos, tamanho de arquivo ou sem máscara
   Relacionamento alternativo	Aparece quando alguma ligação tem chave secundária. Escreve o use() no começo da fórmula
   Fórmula	Por exemplo SUM([Vendas]."VALOR") / SUM([Metas]."VALOR_META") * 100

3. Se quiser, registre a regra de negócio e as premissas na aba Documentação.

4. Clique em Salvar Expressões.

Para a IA escrever a fórmula, clique em Gerar com IA, preencha Nome da Expressão, Tipo da Expressão, Comportamento, o modelo e a Descrição para geração da Expressão, e confirme. A fórmula gerada passa pela mesma verificação e abre no editor para você revisar antes de salvar. O uso conta créditos de IA; veja Créditos de IA.

Verificar a fórmula

Quando você para de digitar, o editor mostra "Verificando a fórmula…" e depois "Fórmula válida" ou o erro, com a fase em que ele aconteceu:

Mensagem	O que quer dizer
Erro de sintaxe	Construção inválida, como use() fora do começo
Erro na fórmula	Referência a tabela, coluna ou expressão que não existe na Aplicação
O banco recusou a fórmula	Função, tipo ou sintaxe que o banco não aceita

A verificação só informa. Salvar Expressões continua disponível com a fórmula errada, então confira a mensagem antes de salvar. Se a verificação não roda, o editor diz "Não foi possível verificar a fórmula agora".

Ver a prévia do resultado

Com a fórmula válida, a coluna Prévia roda a expressão sem salvar e mostra o resultado com a máscara. Antes disso, ela diz "A prévia aparece quando a fórmula estiver válida."

Comportamento	O que a prévia mostra
Medida	O Total e as maiores linhas pelo campo escolhido em Maiores por
Agrupamento ou texto	Os Valores mais frequentes, com a quantidade de Linhas

O período é Mês atual, pela data da fato, ou Todo o período. Aplicação sem coluna de data usa sempre todo o período. Se a prévia falhar, a coluna diz "Prévia indisponível agora."

Usar uma data alternativa

1. Em Tabelas, cadastre a chave secundária na ligação (como).
2. No editor da expressão, em Relacionamento alternativo, escolha a chave. A chave padrão aparece marcada como "padrão", e Padrão (sem use) tira o use().

Se a fórmula pede uma ligação que não existe, o editor diz "não existe em Tabelas" e oferece Criar em Tabelas.

Ver onde uma expressão é usada

A coluna Usada em mostra quantos indicadores, dashboards e relatórios da Aplicação usam cada expressão, ou "Sem uso". Um dashboard conta quando a expressão está num gráfico ou no filtro dele. Clique na célula para ver a lista com links, que abrem em nova aba para você não perder o que não salvou. O filtro Uso mostra Todas, Em uso ou Sem uso.

O uso de uma expressão dentro de outra expressão não entra na conta.

Num clone de Aplicação publicada, o uso na publicada aparece à parte, em "No app original “...”": vale se o clone for publicado por cima dela.

Excluir uma expressão

Exclua na lista e clique em Salvar Expressões. Se ela está em uso, a confirmação Excluir expressão em uso lista os indicadores, dashboards e relatórios que deixam de funcionar, e o filtro da Aplicação, se for o caso.

Relacionado

• Linguagem de expressões
• Referência rápida DAX
• Tutorial DAX
• Tabelas e relacionamentos
• Indicadores

Pelo Lumo CLI

As expressões também podem ser criadas e versionadas em YAML. Veja a referência de app.