Variáveis globais¶

Introdução¶

Variáveis globais 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 Jitterbit 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 Jitterbit 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.

As variáveis globais são declaradas primeiro em uma operação, após o que ficam disponíveis para serem referenciadas nas mesmas operações ou abaixo e scripts. Operações ou scripts downstream 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. As operações downstream podem estar dentro dos mesmos fluxos de trabalho ou workflows abaixo.

Variáveis globais também podem ser usadas como origem ou destino dentro da operação conforme descrito em Variable Read e Escrita de variável.

Você pode querer usar variáveis globais se seu caso de uso envolver o compartilhamento de informações com partes subsequentes de uma cadeia de operação, como nestes exemplos:

Usar valores criados em uma transformação em uma transformação posterior. Por exemplo, um ID de sessão (retornado de um serviço web de login) pode ser necessário ao chamar serviços web subsequentes para autenticação.
Utilizar um valor criado numa parte de uma transformação numa fase posterior dessa mesma transformação. Por exemplo, um número de registro pode ser inicializado e incrementado para cada registro inserido em um destino para identificar o seu número de item.
Utilizar um valor retornado em uma transformação na configuração de componentes em operações subsequentes. Por exemplo, a configuração de URL retornada por uma transformação pode ser usada para definir a URL do serviço web de uma chamada de serviço web subsequente.

Variáveis globais passam por operações encadeadas. Isso inclui operações vinculadas a uma operação anterior dentro da cadeia de operação usando "em caso de sucesso" ou "em caso de falha" ações de operação, bem como aqueles que estão vinculados através do RunOperation função. Variáveis globais também podem ser usadas na mesma transformação.

Exibição de Variáveis globais¶

Variáveis globais definidas são exibidas em vários locais:

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

Criar e Atualizar Variáveis globais¶

Variáveis globais são criadas ou atualizadas usando Jitterbit Script (em scripts e transformações) ou JavaScript (somente em scripts criados como componente do projeto). Consulte Tipos de Script e criação para obter informações sobre como criar os diferentes tipos de scripts. Variáveis globais configuradas em uma conexão Variável são criadas ou atualizadas automaticamente (ver Conexão Variável).

Nomes de Variáveis globais¶

Os nomes das variáveis globais podem ser compostos de caracteres alfanuméricos (as letras a-z e A-Z, e os dígitos 0-9), pontos (.) e sublinhados (_). (Outros caracteres, como hífens, não são recomendados e podem causar problemas.) Os nomes de variáveis globais não diferenciam maiúsculas de minúsculas; uma variável chamada GlobalVar é tratado da mesma forma que globalvar.

É uma boa prática usar pontos ou sublinhados ao definir variáveis globais para que sejam fáceis de encontrar. Por exemplo, uma variável global criada em um Jitterbit Script chamada org.account.filename começa com org, seguido pela account, etc. organizando-o efetivamente quando estiver em uma lista entre outras variáveis globais construídas de forma semelhante. Observe que para variáveis globais criadas em JavaScript (ou para variáveis globais do Jitterbit Script que podem ser usadas posteriormente em JavaScript), recomendamos o uso de sublinhados em vez de pontos. Usar pontos em variáveis globais definidas pelo usuário causa problemas em tempo de execução. Mais informações são fornecidas no JavaScript subseção abaixo.

Jitterbit Script¶

No Jitterbit Script usado em scripts e transformações, uma variável global pode ser definida começando com um cifrão $ ou ligando para o Set função:

$: Usando o cifrão $ sintaxe, $ServerURL=URL cria ou atualiza uma variável global chamada ServerURL com o valor de URL (o nome de outra variável ou o nome de um campo em uma transformação).
Set: Usando o Set função, Set("ServerURL", URL) cria ou atualiza uma variável global chamada ServerURL com o valor de URL (o nome de outra variável ou o nome de um campo em uma transformação).

JavaScript¶

Em JavaScript usado em scripts criado como um componente do projeto, a sintaxe usada para definir uma variável global depende se o nome da variável global contém um ponto final:

Nome não inclui ponto final (recomendado): Uma variável global que não contém ponto final em seu nome pode ser criada ou atualizada usando var $<name> ou atualizado simplesmente usando $<name> sem var:
- var $: A expressão var $ServerURL="https://www.example.com/" cria ou atualiza uma variável global ServerURL com um valor de string de https://www.example.com/. Uma nova variável global deve preceder a $ com var.
- $: A expressão $ServerURL="https://www.example.com/" atualiza a mesma variável global ServerURL com a mesma string URL. Isto funciona apenas para variáveis globais que já existem.
O nome inclui um ponto (recomendado apenas para variáveis Jitterbit e valores de objetos JavaScript): Uma variável que contém pontos em seu nome pode ser atualizada ou recuperada em JavaScript somente com o Jitterbit.SetVar e Jitterbit.GetVar funções. Como essas funções não se destinam a variáveis globais definidas pelo usuário, consulte Variáveis Jitterbit Para maiores informações.

