Testar um script no Jitterbit Studio

Introdução

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

Esteja ciente de que, dependendo do conteúdo de um script, às vezes um script pode falhar durante o teste, mas ainda assim ser executado com sucesso quando implantado e executado em um agente. Isso pode acontecer se, por exemplo, você não tiver um valor padrão definido para uma variável global que obtém seu valor durante a execução.

O script utilizado para teste tem uma limitação de tamanho de 51200 bytes. Este limite não se aplica além do teste.

Usar pontos de interrupção

Em Scripts Jitterbit, 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 de script Jitterbit 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 fornece uma maneira poderosa de testar a lógica que você colocou no script.

A função DebugBreak aceita opcionalmente um valor booleano. Se verdadeiro, a execução é interrompida na instrução durante o teste. Se falso, o ponto de interrupção é ignorado durante o teste. Isso permite que você configure cenários de teste sofisticados que são 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, veja Funções de depuração.

Em JavaScripts, você pode ver e validar os valores das variáveis assim como faria para Scripts Jitterbit. 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 scripts, use o botão de alternância Editar/Testar (ou o botão Testar no painel de scripts) para selecionar o modo Testar:

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

Executar teste

Considerações sobre a implantação

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

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

  Texto do diálogo

  Implantação necessária
  Testar este script requer a implantação destes componentes:

  Tipo de componente
  Componente 1

  
  Implantar e testarCancelar

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

• Impossível implantar: Se os componentes referenciados forem inválidos, o diálogo contém uma lista dos componentes inválidos e o motivo pelo qual são inválidos. Os itens inválidos devem ser corrigidos para que o teste seja executado com sucesso. Clique em Continuar para fechar o diálogo:

  Texto do diálogo

  Impossível implantar
  Seu projeto não pode ser implantado devido ao(s) seguinte(s) item(ns) inválido(s). Por favor, corrija esses erros e tente novamente:

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

  
  Continuar

• Implantar projeto: Se scripts independentes 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
  Esses itens foram alterados desde a última implantação. Por favor, implante o projeto primeiro.

  Componente 1

  
  Continuar

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

Interface de teste

Ao executar um teste, 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 do que o tamanho atual da coluna, ele é 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 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 do que o tamanho atual da coluna, ele é 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 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, quaisquer novos valores são enviados de volta para o 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 os pontos de interrupção. Ative Desativar Ponto de Interrupção se quiser 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 Scripts Jitterbit.

Para buscar uma variável específica pelo nome, use a caixa de pesquisa para inserir uma palavra-chave ou várias palavras-chave separadas por vírgulas. Variáveis que contê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.

Finalmente, o Resultado é mostrado na segunda tabela que aparece abaixo da primeira:

• Script Jitterbit: A tabela Resultado exibe a saída resultante da última instrução do script (se não houver pontos de interrupção presentes), 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, quaisquer mensagens de erro ocorridas durante o teste também são exibidas.