Ir para o conteúdo

Conexão variável

Introdução

Uma conexão variável, criada usando o conector variável, estabelece acesso a uma variável de projeto ou a uma variável global em memória. Uma vez que a conexão é estabelecida, é possível criar instâncias de atividades Variável associadas a essa conexão para serem usadas como fontes (para fornecer dados em uma operação) ou como alvos (para consumir dados em uma operação).

Para mais informações sobre como usar 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 a partir de uma destas localizações:

Uma conexão variável existente pode ser editada a partir destas localizações:

Configurar uma conexão variável

Cada elemento da interface do usuário da tela de configuração da conexão Variável é descrito abaixo.

  • Nome da conexão: Insira um nome 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 às suas atividades.

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

    Os nomes das 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, de modo que sejam fáceis de localizar mais tarde. Por exemplo, uma variável chamada org.account.filename é primeiro prefixada com org, depois account, etc., para organizá-la efetivamente em uma lista entre outras variáveis. No entanto, observe que para variáveis que podem ser usadas em JavaScript mais tarde, é recomendado usar sublinhados em vez de pontos. Mais informações são fornecidas em Variáveis globais e Variáveis de projeto.

  • Salvar alterações: Clique para salvar e fechar a configuração da conexão. Se estiver editando uma conexão Variável existente para usar um nome diferente no Nome da variável, uma caixa de diálogo de confirmação pergunta se o nome da variável deve ser atualizado em todas as instâncias onde é usado ao longo do projeto:

    Texto da caixa de diálogo

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

    • Sim
    • Não
    • Cancelar

    • 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 não fazer alterações e retornar à configuração da conexão da 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 pergunta se você deseja confirmar 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 (veja Dependências de componentes, exclusão e remoção). Uma caixa de diálogo pergunta se você deseja confirmar que deseja excluir a conexão.

Próximos passos

As ações do menu para uma conexão e seus tipos de atividade estão acessíveis no painel do projeto e na paleta de componentes de design. Para detalhes, veja Menus de ações em Noções básicas sobre conectores.

Após 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 fonte para fornecer dados a uma operação ou como um alvo para consumir dados em uma operação.

Configurar atividades

Esses tipos de atividade estão disponíveis:

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

  • Escrever: Escreve dados em um endpoint de variável e é destinado a ser usado como um alvo em uma operação.