Ir para o conteúdo

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 executar 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 ações adicionais 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.

Nota

A linguagem de script usada nas transformações é limitada a Jitterbit Script. Os Scripts usados nas operações podem usar Jitterbit Script ou JavaScript.

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:

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:

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

Item do menu
Descrição
visualizar edição Visualizar/Editar abre o editor de script para você construir o script (consulte Editor de Script).
corte Cut coloca uma cópia do script na área de transferência e exclui o script original do projeto (consulte Reutilização de componentes).
cópia de Copiar coloca uma cópia do script na área de transferência (consulte Reutilização de componentes).
duplicado Duplicado cria um script novo e não referenciado usando a mesma configuração do script original (consulte Reutilização de componente).
renomear Renomear posiciona o cursor no nome do script para você fazer as edições necessárias.
ver dependências 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 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 Excluir exclui permanentemente o script (consulte Dependências, exclusão e remoção de componentes).
remover 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 add 2 no canto superior direito de um campo de destino para abrir um menu de ações. No menu, selecione Adicionar Script:

campo de destino 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 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:

objetos de origem cortados

Para visualizar o editor de script completo com todas as opções disponíveis para o script, clique no ícone popout 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 menu de ações 22 para abrir o menu de ações. No menu, selecione Adicionar condição ao nó:

condição de adição do nó de destino

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.

condição se

Para visualizar o editor de script completo com todas as opções disponíveis para o script de condição, clique no ícone popout 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 menu de ações 22 para abrir o menu de ações. No menu, selecione Editar condição ou Remover condição:

condição de remoção do nó de destino

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