Testar um script no Jitterbit Studio

Introdução

O modo de teste oferece funcionalidade básica de depuração onde você pode testar os resultados de um script inserindo valores para testar como entrada do script.

Esteja ciente de que, dependendo do conteúdo de um script, às vezes um script pode falhar ao testar, mas ainda assim ser executado com sucesso quando implantado e executado em um agente. Um teste executa apenas o script sendo testado, portanto uma variável que obtém seu valor durante a execução precisa de um valor em tempo de design para recorrer:

• Uma variável global requer um valor padrão definido no campo de configuração que a referencia.
• Uma variável de projeto requer um valor no campo Valor padrão de sua configuração.

Isso se aplica a variáveis referenciadas nos campos de configuração de um endpoint, bem como a variáveis usadas diretamente no script.

O script usado para teste tem um limite de tamanho de 51200 bytes. Este limite não se aplica além do teste.

Usar pontos de interrupção

Em Jitterbit Scripts, você pode usar a função DebugBreak, que atua como um ponto de interrupção para a execução do script. Quando um script é testado, o mecanismo Jitterbit Script interrompe a execução quando atinge uma chamada para DebugBreak. Ele envia de volta informações sobre o estado atual para o cliente, incluindo os valores de todos os elementos de dados, tanto elementos de dados de origem quanto elementos de dados globais. Isso oferece uma maneira poderosa de testar a lógica que você coloca no script.

A função DebugBreak aceita opcionalmente um valor boolean. Se verdadeiro, a execução quebra na instrução ao testar. Se falso, o ponto de interrupção é ignorado ao testar. Isso permite que você configure cenários de teste sofisticados controlados por variáveis de entrada, permitindo que você teste partes de um script dependendo das configurações. Para mais informações sobre como usar DebugBreak, consulte Funções de depuração.

Em JavaScripts, você pode ver e validar os valores das variáveis assim como faria para Jitterbit Scripts. No entanto, a depuração não está disponível em JavaScript e o uso de pontos de interrupção não é suportado.

Executar um teste

Dentro do editor de script, use o botão de alternância Editar/Testar (ou botão Testar no painel de script) para selecionar o modo Testar:

Em seguida, clique no botão Executar teste para executar um teste:

Executar teste

Considerações de implantação

Quando você clica no botão Executar teste, uma caixa de diálogo de implantação é exibida se um script chama outros componentes do projeto que não foram implantados ou foram alterados desde a última implantação. A caixa de diálogo exibida depende da validade dos componentes referenciados.

• Implantação necessária: Se todos os componentes referenciados forem válidos, a caixa de diálogo contém uma lista dos componentes que requerem implantação para teste de script. Clique em Implantar e testar para implantar os componentes listados e executar o teste:

Clique em Cancelar para fechar o diálogo sem implantar os componentes listados. O teste não será executado.

• Não foi possível implantar: Se os componentes referenciados forem inválidos, o diálogo contém uma lista dos componentes inválidos e o motivo da invalidade. Os itens inválidos devem ser corrigidos para executar o teste com sucesso. Clique em Continuar para fechar o diálogo:

  Texto do diálogo

  Não foi possível implantar
  Seu projeto não pode ser implantado devido ao(s) seguinte(s) item(ns) inválido(s). Corrija estes erros e tente novamente:

  Componente 1
  Explicação do motivo pelo qual o componente é inválido.

  
  Continuar

• Implantar projeto: Se scripts autônomos não implantados (não associados a uma operação) ou variáveis de projeto forem referenciados, o diálogo contém uma lista do que precisa ser implantado com uma implantação de projeto para executar o teste com sucesso. Clique em Continuar para fechar o diálogo:

  Texto do diálogo

  Implantar projeto
  Estes itens foram alterados desde a última implantação. Implante o projeto primeiro.

  Tipo de componente
  Componente 1

  
  Continuar

Consulte Implantar e executar uma operação e Implantar um projeto para obter mais informações sobre implantações. Se nenhuma implantação for necessária, nenhum diálogo de implantação será exibido e o teste será executado automaticamente.

Interface de teste

Ao executar um teste, as informações relevantes são exibidas em uma tabela contendo cada variável usada no script com colunas redimensionáveis:

• Nome: O nome da variável. Se o nome for maior que o tamanho atual da coluna, será truncado por padrão e visível como uma dica de ferramenta ao passar o mouse.

  Um botão Copiar nome para a área de transferência também é exibido ao passar o mouse para sua conveniência.

• Valor: O valor atual da variável. Selecione para editar o valor da variável quando o script não estiver em execução. Se o valor for maior que o tamanho atual da coluna, será truncado por padrão e visível como uma dica de ferramenta ao passar o mouse.

  Se o valor não for null, um botão Copiar valor para a área de transferência também é exibido ao passar o mouse para sua conveniência.

• É nulo: Indica se a variável é null. Selecione para definir o valor da variável como null quando o script não estiver em execução.

Quando um teste é iniciado ou retomado, todos os novos valores são enviados de volta ao mecanismo de script.

Você pode percorrer o processo de depuração usando os controles na parte superior da tabela:

Você também tem a opção de desativar pontos de interrupção. Ative Desativar ponto de interrupção se desejar que o teste ignore todas as chamadas para DebugBreak e, em vez disso, execute até a conclusão. Esta opção é aplicável apenas para Jitterbit Scripts.

Para procurar uma variável específica por nome, use a caixa de pesquisa para inserir uma palavra-chave ou várias palavras-chave separadas por vírgulas. As variáveis que têm qualquer parte das palavras-chave no nome da variável são retornadas.

Para redefinir todos os valores, clique no botão Redefinir valores acima da tabela.

Por fim, o Resultado é exibido em uma segunda tabela que aparece abaixo da primeira:

• Jitterbit Script: A tabela Resultado exibe a saída resultante da última instrução do script (se nenhum ponto de interrupção estiver presente) ou a saída resultante após cada ponto de interrupção.
• JavaScript: A tabela Resultado exibe os resultados do script conforme definido pelas funções SetScriptOutput ou SetScriptResult.

Além disso, todas as mensagens de erro incorridas durante o teste também são exibidas.