Skip to main content

Funções

Use funções para criar expressões que executam uma variedade de cálculos e operações.

Os seguintes tipos de funções estão disponíveis para ajudar você a transformar seus dados. O tipo de dados determina quais funções você pode usar. Acesse Tipos de dados para obter mais informações.

Custom Formula Functions

If you use custom formula functions and your custom function has the same name as an existing Alteryx function (or a newly-introduced Alteryx function), you might encounter unexpected results and conflicts.Build Custom Formula Functions

To resolve this, rename your custom function (or add a prefix/suffix) to differentiate it from base-installed Designer functions.

Tipos de funções

  • Condicional : as funções condicionais permitem que você execute uma ação ou cálculo usando uma instrução IF. Saiba mais no artigo Funções condicionais .

  • Conversão : as funções de conversão convertem números em cadeias de caracteres ou vice-versa. Saiba mais no artigo Funções de conversão .

  • Data e Hora : as funções de data e hora permitem que você execute uma ação ou cálculo em um valor de data\hora. Saiba mais no artigo Funções de data e hora .

  • Arquivo : uma função de arquivo cria caminhos de arquivo, verifica se um arquivo existe ou extrai parte de um caminho de arquivo. Saiba mais no artigo Funções de arquivo .

  • Finanças : uma função de finanças aplica algoritmos financeiros ou cálculos matemáticos. Saiba mais no artigo Funções de finanças .

  • Matemática : uma função matemática realiza cálculos matemáticos. Saiba mais no artigo Funções matemáticas .

  • Matemática: Bit a bit : uma função bit a bit opera em um ou mais padrões de bit ou numerais binários no nível de seus bits individuais. Use uma função bit a bit para manipular valores para comparações e cálculos. Saiba mais no artigo Funções matemáticas: bit a bit .

  • Mín/Máx : uma função de mínimo ou máximo encontra o menor ou o maior valor de um conjunto de valores. Saiba mais no artigo Funções de mín/máx .

  • Operadores : um operador é um caractere que representa uma ação. Use um operador aritmético para executar cálculos matemáticos ou um operador booleano para trabalhar com valores verdadeiro/falso. Saiba mais no artigo Operadores .

  • Geografia : uma função de geografia constrói objetos geográficos, analisa dados espaciais e retorna métricas de campos espaciais. Saiba mais no artigo Funções de geografia .

  • Especializado : estas funções executam uma variedade de ações especializadas e podem ser usadas com todos os tipos de dados. Saiba mais no artigo Funções especializadas .

  • Cadeia de caracteres : uma função de cadeia de caracteres executa operações em dados de texto. Utilize uma função de cadeia de caracteres para limpar dados, converter dados a um formato diferente, modificar o uso de maiúsculas, calcular métricas sobre os dados ou executar outras manipulações. Saiba mais no artigo Funções de cadeia de caracteres .

  • Teste : uma função de teste realiza comparações de dados. Use uma função de teste para identificar o tipo de dados de um valor ou determinar se um valor existe. Saiba mais no artigo Funções de teste .

Editor de expressões

Você pode criar funções com o editor de expressões.

Criar uma expressão

Para criar sua expressão, primeiro especifique uma coluna de saída. A coluna de saída conterá os resultados da expressão. Você pode substituir uma coluna existente ou criar uma nova coluna. Abra o menu suspenso Coluna de saída  e escolha uma coluna existente ou selecione  Adicionar coluna e forneça um nome para a nova coluna.

Depois de especificar uma coluna de saída, use qualquer um destes métodos para criar uma expressão:

  • Digite diretamente no editor de expressões.

  • Clique no botão Colunas e constantes para navegar por variáveis que podem ser usadas na expressão. Selecione a variável para adicioná-la ao editor de expressõ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 de pergunta (Q) de uma ferramenta com um editor de expressões, quando a ferramenta é usada em um aplicativo ou macro. Use a âncora de pergunta (Q) quando desejar que os valores das perguntas sejam usados como variáveis na expressão. Acesse 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.

Realce da sintaxe

À medida que você constrói a expressão, o editor aplica um esquema de cores a cada uma das suas partes para que fique fácil de distingui-las. As funções são douradas, as variáveis são roxas, os operadores são rosa e as cadeias de caracteres são turquesa, um azul-esverdeado.

Funções

Clique em Funções para navegar por categorias de funções. Selecione a função para adicioná-la ao editor de expressões.

Colunas e constantes

Clique em Colunas e constantes para navegar pelos dados das conexões de entrada e variáveis globais.

  • 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 de pergunta (Q) de uma ferramenta com um editor de expressões, quando a ferramenta é usada em um aplicativo ou macro. Use a âncora de pergunta (Q) quando desejar que os valores das perguntas sejam usados como variáveis na expressão. Acesse 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.

Expressões recentes e salvas

Clique em Expressões recentes e salvas para navegar por expressões recentes e salvas. Selecione a expressão para adicioná-la ao editor de expressões.

Salvar uma expressão

  1. Com uma expressão no editor de expressões, clique no ícone de Salvar expressão (ícone de disquete).

  2. Digite um nome para a expressão e clique em Salvar .

Estas ferramentas incluem um editor de expressões. As ferramentas que incluem um editor de expressões possuem uma âncora de entrada adicional e uma âncora de pergunta quando são usadas em um fluxo de trabalho de aplicativo ou de macro. Use as ferramentas de interface para conectar à âncora de pergunta quando desejar que os valores das perguntas sejam usados como variáveis na expressão. Acesse Ferramentas de interface para obter mais informações.

Action Tool Icon
Condition Tool Icon
Error Message Tool Icon
Dynamic Rename tool
Filter Tool Icon
Beaker with bubbling liquid
Box with rows, a plus sign and an arrow pointing downward.
Beaker with liquid and stir-stick.
Liquid drops falling into a beaker.
Orange polygon with white table with multiple rows.
Message tool
Test Tool

Dados numéricos nas funções de fórmula

Atenção

Tenha cuidado ao usar decimais fixos na ferramenta Fórmula (tipo FixedDecimal) e ao convertê-los nos tipos Float ou Double. Na ferramenta Fórmula, os decimais fixos são convertidos implicitamente em doubles. A precisão máxima para o tipo de dados Double é de 15 dígitos. Para o tipo de dados Float, são 7 dígitos. Se você estiver convertendo decimais fixos, deve esperar perder todos os dados que não cabem no tipo para o qual você está convertendo.