Aviso

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

Endpoint Variável¶

Durante a configuração de uma Conexão variável, uma variável global pode ser criada ou atualizada automaticamente.

Ou seja, se durante a configuração você fornecer o nome de uma variável que ainda não existe, uma variável global será criada automaticamente. Se você fornecer o nome de uma variável global que já existe, ela será associada ao endpoint Variable.

Para obter detalhes sobre como criar ou atualizar uma variável global usando este método, consulte Conexão de Variável.

Recuperar Variáveis globais em Scripts Ou Transformações¶

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

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 global:

$: Prefixado com um cifrão $, o exemplo de código $serverURL recupera o valor (ou campo em uma transformação) da variável global chamada "serverURL".
Get: Usando o Get função, o exemplo de código Get("serverURL") retorna o mesmo valor (ou campo em uma transformação).

Em scripts e transformações, as variáveis globais existentes também são exibidas na aba Variáveis da paleta de componentes de script dentro da subguia Variáveis Globais. Consulte Adicionar uma variável global a um Script abaixo.

JavaScript¶

Em JavaScript scripts dentro de uma operação, a sintaxe usada para recuperar o valor de uma variável global depende se o nome da variável global contém um ponto final.

O nome não inclui um ponto final (recomendado): O valor de uma variável global que não contém um ponto final em seu nome pode ser recuperado começando com um cifrão $. Prefixado com um cifrão $, a expressão $ServerURL recupera o valor da variável global chamada ServerURL.
Nome com pontos (recomendado apenas para variáveis Jitterbit e valores de objetos JavaScript): Uma variável que contém um ponto em seu nome pode ser atualizada ou recuperada em JavaScript somente com o Jitterbit.SetVar e Jitterbit.GetVar funções. Como essas funções não se destinam a variáveis globais definidas pelo usuário, consulte a seção sobre Variáveis Jitterbit Para maiores informações.

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 $-prefixação 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.

Se um JavaScript falhar, quaisquer alterações feitas no valor de uma variável global serão perdidas. Somente se o JavaScript for concluído com êxito os valores das variáveis globais modificados estarão disponíveis fora do script.

Em scripts e transformações, as variáveis globais existentes também são exibidas na aba Variáveis da paleta de componentes de script dentro da subguia Variáveis Globais. Consulte Adicionar uma variável global a um Script abaixo.

Adicionar uma Variável Global a um Script¶

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

! variáveis globais

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 globais 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 globais em qualquer campo que tenha um ícone de variável . As variáveis podem ser usadas em campos junto com outras entradas, inclusive com outras variáveis ou palavras-chave. Essas ações são abordadas abaixo:

Selecione uma variável global
Alternar formatos entre comprimido e texto
Definir um valor padrão
Remover uma variável

Selecione uma Variável Global¶

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

Dentro da lista, cada variável ou tipo de palavra-chave é indicada pelo ícone próximo ao seu nome:

para palavra-chave de nome de arquivo
para variável global
para variável do projeto
para variável Jitterbit

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

ftp read get files select variável

A Descrição no pop-up de informações é [Nenhum] para uma variável global. Um Value será preenchido somente se a variável global tiver um valor padrão especificado neste campo de configuração.

O fundo do ícone é sólido se a variável global tiver um valor padrão especificado neste campo de configuração ou vazio se isso não acontecer. O plano de fundo do ícone não é afetado se a mesma variável global tiver um valor especificado em outro campo de configuração, pois apenas um valor padrão especificado no campo atual será usado.

Aviso

Se uma variável global obtiver seu valor em um script acima na cadeia do componente, seu valor avaliado substituirá o valor padrão especificado no campo de configuração. Observe que os valores avaliados obtidos em um script não são refletidos no Valor no pop-up de informações.

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:

ftp ler pílula para obter arquivos

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

ftp ler obter arquivos pílula pairar

Alternar Formatos Entre Comprimido e Texto¶

Para alterar o formato padrão do comprimido variável para formato de texto, clique no ícone de recolhimento :

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

ftp ler obter texto dos arquivos

No formato de texto, você pode definir um valor padrão.

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

Definir um Valor Padrão¶

No tempo de execução de operação, um valor padrão definido em um campo de configuração, conforme mostrado abaixo, é usado somente se o valor da variável não tiver sido definido durante o tempo de tempo de execução. Isso é diferente durante teste de script, onde — como qualquer valor de script acima na cadeia ainda não terá sido instanciado — qualquer valor padrão definido em um campo de configuração será usado.

