Depurar o Construtor de Fórmulas¶

O Formula Builder oferece funcionalidade básica de depuração por meio do uso da função especial DebugBreak, que atua como um breakpoint para a execução do script.

Quando um script ou mapeamento é testado, o mecanismo de script Jitterbit interrompe a execução quando atinge uma chamada para DebugBreak. Ele envia informações sobre o estado atual para o cliente, incluindo os valores de todos os elementos de dados, tanto os elementos de dados de origem quanto os elementos de dados globais. Isso fornece uma maneira poderosa de testar a lógica que você coloca no script.

Ao executar um teste, o Formula Builder alterna automaticamente para a aba Test (veja a captura de tela abaixo). Aqui você pode ver os valores atuais de todas as variáveis de script, na tabela Data Elements. Quando parado em um ponto de interrupção, você também pode alterar o valor de uma variável clicando na coluna Valor. O novo valor inserido é enviado de volta ao mecanismo de script quando o teste é retomado. O valor e o tipo de uma variável também são exibidos em um pop-up se você passar o mouse sobre o nome da variável na área de expressão.

Você também pode controlar o processo de depuração por meio de uma linha de botões na barra de ferramentas da guia Test. Da esquerda para a direita, esses botões são:

• Iniciar teste: Inicia um novo teste. Este botão é desativado se um teste já estiver em execução.

• Retomar a sessão de teste atual:** Quando o teste é interrompido em um ponto de interrupção, clicar neste botão retoma o teste. O teste será executado até chegar a outro ponto de interrupção ou até ser concluído.

• Execute a próxima instrução no teste atual:** Quando o teste for interrompido em um ponto de interrupção, clique neste botão para executar apenas a próxima instrução do script. Isso permite que você percorra o script linha por linha.

• Interromper a sessão de teste atual:** Isso interrompe o teste atual.

• Desativar pontos de interrupção:** Marque esta caixa de seleção se desejar que o teste ignore todas as chamadas para DebugBreak e, em vez disso, apenas execute até a conclusão.

Apenas um teste pode ser executado por vez. Se você tentar iniciar um novo teste enquanto outro estiver em execução, receberá uma mensagem de erro solicitando que pare primeiro o teste atual. O teste atual pode ser interrompido na abaTeste ou no menu Ações de nível superior na janela principal (Ações > Parar teste atual).

O DebugBreak a função só é chamada quando você executa um teste de uma operação, transformação ou script. Quando o script é executado fora de um teste (como na produção), o mecanismo de script ignora DebugBreak; DebugBreakas chamadas não precisam ser removidas dos scripts no código de produção.

Esta captura de tela mostra a aba Teste, com um script parado em um ponto de interrupção. Observe como a localização do ponto de interrupção é marcada por uma pequena seta na margem esquerda da área de expressão:

DebugBreakaceita opcionalmente um valor booleano. Se verdadeiro, a execução será interrompida na instrução durante o teste. Se falso, o ponto de interrupção será 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 seu script dependendo das configurações.