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 dar suporte à passagem de dados entre operações e para conduzir uma lógica de integração detalhada com scripts de transformação.

O Jitterbit oferece suporte a 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 alteração de 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 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
    As variáveis locais são as mais limitadas em escopo. Eles são declarados dentro de um script e podem ser acessados somente dentro desse script.

  • Variáveis globais
    Variáveis globais são declaradas em uma operação e ficam então disponíveis para serem referenciadas nas mesmas operações e scripts ou em operações abaixo. As operações downstream podem estar dentro dos mesmos workflows ou fluxos de trabalho abaixo, conforme vinculados às ações 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 fornecem 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.