Mapeamento com Scripts¶

Introdução¶

Todos os mapeamentos de transformação são compostos de scripts em nós e campos individuais dentro de um esquema de destino.

Você não precisa necessariamente criar manualmente esses scripts para criar o mapeamento; muitos mapeamentos são criados visualmente, como arrastando e soltando objetos de origem ou variáveis para um campo de destino, mas resultam na criação de um script nos bastidores. Independentemente do método usado para criar o mapeamento, o resultado é sempre o mesmo: um script em um nó ou campo de destino.

Esta página aborda como abrir scripts de transformação e fazer referência a componentes e funções do projeto dentro deles, embora observe que qualquer lógica de script válida pode ser usada.

Abra um Script de Campo¶

Antes de poder adicionar lógica de script, você precisa entrar na visualização que permite editar o script para um campo ou nó individual. A adição de um script em um nó é abordada separadamente em Mapeamento Condicional.

Adicionar um Script¶

Adicionar um script em um campo pode ser feito em modo de mapeamento ou modo de script. Para adicionar um novo script em um campo de destino, siga um destes procedimentos:

• Clique duas vezes no nome do campo.

• Passe o mouse sobre o campo de destino e clique no ícone adicionar no canto superior direito de um campo de destino para abrir um menu de ações. No menu, selecione Adicionar Script:

  

Isso abre a área de script editável no campo de destino no modo de script, onde você pode inserir ou editar a lógica do script para o mapeamento.

Editar um Script¶

Para editar um script em um campo de destino que já possui um mapeamento, clique duas vezes no nome do campo ou clique no ícone do script no canto superior direito de um campo de destino.

Isso abre a área de script editável no campo de destino no modo de script, onde você pode inserir ou editar a lógica do script para o mapeamento.

Insira Ou Edite a Lógica do Script¶

Em adicionar ou editar um script, a área de script editável é aberta no campo de destino no modo de script, onde você pode inserir ou editar a lógica do script para o mapeamento:

Abaixo da área do script, o texto indica se o script é válido. Para obter informações sobre validação de script, consulte Jitterbit Script.

Alternar a Área de Script¶

Para alternar a área do script de volta para a exibição original do bloco, clique no ícone de recolhimento .

Abra o Editor de Script Completo¶

Para trabalhar em uma área de script maior, clique no ícone popout no canto superior direito do campo de destino para abrir o editor de script. Após abrir o editor de script completo, clique no ícone de retorno para voltar a esta tela.

Remova o Script¶

Para remover o script, simplesmente exclua o texto do script.

Adicionar um Objeto de Origem¶

Na paleta de componentes, uma lista de funções disponíveis para uso em um script é fornecida na aba Objetos de origem:

Em um script de transformação, você pode fazer referência a dados de origem inserindo um caminho de referência de campo ou pode fazer referência a nós de dados de origem inserindo um caminho de referência de nó.

Para adicionar um caminho de referência de campo ou nó a um script de transformação ( Jitterbit Script somente), use um destes métodos:

• Arraste o objeto da paleta até o script para inserir o caminho de referência do objeto.
• Clique duas vezes no objeto na paleta para inserir o caminho de referência do objeto na localização do cursor dentro do script.
• Insira manualmente o caminho de referência para o objeto de origem.

Consulte Mapeamento de objetos de origem para obter informações detalhadas sobre o mapeamento de objetos de origem, inclusive adicionando um objeto de origem ao script. Para obter detalhes adicionais, consulte Objetos de origem em Jitterbit Script.

Adicionar uma Função¶

Na paleta de componentes, uma lista de funções disponíveis para uso em um script é fornecida na aba Funções:

Dentro de um script, você pode usar funções inserindo a sintaxe de função apropriada para a linguagem de script.

Para adicionar a sintaxe da função a um script (Jitterbit Script ou JavaScript), use um destes métodos:

• Arraste a função da paleta para o script para inserir a sintaxe da função.
• Clique duas vezes na função na paleta para inserir a sintaxe da função no local do cursor dentro do script. Ao inserir a sintaxe da função, o primeiro argumento da função fica destacado e o cursor é movido para o final do argumento.
• Comece a digitar o nome da função e pressione Control+Space para exibir uma lista de sugestões de preenchimento automático. Selecione uma função para inserir a sintaxe da função.
• Insira manualmente a sintaxe da função.

Para obter mais informações, consulte a documentação de cada função por categoria em Funções.

Adicionar uma Variável¶

Na paleta de componentes, uma lista de variáveis disponíveis para uso em um script é fornecida na aba Variáveis:

Dentro de um script, você pode usar variáveis inserindo a sintaxe da variável.

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.

Consulte Mapeamento de Variáveis para obter informações detalhadas sobre variáveis de mapeamento, inclusive adicionando uma variável ao script. Para obter detalhes adicionais, consulte Variáveis em Jitterbit Script.

Adicionar um Plug-in¶

Na paleta de componentes, uma lista de plug-ins disponíveis para uso em um script é fornecida na aba Plugins:

Dentro de um script, você pode usar um plugin como argumento para o RunPlugin função inserindo o caminho de referência do plugin.

Para adicionar um caminho de referência de plugin a um script (Jitterbit Script somente), use um destes métodos:

