Version 431.23 von MACH formsolutions am 15.10.2025

Zeige letzte Bearbeiter
1 **Inhaltsverzeichnis:**
2
3 {{toc start="2"/}}
4
5 ## CSS-Einstellungen für Assistenten
6
7 Mit **CSS**-Anweisungen (Cascading Style Sheets) können Sie die visuelle Gestaltung Ihrer veröffentlichten Assistenten verändern. Damit gleichen Sie die Assistenten optisch nahtlos an Ihre Website und Ihre gewohnte Corporate Identity an.
8 Die Einstellungen werden zentral verwaltet und sind für alle Assistenten gültig.
9
10 Änderungen im CSS-Bereich können die Barrierefreiheit der Anwendung beeinträchtigen.
11
12 ### Organisations-Konfiguration aufrufen
13
14 **Voraussetzung:** Benutzerrecht **Layout verwalten**
15
16 Klicken Sie im Formulareditor in der [[Hauptwerkzeugleiste|doc:Main.05_Assistenten.01_Hauptwerkzeugleiste.WebHome]] die Schaltfläche Administration an.![[Schaltfläche Administration|Main.05_Assistenten.01_Hauptwerkzeugleiste.WebHome@HauptwerkzeugleisteCSS.jpg]]
17
18 {{icon name="far fa-arrow-right"}}{{/icon}}Der Dialog **Organisations-Konfiguration** öffnet sich.
19
20 ### Reiter "CSS"
21
22 Verweisen Sie auf eine externe Quelle, aus der die CSS-Anweisungen geladen werden (**externes CSS**), oder tragen Sie Anweisungen/Code direkt in der Konfiguration ein (**internes CSS**).
23
24 Im Feld **externes CSS (URL)** kann die Internetadresse einer CSS-Datei eingetragen werden, auf die der Formularserver Zugriff hat.
25 Beim Feld **internes CSS** können alle gängigen CSS-Regeln verwendet werden.
26
27 Über **Attribute** können spezifische Assistenten, Panels oder Komponenten ausgewählt werden.
28
29 | Attribut | Beschreibung | Beispiel |
30 | ------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -------------------------------------------------------------------------------------------- |
31 | data-assistant-identifier | Wert ist die Artikelnummer
32 Elternknoten für die Attribute "`data-panel-identifier`" und "`data-component-identifier`" | [data-assistant-identifier="KFAS_123456"] h2 { color: orange !important; } |
33 | data-panel-identifier | Wert ist die technische Bezeichnung des Panels
34 Elternknoten für das Attribut "`data-component-identifer`" | [data-panel-identifier="Beispielpanel_1"] h2 { color: yellow !important; } |
35 | data-component-identifier | Wert ist die technische Bezeichnung der Komponente
36 Unterhalb des Attributs "`data-panel-identifier`" können mehrere Attribute "`data-component-identifier`" vorkommen. Verschachtelte Komponenten werden mit Punkten zwischen den technischen Bezeichnungen getrennt als Wert dargestellt. Beispiel: _Objektgruppenname.Komponentenname_ | [data-component-identifier="Textfeld (einzeilig)"] input{ border-color: orange !important; } |
37
38
39
40 ### Reiter "CSS-Generator"
41
42 Legen Sie Hintergrundfarbe und Textfarbe mithilfe eines Farbwählers fest, und wählen Sie Schriftarten aus.
43
44 Generiere
45
46 Mittels des integrierten CSS-Generators hat der Benutzer die Möglichkeit, verschiedenste optische Anpassungen per GUI vorzunehmen. Für die Hintergrund- und Schriftfarbe wird ein Colorpicker zur Verfügung gestellt, mit welchem die entsprechenden Farben ausgewählt werden können. Des Weiteren können Schriftarten spezifiziert werden. Nach dem Generieren der vorgenommenen Einstellungen wird im Eingabefeld „internes CSS“ die entsprechenden CSS-Anweisungen eingefügt.
47
48 ## Rubrik „JavaScript“
49
50 Im der Rubrik „JavaScript“ kann für den Mandanten Assistenten übgreifendes JavaScript hinterlegt werden. Weitere Informationen zu den Möglichkeiten JavaScript zu hinterlegen finden Sie [[hier|Main.05_Assistenten.04_Assistentenbauoberfläche.15_JavaScript]].
51
52 > {{icon name="far fa-info-circle" size="3"/}} _**Hinweis:**_ Diese Funktion funktioniert derzeit nur für die Bereiche Assistenten ausfüllen/einreichen, [[Payment|Main.07_Einstellungen-Fachadministration.03_Module.01_Payment]] und [[eID|Main.07_Einstellungen-Fachadministration.03_Module.05_eID]].
53
54 ### Externe Bibliotheken
55
56 In der Rubrik JavaScript kann nach der Hinterlegung einer URL und der Prüfsumme über externe Bibliotheken JavaScript hinterlegt werden. Die Prüfsumme bietet die Möglichkeit die eingebundene Ressource auf ihre Korrektheit zu überprüfen. Bevor die Ressource in den Assistenten geladen wird, wird die Prüfsumme verifiziert. Wenn die Ressource gültig ist, wird diese geladen. Falls nicht, wird die Ressource vom Browser ignoriert. Wenn keine Prüfsumme angegeben wird, wird die Ressource trotzdem vom Browser geladen.
57
58 ### Generierte Platzhalter
59
60 Über die Schaltflächen können Platzhalter in den Editor eingefügt werden. Diese Platzhalter werden zur Laufzeit des Assistenten dynamisch mit dem jeweiligen Wert ersetzt.
61
62 ### Internes JavaScript
63
64 In dem Editor kann das kundenspezifische JavaScript eingefügt werden. Dieses wird zur Laufzeit des Assistenten ausgeführt.
65
66 > {{icon name="far fa-info-circle" size="3"/}} _**Hinweis:**_ Das konfigurierte JavaScript ist mandantenweit hinterlegt und wird somit in jedem Assistenten auf jedem Panel ausgeführt.
67
68 ![[Ansicht des JavaScript Bereichs|@CSSJavaScript_befüllt.jpg]]