Ir para o conteúdo

Variáveis no Jitterbit Integration Studio

Visão geral

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

O Jitterbit suporta vários tipos de variáveis com escopo variado, 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 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 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. Veja Variável 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 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 abaixo, conforme vinculados com 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 definidas por meio do Management Console e dentro do Citizen Integrator, elas fornecem a flexibilidade para 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.