Mapear variáveis em transformações no Jitterbit Integration Studio
Introdução
Você pode usar variáveis para passar valores dinâmicos em seus mapeamentos de transformação.
É possível utilizar três tipos de variáveis em transformações:
- Variáveis de projeto: Definidas no nível do projeto e disponíveis em todo o projeto.
- Variáveis globais: Definidas em qualquer lugar do projeto e devem ser inicializadas antes do uso.
- Variáveis Jitterbit: Variáveis do sistema fornecidas pelo Jitterbit.
Acessar variáveis
Ao acessar uma transformação, as variáveis aparecem na aba Variáveis no lado esquerdo (fonte). Ícones indicam o tipo de variável:
Variável de projeto Variável global Variável Jitterbit
Um fundo sólido (
As variáveis também aparecem na aba Variáveis da paleta de componentes de script, organizadas por tipo.
Mapear variáveis para campos de destino
Você pode mapear variáveis usando esses três métodos:
-
Arrastar e soltar: Na aba Variáveis na estrutura de origem ou na paleta de componentes de script, arraste uma variável para um campo de destino.
-
Clique duas vezes: Ao editar um script, posicione o cursor no campo de destino do script e clique duas vezes na variável para inserir sua referência.
-
Digite manualmente: Ao editar um script, digite a referência da variável usando um sinal de dólar:
$variableName
.
Referências de variáveis em scripts de transformação
As variáveis são prefixadas com um sinal de dólar ($
) quando usadas em scripts. Por exemplo, $variableName
.
Você também pode referenciar variáveis usando a função Get
(ou Set
para variáveis Jitterbit):
Get("variableName")
O nome da variável depende de como a variável foi definida:
- Variáveis locais usam o nome que você atribuiu:
$tempValue
ouGet("tempValue")
. - Variáveis de projeto usam o nome que você atribuiu:
$myProjectVariable
ouGet("myProjectVariable")
. - Variáveis globais usam o nome que você atribuiu:
$myGlobalVariable
ouGet("myGlobalVariable")
. - Variáveis Jitterbit usam nomes predefinidos com pontos:
$jitterbit.operation.name
ouSet("jitterbit.operation.name", "My Operation");
.
Criar novas variáveis
Você pode adicionar uma nova variável ao visualizar uma transformação usando um destes métodos:
-
Variáveis de projeto: Na aba Variáveis da estrutura de origem, clique em Criar Nova Variável de Projeto ou, no painel de componentes de script, clique em Adicionar Novo.
-
Variáveis globais: Definidas em scripts usando esta sintaxe:
$globalVariableName = "value";
. Variáveis globais devem ser declaradas antes de onde são usadas.
Nota
Ao usar variáveis em transformações, observe estas considerações:
- Variáveis globais sem inicialização têm valores padrão vazios.
- Algumas variáveis Jitterbit podem não se aplicar à sua operação específica.