Show Menu
TÓPICOS×

Ativar o registro em log para formulários HTML5

Você pode configurar o utilitário logger para start criando registros para formulários HTML5. O utilitário logger tem vários níveis, você pode definir um nível conforme suas necessidades. Os formulários HTML5 têm componentes de servidor e cliente. Você pode configurar registros para ambos os componentes.

Configuração do registro no servidor

Execute as seguintes etapas para configurar os registros do servidor:
  1. Ir para https://'[server]:[port]'/system/console/configMgr . Localize e abra a opção de configuração do agente de log do Apace Sling. Uma caixa de diálogo é exibida:
    Opção de configuração do agente de log do Apace Sling
  2. Altere o Nível do log para Depuração .
  3. Especifique o nome e o caminho do Arquivo de Log.
    Para gerar logs no diretório de log de formulários HTML5, adicione ../logs/ antes do nome do arquivo.
  4. Altere o Logger para HTMLFormsPerfLogger . Clique em Salvar .

Configurando o registro de cliente

Você pode usar os seguintes métodos para habilitar o logon do lado do cliente em formulários HTML5:
  • Uso do parâmetro request nomeado log
  • Uso do CQ Configuration Manager

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

Usando esse método, você pode gerar logs para uma solicitação específica. O nome do parâmetro request é `log. O URL do 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 registro

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

Níveis de registro

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

Categorias do registrador

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

Configuração do registro

No URL do log, o parâmetro da string de configuração do query é definido da seguinte forma:
{destination}-{a level}-{b level}-{c level}
Por exemplo:
Configuração do registro Descrição
2-a4-b5-c6 Destino: Nível xfa do servidor : Nível de INFO xfaView: Nível DEBUG xfaPerf: TRAÇ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)

Habilitar o registro usando 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 desabilitado novamente.
  1. Faça logon no CQ Configuration Manager em https://'[server]:[port]'/system/console/configMgr e faça logon com as credenciais de administrador.
  2. Procure e clique em Configurações de formulários móveis.
  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

Carregar logs

Se o destino for definido como 1, todas as mensagens de log de 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 registros 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 registros 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 (Configuração do registrador Apache Sling). Uma caixa de diálogo é exibida.
  3. Altere o Nível do log para Depuração.
  4. Especifique o caminho e o nome do Arquivo de Log.
    Para criar logs no mesmo diretório onde outros arquivos de log são mantidos, especifique ../logs/<nome do arquivo> na propriedade Arquivos de Log.
  5. Altere o Logger para HTMLFormsPerfLogger e clique em Salvar .