Tipos e Criação de Script¶

Introdução¶

Os Scripts, escritos em Jitterbit Script ou JavaScript, fornecem flexibilidade e poder para transformar dados, realizar cálculos ou realizar validação lógica além do simples mapeamento de campos.

Os Scripts podem ser usados em vários locais, inclusive na quadro de design como etapas de uma operação, bem como em transformações para aplicar lógica ou condições especificadas aos dados. As etapas para criar um script e executar outras ações em um script são diferentes dependendo do tipo de script, conforme abordado nesta página.

Tipos de Script¶

Existem três tipos distintos de scripts que diferem na forma como são criados e usados:

• Script como componente do projeto
  Este tipo de script pode ser usado como uma etapa em uma operação e/ou chamado usando o RunScript função. Esse tipo de script aparece como um componente do projeto na paleta de componentes de script e também no painel do projeto. A linguagem de script pode ser Jitterbit Script ou JavaScript.

• Script em um campo de destino em uma transformação
  Este tipo de script pode ser criado em um campo em uma transformação para aplicar a lógica especificada ao mapeamento da transformação. O último valor retornado no script é usado como valor para o campo de destino. Esse tipo de script está disponível somente em campos de destino em um mapeamento de transformação. A linguagem de script deve ser Jitterbit Script.

• script de condição em um nó de destino em uma transformação
  Este tipo de script pode ser aplicado em um nó em uma transformação para determinar se o registro de origem que está sendo processado deve ser enviado para o destino. Se o script for avaliado como true, então o registro será gerado. Se o resultado do script for avaliado como false, o registro será ignorado. Esse tipo de script está disponível somente em nós de destino em um mapeamento de transformação. A linguagem de script deve ser Jitterbit Script.

Script Como Componente do Projeto¶

Este tipo de script é um componente do projeto que pode ser usado como uma etapa de uma operação ou chamado por outro script usando o comando RunScript função. Por exemplo, você poderia usar um script como uma etapa em uma operação antes ou depois de uma atividade para recuperar dados e depois processar a lógica do script, ou você poderia executar um script de validação antes de prosseguir para uma transformação.

Crie um Script¶

Um novo script como componente do projeto pode ser criado a partir destes locais:

• A guia Componentes do aba do projeto usando a opção Criar novo na categoria Scripts (consulte Menu Ações da categoria em Guia Componentes do painel do projeto).
• A quadro de design usando uma área de inserção (consulte Menu Ações da zona para soltar em Quadro de Design).

Novos scripts são criados com o nome padrão Novo Script. As novas transformações subsequentes com nomes padrão são anexadas com um número incrementado entre parênteses.

Ao criar um novo script, o editor de script abre para você configurar o script (veja Editor de Script).

Menu de Ações de Script¶

Depois que um script como componente do projeto é criado, as ações de menu desse script ficam acessíveis nestes locais:

• A guia Workflows do aba do projeto (consulte Menu Ações do componente em Guia Workflows do painel do projeto).
• A aba Componentes do painel do projeto (consulte Menu Ações do componente em Guia Componentes do painel do projeto).
• A quadro de design (consulte Menu Ações do componente em Quadro de Design).

Cada uma destas ações de menu está disponível:

Item do menu	Descrição
	Visualizar/Editar abre o editor de script para você construir o script (consulte Editor de Script).
	Cut coloca uma cópia do script na área de transferência e exclui o script original do projeto (consulte Reutilização de componentes).
	Copiar coloca uma cópia do script na área de transferência (consulte Reutilização de componentes).
	Duplicado cria um script novo e não referenciado usando a mesma configuração do script original (consulte Reutilização de componente).
	Renomear posiciona o cursor no nome do script para você fazer as edições necessárias.
	Visualizar dependências altera a visualização no painel do projeto para exibir quaisquer outras partes do projeto das quais o script específico depende (consulte Dependências, exclusão e remoção de componentes).
	Adicionar ao grupo abre uma caixa de diálogo para criar um novo grupo personalizado ou para adicionar o script a um grupo existente (consulte Grupos de componentes).
	Excluir exclui permanentemente o script (consulte Dependências, exclusão e remoção de componentes).
	Remover remove referências ao script como uma etapa de operação na quadro de design (consulte Dependências, exclusão e remoção de componentes).

Script em um Campo de Destino em uma Transformação¶

Este tipo de script pode ser adicionado a um campo em uma transformação para aplicar a lógica especificada ao mapeamento da transformação. O último valor retornado no script é usado como valor para o campo de destino. Por exemplo, você poderia usar scripts para alterar dados de campo de um string para um integer, concatenar valores ou usar uma pesquisa de banco de dados para um campo.

A criação de um novo script em um campo de destino é feita durante o mapeamento de transformação em modo de mapeamento ou modo de script e está limitado a Jitterbit Script linguagem.

Para adicionar um novo script em um campo de destino, clique duas vezes no nome do campo ou 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:

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.

Eles abrem 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:

Para visualizar o editor de script completo com todas as opções disponíveis para o script, clique no ícone popout no canto superior direito. Para obter detalhes, consulte Editor de Script. Feche o editor de script completo para retornar a esta tela.

Para remover o script, simplesmente exclua o texto do script. Para obter mais informações sobre esse tipo de script, consulte Mapeamento com Scripts.

Script de Condição em um Nó de Destino em uma Transformação¶

Um script de condição é criado em um nó de destino em uma transformação para determinar se o registro de origem que está sendo processado deve ser enviado para o destino com base em uma condição definida. A condição determina (sim ou não) se o registro está mapeado. Como parte dessa determinação, você pode incluir lógica para definir quais valores serão usados no mapeamento. Por exemplo, um registro só poderá ser usado se o tamanho de um campo de texto for menor que um máximo especificado.

A criação de um novo script em um nó de destino é feita durante o mapeamento de transformação em modo de mapeamento ou modo de script e está limitado a Jitterbit Script linguagem. As condições podem ser adicionadas como scripts em nós de destino em qualquer nível de uma estrutura de dados.

Para adicionar um novo script em um nó de destino, passe o mouse sobre o nome do nó e clique no ícone do menu de ações para abrir o menu de ações. No menu, selecione Adicionar condição ao nó:

Isso abre a área de script editável no nó de destino no modo de script, onde você pode inserir ou editar a lógica do script de condição conforme apropriado. Por exemplo, o seguinte script de condição requer que o objeto de origem CleanStatus avalia para true para que o registro seja processado. Se CleanStatus avalia para false, o nó será ignorado e esse registro específico não será processado.

Para visualizar o editor de script completo com todas as opções disponíveis para o script de condição, clique no ícone popout no canto superior direito. Para obter detalhes, consulte Editor de Script. Feche o editor de script completo para retornar a esta tela.

Para editar ou remover a condição, passe o mouse sobre o nome do nó e clique no ícone do menu de ações para abrir o menu de ações. No menu, selecione Editar condição ou Remover condição:

Para obter mais informações sobre esse tipo de script, consulte Mapeamento Condicional.