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 eles resultam em um script sendo criado nos bastidores. Independentemente do método usado para criar o mapeamento, o resultado é sempre o mesmo: um script em um nó de destino ou campo de destino.

Esta página aborda como abrir scripts de transformação e referenciar 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 que você edite o script para um campo ou nó individual. Adicionar um script em um nó é abordado separadamente em Mapeamento condicional.

Adicionar um Script¶

Adicionar um script em um campo pode ser feito em modo de mapeamento ou modo 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 em adicione o ícone 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 em ícone de 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¶

Sobre 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 de 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 de script de volta para a exibição do bloco original, clique em ícone de colapso.

Abra o Editor de Script Completo¶

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

Remover o Script¶

Para remover o script, basta excluir 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 dentro do aba Objetos de origem.

Em um script de transformação, você pode referenciar dados de origem inserindo o caminho de referência de um campo ou pode referenciar nós de dados de origem inserindo o caminho de referência de um 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 para 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 no local 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, incluindo a adição de 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 dentro do 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 seu cursor dentro do script. Ao inserir a sintaxe da função, o primeiro argumento da função fica destacado e seu 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 dentro do aba Variáveis.

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

Para adicionar a sintaxe 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 a digitar 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 mapeamento de variáveis, incluindo a adição de uma variável ao script. Para obter detalhes adicionais, consulte Variáveis em Jitterbit Script.

Adicionar um Plugin¶

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

Dentro de um script, você pode usar um plugin como um 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 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 a digitar 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 dentro do aba Operações.

Em 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 ambos 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 da 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 dentro do aba Notificações.

Dentro de um script, você pode referenciar uma notificação como um argumento para o SendEmailMessage função inserindo o caminho de referência de 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 ambos os SendEmailMessage função e a referência de notificação.
• Clique duas vezes na notificação na paleta para inserir a referência de 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 de notificação.
• Insira manualmente a referência de notificação.

Para um exemplo, consulte Notificações em Jitterbit Script.

Adicionar um Script¶

Na paleta de componentes, uma lista de outros scripts que estão disponíveis para uso em um script é fornecida dentro do aba Scripts.

Dentro de um script, você pode referenciar outro script como um argumento para o RunScript 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 ambos os RunScript função 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 de script.
• Insira manualmente a referência do script.

Para um exemplo, veja 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 dentro do aba Endpoints.

Em um script, você pode referenciar endpoints como um argumento para funções inserindo o caminho de referência de conexão ou 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.

Editar Ou Remover um Mapeamento¶

Enquanto em modo de mapeamento ou modo script, 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 mapeamento no modo de mapeamento.
• Editar ou remover um mapeamento no modo script.