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

Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now