O Designer inclui vários recursos e estratégias para depurar cálculos e scripts, dependendo da linguagem de script escolhida.
Para a depuração do script da linguagem JavaScript, você pode usar os métodos alert ou messageBox para fornecer o retorno da depuração. Uma desvantagem deste método é que você precisa fechar muitas caixas de mensagem. Outro problema é que exibir uma caixa de mensagem pode causar diferenças no comportamento do formulário, principalmente se você está tentando depurar um script que define o foco para um objeto em seu formulário. É melhor usar o console.println para produzir o texto para o JavaScript Console do Acrobat para depurar um formulário.
Mensagens de aviso e validação da paleta Relatório do Designer
A paleta Relatório fornece mensagens de aviso e validação para ajudar a depurar um formulário enquanto você o projeta. A guia Aviso permite visualizar erros ou mensagens que o Designer gerou enquanto você projetava um formulário. A guia Log permite visualizar os seguintes erros e mensagens:
Mensagens de validação
Erros de execução do script JavaScript ou FormCalc
Erros de renderização de formulário no momento da criação, gerados ao importar ou salvar um formulário, ou ao visualizar um formulário usando a guia Visualizar PDF.
Para obter mais informações sobre como usar a paleta Relatório, consulte Como usar a área de trabalho para depurar cálculos e scripts.
Fornecimento de retorno da depuração usando o método messageBox
O método messageBox do Modelo de objeto de formulário XML permite inserir informações de um formulário interativo em uma caixa de diálogo em tempo de execução. Você pode aproveitar as vantagens do método messageBox do Modelo de objeto de formulário XML para exibir mensagens ou valores de campo no tempo de execução. Quando iniciado, o método messageBox exibe um valor de string em uma nova caixa de diálogo do aplicativo cliente. O valor da string pode ser uma mensagem de texto criada para depuração ou o valor da string de campos ou expressões.
Por exemplo, considere um cenário com um design de formulário simples que contém um único campo numérico (NumericField1) e um botão (Button1). Nesse caso, cada cálculo FormCalc e script JavaScript a seguir coloca uma mensagem exibindo algum texto e o valor exibido no momento no campo numérico. Ao adicionar o cálculo ou o script ao evento click do objeto de botão, é possível exibir interativamente o valor do campo numérico em uma nova caixa de diálogo clicando no botão.
FormCalc
xfa.host.messageBox(Concat("The value of NumericField1 is: ",
NumericField1), "Debugging", 3)
JavaScript
xfa.host.messageBox("The value of NumericField1 is: " +
NumericField1.rawValue, "Debugging", 3);
Importante: O método messageBox retorna um valor inteiro que representa o botão selecionado pelo usuário na caixa de diálogo de mensagem. Se o método messageBox for anexado ao evento calculate de um objeto de campo e o método messagebox for a última linha do script, o campo exibirá o valor de retorno do método messageBox em tempo de execução.
Para obter mais informações sobre como usar o messageBox, consulte messageBox
Inserção de informações em um campo de texto
Você pode inserir informações, como valores de campos ou mensagens, em um campo de texto do design de formulário. Por exemplo, é possível anexar novas mensagens ou valores ao valor de um campo de texto para criar um log para referência posterior.