• Arraste o plugin da paleta para o script para inserir ambos os RunPlugin função e a referência do plugin.
• Clique duas vezes no plugin na paleta para inserir a referência do plugin no local do cursor dentro do script.
• Comece digitando o nome do plugin e pressione Control+Space para exibir uma lista de sugestões de preenchimento automático. Selecione um plugin para inserir a referência do plugin.
• Insira manualmente a referência do plugin.

Para obter detalhes adicionais, consulte Plugins em Jitterbit Script.

Adicionar uma Operação¶

Na paleta de componentes, uma lista de operações disponíveis para uso em um script é fornecida na aba Operações:

Dentro de um script, você pode usar uma operação como argumento para funções inserindo o caminho de referência da operação.

Para adicionar um caminho de referência de operação a um script (Jitterbit Script somente), use um destes métodos:

• Arraste a operação da paleta para o script para inserir os dois RunOperation função e a referência de operação.
• Clique duas vezes na operação na paleta para inserir a referência da operação no local do cursor dentro do script.
• Comece a digitar o nome da operação e pressione Control+Space para exibir uma lista de sugestões de preenchimento automático. Selecione uma operação para inserir a referência da operação.
• Insira manualmente a referência de operação.

Para obter detalhes adicionais, consulte Operações em Jitterbit Script.

Adicionar uma Notificação¶

Na paleta de componentes, uma lista de notificações disponíveis para uso em um script é fornecida na aba Notificações:

Dentro de um script, você pode fazer referência a uma notificação como argumento para o SendEmailMessage função inserindo o caminho de referência da notificação.

Para adicionar um caminho de referência de notificação a um script (Jitterbit Script somente), use um destes métodos:

• Arraste a notificação da paleta para o script para inserir os SendEmailMessage função e a referência de notificação.
• Clique duas vezes na notificação na paleta para inserir a referência da notificação no local do cursor dentro do script.
• Comece a digitar o nome da notificação e pressione Control+Space para exibir uma lista de sugestões de preenchimento automático. Selecione uma notificação para inserir a referência da notificação.
• Insira manualmente a referência da notificação.

Por exemplo, consulte Notificações em Jitterbit Script.

Adicionar um Script¶

Dentro da paleta de componentes, uma lista de outros scripts que estão disponíveis para uso em um script é fornecida na aba Scripts:

Dentro de um script, você pode fazer referência a outro script como argumento para o RunScript função inserindo o caminho de referência do script.

Para adicionar um caminho de referência de script a um script (Jitterbit Script somente), use um destes métodos:

• Arraste o script da paleta para o script para inserir os RunScript e a referência do script.
• Clique duas vezes no script na paleta para inserir a referência do script no local do cursor dentro do script.
• Comece a digitar o nome do script e pressione Control+Space para exibir uma lista de sugestões de preenchimento automático. Selecione um script para inserir a referência do script.
• Insira manualmente a referência do script.

Por exemplo, consulte Scripts em Jitterbit Script.

Adicionar Endpoints¶

Na paleta de componentes, uma lista de endpoints que estão disponíveis para uso em um script é fornecida na aba Endpoints:

Dentro de um script, você pode fazer referência a endpoints como um argumento para funções inserindo o caminho de referência da conexão ou da atividade.

Para adicionar um caminho de referência de conexão ou atividade a um script (Jitterbit Script ou JavaScript), use um destes métodos:

• Arraste a conexão ou atividade da paleta para o script para inserir a referência apropriada.
• Clique duas vezes na conexão ou atividade na paleta para inserir a referência apropriada no local do cursor dentro do script.
• Comece a digitar o nome da conexão ou atividade e pressione Control+Space para exibir uma lista de sugestões de preenchimento automático. Selecione uma conexão ou atividade para inserir a referência apropriada.
• Insira manualmente a referência de conexão ou atividade.

Dependendo do endpoint, você pode usar a aba Funções para adicionar funções para as quais usar a referência de conexão ou atividade como argumento.

Para obter detalhes adicionais, consulte Endpoints em Jitterbit Script.

Remover um Mapeamento¶

Você pode remover os mapeamentos de campo de destino um de cada vez (Remover um mapeamento de campo único) ou de uma só vez para todos os mapeamentos de campo contidos em um nó (Remover mapeamentos de múltiplos campos).

Remover um Mapeamento de Campo Único¶

Para remover um único mapeamento de script de um campo de destino (às vezes chamado de desmapeamento de um campo), limpe o conteúdo do script do campo de destino.

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ó.

De qualquer modo de mapeamento ou modo de script, passe o mouse sobre o nome de um nó e clique no ícone do menu de ações para abrir o menu de ações. No menu, selecione uma destas opções de remoção de mapeamento:

Item do menu	Descrição
	Remover nó de loop e mapeamentos remove a definição de nó de loop devido a mapeamentos que são filhos-folha 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ó mantém sua definição de nó de loop se pelo menos um neto estiver mapeado. Esta ação está disponível apenas em nós que possuem um nó de loop definido (manualmente ou por geração automática).
	Remover todos os mapeamentos abaixo deste nó remove todos os mapeamentos nos campos contidos no nó, bem como todos os mapeamentos nos campos contidos nos nós filhos desse nó. Usar esta ação em um o nó raiz remove todos os mapeamentos em uma transformação. Ao selecionar esta ação, uma mensagem solicitará que você confirme 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 inválidos mapeamentos, consulte Validade do mapeamento de Transformação.