Adicionando Flow Variables

Variáveis permitem uma configuração personalizada do fluxo e a parametrização dos ambientes, eliminando a necessidade de criar um fluxo de integração separado para cada ambiente.

Caso seu fluxo tenha um gatilho (trigger) do tipo REST, não será possível utilizar variáveis de ambiente na URI.

Criando uma variável

Variáveis podem ser criadas tanto na aba Diagram quanto na aba Source Code.

Na aba Diagram:

flow variables diagram

  1. Clique no ícone de variáveis environment variables button no canto esquerdo do canvas.

  2. Selecione o ambiente no qual a variável será aplicada: Production ou Staging.

  3. Cadastre a variável no formulário que se abrirá.

  4. Salve a variável clicando em SAVE.

Na aba Source Code, na estrutura de pastas Source > Flow Variables:

flow variables source code

  1. Selecione o ambiente no qual a variável será aplicada: Production ou Staging.

  2. Cadastre a variável no formulário que se abrirá.

  3. Salve a variável, clicando em SAVE.

Para cadastrar uma variável, preencha os seguintes campos:

  • Variable: nome da variável. Campo alfanumérico. É permitido o uso dos caracteres . e _.

  • Value: valor atribuído à variável, que será implantado automaticamente conforme o ambiente selecionado.

Para aplicar as variáveis, informe o nome da variável entre chaves dentro do componente, como no exemplo abaixo:

  • Variável no componente HTTPS:

    uri: https://{{nome da variável}}

Neste caso, siga os passos abaixo:

  • Cadastre a variável clicando no ícone de flow variables no canvas.

  • No formulário do componente HTTPS, na aba Common, preencha o campo Http Uri com o nome da variável entre chaves: {{nome da variável}}.

Gerenciamento de variáveis

  • Para adicionar mais de uma variável, clique no botão + no canto direito.

  • Para excluir uma variável, clique no ícone da lixeira.

  • Para ocultar uma variável, clique no ícone do olho.

Não é possível alterar as variáveis de um fluxo com status Deployed. Para modificá-las, será necessário fazer uma nova implantação.

Variáveis bloqueadas

As variáveis listadas abaixo são reservadas para uso interno e não podem ser utilizadas:

AWS_ACCESS_KEY_ID
AWS_SECRET_ACCESS_KEY
AWS_REGION
AWS_DEFAULT_REGION
RESOURCES_DIR
CAMEL_* (qualquer variável iniciada com CAMEL_)

Exemplos

O exemplo abaixo faz referência à variável "name". Na execução desta integração, a variável será substituída pelo nome cadastrado.

- from:
    uri: rest:get:/hello
    steps:
    - log:
          message: Hello {{name}}

flow variables hello

Neste outro exemplo, referenciamos uma variável em uma URL.

- to:
    id: to-generic
    uri: https://{{url}}
    parameters:
      httpMethod: POST

flow variables url

Thanks for your feedback!
EDIT

Share your suggestions with us!
Click here and then [+ Submit idea]