Abilitare la registrazione per i moduli HTML5

È possibile configurare l’utility logger per avviare la creazione di registri per i moduli HTML5. L'utilità logger ha vari livelli, è possibile impostare un livello in base alle proprie esigenze. HTML5 forms dispone di componenti server e client. Puoi configurare i registri per entrambi i componenti.

Configurazione della registrazione lato server

Esegui i seguenti passaggi per configurare i registri lato server:

  1. Passa a https://'[server]:[port]'/system/console/configMgr. Individua e apri la Configurazione del logger di registrazione di Apache Sling opzione . Viene visualizzata una finestra di dialogo:

    Finestra di dialogo delle opzioni di configurazione del logger di registrazione di Apache Sling

    Opzione di configurazione del logger di registrazione di Apache Sling

  2. Modificare la Livello di log a Debug.

  3. Specifica nome e percorso del File di log.

    NOTA

    Per generare i registri nella directory di registro dei moduli di HTML5, aggiungi …/logs/ prima del nome del file.

  4. Modifica Registratore a HTMLFormsPerfLogger. Fai clic su Salva.

Configurazione della registrazione client

Per abilitare la registrazione lato client nei moduli HTML5 è possibile utilizzare i metodi seguenti:

  • Utilizzo del parametro di richiesta denominato log
  • Utilizzo di CQ Configuration Manager

Abilitazione della registrazione utilizzando il parametro di richiesta

Utilizzando questo metodo, puoi generare registri per una particolare richiesta. Il nome del parametro della richiesta è log. L’URL del registro è il seguente:

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

La configurazione del registro è composta dal livello di registro e dalla categoria logger.

Destinazione log

Destinazione log Descrizione
1 I registri vengono indirizzati al browser Console
2 I registri vengono raccolti in un oggetto JavaScript sul lato client e possono essere pubblicati in Server
3 Entrambe le opzioni di cui sopra

Livelli di log

Livello registro Descrizione
0 DISATTIVATO
1 GRASSETTO
2 ERRORE
3 AVVISO
4 INFO
5 DEBUG
6 TRACE
7 TUTTO

Categorie di logger

Categoria registro Descrizione
a xfa (registri relativi al motore di script)
b xfaView (registri relativi al motore di layout)
c xfaPerf (registri relativi alle prestazioni)

Configurazione del registro

Nell’URL del registro, il parametro della stringa di query per la configurazione del registro è definito come segue:

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

Esempio:

Configurazione del registro Descrizione
2-a4-b5-c6
 Destinazione: Server
livello xfa: INFORMAZIONI
livello xfaView: DEBUG
livello xfaPerf: TRACE
NOTA

Il livello di log predefinito per ogni categoria di log a (xfa), b (xfaView) e c (xfaPerf) è 2 (ERROR). Di conseguenza, per la configurazione del registro: 2-b6, i livelli di log per le diverse categorie sono:
a (xfa): 2 (livello predefinito ERROR)
b (xfaView): 6 (TRACE specificato dall'utente)
a (xfaPerf): 2 (livello predefinito ERROR)

Abilitazione della registrazione tramite Configuration Manager

Se si utilizza Configuration Manager per abilitare la registrazione, vengono generati i registri per ogni richiesta di rendering fino a quando la registrazione non viene nuovamente disabilitata.

  1. Accedi a CQ Configuration Manager all’indirizzo https://'[server]:[port]'/system/console/configMgr e accedi con le credenziali di amministratore.

  2. Cerca e fai clic su Configurazioni Forms per dispositivi mobili.

  3. Nella casella di testo Opzioni di debug, immetti le configurazioni del registro come descritto, ad esempio, nella sezione precedente, 2-a4-b5-c6

    Configurazione dei moduli

    Configurazione dei moduli

Caricamento dei registri

Se la destinazione è impostata su 1, tutti i messaggi di log degli script client vengono indirizzati alla console. Se un amministratore richiede questi registri insieme ai registri del server, imposta il livello di destinazione su 2. A questo livello, tutti i registri vengono raccolti in un oggetto JS sul lato client e, se viene eseguito il rendering del modulo con il profilo predefinito, un Registri di invio a sinistra di Evidenzia campi esistenti nella barra degli strumenti. Quando l'utente fa clic sul collegamento, tutti i registri raccolti vengono inviati al server e vengono registrati nel file di registro degli errori configurato sul server.

Per impostazione predefinita, tutte le informazioni vengono aggiunte al file error.log nella directory /crx-repository/logs/ .

Per modificare la posizione e il nome del file di log:

  1. Accedi a Configuration Manager come amministratore. L’URL predefinito di Configuration Manager è https://'[server]:[port]'/system/console/configMgr.

  2. Fai clic su Configurazione del logger di registrazione Sling di Apache. Viene visualizzata una finestra di dialogo.

    logconfig-1

  3. Modificare la Livello di log da eseguire il debug.

  4. Specificare il percorso e il nome dell'operatore File di log.

    NOTA

    Per creare i registri nella stessa directory in cui vengono conservati gli altri file di registro, specifica …/logs/<filename> nella proprietà File di registro.

  5. Modificare la Registratore a HTMLFormsPerfLogger e fai clic su Salva.

In questa pagina