Modo de Script em transformações no Jitterbit Integration Studio

Introdução

O modo de Script fornece visualizações detalhadas dos campos e ferramentas avançadas para adicionar scripts ao mapeamento. Consulte também Elementos do modo comum para elementos da interface do usuário que são compartilhados por vários modos de exibição.

Modo de script de acesso

O modo de Script permite que você acesse o nível de script de cada campo de destino e oferece mais controle sobre o mapeamento de cada campo. Você pode entrar no modo de script a partir de qualquer campo de destino individual a partir do modo de mapeamento de qualquer uma destas maneiras:

• Clique duas vezes no nome de um campo de destino.
• Para campos de destino que ainda não tenham um mapeamento, passe o mouse sobre o campo de destino e clique em adicione o ícone e selecione Adicionar Script.
• Para campos de destino que já possuem um mapeamento, clique em ícone de script.

No modo script, a estrutura e os mapeamentos de destino são exibidos no lado esquerdo. Quando o foco do cursor estiver dentro do script de um determinado campo de destino, uma borda roxa será exibida ao redor do campo de destino. Quaisquer componentes disponíveis para uso em um script específico são exibidos na paleta de componentes no lado direito:

Ao acessar uma transformação aberta anteriormente, o Integration Studio rola automaticamente para o local no esquema que você acessou pela última vez. Além disso, se você sair de uma transformação enquanto o foco do cursor estiver dentro de um script, o Integration Studio se lembrará do último script que você acessou e abrirá e rolará automaticamente para ele na próxima vez que você acessar a transformação.

Nós de destino

Um esquema de destino especificado é composto por nós que podem conter campos, bem como outros nós filhos que também podem conter campos. Os dados de origem não podem ser mapeados para os próprios nós de destino, pois podem ser mapeados apenas para os campos que os nós de destino contêm. Após especificar um esquema de destino, para acessar as opções disponíveis em cada nó, passe o mouse sobre o nó de destino e clique em ícone do menu de ações. Cada ação possível é descrita abaixo.

