Tipos de Script e Criação

Introdução

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

Os Scripts podem ser usados em vários lugares, incluindo dentro do quadro de design como etapas de uma operação, bem como dentro de 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 um 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. Este tipo de script aparece como um componente de projeto dentro da paleta de componentes de script, bem como dentro do painel de 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 de transformação. O último valor retornado no script é usado como o valor para o campo de destino. Este tipo de script está disponível somente em campos de destino em um mapeamento de transformação. A linguagem do 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 é emitido. Se o resultado do script for avaliado como false, então o registro é ignorado. Este tipo de script está disponível somente em nós de destino em um mapeamento de transformação. A linguagem do script deve ser Jitterbit Script.

Script Como um Componente do Projeto

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

Criar um Script

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

• A aba Componentes do painel do projeto usando a opção Criar novo na categoria Scripts (consulte menu de ações da aba Componentes na aba Componentes do painel Projeto).
• A quadro de design usando uma área de inserção (veja menu de ações da zona de lançamento em Tela de design).

Novos scripts são criados com o nome padrão New Script. 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 é aberto para você configurar o script (consulte Editor de Script).

Menu de Ações do Script

Depois que um script como um componente do projeto é criado, as ações de menu para esse script podem ser acessadas nestes locais:

• A aba Workflows do painel do projeto (consulte menu de ações do componente na aba Workflows do painel Projeto).
• A aba Componentes do painel do projeto (consulte menu de ações do componente na aba Componentes do painel Projeto).
• A quadro de design (veja menu de ações do componente em Tela de design).

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

Item de menu	Descrição
	Exibir/Editar abre o editor de script para você construir o script (veja Editor de Script).
	Cortar coloca uma cópia do script na sua área de transferência e exclui o script original do projeto (consulte Reutilização de componentes).
	Copiar coloca uma cópia do script na sua área de transferência (veja Reutilização de componentes).
	Duplicar cria um novo script não referenciado usando a mesma configuração do script original (consulte Reutilização de componentes).
	Renomear posiciona o cursor no nome do script para que você faça as edições necessárias.
	Exibir dependências altera a exibiçã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).TABLEROWEND
	Adicionar ao grupo abre uma caixa de diálogo para criar um novo grupo personalizado ou adicionar o script a um grupo existente (consulte Grupos de componentes).
	Excluir exclui permanentemente o script (consulte Dependências de componentes, exclusão e remoção).
	Remover remove referências ao script como uma etapa de operação na quadro de design (consulte Dependências de componentes, exclusão e remoção).

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

Este tipo de script pode ser adicionado 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 o valor para o campo de destino. Como exemplo, você pode 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 script e é 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 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:

Para editar um script em um campo de destino que já tenha um mapeamento, clique duas vezes no nome do campo ou clique em ícone de 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 de script para o mapeamento:

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

Para remover o script, basta excluir 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 é mapeado. Como parte dessa determinação, você pode incluir lógica para definir quais valores são usados no mapeamento. Por exemplo, um registro pode ser usado somente 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 script e é limitado a Jitterbit Script idioma. 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 em í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 script de condição a seguir requer que o objeto de origem CleanStatus avalia para true para que o registro seja processado. Se CleanStatus avalia para false, então o nó é ignorado e este registro em particular 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 em ícone popout no canto superior direito. Para detalhes, veja 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 em í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.