Ferramenta Fórmula
Ferramenta Fórmula
Requisitos da função de usuário
Função de usuário* | Acesso à ferramenta/ao recurso |
|---|---|
Usuário completo | ✓ |
Usuário básico | ✓ |
*Aplica-se a clientes do Alteryx OneProfessional e Enterprise Edition nas versões 2025.1 e posteriores do Designer.
Use a ferramenta Fórmula para criar novas colunas, atualizar colunas e usar uma ou mais expressões para executar uma variedade de cálculos e operações. Vá para Funções para ver uma lista de funções que podem ser usadas para criar uma expressão.
Você pode usar a ferramenta Fórmula para...
Aplicar instruções condicionais.
Converter números e cadeias de caracteres.
Formatar datas.
Extrair caminhos de arquivo.
Aplicar algoritmos financeiros ou cálculos matemáticos.
Determinar valores mínimos e máximos.
Analisar dados espaciais.
Limpar dados de cadeia de caracteres.
Executar testes de validação nos dados.
Fluxo de trabalho de exemplo
Esta ferramenta tem um fluxo de trabalho de exemplo. Acesse Exemplos de fluxos de trabalho para saber como acessar esse e muitos outros exemplos diretamente no Designer.
Configurar a ferramenta
Na janela Configuração, você pode criar várias expressões. A Alteryx atribui um ID da expressão a cada expressão individual na ordem em que aparece na janela Configuração (não necessariamente na ordem em que foi criada). Por exemplo, a primeira expressão tem um ID de 1, a segunda tem um ID de 2 e assim por diante.
Nota
Observe que, se você reorganizar suas expressões, os IDs não serão reorganizados junto com elas. Por exemplo, se você tiver três expressões e mover a terceira expressão para o topo, ela passará a ter o ID 1, sendo que anteriormente ela tinha o ID 3.
Esses IDs podem ajudar você a documentar e solucionar problemas em suas expressões, pois eles são referenciados nas mensagens de erro.
Criar expressões
Para construir sua expressão, primeiro especifique uma coluna de saída. A coluna de saída conterá os resultados da sua expressão. Você pode substituir uma coluna existente ou criar uma nova coluna. Selecione a lista suspensa Coluna de saída e escolha uma coluna existente ou selecione Adicionar coluna e informe um nome para sua nova coluna.
Para adicionar uma nova coluna de dados...
Selecione + Adicionar coluna e digite um nome para a nova coluna.
Tipo de dados: selecione o tipo de dados, se necessário.
Nota
Para os valores FixedDecimal, há uma conversão implícita para Double na ferramenta Fórmula.
Tamanho: selecione para alterar o tamanho ou a largura dos dados dos tipos decimal fixo (FixedDecimal), cadeia de caracteres (todos os tipos String), data e hora (DateTime), hora (Time) ou objeto espacial (SpatialObj).
Selecione o editor de expressões para construir sua expressão. Depois que o fluxo de trabalho for executado, a caixa Pré-visualização de dados exibe a primeira linha de dados da coluna especificada com a expressão aplicada.
Importante
Observe que o valor no campo Pré-visualização de dados pode não corresponder ao valor de saída real quando o fluxo de trabalho for executado. Os tipos de dados são resolvidos no momento da execução do fluxo de trabalho e podem fazer com que o fluxo de trabalho gere erros que a Pré-visualização de dados não considera.
Use qualquer um destes métodos para criar uma expressão:
Digite texto diretamente no editor de expressões.
Pressione Ctrl + Espaço para exibir uma lista de todas as funções.
Digite uma palavra ou frase para exibir uma lista de funções correspondentes.
Insira um [ (colchete esquerdo) para exibir uma lista de variáveis que podem ser usadas na expressão. As variáveis incluem...
Colunas: dados de uma conexão de entrada ou de uma coluna criada em uma expressão anterior.
Conexões de perguntas: valores de uma ferramenta de Interface conectada à âncora Pergunta de uma ferramenta com um editor de expressões, quando a ferramenta é usada em um aplicativo ou macro. Use a âncora Pergunta quando quiser que os valores das perguntas sejam usados como variáveis na expressão. Vá para Ferramentas de interface para obter mais informações.
Constantes: variáveis globais para um fluxo de trabalho que possibilitam alterar um valor em um único local e fazer com que essa alteração se aplique ao restante do fluxo. Acesse Constantes para obter mais informações.
Selecione o ícone Funções ("fx") para pesquisar e navegar pelas categorias de funções. Vá para Funções para mais informações.
Clique no ícone de Colunas e constantes ("x") para pesquisar e navegar por colunas e constantes de entrada ou recém-criadas.
Colunas existentes: dados de uma conexão de entrada ou de uma coluna criada em uma expressão anterior.
Conexões de perguntas: valores de uma ferramenta de interface conectada à âncora Pergunta de uma ferramenta com um editor de expressão, quando a ferramenta é usada em um app ou macro. Use a âncora Pergunta quando quiser que os valores das perguntas sejam usados como variáveis na expressão. Vá para Ferramentas de interface para mais informações.
Constantes: variáveis globais para um fluxo de trabalho que possibilitam alterar um valor em um único local e fazer com que essa alteração se aplique ao restante do fluxo. Acesse Constantes para obter mais informações.
Clique no ícone de Expressões recentes e salvas (ícone de pasta) para pesquisar e navegar por expressões recentes e salvas.
Com uma expressão no editor de expressões, selecione o ícone Salvar expressão (disquete), insira um nome e selecione Salvar. Depois que uma expressão é criada, ela pode ser salva para uso posterior.
Adicionar outra expressão
Ao modificar dados em colunas que são relacionadas ou executar operações semelhantes, é bastante útil adicionar várias expressões a uma única ferramenta Fórmula. Ao modificar dados não relacionados ou executar funções não relacionadas, o uso de várias ferramentas Fórmula auxilia na solução de problemas do fluxo de trabalho. Para adicionar uma expressão, clique no ícone "+".
Reordenar expressões
A sequência em que as expressões são aplicadas afeta os resultados quando várias expressões modificam os mesmos dados. Para reordenar uma expressão, selecione e mantenha pressionado o ícone de reordenação (à esquerda do ID da expressão ou à esquerda do editor de expressões na Exibição clássica) e arraste a expressão para cima ou para baixo.
Observe que, quando você reordenar as expressões, os IDs delas são reatribuídos. A Alteryx atribui um número de ID a cada expressão individual na ordem em que ela aparece na janela de configuração.
Expandir e recolher expressões
À medida que você trabalha em suas expressões, a janela de configuração da ferramenta Fórmula pode ficar um pouco cheia, especialmente se você tiver muitas expressões individuais.
Você pode usar os ícones de expandir e recolher para mostrar e ocultar expressões individuais ou para mostrar e ocultar todas as expressões de uma só vez.
Para expandir e recolher uma única expressão, selecione o ícone ">" associado a um ID de expressão específico.
Para expandir e recolher todas as expressões, selecione o ícone ">" na parte superior do editor.
Observe que toda vez que você acessar a janela de configuração da ferramenta Fórmula, a primeira expressão estará expandida e todas as expressões seguintes estarão recolhidas.
Âncora de entrada adicional
Como essa ferramenta inclui um editor de expressões, uma âncora de entrada adicional é exibida quando ela é utilizada em um fluxo de trabalho de aplicativo ou de macro. Use as ferramentas de interface para fazer conexão a uma âncora de pergunta (Q).
Desabilitar expressões individuais
Enquanto trabalha com a ferramenta Fórmula, você tem a opção de habilitar e desabilitar expressões individuais. Isso lhe proporciona flexibilidade enquanto você cria, testa, soluciona problemas e executa seus fluxos de trabalho.
Por padrão, as expressões na ferramenta Fórmula estão sempre habilitadas.
Quando você desabilita uma expressão, as informações de configuração da ferramenta Fórmula permanecem inalteradas (por exemplo, seleção do nome e do tipo de dados).
Quando desabilitada, uma expressão não é executada no momento da execução e uma mensagem de informações é exibida na guia de mensagens da janela de resultados para indicar que uma expressão está desabilitada.
Você pode continuar a editar expressões desabilitadas.
Para desabilitar uma expressão individual da ferramenta Fórmula...
Na ferramenta Fórmula, encontre a expressão que você deseja desabilitar.
Use o botão de alternância Desabilitar expressão e Habilitar expressão (ao lado do ícone de lixeira "Excluir expressão") para desabilitar a expressão. Mude o botão para a posição esquerda (desabilitada). Observe que uma expressão habilitada exibe uma cor branca no painel esquerdo, enquanto uma expressão desabilitada exibe uma cor cinza.
Para habilitar a expressão, mude o botão de alternância para a posição direita (habilitada).
Cuidado
Se a expressão 1 está configurada para criar uma nova coluna e está desabilitada e a expressão 2 faz referência a essa nova coluna, a expressão 2 gera então um erro de campo (coluna) ausente.