Item de Menu	Descrição
	Remover nó de loop remove a definição do nó de loop. Esta ação está disponível somente em nós que possuem um nó de loop definido manualmente. Nota Se você remover todos os mapeamentos de folhas diretas de um nó de loop definido manualmente, a definição do nó de loop ainda existirá.
	Remover nó de loop e mapeamentos remove a definição do nó de loop devido a mapeamentos que são filhos folhas diretos associados ao nó de loop e remove esses mapeamentos. Quaisquer outros mapeamentos dentro de nós de loop filhos abaixo do nó de loop pai são preservados, e o nó retém sua definição de nó de loop se pelo menos um neto for mapeado. Esta ação está disponível somente em nós que têm um nó de loop definido (manualmente ou por geração automática).
	Remover todos os mapeamentos abaixo deste nó remove todos os mapeamentos em campos contidos no nó, bem como todos os mapeamentos em campos contidos em nós filhos desse nó. Usar esta ação em um nó raiz remove todos os mapeamentos em uma transformação. Ao selecionar esta ação, uma mensagem solicita que você confirme se deseja remover os mapeamentos.
	Remover todos os mapeamentos inválidos remove todos os mapeamentos inválidos em campos contidos no nó, bem como todos os mapeamentos inválidos em campos contidos em nós filhos desse nó. Para obter mais informações sobre mapeamentos inválidos, consulte Validade do mapeamento de Transformação.
	Expandir todos os nós abaixo deste nó expande todos os nós filhos abaixo do nó pai. (Por padrão, os nós são expandidos até 8 níveis de profundidade para esquemas com 750 nós ou menos e até 5 níveis de profundidade para esquemas com mais de 750 nós.)
	Duplicar nó duplica o nó e seus campos, bem como quaisquer nós filhos e seus campos. Os mapeamentos não são duplicados. Esta ação está disponível em nós raiz em esquemas simples e em nós cuja cardinalidade(/pt/integration-studio/design/transformations/basics/nodes-and-fields#nodesandfields-cardinalitykey) indica que os elementos podem ocorrer mais de uma vez. O nó não deve ser uma duplicata de outro nó. Para fins de exibição apenas em tempo de design, o nome do nó duplicado é anexado com um hash e um número incrementado. Por exemplo, quando você duplica um nó chamado transaction, a primeira duplicata do nó é exibida como transaction#1. Se você então duplicar o transaction nó novamente, a segunda duplicata é exibida como transaction#2. Durante o tempo de execução, o nome do nó original é usado tanto para o nó original quanto para os nós duplicados. Por exemplo, os nós exibidos como transaction, transaction#1, e transaction#2 são cada um processado com o nome do nó original transaction. Nós duplicados não podem ser renomeados. Se um nó duplicado é refletido em outros locais do projeto depende de como o esquema foi definido: Definido em uma atividade: Se o esquema no qual o nó é duplicado for definido em uma atividade, o nó duplicado será refletido no esquema da atividade. Se o esquema da atividade sofrer alterações posteriormente como resultado de uma configuração de atividade alterada ou de uma atualização de esquema do endpoint, a retenção de nós duplicados dependerá da existência do nó original duplicado: Se o nó original existir, todos os nós duplicados anteriormente serão retidos. Se o nó original não existir mais, todos os nós criados como duplicatas desse nó serão removidos. Definido em uma Transformação: Se o esquema no qual o nó é duplicado for definido em uma transformação, então o nó duplicado não é refletido no esquema da atividade, pois o esquema da atividade não faz parte da transformação.
	Remover nó duplicado remove o nó duplicado e seus campos, bem como quaisquer nós filhos duplicados e seus campos. Esta ação está disponível somente em nós que foram criados usando Nó duplicado.
	Renomear nó duplicado permite renomear um nó de destino duplicado. O novo nome serve apenas para fins de exibição durante o tempo de design. Em tempo de execução, o nome do nó duplicado original (o nome do nó com um hash anexado) (#)e um número incrementado) é usado. Esta ação está disponível somente em nós que foram criados usando Duplicar nó.
	Adicionar condição ao nó é usado para aplicar condicionalmente um mapeamento aos campos contidos em um nó. Esta ação está disponível apenas em nós que ainda não possuem uma condição aplicada. Ao selecionar esta ação, o modo de script é aberto para você criar a condição. Para obter detalhes sobre como criar a condição, consulte Mapeamento condicional.
	Editar condição abre o modo de script para editar a condição existente no modo de script. Esta ação está disponível apenas em nós que já possuem uma condição aplicada. Para mais detalhes, consulte Mapeamento condicional.
	Remover condição remove a condição. Esta ação está disponível somente em nós que já têm uma condição aplicada.

Campos de destino

Para que um mapeamento de transformação resulte em dados de saída da transformação, você deve mapear para pelo menos um campo no esquema de destino. Depois de especificar um esquema de destino, você pode mapear para os campos de destino de qualquer uma das maneiras descritas abaixo, incluindo mapeando objetos de origem, variáveis, scripts ou valores personalizados para os campos de destino ou adicionando outra lógica de script:

• Mapeamento automático
  O mapeamento automático é usado para mapear automaticamente campos de origem e destino cujos nomes correspondem exatamente a estruturas de dados idênticas. Você pode executar o mapeamento automático usando toda a estrutura de dados ou dentro de nós de origem e destino selecionados.
• Mapeando objetos de origem
  Além do mapeamento automático, os campos de origem podem ser mapeados manualmente para um campo de destino. Ao mapear um campo de origem para um campo de destino, o caminho de referência do objeto de origem é inserido em um script no campo de destino.
• Mapeamento de variáveis
  Ao mapear uma variável, a referência à variável é inserida em um script no campo de destino. As referências a variáveis são construídas com um cifrão ($) precedendo o nome da variável.
• Mapeando valores personalizados
  Valores personalizados são valores (incluindo valores codificados) e expressões que podem ser mapeados para um campo de destino.
• Mapeamento com scripts
  Todos os mapeamentos de transformação são compostos por scripts em nós e campos individuais dentro de um esquema de destino. Esta página aborda como abrir scripts de transformação e referenciar componentes e funções do projeto dentro deles, embora qualquer lógica de script válida possa ser usada.

Editar ou remover um mapeamento

Você pode editar ou remover mapeamentos de campos de destino um por vez ou remover todos os mapeamentos de campos contidos em um nó.

Editar ou remover um único mapeamento de campo

Ao pairar sobre um campo de destino mapeado (indicado por uma linha vertical roxa e uma ícone de script no bloco do campo) cujo script não está aberto no momento, estas opções ficam disponíveis:

• Editar: Abre o editor de script para o campo.

• Remover mapeamento: Remove o mapeamento do campo.

Remover vários mapeamentos de campos

Para mapeamentos em esquemas hierárquicos, as opções para remover vários mapeamentos de campos de destino estão disponíveis no menu de ações de um nó (descrito acima em Nós de destino)