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 logs para 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, pesquise por palavra causado 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
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 é mesclado com o modelo.
Observação: O caminho define o caminho absoluto do arquivo de dados.
dados Bytes de dados codificados por 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 Parâmetros de renderização.

  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-<version>.zip
    • adobe-lc-forms-runtime-pkg-<version>.zip

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

    Verifique se o status dos seguintes pacotes é "ativo":

    • scala-lang.bundle [osgi]

    (com.adobe.livecyescala-lang.bundle)

    • Renderizador de Forms do Adobe XFA

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

    • Conector Adobe XFA Forms LC

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

Problema: formulário é renderizado sem estilos

  1. No 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.

    • perfil
    • tempo de execução
    • scrollnav
    • barra de ferramentas
    • 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 arquivo adobe-lc-forms-runtime-pkg-<version>pacote .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="">&modelo=<name of="" xdp="" file="">&log=1-a9-b9-c9&debugClientLibs=true)

  2. No navegador do 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 registros 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 for uma falha de script, verifique se o mesmo problema ocorre durante a representação PDF do formulário também. Se sim, então há um problema na lógica do script de formulário.

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

  1. Verifique se você tem direitos de acesso ao servidor AEM e se está conectado ao servidor.
  2. Verifique se o parâmetro submitUrl está correto.
  3. Ative os registros do lado do cliente conforme mencionado em Logs 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 submit. Abra o console de depuração do navegador e verifique se há um erro.
  4. Localize os registros do servidor conforme mencionado em Logs para os formulários HTML5. Verifique se houve algum erro nos logs do servidor durante o envio.

Problema: as mensagens de erro localizadas não são exibidas

  1. Renderizar o formulário com parâmetro de consulta adicional debugClientLibs=true no navegador do desktop, 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 adobe-lc-forms-runtime-pkg-<version>.zip pacote novamente.

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

    • I18N.js
    • js.txt

  6. Verifique o conteúdo do js.txt e certifique-se de que ele tenha as entradas a seguir.

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

Problema: a imagem não é exibida

  1. Verifique se o URL da imagem está correto.

  2. Verifique se o navegador é compatível com esse tipo de imagem.

  3. Nos detalhes da exceção, pesquise por palavra causado 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 é mesclado com o modelo.
Observação: O caminho define o caminho absoluto do arquivo de dados.
dados Bytes de dados codificados por UTF-8 que são mesclados com o modelo.

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

    Verifique no lado esquerdo em Quadros se essa imagem é exibida.

Nesta página