Ir para o conteúdo

Variáveis Jitterbit

Visão Geral

Variáveis Jitterbit são um dos tipos de elementos de dados globais disponíveis no Harmony. Os outros tipos de elementos de dados globais — variáveis de projeto, variáveis globais e palavras-chave de nome de arquivo — também estão disponíveis globalmente em todo o projeto. Elas são definidas de forma diferente, conforme descrito em Variáveis do projeto, Variáveis globais e palavras-chave do nome do arquivo, respectivamente. No entanto, como todos os elementos de dados globais partilham o mesmo espaço de nomes, os seus nomes devem ser exclusivos quando comparados com todos os outros elementos de dados globais.

O caso de uso mais comum para variáveis Jitterbit é 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. Outro caso de uso comum é usar variáveis Jitterbit para 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. Upstream operações ou scripts são aqueles que estão vinculados 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.

Se estiver usando um agente privado, você pode alterar programaticamente o comportamento do Jitterbit alterando o valor padrão de uma variável Jitterbit predefinida ou criando e predefinindo sua própria variável Jitterbit.

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

Exibição de Variáveis Jitterbit

Variáveis Jitterbit são exibidas em vários lugares:

  • No editor de script, as variáveis Jitterbit são exibidas na paleta de componentes à direita na aba Variáveis na subguia Variáveis Jitterbit. Este local fornece acesso fácil para inserir referências de variáveis Jitterbit em scripts, inclusive dentro de scripts de transformação em modo de script.
  • Em transformação modo de mapeamento, as variáveis Jitterbit são exibidas na aba Variáveis à esquerda na categoria Variáveis Jitterbit. Este local fornece acesso fácil para inserir referências de variáveis Jitterbit durante o mapeamento de transformação no modo de mapeamento.
  • Em telas de configuração do endpoint, as variáveis Jitterbit podem ser acessadas e usadas em qualquer campo que tenha um ícone de variável ícone de variável. Como alternativa à seleção de uma variável Jitterbit, você pode inserir manualmente a referência da variável usando a sintaxe padrão de colchetes do Jitterbit Script.

Defina 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 configurado.

Dica

Consulte a documentação de cada variável Jitterbit para obter informações sobre quais variáveis podem ser definidas e para que 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" para o 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" para o aplicativo solicitante.

Nota

Para variáveis Jitterbit com um hífen em seu nome, use o Get e Set funções para recuperar e definir seus valores. Por exemplo: Set("jitterbit.target.http.response.header.X-Jitterbit-Authorization", $authorization).

Em scripts e transformações, as variáveis Jitterbit também são exibidas na aba Variáveis da paleta de componentes de script, dentro da subguia Variáveis Jitterbit. Consulte Adicionar 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" para o aplicativo solicitante.

Aviso

O JavaScript Jitterbit.SetVar e Jitterbit.GetVar funções são projetadas especificamente para acessar as variáveis Jitterbit predefinidas. Elas não devem ser usadas 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 são exibidas na aba Variáveis da paleta de componentes de script, dentro da subguia Variáveis Jitterbit. Consulte Adicionar uma variável Jitterbit a um script abaixo.

Recuperar Variáveis jitterbit em um Script Ou Transformação

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.

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.

Nota

Para variáveis Jitterbit com um hífen em seu nome, use o Get e Set funções para recuperar e definir seus valores. Por exemplo: Get("jitterbit.target.http.response.header.X-Jitterbit-Authorization").

Em scripts e transformações, as variáveis Jitterbit também são exibidas na aba Variáveis da paleta de componentes de script, dentro da subguia Variáveis Jitterbit. Consulte Adicionar 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.

Em scripts e transformações, as variáveis Jitterbit também são exibidas na aba Variáveis da paleta de componentes de script, dentro da subguia Variáveis Jitterbit. Consulte Adicionar 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. Elas não devem ser usadas 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.

Adicione uma Variável Jitterbit a um Script

Em Jitterbit Script ou JavaScript usado em scripts criadas em uma operação, as variáveis Jitterbit são exibidas na aba Variáveis da paleta de componentes, dentro da subguia Variáveis Jitterbit:

