Depuração de formulários HTML5

Este documento inclui vários cenários de solução de problemas. Para cada cenário, algumas etapas são fornecidas para solucionar o problema. Siga estas etapas e, se o problema persistir, configure o Logger para obter e revisar os logs quanto a erros/avisos. Para obter mais detalhes sobre o registro de formulários HTML5, consulte Geração de logs para formulários HTML5.

Problema: Ao renderizar o formulário, vejo a página de exceção org.apache.sling.api.SlingException

Nos detalhes da exceção, procure a palavra causada por.

O motivo provável é que um ou mais parâmetros no URL estão incorretos.

Verifique os seguintes parâmetros:

Parâmetro Descrição
template O nome do arquivo do modelo
contentRoot O caminho onde o modelo e os recursos associados residem
dataRef Caminho absoluto do arquivo de dados que é unido ao modelo.
Observação: Path define o caminho absoluto do arquivo de dados.
data Bytes de dados codificados UTF-8 que são mesclados com o modelo.

Problema: Não é possível renderizar um formulário (uma mensagem de erro é exibida)

  1. Verifique se os parâmetros especificados estão corretos. Para obter informações detalhadas sobre parâmetros, consulte Renderizar parâmetros.

  2. Faça logon no Gerenciador de pacotes do CRX (em https://<server>:<port>/crx/packmgr/index.jsp) e verifique se os seguintes pacotes estão instalados corretamente:

    • adobe-lc-forms-content-pkg-<versão>.zip
    • adobe-lc-forms-runtime-pkg-<versão>.zip

  3. Faça logon no Console da Web CQ (Felix Console) em https://<server>:<port>/system/console/bundles.

    Certifique-se de que o status dos seguintes pacotes esteja "ativo":

    • escala-lang.bundle [osgi]

    (com.adobe.livecyclescala-lang.bundle)

    • Renderizador Forms do Adobe XFA

    (com.adobe.livecycle.adobe-lc-forms-core)

    • Conector LC do Adobe XFA Forms

    (com.adobe.livecycle.adobe-lc-forms-lc-connector)

Problema: O formulário é renderizado sem estilos

  1. No seu navegador, abra Ferramentas do desenvolvedor. Certifique-se de que profile.css esteja disponível.

  2. Se o arquivo profile.css não estiver disponível, faça logon no CRX DE em https://<server>:<port>/crx/de.

  3. Na hierarquia de pastas à esquerda, navegue até /etc/clientlibs/fd/xfaforms/. Abra os arquivos css.txt listados nas pastas.

    • o perfil do visitante
    • tempo de execução
    • scrollnav
    • toolbar
    • xfalib

  4. Verifique se os arquivos mencionados no css.txt estão presentes no CRX DE lite em /libs/fd/xfaforms/clientlibs/xfalib/css.

    #base=css
application.css
dialog.css
datepicker.css
scribble.css
listboxwidget.css

  5. Se os arquivos mencionados não estiverem disponíveis, instale o pacote adobe-lc-forms-runtime-pkg-<version>.zip novamente.

Problema: Erro inesperado encontrado

  1. No URL do formulário, adicione um parâmetro de consulta debugClientLibs e defina seu valor como true (Por exemplo: https://<server>:<port>/content/xfaforms/profiles/test.html?contentRoot=<some path>&template=<name of xdp file>&log=1-a9-b9-c9&debugClientLibs=true)

  2. No navegador de desktop como o chrome, acesse Ferramentas do desenvolvedor -> Console.

  3. Abra os logs para identificar o tipo de erro. Para obter informações detalhadas sobre logs, consulte logs para formulários HTML5.

  4. Acesse Ferramentas do desenvolvedor -> Console. Use o rastreamento de pilha para localizar o código que está causando o erro. Depurar o erro para resolver o problema.

    OBSERVAÇÃO

    Se houver falha no script, verifique se o mesmo problema ocorre durante a renderização do formulário em PDF. Em caso afirmativo, há um problema na lógica de script de formulário.

Problema: Não é possível enviar o formulário

  1. Certifique-se de ter direitos para acessar o servidor AEM e estar conectado ao servidor.
  2. Verifique se o parâmetro submitUrl está correto.
  3. Ative os logs do lado do cliente, conforme mencionado em Registros para os formulários HTML5 usando a opção de depuração como 1-a5-b5-c5. Em seguida, renderize o formulário e clique em enviar. Abra o console de depuração do navegador e verifique se há um erro.
  4. Localize os logs do servidor, conforme mencionado em Registros para os formulários HTML5. Verifique se houve algum erro nos logs do servidor durante o envio.

Problema: Mensagens de erro localizadas não exibem

  1. Renderize o formulário com o parâmetro de consulta adicional debugClientLibs=true no navegador do desktop e acesse Ferramentas do desenvolvedor -> Recursos e verifique o arquivo I18N.css.

  2. Se o arquivo não estiver disponível, faça logon no CRX DE em https://<server>:<port>/crx/de.

  3. Na hierarquia de pastas à esquerda, navegue até /libs/fd/xfaforms/clientlibs/I18N e verifique se os seguintes arquivos e pastas existem:

    • Namespace.js
    • LogMessages.js
    • Pastas para idiomas

  4. Se algum dos arquivos ou pastas acima não existir, instale o pacote adobe-lc-forms-runtime-pkg-<version>.zip novamente.

  5. Navegue até a pasta que tem o mesmo nome do local e verifique seu conteúdo. A pasta deve conter os seguintes arquivos:

    • I18N.js
    • js.txt

  6. Verifique o conteúdo de js.txt e verifique se ele tem as seguintes entradas.

    ../Namespace.js
I18N.js
../LogMessages.js

Problema: Imagem não mostrando

  1. Certifique-se de que o URL da imagem esteja correto.

  2. Verifique se o navegador aceita esse tipo de imagem.

  3. Nos detalhes da exceção, procure a palavra causada por.

    O motivo provável é que um ou mais parâmetros no URL estão incorretos.

    Verifique os seguintes parâmetros:
    Texto da etapa

Parâmetro Descrição
modelo O nome do arquivo do modelo
contentRoot O caminho onde o modelo e os recursos associados residem
dataRef Caminho absoluto do arquivo de dados que é unido ao modelo.
Observação: Path define o caminho absoluto do arquivo de dados.
dados Bytes de dados codificados UTF-8 que são mesclados com o modelo.

  1. No navegador do desktop, acesse Ferramentas do desenvolvedor -> Recursos.

    Verifique o lado esquerdo em Quadros se essa imagem for exibida.

Nesta página