Modo de Script

Introdução

O modo de Script fornece visualizações detalhadas de campos e ferramentas avançadas para adicionar scripts ao mapeamento. Veja 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ê faça drill down até o nível de script de cada campo de destino e fornece mais controle sobre o mapeamento de cada campo. Você pode entrar no modo de script de qualquer campo de destino individual de dentro 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 no adicione o ícone e selecione Adicionar Script.
• Para campos de destino que já tenham um mapeamento, clique em ícone de script.

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

Ao acessar uma transformação que você abriu anteriormente, o Cloud 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 Cloud Studio se lembrará do último script que você estava acessando e abrirá e rolará automaticamente para ele na próxima vez que você acessar a transformação.

Nós Alvo

Um esquema de destino especificado é composto de 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. Depois de 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 têm 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 filho 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 dentro do nó, bem como todos os mapeamentos em campos contidos dentro de 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 pede para você confirmar que 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 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 somente 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 em todo o 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, então o nó duplicado é refletido no esquema da atividade. Se o esquema da atividade posteriormente sofrer quaisquer alterações como resultado de uma configuração de atividade alterada ou uma atualização de esquema do endpoint, a retenção de nós duplicados dependerá se o nó original que foi duplicado ainda existe: 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 apenas em nós que foram criados usando Nó duplicado.
	Renomear nó duplicado permite renomear um nó de destino duplicado. O novo nome é para fins de exibição somente durante o tempo de design. No tempo de execução, o nome do nó duplicado original (o nome do nó anexado com um hash (#) 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 somente em nós que ainda não têm uma condição aplicada. Ao selecionar esta ação, o modo de script abre 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 somente em nós que já têm uma condição aplicada. Para mais detalhes, veja 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 abordadas 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 são uma correspondência exata dentro de 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.
• Mapeamento de objetos de origem
  Além do mapeamento automático, os campos de origem podem ser mapeados manualmente para um campo de destino. Quando você mapeia 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
  Quando você mapeia uma variável, a referência de variável é inserida em um script no campo de destino. As referências de variável 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 de 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 de 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 de cada vez ou remover todos os mapeamentos de campos contidos em um nó.

Editar Ou Remover um Único Mapeamento de Campo

Ao passar o mouse sobre um campo de destino mapeado (indicado com uma linha vertical roxa e um í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 para o campo.

Remover Vários Mapeamentos de Campo

Para mapeamentos em esquemas hierárquicos, 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)