Skip to main content

Constantes

Constantes são variáveis globais para um fluxo de trabalho. Estão definidas na guia Fluxo de trabalho da janela Configuração do fluxo de trabalho. Use constantes para alterar um valor em um único local e fazer com que essa alteração se aplique ao restante do fluxo de trabalho.

Existem três tipos de constantes:

  1. Motor: cinco constantes do motor são exibidas em todos os fluxos de trabalho e uma constante adicional, IterationNumber, é exibida quando o fluxo de trabalho é uma macro de lote (Batch), uma macro iterativa ou uma macro otimizadora de local.

    • TempFilePath: o diretório onde o motor grava os arquivos temporários.

    • Version: o número da versão do Alteryx Engine instalado no computador.

    • WorkflowDirectory: o diretório do fluxo de trabalho atual. Se nenhum fluxo estiver aberto, o valor será o diretório de instalação do Alteryx.

    • WorkflowFileName: o nome do arquivo do fluxo de trabalho, que só estará disponível após o salvamento.

    • GuiInteraction: um valor booleano que indica se um fluxo de trabalho está ou não sendo executado a partir da GUI.

      • Quando um fluxo é executado a partir do Alteryx Designer ou da interface de um aplicativo analítico, o valor retornado é "True" ou "1".

      • Quando um fluxo é executado a partir da linha de comando, o valor retornado é "False" ou "0".

    • IterationNumber: um número inteiro que corresponde ao número de vezes que uma macro foi executada, começando em 0.

  2. Question: quando o fluxo de trabalho é do tipo aplicativo analítico ou macro, muitas das ferramentas de interface são exibidas como constantes Question (pergunta). O nome da constante corresponde ao nome da ferramenta (campo Nome na guia "Anotação" da janela de configuração da ferramenta). Acesse Ferramentas de interface para obter mais informações.

    • __cloud:UserId: esta constante destina-se ao uso especificamente com a ferramenta de interface Caixa de Texto. Use essa constante para capturar o ID do usuário que executa um fluxo de trabalho ou aplicativo durante o tempo de execução. Para usar essa constante, insira __cloud:UserId (observe os dois caracteres de sublinhado) no campo Nome da ferramenta Caixa de Texto (localizado na guia "Anotação" da configuração da ferramenta). Combine isso com a configuração Ocultar controle (para desenvolvimento de API) para impedir que o usuário do aplicativo interaja com a constante.

  3. Usuário: você pode criar e editar constantes de usuário através da janela "Configuração do fluxo de trabalho".

Adicionar uma constante de usuário

Na guia Fluxo de trabalho da janela Fluxo de trabalho - Configuração...

  1. Na seção Constantes, clique no botão Adicionar (+).

  2. Digite um Nome e um Valor.

  3. Se o valor for um número, marque a caixa de seleção na coluna #. Por padrão, constantes são cadeias de caracteres.

Excluir uma constante

  1. Realce a constante.

  2. Clique no botão (-) para excluir.

Usar uma constante

Existem algumas maneiras de usar uma constante.

Usar uma constante em uma expressão

As constantes do motor (Engine) e do usuário são exibidas como variáveis que você pode utilizar para criar uma expressão em qualquer ferramenta que use um editor de expressões.

use-constant.png

O tipo de dados de uma constante é determinado pelo fato de ela ser designada como um número ou como uma cadeia de caracteres na guia Fluxo de trabalho da janela Configuração do fluxo de trabalho.

Observe que as constantes de Question (perguntas) não são exibidas no editor de expressões. Vá para Editor de expressões para obter mais informações.

Usar uma constante por meio de um atalho de referência

Você pode utilizar um atalho de referência para usar qualquer constante na configuração de uma ferramenta. Para especificar uma variável de constante, adicione um % (sinal de porcentagem) no início e no final do nome: %ConstantType.ConstantName%.

O atalho de referência pode ser usado em um editor de expressões ou em uma caixa de texto, e a constante pode ser atualizada por meio de uma ferramenta de pergunta ou modificada na guia Fluxo de trabalho da janela Fluxo de trabalho - Configuração.

Seja cauteloso ao usar esse método, pois nem sempre são produzidos os resultados esperados.