Aktivieren der Protokollierung für HTML5-Formulare enable-logging-for-html-forms

CAUTION
AEM 6.4 hat das Ende der erweiterten Unterstützung erreicht und diese Dokumentation wird nicht mehr aktualisiert. Weitere Informationen finden Sie in unserer technische Unterstützung. Unterstützte Versionen suchen here.

Sie können das Dienstprogramm der Protokollfunktion konfigurieren, um mit der Erstellung von Protokollen für HTML5-Formularen zu beginnen. Das Dienstprogramm der Protokollfunktion bietet mehrere Stufen, unter denen Sie die für Ihre Zwecke geeignete wählen können. Für HTML5-Formulare sind Server- und Client-Komponenten vorhanden. Sie können Protokolle für beide Komponenten konfigurieren.

Serverseitige Protokollierung konfigurieren configuring-server-side-logging

Führen Sie die folgenden Schritte aus, um serverseitige Protokolle zu konfigurieren:

  1. Rufen Sie https://[server]:[port]/system/console/configMgr auf. Suchen Sie die Option Apache Sling Logging Logger-Konfiguration und öffnen Sie sie. Folgendes Dialogfeld wird angezeigt:

    Dialogfeld mit Apache Sling Logging Logger-Konfigurations-Optionen

    Apache Sling Logging Logger-Konfigurations-Option

  2. Ändern Sie die Protokollierungsstufe in Debug.

  3. Geben Sie den Namen und den Pfad der Protokolldatei an.

    note note
    NOTE
    Wenn Sie Protokolle im Protokollordner für HTML5-Formulare generieren möchten, stellen Sie dem Dateinamen „…/logs/“ voran.
  4. Ändern Sie Logger in HTMLFormsPerfLogger. Klicken Sie auf Speichern.

Client-Protokollierung konfigurieren configuring-client-logging

Sie können die folgenden Methoden verwenden, um die clientseitige Protokollierung in HTML5-Formularen zu aktivieren:

  • Mithilfe des Anforderungsparameters log
  • Verwenden von CQ Configuration Manager

Aktivieren der Protokollierung mithilfe des Anforderungsparameters enabling-logging-using-request-parameter

Mit dieser Methode können Sie Protokolle für eine bestimmte Anforderung generieren. Der Name des Anforderungsparameters lautet log. Die Protokoll-URL lautet wie folgt:

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

Die Protokollkonfiguration besteht aus der Protokollebene und der Protokollfunktionskategorie.

Protokollziel log-destination

Protokollziel
Beschreibung
1
Protokolle werden an den Browser weitergeleitet Konsole
2
Die Protokolle werden in einem JavaScript-Objekt auf Client-Seite erfasst und können an den Server gesendet werden.
3
Beide der oben genannten Optionen

Protokollebenen log-levels

Protokollebene
Beschreibung
0
AUS
1
FATAL
2
ERROR
3
WARN
4
INFO
5
DEBUG
6
TRACE
7
ALL

Protokollfunktionskategorien logger-categories

Protokollkategorie
Beschreibung
eine
xfa (auf Scripting-Engine bezogene Protokolle)
b
xfaView (auf Layout-Engine bezogene Protokolle)
c
xfaPerf (leistungsbezogene Protokolle)

Protokollkonfiguration log-configuration

In der Protokoll-URL wird der Abfragezeichenfolgenparameter für die Protokollkonfiguration wie folgt definiert:

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

Beispiel:

Protokollkonfiguration
Beschreibung
2-a4-b5-c6
Ziel: Server
xfa-Ebene: INFO
xfaView-Ebene: DEBUG
xfaPerf-Ebene: TRACE
NOTE
Die standardmäßige Protokollebene für jede Protokollkategorie a (xfa), b (xfaView) und c (xfaPerf) ist 2 (ERROR). Entsprechend gilt für die Protokollkonfiguration: 2-b6 Die Protokollebenen für verschiedene Kategorien sind:
a (xfa): 2 (FEHLER der Standardebene)
b (xfaView): 6 (vom Benutzer angegebenes TRACE)
a (xfaPerf): 2 (FEHLER der Standardebene)

Aktivieren der Protokollierung über den Configuration Manager enabling-logging-using-configuration-manager

Wenn Sie Configuration Manager zur Aktivierung der Protokollierung verwenden, werden für jede Render-Anforderung so lange Protokolle generiert, bis die Protokollierung wieder deaktiviert wird.

  1. Melden Sie sich bei CQ Configuration Manager unter https://[server]:[port]/system/console/configMgr an und melden Sie sich mit Administratorberechtigungen an.

  2. Suchen Sie nach und klicken Sie auf Mobile Forms-Konfigurationen.

  3. Geben Sie im Textfeld „Debug Options“ die Protokollkonfigurationen ein, wie sie im letzten Abschnitt beschrieben sind, z. B. 2a4-b5-c6

    Formularkonfiguration

    Formularkonfiguration

Hochladen von Protokollen uploading-logs

Wenn das Ziel auf 1 gesetzt ist, werden alle Protokollmeldungen des Client-Skripts an die Konsole weitergeleitet. Wenn ein Administrator diese Protokolle zusammen mit dem Server-Protokollen benötigt, setzen Sie die Zielebene auf 2. Auf dieser Ebene werden alle Protokolle in einem JS-Objekt auf Client-Seite erfasst. Wenn ein Formular mit einem Standardprofil gerendert wird, wird in der Symbolleiste links neben der Schaltfläche Vorhandene Felder hervorheben eine Schaltfläche Protokolle senden angezeigt. Wenn der Benutzer auf den Link klickt, werden alle erfassten Protokolle an den Server geleitet und in der konfigurierten Fehlerprotokolldatei auf dem Server protokolliert.

Standardmäßig werden alle Daten der Datei „error.log“ im Ordner „/crx-repository/logs/“ hinzugefügt.

So ändern Sie Speicherort und Namen der Protokolldatei:

  1. Melden Sie sich bei Configuration Manager als Admin an. Die Standard-URL von Configuration Manager lautet https://[*Server*]:[*Port*]/system/console/configMgr.

  2. Klicken Apache Sling Logging Logger-Konfiguration. Folgendes Dialogfeld wird angezeigt.

    logconfig-1

  3. Ändern Sie die Protokollierungsstufe in Debug.

  4. Geben Sie Pfad und Namen der Protokolldatei an.

    note note
    NOTE
    Um Protokolle im selben Ordner zu erstellen, in dem bereits andere Protokolldateien enthalten sind, geben Sie in den Eigenschaften der Protokolldateien …/logs/<filename> an.
  5. Ändern Sie den Logger in HTMLFormsPerfLogger und klicken Sie auf Speichern.

recommendation-more-help
a6ebf046-2b8b-4543-bd46-42a0d77792da