Ir para o conteúdo

Variáveis de Jitterbit

Visão Geral

Variáveis Jitterbit são um dos três tipos de elementos de dados globais disponíveis no Harmony. (Os outros dois tipos de elementos de dados globais – variáveis globais e variáveis de projeto – também estão disponíveis globalmente ao longo de um projeto. Eles são definidos de forma diferente, conforme descrito em Variáveis Globais e Variáveis do Projeto.)

As variáveis Jitterbit estão sempre disponíveis em todo o seu projeto. Eles são predefinidos pelo Jitterbit ou definidos no arquivo de configuração do Jitterbit.

Os casos de uso mais comuns para variáveis Jitterbit são ler uma variável para que você possa coletar informações sobre o que ocorreu durante uma operação ou buscar informações globais, como o nome do arquivo de origem atual. Com menos frequência, as variáveis Jitterbit são gravadas ao alterar as configurações padrão usadas para processar a cadeia de operação.

Se uma variável Jitterbit afeta a maneira como uma função funciona, ele deve ser configurado acima na cadeia da chamada de função. Operações a montante ou scripts são aqueles que estão ligados dentro de uma cadeia de operação usando ações de operação ou o RunOperation ou RunScript funções. Upstream neste contexto também se refere à alteração do valor da variável Jitterbit no mesmo script, mas antes da chamada da função.

Como essas variáveis são variáveis predefinidas, os projetos raramente criam ou alteram o valor padrão de uma variável Jitterbit. Porém, ao usar um Agente Privado, variáveis Jitterbit podem ser criadas ou seu valor padrão modificado. Consulte Criar novas variáveis ou definir padrões em Agentes Privados abaixo para obter detalhes.

Consulte estas páginas para obter documentação sobre as variáveis Jitterbit predefinidas:

Exibição de Variáveis jitterbit

Ao projetar seu projeto, as variáveis Jitterbit estão disponíveis na aba Elementos de dados do construtor de script, acessível nas telas de scripts e transformações. Cada variável Jitterbit predefinida pelo Jitterbit está documentada em uma página nesta seção.

Definir Variáveis jitterbit em Scripts Ou Transformações

Embora o caso de uso mais comum para variáveis Jitterbit seja ler informações, existem algumas variáveis Jitterbit que você pode querer definir para comunicar algo a um agente. No Cloud Studio, as variáveis Jitterbit podem ser definidas usando Jitterbit Script ou JavaScript, da mesma forma que qualquer variável global pode ser definida.

Dica

Consulte a documentação de cada variável Jitterbit para obter informações sobre quais variáveis podem ser definidas e como elas podem ser definidas.

Jitterbit Script

No Jitterbit Script usado em scripts e transformações, o valor de uma variável Jitterbit pode ser definido começando com um cifrão $ ou ligando para o Set() função.

  • $: Usando o cifrão $ sintaxe, $jitterbit.api.response="Success" define a resposta da API (jitterbit.api.response) para retornar a string "Success" ao aplicativo solicitante.
  • Set: Usando o Set() função, Set("jitterbit.api.response", "Success") define a resposta da API (jitterbit.api.response) para retornar a string "Success" ao aplicativo solicitante.

Em scripts e transformações, as variáveis Jitterbit também serão exibidas na aba Variáveis da paleta de componentes de script, dentro da subaba Variáveis Jitterbit. Consulte Adicionando uma variável Jitterbit a um Script abaixo.

JavaScript

Em JavaScript usado em scripts criado como um componente do projeto, as variáveis Jitterbit predefinidas pelo Jitterbit podem ser definidas apenas com o Jitterbit.SetVar() função. Isso ocorre porque todas as variáveis Jitterbit predefinidas pelo Jitterbit contêm pontos dentro do nome da variável.

  • Jitterbit.SetVar: Usando Jitterbit.SetVar, o exemplo de código Jitterbit.SetVar("$jitterbit.api.response", "Success") define a resposta da API para retornar a string "Success" ao aplicativo solicitante.

Em scripts e transformações, as variáveis Jitterbit também serão exibidas na aba Variáveis da paleta de componentes de script, dentro da subaba Variáveis Jitterbit. Consulte Adicionando uma variável Jitterbit a um Script abaixo.

Aviso

O JavaScript Jitterbit.SetVar e Jitterbit.GetVar funções são projetadas especificamente para acessar as variáveis Jitterbit predefinidas. Eles não devem ser usados para acessar variáveis globais definidas pelo usuário.

Em JavaScript, não misture e combine seu uso de SetVar (e GetVar) com $-prefacing ao definir (e recuperar) uma variável. Use apenas uma sintaxe. Misturar as duas sintaxes diferentes para a mesma variável pode causar problemas em tempo de execução.

Recuperar Variáveis jitterbit em Scripts Ou Transformações

