Gibt es Fehler?

Diese Seite befindet sich aktuell im Aufbau. Die Inhalte können teilweise noch fehlerhaft sein.

Fehler in FirstSpirit-Vorlagen können an unterschiedlichen Stellen des Entwicklungsprozesses auftreten oder herausgefunden werden:

• Auf einige Syntaxfehler in FirstSpirit-Vorlagen wird bereits direkt beim Entwickeln hingewiesen: Werden beispielsweise Parameter oder Attribute in Formularen falsch verwendet, lassen sich Vorlagen nicht speichern und es wird eine entsprechende Fehlerbegründung angezeigt.
• Ob Formulare das gewünschte Aussehen und die gewünschte Funktion haben, kann direkt in der integrierten Vorschau auf dem Register „Formular“ geprüft werden.
• Um Eingaben auf den Ausgabekanal-Registern prüfen und ihre Auswirkung direkt anhand von bestehenden Inhalten sehen zu können, kann auf dem Register „Eigenschaften“ im Feld „Vorschau Seite“ (für Seitenvorlagen siehe Register Eigenschaften) eine Seitenreferenz definiert werden, die die Inhalte der betreffenden Vorlagen rendert und als Vorschau für den Ausgabekanal der Vorlage verwendet werden soll.
• Bei der Berechnung der Vorschau und bei der Generierung werden die von den Redakteuren in die Formulare eingegebenen Inhalte mit den Anweisungen der Ausgabekanal-Register miteinander kombiniert. Die Schritte der Auswertung der FirstSpirit-Syntax und der verwendeten Beschreibungssprache (z. B. HTML) wird protokolliert und dabei Fehler besonders hervorgehoben.
  • Fehler bei der Berechnung der Vorschau können über den Kontextmenü-Eintrag „Fehler der Vorschau anzeigen“ auf Seiten und Seitenreferenzen im SiteArchitect angezeigt werden. Per Klick kann direkt zur fehlerhaften Stelle in der betreffenden Vorlage springen.
    Beispiele: Syntax- und logische Fehler, fehlende Referenzen
  • Fehler bei der Generierung werden in einer gesonderten Log-Datei festgehalten: fs-schedule.*.log.
    Beispiele: Hinweise auf deprecatete Methoden, Funktionen usw., Syntax- und logische Fehler, fehlende Referenzen
• Allgemeine Informationen zum Betrieb des FirstSpirit-Servers und auch zu Aktionen und Fehlern in Projekten enthält die Datei fs-server.log („Server-Log“).
• Einige Fehler werden trotz aller Sorgfalt erst beim konkreten Anwenden der Vorlagen im Projekt herausgefunden. Damit diese nicht erst durch die Redakteure gefunden werden, ist es empfehlenswert, Vorlagen auf einem Testsystem zu entwickeln, sie zu testen und erst nach erfolgreichen Tests produktiv zu verwenden. Dabei wird der Vorlagenentwickler beispielsweise durch die Funktion ContentTransport unterstützt.

Aktivieren von zusätzlichem Logging

1) Für die gezielte Fehlersuche kann in Vorlagen temporär folgende Zeile eingefügt werden:

$CMS_VALUE(#global.logError"xxx")$ 

Im Log sieht man die aufrufende(n) Stelle(n).

2) Klasse de.espirit.common.Logging

3) context.log*()-Methoden

Beispiel:

context.logDebug("Hello World!")

Siehe Seite zum Skripting

4) Erweiterter Fehler-Protokollierungs-Modus

$CMS_SET(#global.debugMode,true)$

Siehe Seite vorschaubezogene #global-Aufrufe