Trabalhando com o editor de expressões

Você pode inserir o editor de expressões sempre que vir o símbolo no painel de propriedades ao editar uma visualização. O símbolo  indica um campo de expressão. Clique em para abrir o editor de expressão.

É possível incluir expressões de duas maneiras. Expressões podem ser criadas com o uso das seções Campos, Funções, Variáveis e Expressões de conjunto. Para criar expressões, faça seleções e insira-as no campo de expressão. Você pode editar as expressões inseridas e adicionar expressões mais complexas, digitando diretamente no campo de expressão. Você pode desfazer uma ação clicando no botão Desfazer .

Inserindo uma expressão usando campos

Você pode inserir uma expressão fazendo seleções na seção Campos no lado direito do diálogo do editor de expressões.

Faça o seguinte:

1. Caso queira limitar os campos disponíveis para aqueles de uma tabela específica em seu modelo de dados, selecione uma tabela na lista suspensa Filtrar por tabela.
2. Selecione um campo na lista suspensa Campo.
3. Selecione a função de agregação que você deseja usar. As funções disponíveis são do grupo de funções de agregação básicas.
4. Se quiser inserir a seleção atual como uma expressão de conjunto na sua agregação, use a caixa de seleção Expressão de conjunto. A seleção atual sempre é baseada no estado padrão.
5. Se quiser inserir uma cláusula Distinct ou Total junto com a função de agregação, use as caixas de seleção para cada cláusula. Cada cláusula pode ser usada separadamente.

6. Clique em Inserir para inserir o campo e a função no campo de expressão.

   Nota de dicaSe você não selecionar uma função de agregação, apenas o campo será inserido na expressão. Cláusulas só podem ser adicionadas se você selecionar uma função de agregação.

7. Clique em Aplicar para fechar o diálogo Adicionar expressão.

   Para uma dimensão ou medida, é possível continuar adicionando os dados descritivos da dimensão ou medida.

Inserindo uma expressão de medida usando o gerador de expressões

Se estiver criando uma expressão para uma medida, você poderá construir a expressão usando linguagem natural. Expanda a seção Gerador de expressões no lado direito da caixa de diálogo do editor de expressões. Use nomes de campos ou itens mestres, agregações básicas e filtros para criar o cálculo necessário. Você pode usar essa ferramenta para construir visualizações e medidas mestras, bem como para criar regras de cores personalizadas para suas visualizações.

Faça o seguinte:

1. Se necessário, altere o idioma que você está usando para construir a expressão.

2. Em Descreva uma expressão, resuma uma combinação de campos, itens mestres, agregações e filtros usando linguagem natural.

3. Em Resumo da expressão, verifique se o texto de entrada foi interpretado corretamente. Campos e filtros são codificados por cores distintamente.

4. Visualize a expressão de saída em Visualização da expressão e clique em Inserir para adicioná-la ao editor de expressões.

Para obter mais informações, consulte Gerador de expressões.

Inserindo uma função usando funções

Você pode inserir mais de uma função de agregação básica fazendo seleções na seção Funções no lado direito do diálogo do editor de expressões.

1. Se você quiser filtrar a lista de funções disponíveis, selecione uma categoria de função na lista suspensa Categoria da função.

2. Selecione uma função na lista suspensa Nome da função.

   Você vê uma pré-visualização da função.

3. Clique em Inserir para inserir a função e o primeiro parêntese no campo de expressão.

4. Digite o resto da expressão no editor de expressões de acordo com a sintaxe.

5. Clique em Aplicar para fechar o diálogo Adicionar expressão.

   Para uma dimensão ou medida, é possível continuar adicionando os dados descritivos da dimensão ou medida.

Inserindo uma variável usando variáveis

Você pode inserir uma variável fazendo seleções na seção Variáveis no lado direito do diálogo do editor de expressões.

1. Se quiser que as variáveis do sistema apareçam na lista de variáveis disponíveis, use a caixa de seleção Mostrar variáveis do sistema.

2. Selecione uma variável na lista suspensa Variável.

   Você vê uma Definição e um Valor da variável, se disponível.

3. Clique em Inserir para inserir a variável no campo de expressão.