Variáveis Jitterbit

Para adicionar a sintaxe da variável a um script (Jitterbit Script ou JavaScript), use um destes métodos:

  • Arraste a variável da paleta para o script para inserir a sintaxe da variável.
  • Clique duas vezes na variável na paleta para inserir a sintaxe da variável no local do cursor dentro do script.
  • Comece digitando o nome da variável e pressione Control+Space para exibir uma lista de sugestões de preenchimento automático. Selecione uma variável para inserir a sintaxe da variável.
  • Insira manualmente a sintaxe da variável.

Use Variáveis Jitterbit em Telas de Configuração

Durante a configuração de vários componentes do projeto, incluindo a configuração do endpoint usando conectores, você pode usar variáveis Jitterbit em qualquer campo que tenha um ícone de variável ícone de variável. Variáveis podem ser usadas em campos junto com outras entradas, incluindo com outras variáveis ou palavras-chave. Essas ações são abordadas abaixo:

Selecione uma Variável Jitterbit

Para acessar as variáveis Jitterbit, você pode clicar no ícone de variável ícone de variável ou insira um colchete aberto [ para exibir uma lista de variáveis e palavras-chave (se disponível para o campo atual).

Dentro da lista, o tipo de variável ou palavra-chave é indicado pelo ícone ao lado do seu nome:

  • nome-de-arquivo palavra-chave para palavra-chave filename
  • palavra-chave filename para variável global
  • variável de projeto para variável de projeto
  • Variável Jitterbit para variável Jitterbit

Na lista, passe o mouse sobre o nome da variável para visualizar informações sobre ela:

Variável de seleção de nomes de arquivos de gravação FTP

O Valor e Descrição que aparecem no pop-up de informações estão sempre vazios para uma variável Jitterbit. Para obter uma descrição de como cada variável é usada, consulte as páginas deste tópico.

Um valor padrão para uma variável Jitterbit não pode ser definido em um campo de configuração. Em vez disso, você pode definir valores para determinadas variáveis Jitterbit em um script para serem avaliadas em tempo de execução.

Selecione uma variável para adicionar ao campo no local do cursor, em qualquer lugar da string. A variável é exibida em formato de comprimido semelhante ao mostrado abaixo:

Pílula de gravação de nomes de arquivos FTP

Para revisar informações sobre a variável, passe o mouse sobre o quadro da variável:

FTP escrever nomes de arquivos pílula pairar

Alternar Formatos Entre Pílula e Texto

Para alterar o formato padrão da pílula variável para o formato de texto, clique no ícone de recolhimento ícone de recolhimento:

Colapso da pílula de nomes de arquivos de gravação de FTP

Isso alterna a exibição do formato da pílula para um formato de texto, com o nome da variável entre colchetes [ ]:

FTP escreve texto de nomes de arquivos

Para mudar de um formato de texto de volta para o formato de pílula, mude o foco do campo, como clicando em outro campo configurável. A entrada do campo retorna automaticamente ao formato de pílula padrão.

Remover uma Variável

Para remover a variável, clique no ícone remover ícone fechar:

Remover pílula de nomes de arquivos de gravação FTP

Tutoriais Sobre Variáveis jitterbit

Esta seção inclui detalhes sobre o uso de variáveis Jitterbit em projetos.

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 por meio 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 de valores padrão ou a criação de novas variáveis Jitterbit é feita a partir destas seções do arquivo de configuração do agente privado:

  • [PredefinedGlobalVariables]
    Verifique ou altere os valores padrão para 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 por estes 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 no nome de uma variável se você planeja acessá-las com JavaScript. Em vez disso, é recomendado que você crie variáveis Jitterbit que não contenham pontos e, em vez disso, use sublinhados no lugar de pontos. Consulte as informações sobre variáveis globais, que também é aplicável a variáveis Jitterbit.

Para mais informações sobre como editar ou criar variáveis Jitterbit, veja Editar o arquivo de configuração (jitterbit.conf).