Conexão Variável¶

Introdução¶

Uma conexão Variável é configurada usando o conector Variável, estabelecendo acesso a uma variável do projeto ou uma variável global. Depois que uma conexão for estabelecida, você poderá configurar uma ou mais atividades variáveis associadas a essa conexão para serem usadas como origem para fornecer dados a uma operação ou como destino 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 Variável é criada usando o conector Variável de um destes locais:

• A aba Conexões da paleta de componentes de design (consulte Paleta de Componentes de Design).

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

• A aba Conexões da paleta de componentes de design (consulte Paleta de Componentes de Design).
• A aba Componentes do painel do projeto (consulte Menu Ações do componente em Guia Componentes do painel do projeto).

Configurar uma Conexão Variável¶

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

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

• Nome da variável: Insira o nome que deseja usar para uma nova variável global ou insira uma variável global existente ou variável do 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 de variáveis existentes para escolher.

  Os nomes das variáveis podem ser compostos destes 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 seja fácil consultá-las 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 posteriormente em JavaScript, é recomendado usar sublinhados em vez de pontos. Mais informações são fornecidas em Variáveis Globais e Variáveis do Projeto.

  Nota

  Este campo é diferente de outros campos de configuração que possuem um ícone de 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 em 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 da conexão. Se estiver editando uma conexão de variável existente para usar um nome diferente em 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 em todo o projeto:

  

  • 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 que 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, exclusão e remoção de componentes). Uma caixa de diálogo solicitará que você confirme que deseja excluir a conexão.

Próximos Passos¶

Após a criação de uma conexão variável, as ações de menu para essa conexão estarão acessíveis na guia Componentes do aba do projeto. Consulte Menu Ações de conexão para detalhes.

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

Use o menu suspenso Mostrar para filtrar Endpoints e, em seguida, clique no bloco Conexão variável para exibir atividades que estão disponíveis para uso com uma conexão variável:

Para obter mais informações, consulte estas atividades:

• Ler: Lê dados de um endpoint variável e destina-se a ser usado como fonte em uma operação.
• Escrever: Grava dados em um endpoint variável e deve ser usado como destino em uma operação.