4. Clique em Aplicar para fechar o diálogo Adicionar expressão.

   Para uma dimensão ou medida, é possível continuar adicionando os dados descritivos da dimensão ou medida.

Inserindo uma expressão de conjunto usando Expressões de conjunto

Você pode inserir uma expressão de conjunto fazendo seleções na seção Expressões de conjunto no lado direito do diálogo do editor de expressões.

1. Selecione se deseja Usar seleções atuais ou Usar marcador como uma expressão de conjunto.

   Você só poderá Usar seleções atuais se uma seleção tiver sido feita no aplicativo e só poderá usar Usar marcador se um marcador estiver disponível. Use o menu suspenso Marcador para escolher entre marcadores.

2. Se você tiver definido estados alternados, poderá alterar o estado alternado no qual a expressão de conjunto se baseia. Selecione o estado alternado no menu suspenso Estado alternado.

3. Clique em Inserir para inserir a expressão de conjunto no campo de expressão.

4. Clique em Aplicar para fechar o diálogo Adicionar expressão.

   Para uma dimensão ou medida, é possível continuar adicionando os dados descritivos da dimensão ou medida.

Adicionar ou editar uma expressão por digitação

Faça o seguinte:

1. Digite a expressão diretamente no campo de expressão.

   Os nomes de campo que você usa na expressão são verificados e a sintaxe da expressão é validada.

   Nota de dicaConforme você digita no editor de expressão, a expressão é validada. Se houver um erro, você verá uma dica do que está incorreto. Informações de erro adicionais podem estar disponíveis clicando no ícone ao lado da dica.

   Quando você digita o nome de uma função na expressão, uma dica de ferramenta fornece informações para ajudá-lo a inserir a função corretamente, incluindo nomes de argumentos e qualificadores.

   Nota informativaA dica de ferramenta para algumas funções de gráfico mostra o qualificador ALL. É recomendado que você não use o qualificador ALL. Em vez disso, use a expressão definida {1}.

   Cada linha no editor de expressão é numerada e o destaque de sintaxe é usado.

2. Clique em Aplicar para fechar o diálogo Adicionar expressão.

   Para uma dimensão ou medida, é possível continuar adicionando os dados descritivos da dimensão ou medida.

Preenchimento automático, avaliação e codificação de cores

Ao digitar no editor de expressões, é possível obter uma lista de campos que correspondem ao preenchimento automático, variáveis e funções para selecionar. A lista é reduzida à medida que você continua escrevendo. A codificação de cores ajuda a ver quais campos, variáveis e funções são usadas na expressão.

Você pode desativar ou ativar as dicas de preenchimento automático clicando em ou em .

A codificação de cores aplica-se à lista de preenchimento automático e à própria expressão.

Para conferir que qualquer expansão do sinal de dólar acrescentada à sua expressão gera o resultado correto, verifique a avaliação da expressão na visualização de expansão de sinal de dólar.

Buscar e substituir

Ao usar o editor de expressão, você pode abrir a barra de ferramentas de pesquisar e substituir clicando em . Digite a sequência que deseja procurar no campo Pesquisar por, usando a opção Diferenciar maiúsculas de minúsculas, se necessário. Todas as ocorrências correspondentes na expressão serão destacadas e você poderá navegar entre todas elas usando as setas Anterior e Próximo. Você pode então substituir opcionalmente uma ou todas as ocorrências pela sequência de caracteres inserida no campo Substituir por.

Ajuda de sintaxe detalhada

Você pode ativar o modo de ajuda, clicando no botão Ajuda . Quando ativas, todas as funções no editor de expressões atuam como hiperlinks. Clicar em uma função abre uma guia do navegador para a seção de ajuda on-line com a descrição completa de como usar a função específica. Quando uma função é clicada, o modo de ajuda é encerrado.

• Usando expressões em visualizações

• Referências a campos, medidas e variáveis

• Editor de expressão
• Funções básicas de agregação
• Análise de conjunto
• Exemplos de como usar uma variável em uma expressão
• Usando variáveis em expressões
• Como configurar uma expressão usando os menus suspensos no editor de expressões?