Activer la journalisation des formulaires au format HTML5 enable-logging-for-html-forms

Vous pouvez configurer l'utilitaire de journal pour créer des journaux pour les formulaires HTML5. L’utilitaire de journal possède plusieurs niveaux, vous pouvez définir le niveau selon vos besoins. Les formulaires HTML5 possèdent des composants de serveur et de client. Vous pouvez configurer des journaux pour chaque composant.

Configuration de la journalisation côté serveur configuring-server-side-logging

Effectuez les étapes suivantes pour configurer les journaux côté serveur :

  1. Accédez à https://'[server]:[port]'/system/console/configMgr. Recherchez et ouvrez l’option Configuration des journaux de journalisation Apache Sling. Une boîte de dialogue s’affiche:

    Boîte de dialogue des options de configuration des journaux de journalisation

    Option de configuration des journaux de journalisation Apache Sling

  2. Remplacez le Niveau de journal par Débogage.

  3. Spécifiez le chemin et le nom du fichier journal.

    note note
    NOTE
    Pour générer des journaux dans le répertoire de formulaires HTML5, ajoutez …/logs/ avant le nom de fichier.
  4. Modifiez Logger en HTMLFormsPerfLogger. Cliquez sur Enregistrer.

Configuration de la journalisation côté client configuring-client-logging

Vous pouvez utiliser les méthodes suivantes pour activer la journalisation côté client dans les formulaires HTML5 :

  • A l’aide du paramètre de requête nommé log
  • A l’aide de CQ Configuration Manager

Activation de la journalisation à l’aide du paramètre de requête enabling-logging-using-request-parameter

Grâce à cette méthode, vous pouvez générer des journaux pour une requête spécifique. Le nom du paramètre de requête est log. L’URL du journal se présente comme suit :

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 configuration du journal comprend le niveau et la catégorie de journalisation.

Destination du journal log-destination

Destination du journal
Description
1
Les journaux sont dirigés vers la Console du navigateur.
2
Les journaux sont collectés dans un objet JavaScript côté client et peuvent être publiés sur le serveur
3
Les deux options ci-dessus

Niveaux de journalisation log-levels

Niveau de journal
Description
0
DÉSACTIVÉ
1
FATAL
2
ERROR
3
WARN
4
INFO
5
DEBUG
6
TRACE
7
ALL

Catégories d’utilitaire de journal logger-categories

Catégorie de journal
Description
une
xfa (journaux liés au moteur de script)
b
xfaView (journaux liés au moteur de disposition)
c
xfaPerf (journaux liés aux performances)

Configuration des journaux log-configuration

Dans l’URL du journal, le paramètre de chaîne de requête de configuration du journal est défini comme suit :

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

Par exemple :

Configuration des journaux
Description
2-a4-b5-c6
Destination : serveur
niveau xfa : INFO
niveau xfaView : DEBUG
niveau xfaPerf : TRACE
NOTE
Le niveau de journalisation par défaut de chaque catégorie de journalisation a (xfa), b (xfaView) et c (xfaPerf) est de 2 (ERROR). Par conséquent, pour la configuration de journal 2-b6, les niveaux de journalisation pour les différentes catégories sont les suivants :
a (xfa) : 2 (niveau par défaut ERROR)
b (xfaView) : 6 (TRACE spécifié par l’utilisateur)
a (xfaPerf) : 2 (niveau par défaut ERROR)

Activation de la journalisation à l’aide de Configuration Manager enabling-logging-using-configuration-manager

Si vous utilisez Configuration Manager pour activer la journalisation, les journaux sont générés pour chaque demande de rendu jusqu’à ce que la journalisation soit de nouveau désactivée.

  1. Connectez-vous à CQ Configuration Manager à l’adresse https://'[server]:[port]'/system/console/configMgr à lʼaide de vos informations d’identification d’administrateur.

  2. Recherchez Configurations des formulaires mobiles et cliquez dessus.

  3. Dans la zone de texte Options de débogage, saisissez les configurations des journaux comme décrit dans la section précédente. Par exemple : 2-a4-b5-c6

    Configuration de formulaires

    Configuration de formulaires

Chargement des journaux uploading-logs

Si la destination est définie sur 1, tous les messages de journal de script client sont dirigés vers la console. Si un administrateur a besoin de ces journaux ainsi que des journaux de serveur, définissez le niveau de destination sur 2. À ce niveau, tous les journaux sont rassemblés dans un objet JS côté client et, si le formulaire est généré avec le profil par défaut, un bouton Envoyer des journaux apparaît à gauche du bouton Mettre les champs existants en surbrillance dans la barre d’outils. Lorsque l’utilisateur clique sur le lien, tous les journaux rassemblés sont publiés sur le serveur et consignés dans le fichier de journalisation des erreurs configuré sur le serveur.

Par défaut, toutes les informations sont ajoutées dans le fichier error.log du répertoire /crx-repository/logs/.

Pour modifier l’emplacement et le nom du fichier journal :

  1. Connectez-vous à Configuration Manager en tant qu’administrateur. L’URL de Configuration Manager définie par défaut est https://'[server]:[port]'/system/console/configMgr.

  2. Cliquez sur Configuration des journaux de journalisation Sling d’Apache. Une boîte de dialogue s’affiche.

    logconfig-1

  3. Remplacez le Niveau de journal par Débogage.

  4. Spécifiez le chemin d’accès et le nom du fichier journal.

    note note
    NOTE
    Pour créer des journaux dans le répertoire où les autres fichiers journaux sont conservés, spécifiez …/logs/<nom_fichier> dans la propriété Fichiers journaux.
  5. Modifiez Logger en HTMLFormsPerfLogger et cliquez sur Enregistrer.

recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2