Layout-Anpassung mithilfe von Skinning

Die visuelle Darstellung des Web Clients kann mithilfe von Skinning angepasst werden. Die dazu benötigten CSS-Dateien, Bilder und Bibliotheken können im Dateisystem gespeichert werden.

Web Client

Gehen Sie folgendermaßen vor, um einen angepassten Skin für den Web Client zu erstellen:

1. Erstellen Sie einen Ordner mit dem Namen design auf der Seite Datenverzeichnis. Der Speicherort des Datenverzeichnisses wird in der System-Property cmas-core-shared, data.directory festgelegt, siehe Datenverzeichnis.
2. Erstellen Sie im Verzeichnis design einen Ordner und setzen Sie die System-Property cmweb-server-adapter, themeOverlay auf den Namen dieses Ordners.
3. Fügen Sie die angepassten Layoutdateien hinzu. Es gibt zwei Möglichkeiten:
   • Sie können alles in den Theme-Ordner kopieren. Der Theme-Ordner kann eine oder mehrere Dateien mit dem angepassten Design enthalten.
   • Sie können eine Datei mit dem Namen theme_<folder name>.css erstellen. Ihr Inhalt wird mit der Standard-CSS-Datei zusammengeführt.
4. Die Änderungen an Dateien werden automatisch geladen. Wenn Sie neue Ordner erstellen, müssen Sie ConSol CM neu starten, um die Änderungen anzuwenden.

info

Wenn Sie die System-Property nicht setzen möchten, können Sie einen Unterordner mit dem Namen default erstellen und ihn für Ihre Skin-Dateien verwenden. ::

Das bestehende Standarddesign wird nur an den Stellen überschrieben, die im angepassten Skin explizit konfiguriert sind. Sie können daher zum Beispiel eine angepasste CSS-Datei erstellen, die nur die Einstellungen enthält, die im Vergleich zum Standarddesign geändert werden sollen. Dies erleichtert die Pflege der angepassten CSS-Datei nach ConSol CM-Aktualisierungen.

Authentifizierungsanwendung

Gehen Sie wie folgt vor, um einen angepassten Skin für die OIDC-Anmeldeseite des Web Clients zu erstellen:

1. Erstellen Sie eine Datei cmas-auth-user.properties. Der Speicherort hängt von der Deployment-Methode der Authentifizierungsanwendung ab:
   • Overlay-Deployment: Erstellen Sie die Datei im Verzeichnis bin des Applikationsservers.
   • Standalone-Deployment: Erstellen Sie die Datei im Verzeichnis der jar-Datei der Authentifizierungsanwendung.
2. Kopieren Sie den Pfad zu Ihrem Datenverzeichnis aus der System-Property cmas-core-shared, data.directory und fügen Sie die folgende Zeile zur Datei hinzu:

   spring.web.resources.static-locations=file:/<Pfad zum Datenverzeichnis>/design/auth/,classpath:/static/

3. Erstellen Sie auf der Seite Datenverzeichnis einen Unterordner auth im Verzeichnis design.
4. Fügen Sie die Dateien, die Sie überschreiben möchten, zum Verzeichnis auth hinzu. Sie müssen komplette Dateien überschreiben. Es ist nicht möglich, einzelne Stile zu überschreiben.

warnung

Wenn die Authentifizierungsanwendung im Standalone-Modus auf einem anderen Rechner ausgeführt wird, der keinen Zugriff auf das Datenverzeichnis hat, müssen Sie den Ordner auth auf diesem Rechner erstellen und ihn in der Property spring.web.resources.static-locations referenzieren.