Ir para o conteúdo

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 prática recomendada 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 Armazenamento variável 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.