Variáveis no Jitterbit Design Studio

Visão Geral

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

O Jitterbit suporta múltiplos tipos de variáveis com escopos variados, incluindo variáveis locais, variáveis globais, variáveis de projeto e variáveis 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 que tem o escopo mais limitado, a fim de minimizar o risco de alteração dos valores das variáveis em múltiplos componentes do projeto.

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

• Arquivos de dados são passados entre operações armazenando-os em uma variável global.
• Variáveis são mapeadas para campos de destino em uma transformação, proporcionando capacidades 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 a partir do Console de Gerenciamento durante a execução da operação.

Todos os tipos de variáveis podem ser lidos e escritos 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 novas variáveis globais definidas em JavaScript se tornarão variáveis globais do 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. Veja Variável global versus 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 apenas dentro desse script.

• Variáveis Globais
  Variáveis globais são declaradas em uma operação e estão disponíveis para serem referenciadas nas mesmas operações ou em operações e scripts subsequentes. Operações subsequentes podem estar dentro dos mesmos fluxos de trabalho ou em fluxos de trabalho subsequentes, conforme vinculado às ações da operação.

• Variáveis de Projeto
  Variáveis de projeto são definidas antes da execução da operação e se tornam disponíveis para uso em todos os fluxos de trabalho do projeto. Como as variáveis de projeto podem ser definidas através do Console de Gerenciamento e dentro do Citizen Integrator, elas oferecem a flexibilidade de definir e alterar parâmetros e credenciais sem a necessidade de reimplantar o projeto.

• Variáveis Jitterbit
  Variáveis Jitterbit são pré-definidas 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 temporariamente sobrescritos 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 mudar o valor padrão de uma variável Jitterbit pré-definida ou para criar e pré-definir 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 de Nome de Arquivo
  Palavras-chave de nome de arquivo são usadas para gerar nomes de arquivos exclusivos para campos configuráveis que aceitam nomes de arquivos como entrada. Isso inclui certos campos disponíveis ao configurar endpoints baseados em arquivos.