Depuração de formulários HTML5 debugging-html-forms

CAUTION
AEM 6.4 chegou ao fim do suporte estendido e esta documentação não é mais atualizada. Para obter mais detalhes, consulte nossa períodos de assistência técnica. Encontre as versões compatíveis here.

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 em log de formulários do 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 problem-when-rendering-the-form-i-see-org-apache-sling-api-slingexception-exception-page

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 é 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.

Problema: Não é possível renderizar um formulário (uma mensagem de erro é exibida) problem-unable-to-render-a-form-an-error-message-is-displayed

  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.

    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: Renderizações de formulário sem estilos problem-form-renders-without-styles

  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.

    • 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.

    code language-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 adobe-lc-forms-runtime-pkg-<version>pacote .zip novamente.

Problema: Erro inesperado encontrado problem-unexpected-error-encountered

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

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

Problema: Não é possível enviar o formulário problem-unable-to-submit-the-form

  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. Habilite 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, como 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 são exibidas problem-localized-error-messages-do-not-display

  1. Renderizar o formulário com um 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 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.

    code language-none
    ../Namespace.js
    I18N.js
    ../LogMessages.js
    

Problema: Imagem não exibida problem-image-not-showing-up

  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, 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 é 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.

recommendation-more-help
a6ebf046-2b8b-4543-bd46-42a0d77792da