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

CAUTION
AEM 6.4 a atteint la fin de la prise en charge étendue et cette documentation n’est plus mise à jour. Pour plus d’informations, voir notre période de support technique. Rechercher les versions prises en charge here.

Vous pouvez configurer l’utilitaire de journalisation pour commencer à créer des journaux pour les formulaires HTML5. L’utilitaire de journalisation comporte plusieurs niveaux. Vous pouvez définir un niveau en fonction de vos besoins. HTML5 forms comporte des composants serveur et 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 du client configuring-client-logging

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

  • A l’aide du paramètre de requête nommé log
  • Utilisation 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 le navigateur. Console
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 journal log-levels

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

Catégories de journalisation logger-categories

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

Configuration du journal 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 du journal
Description
2-a4-b5-c6
Destination : Serveur
niveau xfa : INFO
niveau xfaView : DEBUG
niveau xfaPerf : TRACE
NOTE
Le niveau de journalisation par défaut pour chaque catégorie de logs a (xfa), b (xfaView) et c (xfaPerf) est de 2 (ERROR). En conséquence, pour la configuration des logs : 2-b6, les niveaux de journal des 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 et cliquez sur Configurations de Mobile Forms.

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

    Configuration de formulaires

    Configuration de formulaires

Chargement des logs uploading-logs

Si la destination est définie sur 1, tous les messages du 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
a6ebf046-2b8b-4543-bd46-42a0d77792da