Ir para o conteúdo

Transforme as suas conexões em um bônus de fim de ano com o nosso novo Programa de Indicação de Clientes! Saiba mais

✕

Conexão variável

Introdução

Uma conexão variável, criada usando o Conector de variável, estabelece acesso a uma variável de projeto ou uma variável global na memória. Depois que uma conexão é estabelecida, você pode criar instâncias de atividades variáveis associadas a essa conexão para serem usadas como fontes (para fornecer dados em uma operação) ou como destinos (para consumir dados em uma operação).

Para obter mais informações sobre o uso de variáveis em scripts, transformações e telas de configuração de conexão/atividade, consulte Variáveis.

Criar ou editar uma conexão variável

Uma nova conexão de variável é criada usando o conector de variável de um destes locais:

Uma conexão de variável existente pode ser editada nestes locais:

Configurar uma conexão variável

A configuração de uma conexão variável inclui os seguintes campos:

Configuração de conexão variável

  • Nome da conexão: Insira um nome para identificar a conexão da variável. O nome deve ser exclusivo para cada conexão da variável e não deve conter barras (/) ou dois pontos (:). Este nome também é usado para identificar o endpoint da variável, que se refere tanto a uma conexão específica quanto às suas atividades.

  • Nome da variável: Digite o nome que deseja usar para uma nova variável global na memória, ou insira uma variável global existente ou variável de projeto nome. Para ver uma lista de variáveis globais e de projeto existentes, comece digitando um colchete aberto [ no campo ou clicando no ícone da variável para exibir uma lista das variáveis existentes para escolher.

    Os nomes de variáveis podem ser compostos pelos seguintes caracteres: letras (a-z, A-Z), números (0-9), pontos e sublinhados. Outros caracteres não são recomendados e podem causar problemas. É uma boa ideia usar pontos ou sublinhados para prefixar variáveis, para que sejam fáceis de consultar posteriormente. Por exemplo, uma variável chamada org.account.filename é primeiro prefixado com org, então account, etc. para organizá-lo efetivamente em uma lista entre outras variáveis. No entanto, observe que, para variáveis que podem ser usadas em JavaScript posteriormente, é recomendável usar sublinhados em vez de pontos. Mais informações podem ser encontradas em Variáveis globais e Variáveis do projeto.

    Nota

    Este campo é diferente de outros campos de configuração que possuem um ícone variável . Como este campo recebe o nome de uma variável nova ou existente em vez da representação da própria variável, sua entrada é sempre exibida como texto e não é exibida no formato de pílula. Além disso, a sintaxe típica de variáveis usando colchetes não pode ser usada neste campo, exceto para exibir a lista de variáveis existentes.

  • Salvar alterações: Clique para salvar e fechar a configuração de conexão. Ao editar uma conexão de variável existente para usar um nome diferente no Nome da variável, uma caixa de diálogo de confirmação solicitará que você escolha se o nome da variável deve ser atualizado em todas as instâncias em que for usado no projeto:

    Texto de diálogo

    Confirmar atualização
    Você deseja atualizar todos os usos desta variável no projeto:

    • Sim
    • Não
    • Cancel

    • Sim: Clique para modificar o nome da variável que o endpoint acessa e também alterar quaisquer outros usos dessa variável no projeto.

    • Não: Clique para modificar o nome da variável que o endpoint acessa e deixar quaisquer outros usos dessa variável no projeto inalterados.

    • Cancelar: Clique para que nenhuma alteração seja feita e para retornar à configuração de conexão variável.

  • Descartar Alterações: Após fazer alterações em uma configuração nova ou existente, clique para fechar a configuração sem salvar. Uma caixa de diálogo solicitará que você confirme se deseja descartar as alterações.

  • Excluir: Após abrir uma configuração de conexão existente, clique para excluir permanentemente a conexão do projeto e fechar a configuração (consulte Dependências de componentes, exclusão e remoção). Uma caixa de diálogo solicitará que você confirme se deseja excluir a conexão.

Próximos passos

As ações de menu para uma conexão e seus tipos de atividade podem ser acessadas no painel do projeto e na paleta de componentes de design. Para obter detalhes, consulte Menus de ações em Noções básicas do conector.

Depois de configurar uma conexão de variável, você pode configurar uma ou mais atividades de variável associadas a essa conexão para serem usadas como uma origem para fornecer dados a uma operação ou como um destino para consumir dados em uma operação.

Configurar atividades

Estes tipos de atividades estão disponíveis:

  • Ler: Lê dados de um endpoint de variável e deve ser usado como fonte em uma operação.

  • Escrever: Grava dados em um endpoint de variável e deve ser usado como um alvo em uma operação.