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.
Führen Sie die folgenden Schritte aus, um serverseitige Protokolle zu konfigurieren:
Rufen Sie https://'[server]:[port]'/system/console/configMgr
auf. Suchen und öffnen Sie die Option Apache Sling Logging Logger configuration . Folgendes Dialogfeld wird angezeigt:
Apache Sling Logging Logger-Konfigurations-Option
Ändern Sie die Protokollierungsstufe in Debug.
Geben Sie den Namen und Pfad der Protokolldatei an.
Wenn Sie Protokolle im Protokollordner für HTML5-Formulare generieren möchten, stellen Sie dem Dateinamen „…/logs/“ voran.
Ändern Sie Logger in HTMLFormsPerfLogger. Klicken Sie auf Speichern.
Um die clientseitige Protokollierung in HTML5-Formularen zu aktivieren, können Sie die folgenden Verfahren verwenden:
log
Mit dieser Methode können Sie Protokolle für eine bestimmte Anforderung generieren. Der Name des Anforderungsparameters ist 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 | Beschreibung |
---|---|
1 | Protokolle werden an den Browser Console weitergeleitet |
2 | Protokolle werden in einem JavaScript-Objekt auf Clientseite erfasst und können unter Server veröffentlicht werden |
3 | Beide der oben genannten Optionen |
Protokollebene | Beschreibung |
---|---|
0 | AUS |
1 | FATAL |
2 | ERROR |
1 | WARN |
4 | INFO |
5 | DEBUG |
6 | TRACE |
7 | ALL |
Protokollkategorie | Beschreibung |
---|---|
eine | xfa (auf Scripting-Engine bezogene Protokolle) |
b | xfaView (auf Layout-Engine bezogene Protokolle) |
c | xfaPerf (leistungsbezogene Protokolle) |
In der Protokoll-URL wird der Abfragezeichenfolgen-Parameter zur 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 |
Die Standardprotokollebene für jede Protokollkategorie – a (xfa), b (xfaView) und c (xfaPerf) – ist 2 (ERROR). Entsprechend lauten bei der Protokollkonfiguration 2-b6 die Protokollebenen für die verschiedenen Kategorien:
a (xfa): 2 (FEHLER DER Standardebene)
b (xfaView): 6 (vom Benutzer angegebenes TRACE)
a (xfaPerf): 2 (FEHLER DER Standardebene)
Wenn Sie Configuration Manager zum Aktivieren der Protokollierung verwenden, werden Protokolle für jede Rendering-Anforderung generiert, bis die Protokollierung erneut deaktiviert wird.
Melden Sie sich bei CQ Configuration Manager unter https://'[server]:[port]'/system/console/configMgr
an und melden Sie sich mit Administratorberechtigungen an.
Suchen Sie nach Mobile Forms Configurations und klicken Sie darauf.
Geben Sie im Textfeld "Debug Options" die Protokollkonfigurationen ein, wie sie im letzten Abschnitt beschrieben sind, z. B. 2a4-b5-c6
Formularkonfiguration
Wenn als Ziel 1 eingestellt ist, werden alle clientseitigen Skriptprotokollmeldungen an die Konsole geleitet. Wenn ein Administrator diese Protokolle zusammen mit Serverprotokollen benötigt, setzen Sie die Zielebene auf 2. Auf dieser Ebene werden alle Protokolle in einem JS-Objekt auf Clientseite erfasst. Wenn das Formular mit dem Standardprofil wiedergegeben wird, wird links neben der Schaltfläche Vorhandene Felder markieren die Schaltfläche Protokolle senden angezeigt. Wenn der Benutzer auf den Link klickt, werden alle erfassten Protokolle an den Server gesendet 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.
Speicherort und Namen der Protokolldatei ändern:
Melden Sie sich beim Configuration Manager als Administrator an. Die Standard-URL von Configuration Manager lautet https://'[server]:[port]'/system/console/configMgr
.
Klicken Sie auf Apache Sling Logging Logger-Konfiguration. Folgendes Dialogfeld wird angezeigt.
Ändern Sie die Protokollierungsstufe in Debug.
Geben Sie den Pfad und den Namen der Protokolldatei an.
Um Protokolle im selben Ordner zu erstellen, in dem bereits andere Protokolldateien enthalten sind, geben Sie in den Eigenschaften der Protokolldateien …/logs/<filename> an.
Ändern Sie Logger in HTMLFormsPerfLogger und klicken Sie auf Save.