Processador Calculate fields

Adiciona novos campos com base em expressões de script Qlik.

O processador Calculate fields permite que você crie novos campos no esquema dos seus dados e preencha cada um deles usando expressões de script do Qlik. Seu script pode usar tudo do esquema de entrada, permitindo que você use combinações ou versões transformadas de campos existentes.

Uso

• O processador Calculate fields requer um fluxo de entrada e pode gerar apenas um fluxo de saída.

• Clique no ícone + no painel de configuração do processador para criar mais de um campo calculado.

Propriedades

Propriedades a serem configuradas para calcular novos campos.

Para renomear o processador ou editar sua descrição, aponte o mouse sobre o nome ou a descrição a ser alterada no painel Propriedades e clique no ícone Editar.

Usando o editor de expressão

Clicar no botão Abrir editor no painel de configuração abre o editor de expressão, um poderoso editor de script para ajudá-lo a criar seus novos campos. Insira facilmente nomes de campos ou funções, abra a documentação e verifique a validade de suas expressões.

No painel esquerdo, você pode visualizar o campo atualmente carregado em seu fluxo de dados e navegar por uma ampla gama de funções de script da Qlik. Esse painel está organizado em duas guias:

• Campos, onde são listados os campos disponíveis nesse ponto do fluxo. Passe o mouse sobre qualquer um dos nomes de campo e clique em + para inseri-lo diretamente na expressão.

• Funções, onde você pode navegar pelas funções Qlik. Você pode usar o campo de busca para procurar uma função específica ou usar o menu suspenso Categoria de função para filtrá-las.

  Aponte o mouse sobre qualquer uma das funções e clique em + para inseri-la diretamente na expressão.

• Se você selecionar a opção Guia explicativo, uma breve descrição e um link para a documentação serão exibidos ao clicar em uma função.

No painel superior, você pode ativar ou desativar três ferramentas para ajudá-lo e orientá-lo ao escrever o script, bem como os botões desfazer e refazer para corrigir possíveis erros.

• Pesquisar e substituir para procurar automaticamente valores específicos e substituí-los, se necessário.

  

• Modo de ajuda para transformar qualquer função que você escrever no script em links clicáveis que o levarão à documentação.

  

• Preencher automaticamente para exibir sugestões à medida que o usuário digita, com uma breve descrição e um exemplo de uma função.

  

O painel inferior descreve qualquer erro potencial do script, como nomes de campo incorretos ou expressões inválidas.

Quando o painel de status mostra um Ok verde, sua expressão é válida. Clique em Confirmar para usar essa expressão no campo calculado e voltar ao editor de fluxo de dados. Você pode então validar a configuração do processador.

Exemplos

• Definir um valor incremental a ser usado como ID para as novas linhas de campo:

  RecNo()

  Para obter mais informações, consulte Funções de contador.

• Usando condições if/then/else. Neste exemplo, você carregou dados com temperatura e deseja incluir informações adicionais dependendo dos valores:

  
  If(Temperature <= 0 , 'Freezing',
  If(Temperature >= 100, 'Boiling',
  If(Temperature >0 AND Temperature < 100, 'Between')))

  Para obter mais informações, consulte if - função de script e gráfico

• Executando várias operações matemáticas em um único processador. Em um conjunto de dados que contém campos com um número de unidades vendidas, bem como o preço unitário e o custo unitário, você pode criar dois novos campos para a receita total e o custo total.

  1. No primeiro campo, digite total_revenue como o novo nome do campo e a expressão a seguir:

     [Units Sold] * [Unit Price]

  2. Clique no ícone + no painel de configuração do processador para criar outro campo calculado.

  3. No segundo campo, insira total_cost como o novo nome do campo e a seguinte expressão:

     [Units Sold] * [Unit Cost]

Para obter mais exemplos de expressões de script, consulte Instruções regulares e Funções de script e gráfico.