Abilita la registrazione per i moduli HTML5

È possibile configurare l'utilità logger per iniziare a creare registri per i moduli HTML5. L'utilità logger ha vari livelli, è possibile impostare un livello in base alle proprie esigenze. I moduli HTML5 hanno 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 l’opzione Configurazione del logger di registrazione di Apache Sling . 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. Cambia il Livello di log in Debug.

  3. Specificare il nome e il percorso del File di log.

    NOTA

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

  4. Cambia Logger in HTMLFormsPerfLogger. Fai clic su Salva.

Configurazione della registrazione client

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

  • Utilizzando il parametro della 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 inviati a Server
3 Entrambe le opzioni sopra riportate

Livelli di registro

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

Categorie di logger

Categoria registro Descrizione
una sessione lavagna 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: Livello server
xfa: Livello INFO
xfaView: Livello DEBUG
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 mobili.

  3. Nella casella di testo Opzioni di debug, immetti le configurazioni del registro come descritto nella sezione precedente, ad esempio 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, viene visualizzato un pulsante Invia registri a sinistra del pulsante 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 logger di registrazione Sling Apache. Viene visualizzata una finestra di dialogo.

    logconfig-1

  3. Cambia il Livello di log in Debug.

  4. Specificare il percorso e il nome del 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. Cambia il logger in HTMLFormsPerfLogger e fai clic su Salva.

In questa pagina