Wiki-Quellcode von Leitfaden-Plugin

Zeige letzte Bearbeiter
1 [[**Plugin-Download**>>url:https://customer.formcycle.eu/index.php/apps/files/?dir=/FORMCYCLE%20-%20Plugins%20Customer/Leitfaden%3Aleitfaden-resources&fileid=25265||rel="noopener noreferrer" target="_blank"]] (erfordert Anmeldung)
2
3 {{content/}}
4
5 {{velocity}}
6 ##{{info}}
7 ##Hinweis, dass das für bayr. LK ist.
8 ##Über das //???? Plugin// werden Möglichkeiten zur Einbindung der AKDB Basisdienste **Bürgerkonto** und **Postkorb** in {{formcycle/}} bereitgestellt.
9 ##{{/info}}
10 ##{{figure image="formular_vorlage.png"}}
11 ##TBD
12 ##{{/figure}}
13 {{/velocity}}
14
15 == Vorbemerkungen ==
16
17 In dem vom Bayerischen Landkreistag und dem Bayerischen Staatsministerium für Digitales herausgegebenen [[//Leitfaden zur nutzerorientierten und einheitlichen Formulargestaltung für die bayerischen Landkreise//>>https://www.stmd.bayern.de/wp-content/uploads/2020/10/10-2020_Leitfaden-nutzerfreundlicher-Formulargestaltung.pdf||target="_blank"]] werden für die Umsetzung von Online-Formularen konkrete Vorschläge gemacht und Empfehlungen gegeben.
18
19 Das //Leitfaden-Plugin// stellt Funktionalitäten zur Verfügung, welche im Leitfaden beschrieben wurden, aber nicht standardmäßig in {{formcycle/}} umsetzbar sind.
20
21 {{velocity}}
22 ##Im folgenden wird nach allgemeinen Installationshinweisen zunächst beschrieben, wie die einzelnen Punkte im Leitfaden unter Zuhilfenahme des Plugins [[umgesetzt werden können>>TODO]]. Danach folgt eine detaillierte Beschreibung der durch das Plugin vorgenommenen Anpassungen an der Darstellung von Formularen und der durch das Plugin hinzugefügten [[Widgets>>Formcycle.FormDesigner.FormElements.Widgets]] und Funktionalitäten im Punkt [[XXX>>TODO]].
23 {{/velocity}}
24
25 == Hinweis zur Verwendung des Leitfaden-Plugins zusammen mit dem Theme-Konfigurator-Plugin ==
26
27 Das //Leitfaden-Plugin// nimmt wie auch das [[Theme-Konfigurator-Plugin>>Formcycle/PluginDocumentation/ThemeConfiguratorPlugin]] Änderungen am Aussehen von Formularen vor. Daher kann es beim parallelen Betrieb von beiden Plugins zu Konflikten kommen, wodurch die Darstellungsoptionen des Leitfaden-Plugins eventuell überschrieben werden. Daher sollte bei einem parallen Einsatz beider Plugins darauf geachtet werden, dass möglichst nur Dinge durch das //Theme-Konfigurator-Plugin// angepasst werden, bei denen nicht auch durch das //Leitfaden-Plugin// Veränderungen vorgenommen werden, wie zum Beispiel das Logo.
28
29 == Installation ==
30
31 Das Plugin kann als Mandant-Plugin oder System-Plugin installiert werden. Eine Anleitung zur Installation von Plugins finden Sie [[hier>>doc:Formcycle.UserInterface.Client.Plugins.WebHome]].
32
33 == Technische Dokumentation des Leitfaden-Plugins ==
34 oder lieber technische Details? war: Weitere Hinweise zum Aufbau von Formularen, Inhalt des Plugins
35
36 Das Plugin stellt Ressourcen zur Verfügung, welche in Formularen automatisch verwendet werden und fügt neue Validierungsreglen und Widgets hinzu. Diese werden im folgenden genauer beschrieben.
37
38 === Designanpassungen ===
39
40 Das //Leitfaden-Plugin// stellt folgende das Aussehen von Formularen beeinflussende Inhalte bereit und bindet diese automatisch in alle Formulare ein:
41
42 ; CSS-Designanpassungen
43 : Optische Anpassungen am Formular wie das Aussehen der Labels von Elementen, Upload-Elemente, Mussfeld-Sterne, usw.
44
45 ; Roboto-Schriftart
46 : das Plugin stellt diese Schriftart als Ressource auf dem Server bereit und verwendet diese für alle Texte in den Formularen
47
48 === Validatoren ===
49
50 Durch das Plugin werden 4 neue [[Validatoren>>Formcycle.FormDesigner.CodingPanel.Validators]] bereitgestellt. Zu beachten ist allen, dass sie nur überprüfen können, ob eine Eingabe formal dem Aufbau des jeweiligen Wertetyps entspricht. Es kann aber nicht überprüft werden, ob es tatsächlich einen solchen Wert, wie zum Beispiel eine konkrete BIC, gibt. Folgende Regeln werden hinzugefügt:
51
52 ; xm-vdt-bic
53 : Validierung für Eingabefelder, in die der Benutzer ein Geschäftskennzeichen (SWIFT-BIC) für Kontodaten eingibt
54
55 ; xm-vdt-iban
56 : Validierung für Eingabefelder, in die der Benutzer eine Bankverbindung in Schreibweise der internationalen Bankkontonummer (IBAN) eingibt
57
58 ; xm-vdt-iban-de
59 : Validierung für Eingabefelder, in die der Benutzer eine Bankverbindung in Schreibweise der internationalen Bankkontonummer (IBAN) eingibt
60
61 ; xm-vdt-steuerid
62 : Validierung für Eingabefelder, in die der Benutzer eine steuerliche Identifikationsnummer nach § 139b, Abgabenordnung eingibt
63
64 === Formularwidget Hinweis ===
65 {{figure image="leitfaden_widget_hinweis.png" clear="h3"}}
66 Symbol des //Hinweis//-Widgets und Aussehen im Formular
67 {{/figure}}
68 Mit diesem Widget können farblich abgehobene Hinweistexte leichter im Formular platziert werden. Die Konfigurationsoptionen entsprechen denen von [[Text-Elementen>>TODO]].
69
70 === Formularwidget Kontaktdaten ===
71 {{figure image="leitfaden_widget_kontaktdaten.png" clear="h3"}}
72 Symbol des //Kontaktdaten//-Widgets und Aussehen im Formular
73 {{/figure}}
74 Mit diesem Widget können Kontaktinformationen leicht im Formular eingebunden und in einer leitfadengemäßen Form dargestellt werden.
75
76 === Formularwidget Unsichtbarer Container ===
77 {{figure image="leitfaden_widget_unsichtbarer_container.png" clear="h3"}}
78 Symbol des //Unsichtbarer Container//-Widgets
79 {{/figure}}
80 Mit diesem Widget können Formularinhalte wie in einem normalen [[Container>>Formcycle.FormDesigner.FormElements.Container]] gruppiert werden, der Container ist jedoch unsichtbar. Dadurch ist es leichter möglich Dinge wie Sichtbarkeitsbedingungen an mehreren Formularelementen gleichzeitig zu konfigurieren, da die entsprechenden Einstellungen dann nur noch an dem die Elemente beinhaltenden //Unsichtbaren Container// vorgenommen werden müssen.
81
82 === Zusammenfassung ===
83 {{figure image="leitfaden_zusammenfassung_beispiel.png" clear="h4"}}
84 Beispiel für das Aussehen einer Zusammenfassung mit in [[Fieldsets>>Formcycle.FormDesigner.FormElements.Fieldset]] gruppierten Formularelementen.
85 {{/figure}}
86 Durch das Plugin werden im {{designer/}} zusätzliche Konfigurationsmöglichkeiten hinzugefügt, welche es ermöglichen, auf der letzten im Formular vorhandenen [[Seite>>Formcycle.FormDesigner.FormElements.Page]] eine Zusammenfassung anzuzeigen. Auf dieser Seite wird zuerst die Zusammenfassung aller vorangegangen Seiten angezeigt und darunter alle Elemente, welche im {{designer/}} auf dieser Seite platziert wurden.
87
88 In der Zusammenfassung tauchen nur die Formularelemente auf, welche sichtbar sind und einen Wert haben. Das bedeutet, dass leere Eingabefelder nicht in der Zusammenfassung aufgeführt werden. Werden Formularfelder in einem [[Fieldset>>Formcycle.FormDesigner.FormElements.Fieldset]] platziert, werden diese auch in der Zusammenfassung als Block dargestellt, in welchem oben rechts ein Link //Angaben ändern// angezeigt wird. Mit diesem kann im Formular zurück zum jeweiligen Fieldset gesprungen werden, um eingegebene Daten zu korrigieren. Diese Funktionalität ist nur bei Fieldsets, aber nicht bei [[Containern>>Formcycle.FormDesigner.FormElements.Container]] und Unsichtbaren Containern vorhanden.
89
90 Um die Zusammenfassung nutzen zu können, muss bei einer [[Schaltfläche>>Formcycle.FormDesigner.FormElements.Button]] //Zusammenfassung + prüfen// als Aktion konfiguriert werden. Dadurch wird beim klicken auf diese Schaltfläche auf die Zusammenfassungsseite gesprungen.
91
92 ==== Konfiguration von Formularelementen ====
93 {{figure image="leitfaden_zusammenfassung_elemente.png" clear="h4"}}
94 Konfigurationsmöglichkeiten für die Sichtbarkeit eines Formualrelements in der Zusammenfassung
95 {{/figure}}
96 Über die unter //Darstellung// zu findende Option //Bei Zusammenfassung// kann die Sichtbarkeit von Formularelementen in der Zusamenfassung gesteuert werden.
97
98 Diese Option wird bei allen [[Formularelementen>>Formcycle.FormDesigner.FormElements.WebHome]] und [[Widgets>>Formcycle.FormDesigner.FormElements.Widgets]] angezeigt, ist aber nur sinnvoll bei Bildern und bei Formularelementen, in denen der Nutzer eine Eingabe tätigen kann. Andere Elemente wie Schaltflächen werden generell nicht in der Zusammenfassung angezeigt.
99
100 Folgende Optionen stehen zur Auswahl:
101
102 ; Sichtbarkeit automatisch
103 : Das Element wird in der Zusammenfassung angezeigt, wenn es sichtbar ist und einen Wert hat oder vom Typ [[Bild>>Formcycle.FormDesigner.FormElements.Image]] ist. Standmäßig ist diese Option ausgewählt
104
105 ; nicht sichtbar
106 : Das element wird nicht in der Zusammenfassung angezeigt
107
108
109 ==== Konfiguration der Schaltfläche ====
110 {{figure image="leitfaden_zusammenfassung_buttons.png" clear="h4"}}
111 Aktion //Leitfaden-Plugin// in den Konfigurationseinstellungen einer Schaltfläche
112 {{/figure}}
113 Das //Leitfaden-Plugin// fügt für [[Schaltflächen>>Formcycle.FormDesigner.FormElements.Button]] eine neue Aktion mit dem Namen //Zusammenfassung + prüfen// hinzu. Diese Aktion springt dabei immer auf die letzte im Formular vorhandene Seite.
114
115 {{velocity}}
116 ##== Weitere Anpassungen am Aussehen der Formulare ==
117 ##
118 ##-> jenseits von Leitfaden
119 ##
120 ##Logo einbinden als BILD oder per CSS. -> allgemeine links
121 ##Hier empfihlt sich
122 {{/velocity}}

Navigation

Copyright 2000-2025