O valor de uma variável Jitterbit pode ser retornado usando Jitterbit Script (em scripts ou transformações) ou usando JavaScript (somente em scripts criados como um componente do projeto) da mesma forma que uma variável global pode ser recuperado.

Aviso

Há um problema conhecido que mapeamento de variáveis com pontos no nome da variável não funcionam corretamente, resultando em um mapeamento incorreto do campo de destino na transformação. Até que esse problema seja resolvido, as variáveis Jitterbit não poderão ser referenciadas diretamente em uma transformação. O script pode ser usado para criar um mecanismo de solução alternativa para transmitir valores.

Jitterbit Script

Em scripts e transformações, você pode começar com um cifrão $ ou use o Get() função para recuperar o valor de uma variável Jitterbit:

  • $: Prefixado com um cifrão $, o exemplo de código $jitterbit.operation.error recupera o valor da variável Jitterbit "jitterbit.operation.error".
  • Get: Usando o Get() função, o exemplo de código Get("jitterbit.operation.error") retorna o mesmo valor.

Em scripts e transformações, as variáveis Jitterbit também serão exibidas na aba Variáveis da paleta de componentes de script, dentro da subaba Variáveis Jitterbit. Consulte Adicionando uma variável Jitterbit a um Script abaixo.

JavaScript

Em JavaScript scripts dentro de uma operação, as variáveis Jitterbit predefinidas pelo Jitterbit podem ser acessadas apenas com o Jitterbit.SetVar() e Jitterbit.GetVar() funções. Isso ocorre porque todas as variáveis Jitterbit predefinidas pelo Jitterbit contêm pontos dentro do nome da variável.

  • Jitterbit.GetVar: Usando Jitterbit.GetVar, o exemplo de código Jitterbit.GetVar("$jitterbit.operation.error") retorna o valor da variável Jitterbit chamada "jitterbit.operation.error". Observe que um cifrão inicial $ é opcional antes do nome ao recuperar valores. Os nomes jitterbit.operation.name e $jitterbit.operation.name são equivalentes ao recuperar valores.

Aviso

O JavaScript Jitterbit.SetVar e Jitterbit.GetVar funções são projetadas especificamente para acessar as variáveis Jitterbit predefinidas. Eles não devem ser usados para acessar variáveis globais definidas pelo usuário.

Em JavaScript, não misture e combine seu uso de SetVar (e GetVar) com $-prefacing ao definir (e recuperar) uma variável. Use apenas uma sintaxe. Misturar as duas sintaxes diferentes para a mesma variável pode causar problemas em tempo de execução.

Em scripts e transformações, as variáveis Jitterbit também serão exibidas na aba Variáveis da paleta de componentes de script, dentro da subaba Variáveis Jitterbit. Consulte Adicionando uma variável Jitterbit a um Script abaixo.

Use Variáveis jitterbit em Telas de Definição

Em uma tela de definição (durante a configuração de fontes ou destinos), você pode referenciar variáveis Jitterbit usando o comando [JitterbitVariableName] sintaxe.

Por exemplo, se você estiver usando a variável Jitterbit como parte de um nome de arquivo ou como propriedade de um objeto diferente que não está em um script, poderá referenciá-la usando colchetes, como [jitterbit.source.filename].

Crie Novas Variáveis ou Defina Padrões em Agentes Privados

Aqueles que usam Agentes Privados podem alterar programaticamente o comportamento padrão das variáveis Jitterbit, bem como criar novas variáveis Jitterbit através do arquivo de configuração do Agente Privado. No entanto, observe que isso é usado apenas em casos de uso raros implementados por usuários avançados. A maioria dos casos de uso pode ser tratada criando uma variável de projeto em vez de uma variável Jitterbit.

A alteração dos valores padrão ou a criação de novas variáveis Jitterbit é feita nestas seções do arquivo de configuração do Agente Privado:

  • [PredefinedGlobalVariables]
    Verifique ou altere os valores padrão das variáveis Jitterbit.

  • [PredefinedServerGlobalDataElement]
    Defina suas próprias variáveis Jitterbit personalizadas e valores padrão.

Os nomes das variáveis Jitterbit podem ser compostos destes caracteres: letras (a-z, A-Z), números (0-9), pontos e sublinhados. Outros caracteres não são recomendados e podem causar problemas.

Nota

Ao atualizar um Agente Privado, o arquivo de configuração é preservado e não é substituído pela versão mais recente.

Aviso

Ao criar novas variáveis Jitterbit, não é recomendado usar pontos em um nome de variável se você planeja acessá-los com JavaScript. Em vez disso, é recomendável criar variáveis Jitterbit que não contenham pontos e, em vez disso, usar sublinhados no lugar de pontos. Consulte informações sobre variáveis globais, que também é aplicável a variáveis Jitterbit.

Para obter mais informações sobre edição ou criação de variáveis Jitterbit, consulte Editar o arquivo de configuração (jitterbit.conf).