Variáveis no Jitterbit Integration Studio

Visão geral

Variáveis são usadas para permitir a configuração dinâmica de endpoints, dar suporte à passagem de dados entre operações e conduzir lógica de integração detalhada com scripts de transformação.

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

As melhores práticas de integração sugerem que você use a variável com escopo mais limitado para minimizar o risco de alterar valores de 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 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 preferíveis, 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 Considerações sobre armazenamento temporário para recomendações sobre quando é apropriado usar esses dois tipos.

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

• Variáveis Locais
  Variáveis locais são as mais limitadas em escopo. Elas são declaradas dentro de um script e podem ser acessadas somente dentro desse script.

• Variáveis Globais
  Variáveis globais são declaradas em uma operação e, então, ficam disponíveis para serem referenciadas nas mesmas operações e scripts ou em operações abaixo. Operações posteriores podem estar dentro dos mesmos workflows ou em fluxos de trabalho abaixo, conforme vinculadas às ações da 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 definidas por meio do Management Console e do Citizen Integrator, elas oferecem a flexibilidade de definir e alterar parâmetros e credenciais sem reimplantar o projeto.

• Variáveis Jitterbit
  As variáveis Jitterbit são predefinidas pelo sistema Harmony e podem ser usadas para buscar 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 de 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.