Habilitar registro para formulários HTML5

Você pode configurar o utilitário logger para começar a criar logs para formulários HTML5. O utilitário logger tem vários níveis. Você pode definir um nível de acordo com seus requisitos. Os formulários HTML5 têm componentes de servidor e cliente. Você pode configurar logs para ambos os componentes.

Configurando o registro do lado do servidor

Execute as seguintes etapas para configurar os logs do lado do servidor:

  1. Ir para https://'[server]:[port]'/system/console/configMgr. Localize e abra a opção Apace Sling logging logger configuration . Uma caixa de diálogo é exibida:

    Caixa de diálogo da opção de configuração do logger de registro do Apache Sling

    Opção de configuração do logger de registro do Apache Sling

  2. Altere o Nível de Log para Depuração.

  3. Especifique o nome e o caminho do Arquivo de Log.

    OBSERVAÇÃO

    Para gerar logs no diretório de log de formulários HTML5, adicione …/logs/ antes do nome do arquivo.

  4. Altere Logger para HTMLFormsPerfLogger. Clique em Salvar.

Configurando o registro de cliente

Você pode usar os seguintes métodos para ativar o logon no lado do cliente em formulários HTML5:

  • Uso do parâmetro de solicitação chamado log
  • Uso do Gerenciador de configuração do CQ

Ativar o registro usando o parâmetro de solicitação

Usando este método, você pode gerar logs para uma solicitação específica. O nome do parâmetro da solicitação é log. O URL de log é o seguinte:

https://<server>:<port>/content/xfaforms/profiles/test.html?contentRoot=<path of the folder containing form xdp>&template=<name of the xdp>&log=<log configuration>.

A configuração do log é composta pelo nível do log e pela categoria do logger.

Destino do Log

Destino do log Descrição
1 Os registros são direcionados para o navegador Console
2 Os logs são coletados em um objeto JavaScript no lado do cliente e podem ser publicados em Server
3 Ambas as opções acima

Níveis de Log

Nível de registro Descrição
0 DESLIGADO
1 FATAL
2 ERRO
3 AVISO
4 INFO
5 DEPURAR
6 TRACE
7 TODAS

Categorias de logger

Categoria de Log Descrição
uma sessão gerenciada no quadro branco xfa (registros relacionados ao mecanismo de scripts)
b xfaView (registros relacionados ao mecanismo de layout)
c xfaPerf (registros relacionados ao desempenho)

Configuração de Log

No URL de log, o parâmetro da string de consulta de configuração de log é definido da seguinte maneira:

{destination}-{a level}-{b level}-{c level}

Por exemplo:

Configuração de registro Descrição
2-a4-b5-c6
 Destino: Servidor
nível xfa: INFO
nível xfaView: Nível DEBUG
xfaPerf: TRACE
OBSERVAÇÃO

O nível de log padrão para cada categoria de log a (xfa), b (xfaView) e c (xfaPerf) é 2 (ERRO). Assim, para configuração de log: 2-b6, os níveis de log para categorias diferentes são:
a xfa: 2 (ERRO de nível padrão)
b (xfaView): 6 (TRACE especificado pelo usuário)
a (xfaPerf): 2 (ERRO de nível padrão)

Ativar o registro utilizando o Configuration Manager

Se você usar o Configuration Manager para ativar o registro, os registros serão gerados para cada solicitação de renderização até que o registro seja desativado novamente.

  1. Faça logon no CQ Configuration Manager em https://'[server]:[port]'/system/console/configMgr e faça logon com credenciais de administrador.

  2. Procure por e clique em Configurações de Forms Móvel.

  3. Na caixa de texto Opções de depuração , digite as configurações de log conforme descrito na seção anterior, por exemplo, 2-a4-b5-c6

    Configuração de formulários

    Configuração de formulários

Upload de logs

Se o destino for definido como 1, todas as mensagens de log do script do cliente serão direcionadas para o console. Se um administrador exigir esses logs, juntamente com os logs do servidor, defina o nível de destino como 2. Nesse nível, todos os logs são coletados em um objeto JS no lado do cliente e, se o formulário for renderizado com o Perfil padrão, um botão Enviar logs será exibido à esquerda do botão Realçar campos existentes na barra de ferramentas. Quando o usuário clica no link, todos os logs coletados são publicados no servidor e são registrados no arquivo de log de erros configurado no servidor.

Por padrão, todas as informações são adicionadas ao arquivo error.log no diretório /crx-repository/logs/ .

Para alterar o local e o nome do arquivo de log:

  1. Faça logon no Configuration Manager como administrador. O URL padrão do Configuration Manager é https://'[server]:[port]'/system/console/configMgr.

  2. Clique em Apache Sling Logging Logger Configuration. Uma caixa de diálogo é exibida.

    logconfig-1

  3. Altere o Nível de Log para Depurar.

  4. Especifique o caminho e o nome do Arquivo de Log.

    OBSERVAÇÃO

    Para criar logs no mesmo diretório em que outros arquivos de log são mantidos, especifique …/logs/<filename> na propriedade Arquivos de Log.

  5. Altere o Agente de log para HTMLFormsPerfLogger e clique em Salvar.

Nesta página