Para definir um valor padrão dentro de um campo de configuração, primeiro alternar para formato de texto.

Imediatamente após o nome da variável global entre colchetes [ ], especifique o valor padrão entre chaves { }:

ftp read get files text default

Quando valores padrão são especificados, o valor da variável global é usado se estiver definido, caso contrário, o valor padrão é usado.

Dica

Ao usar uma variável global em uma cláusula WHERE, como em um banco de dados ou Salesforce consultar, você pode especificar um valor padrão para que teste de script é possível. Caso contrário, como uma variável global obtém seu valor em tempo de execução, durante o teste a sintaxe poderá ser inválida se nenhum valor padrão tiver sido especificado.

Se você não quiser que a variável global seja interpretada, use uma barra invertida \ para escapar do conjunto de colchetes [ ].

Por exemplo, o seguinte não usa o valor de serverURL mesmo que esteja definido, mas em vez disso sempre usa http://server/index.asp:

\[serverURL{http://server/index.asp}]

Cuidado

Dentro de caminhos de arquivo que contêm barras invertidas, uma única barra invertida é interpretada como iniciando uma sequência de escape se for seguida por um conjunto de colchetes [ ].

Barras invertidas adicionais podem ser usadas para alcançar o resultado desejado. Por exemplo, \\server\share\\[Directory{testing}] é interpretado como \\server\share\testing se a variável Directory não está definido, senão \\server\share\"value of Directory" é usado.

Para evitar esse problema, converta os caminhos dos arquivos para o formato URL (por exemplo, C:/directory/path).

Remover uma Variável¶

Para remover a variável, clique no ícone de remoção :

ftp ler obter arquivos pílula remover

Ver Dependências de Variáveis globais¶

As dependências de uma variável global são outros componentes que dependem da variável porque estão lendo — ou gravando — na variável global. Depois que uma variável global tiver sido criada e usada em um projeto, você poderá visualizar essas dependências.

Depois que uma variável global é criada, a opção Exibir Dependências fica disponível na aba Componentes do painel do projeto (consulte Menu Ações do Componente em Guia Componentes do painel do projeto). A opção Visualizar dependências altera a visualização no painel do projeto para exibir outras partes do projeto das quais a variável global depende.

Na visualização de dependência, o nome da variável global selecionada aparece na parte superior, abaixo dos recursos de pesquisa e filtro existentes. O nome da variável global é seguido por uma lista de Dependências das quais a variável depende. Esta lista é organizada por categorias como Atividade e Script e ainda classificada em Leitura ou Escrita para indicar o tipo de acesso de uma referência de variável específica:

variável global de dependências

Por exemplo:

Se um script contém $myVar1='abc', ele está escrevendo um valor na variável e referenciando myVar1 para acesso de gravação.
Se um script contém $myVar2=$myVar1, está referenciando myVar2 para acesso de gravação e myVar1 para acesso de leitura.
Se um script contém If(myVar1=='abc', TRUE, FALSE), está referenciando myVar1 para acesso de leitura.

Tutoriais Sobre Variáveis globais¶

Consulte estas seções para obter detalhes sobre o uso de variáveis globais em projetos:

Converter uma variável global em uma variável de projeto
Verificar valores nulos ou indefinidos
Definir e acessar variáveis de array

Converter uma Variável Global em uma Variável de Projeto¶

Você pode converter uma variável global já existente em uma variável de projeto.

Variáveis globais podem ser convertidas em variáveis de projeto durante configuração de variáveis de projeto. Ao configurar uma variável de projeto, insira o nome de uma variável global existente no campo de nome. Ao tentar salvar, um prompt solicitará que você confirme se deseja converter a variável global em uma variável de projeto:

variável global com mesmo nome já existe

Ao clicar em Continuar, todas as referências e dependências da variável global são transferidas para a variável do projeto. Isso inclui referências à antiga variável global dentro de scripts, que agora fazem referência à variável do projeto. (Lembre-se de que um valor para uma variável de projeto definida em um script durante a execução da cadeia de operação substitui o valor padrão especificado na configuração da variável de projeto.)

Para obter mais detalhes sobre variáveis de projeto, consulte Variáveis de Projeto.

Verifique Se Há Valores Nulos Ou Indefinidos¶

Uma variável global que não foi definida possui um valor nulo.

Por exemplo, IsNull(Get("GlobalVariableName")) retorna verdadeiro se uma variável global com o nome GlobalVariableName ainda não foi definido. Isto pode ser usado para verificar se uma variável global foi definida ou não.

Definir e Acessar Variáveis de Array¶

Você pode criar matrizes de variáveis globais, também conhecidas como variáveis de matriz. Consulte Matrizes para obter informações sobre como configurar e recuperar valores de variáveis de matriz.