Variáveis¶

Visão Geral¶

As variáveis são usadas para permitir a configuração dinâmica de endpoints, para suportar a passagem de dados entre as operações e para orientar a lógica de integração detalhada com scripts de transformação.

O Jitterbit oferece suporte a vários tipos de variáveis com escopo variado, incluindo variáveis locais, globais, de projeto e Jitterbit. Além disso, as substituições de palavras-chave estão disponíveis para uso com campos de nome de arquivo.

A melhor prática de integração sugere que você use a variável com escopo mais limitado, a fim de minimizar o risco de alterar os valores das variáveis em vários componentes do projeto.

Algumas maneiras pelas quais as variáveis podem ser usadas incluem estes casos de uso populares:

• Os arquivos de dados são passados entre as operações, armazenando-os em uma variável global.
• As variáveis são mapeadas para campos de destino em uma transformação, fornecendo recursos de mapeamento dinâmico.
• URLs de conexão, parâmetros e credenciais são preenchidos com variáveis de projeto, que podem ser definidas ou alteradas no Management Console durante o tempo de execução da operação.

Todos os tipos de variáveis podem ser lidos e gravados dependendo da natureza da variável específica (ou seja, algumas variáveis podem ser apenas informativas). Em scripts, as variáveis podem ser acessadas e atualizadas com Jitterbit Script ou JavaScript. Quaisquer variáveis globais JavaScript recém-definidas se tornarão variáveis globais Jitterbit.

Quanto à diferença de desempenho entre os diferentes tipos de variáveis, as variáveis locais são preferidas, pois não são persistidas para outras operações. Variáveis globais e de projeto devem ser armazenadas em cache para outras operações. Consulte Variável global versus armazenamento temporário para obter recomendações sobre quando é apropriado usar esses dois tipos.

Estas páginas estão incluídas neste tópico:

• Variáveis Locais
  As variáveis locais são as mais limitadas em escopo. Eles são declarados dentro de um script e podem ser acessados apenas dentro desse script.

• Variáveis Globais
  As variáveis globais são declaradas em uma operação e ficam disponíveis para serem referenciadas nas mesmas operações e scripts ou abaixo. As operações downstream podem estar dentro dos mesmos workflows ou abaixo, conforme vinculados às ações de operação.

• Variáveis do Projeto
  As variáveis do projeto são definidas antes do tempo de execução da operação e ficam disponíveis para uso em todos os workflows do projeto. Como as variáveis do projeto podem ser configuradas por meio do Management Console e dentro do Citizen Integrator, elas fornecem a flexibilidade para configurar e alterar parâmetros e credenciais sem reimplementar o projeto.

• Variáveis Jitterbit
  As variáveis Jitterbit são predefinidas pelo sistema Harmony e podem ser usadas para obter facilmente informações globais, como o nome do arquivo de origem atual e outras informações úteis. Os valores padrão das variáveis Jitterbit também podem ser substituídos temporariamente em um script.

  Nota

  Se estiver usando um Agente Privado, você também pode alterar programaticamente o comportamento do Jitterbit modificando o arquivo de configuração do Agente Privado para alterar o valor padrão de uma variável Jitterbit predefinida ou para criar e predefinir sua própria variável Jitterbit. Criar ou atualizar variáveis Jitterbit usando o arquivo de configuração não está disponível para Agentes em Nuvem.

• Palavras-chave do nome do arquivo
  Palavras-chave de nome de arquivo são usadas para gerar nomes de arquivo exclusivos para campos configuráveis que aceitam nomes de arquivo como entrada. Isso inclui determinados campos disponíveis ao configurar endpoints baseados em arquivo.