... |
... |
@@ -18,11
+18,8 @@ |
18 |
18 |
|
19 |
19 |
Das //Leitfaden-Plugin// stellt Funktionalitäten zur Verfügung, welche im Leitfaden beschrieben wurden, aber nicht standardmäßig in {{formcycle/}} umsetzbar sind. |
20 |
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}} |
|
21 |
+Im folgenden wird nach allgemeinen Installationshinweisen zunächst beschrieben, wie die einzelnen Punkte im Leitfaden unter Zuhilfenahme des Plugins [[umgesetzt werden können>>||anchor="HUmsetzungvonFormularengemE4DFdesLeitfadens"]]. 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]]. |
24 |
24 |
|
25 |
|
- |
26 |
26 |
== Hinweis zur Verwendung des Leitfaden-Plugins zusammen mit dem Theme-Konfigurator-Plugin == |
27 |
27 |
|
28 |
28 |
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. |
... |
... |
@@ -33,6
+33,150 @@ |
33 |
33 |
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]]. |
34 |
34 |
|
35 |
35 |
|
|
33 |
+== Umsetzung von Formularen gemäß des Leitfadens == |
|
34 |
+ |
|
35 |
+Im folgenden wird auf die einzelnen Punkte des Leitfadens stichpunktartig eingegangen und gezeigt, wie diese nach der Installation des Plugins in FORMCYCLE realisiert werden können. |
|
36 |
+ |
|
37 |
+=== #1 Frage den Bürger als erstes, was er möchte. === |
|
38 |
+ |
|
39 |
+* Diese Anforderung wird dadurch umgesetzt, dass das Formular beim Erstellen bereits ensprechend aufgebaut wird |
|
40 |
+* Dem Bürger können nach der Auswahl des Anliegens über [[Sichtbarkeitsbedingungen>>Formcycle.FormDesigner.ElementProperties.Constraints]] nur diejenigen Seiten und Formualarelemente angezeigt werden, die für sein Anliegen notwendig sind |
|
41 |
+ |
|
42 |
+=== #2 Unterteile dein Formular in sinnvolle Prozessschritte und gebe Orientierung === |
|
43 |
+ |
|
44 |
+* Für einen Fortschrittsanzeige kann das kostenfreie [[Widget-Plugin Navigationsleiste>>Formcycle.PluginDocumentation.WidgetXNavigationBar]] verwendet werden |
|
45 |
+* Das Widget muss entweder je einmal am Anfang von jeder Formualarseite oder genau einmal im Header-Bereich (empfohlen) platziert werden |
|
46 |
+* Details zur Konfiguration des Widgets wirden auf der Seite des Plugins genauer [[beschrieben>>Formcycle.PluginDocumentation.WidgetXNavigationBar||anchor="HKonfiguration"]] |
|
47 |
+ |
|
48 |
+=== #3 Gib dem Bürger eine Übersicht über seine Angaben und verlinke zu den Seiten === |
|
49 |
+ |
|
50 |
+* Auf der letzten Seite des Formulars kann mithilfe des //Leitfaden-Plugins// eine Zusammenfassung angezeigt werden |
|
51 |
+* Bei der Schaltfläche, mit der zu dieser letzten Seite gewechselt wird, muss dafür //Zusammenfassung + prüfen// als Aktion festgelegt werden |
|
52 |
+* In der Zusammenfassung werden für Fieldsets die Verlinkungen zu den ensprechenden Seiten gemäß des Leitfadens automatisch generiert |
|
53 |
+* Mehr Informationen finden sich unter dem Punkt [[Zusammenfassung>>TODO]] |
|
54 |
+ |
|
55 |
+=== #4 Biete jederzeit die Möglichkeit an Kontakt aufzunehmen === |
|
56 |
+ |
|
57 |
+* Das //Leitfaden-Plugin// bietet hierfür ein Widget [[Kontaktdaten>>TODO]] an, mit dem die Kontaktdaten einfach eingepfegt werden können |
|
58 |
+* Diese können beispielsweise in den Header und/oder Footer platziert werden |
|
59 |
+ |
|
60 |
+=== #5 Gib dem Bürger die Möglichkeit sich zu erklären === |
|
61 |
+ |
|
62 |
+* Bemerkungsfelder können an geeigneten Stellen als [[Textarea>>Formcycle.FormDesigner.FormElements.Textarea]] hinzugefügt werden |
|
63 |
+* Durch Anpassung der Option //Max. Zeichen// unter [[Bedingungen>>TODO]] und //Höhe (in px)// unter [[Darstellung>>TODO]] kann das Bemerkungsfeld individuell an die Situation angepasst werden |
|
64 |
+ |
|
65 |
+=== #6 Komme den Fragen deiner Bürger zuvor === |
|
66 |
+ |
|
67 |
+* Das //Leitfaden-Plugin// bietet hierfür ein Widget [[Hinweis>>TODO]] an, mit dem fertig gesetzte Hilfeblöcke einfach in Formulare eingepfegt werden können |
|
68 |
+* Die Konfiguration entspricht dabei der eines normalen [[Text-Elements]] |
|
69 |
+ |
|
70 |
+=== #7 Positioniere die Feldbezeichnungen oberhalb des Feldes === |
|
71 |
+ |
|
72 |
+* Die Position von Feldbezeichungen ist in FORMCYCLE standardmäßig über dem Element |
|
73 |
+* Bei Formularlemementen kann die Postitionierung unter Elementeigenschaften [[Label>>Formcycle/FormDesigner/ElementProperties/Label]] angepasst werden |
|
74 |
+ |
|
75 |
+=== #8 Bilde sinnvolle visuelle Hierarchien === |
|
76 |
+ |
|
77 |
+* Die in diesem Punkt angeregten Hervorhebungen durch Farbe und Fettschreibung werden durch das //Leitfaden-Plugin// vorgenommen |
|
78 |
+* Zusammenhängende Formularelemente können durch Verwendung von Fieldsets und Containern gruppiert werden |
|
79 |
+* Durch die Funktionsweise der [[Zusammenfassungs-Funktion>>TODO]] des //Leitfaden-Plugins// wird folgende Verwendung empfohlen: |
|
80 |
+** Verwendung von Fieldsets als erste Gruppierungsstufe, da durch diese in der Zusammenfassung Verlinkungen auf den jeweiligen Block vorhanden sind |
|
81 |
+** Innerhalb von Fieldsets nur mit Containern oder [[unsichtbaren Containern>>TODO]] gruppieren |
|
82 |
+** Container ermöglichen dem Bürger durch Ihre Hintergrundfarbe, die darin enthaltenen Formularelemente deutlich als Gruppe wahrzunehmen |
|
83 |
+ |
|
84 |
+=== #9 Weise deinen Bürgern den Weg === |
|
85 |
+ |
|
86 |
+* Durch das //Leitfaden-Plugin// wird das gerade aktive Formularelemente durch einen blauen Rahmen und eine dunklere Hintergrundfarbe hervorgehoben |
|
87 |
+* Bestimmte Webbrowser setzen selbstständig einen dicken schwarzen Rahmen um das aktive Formularelement, wodurch der vom //Leitfaden-Plugin// gesetzte farbige Rahmen wieder überdeckt wird - Dieses Verhalten kann nicht verändert werden |
|
88 |
+* Erledigte Felder werden in der aktuellen Version des //Leitfaden-Plugin// nicht visuell zurückgestellt |
|
89 |
+ |
|
90 |
+=== #10 Gib deinen Bürgern auch Rückmeldungen === |
|
91 |
+ |
|
92 |
+* In der aktuellen Version des //Leitfaden-Plugin// werden bereits richtig ausgefüllte Felder nicht optisch belohnt |
|
93 |
+ |
|
94 |
+=== #11 Wähle sinnvolle Feldgrößen === |
|
95 |
+ |
|
96 |
+* Für das Eingeben von Text bietet FORMCYCLE die Formuarelemente [[Eingabefeld>>Formcycle.FormDesigner.FormElements.Input]] und [[Textarea>>Formcycle.FormDesigner.FormElements.Textarea]] |
|
97 |
+* Eingabefelder eignen sich für die meisten Eingaben |
|
98 |
+** Durch Platzieren von mehreren Eingabefeldern in einer Zeile und dem Hinzufügen von [[Abstandselmenten>>Formcycle.FormDesigner.FormElements.Spacer]] können Eingabefelder bei Bedarf kleiner gemacht werden |
|
99 |
+** Der relative Anteil, den einzelne Formularfeld in einer Zeile annimmt kann durch das Anpassen des Wertes der Option //Bereite// in den [[Grundeigenschaften>>TODO]] angepasst werden |
|
100 |
+** Durch das Einfügen von Abständen, kann die anteilige Größe eines Formularelements in einer Zeile verringert werden, ohne das weitere Formularelemente in der Zeile vorhanden sein müssen |
|
101 |
+* Textareas können zum Beispiel für längere Freitextabschnitte verwendet werden |
|
102 |
+** Standardmäßig ist bereits die [[Darstellungsoption>>TODO]] //Größe anpassen// aktiv, wodurch das Feld mit den Eingaben des Nutzers mitwächst |
|
103 |
+** Durch //Höhe (in px)// kann zudem die initiale Höhe der Textarea festgelegt werden |
|
104 |
+** Die maximale mögliche Zeichananzahl kann unter [[Bedingungen>>TODO]] im Paramerter //Max. Zeichen// konfiguriert werden |
|
105 |
+** Durch die Option //Zeichenanzahl anzeigen// wird unter dem Feld die aktuell vorhandene und die maximal erlaube Zeichenmenge angezeigt, was dem Bürger einen Hinweis auf die ungefähr erwartete Informationsmenge liefern kann |
|
106 |
+ |
|
107 |
+=== #12 Gehe sorgsam mit Auszeichnungen für Schrift um === |
|
108 |
+ |
|
109 |
+* Verwendung von Fettschrift, Großschreibungen und Kursivschrift wird vom Formularersteller bestimmt |
|
110 |
+* Inhalte von Feldbezeichnungen und Textelementen werden in einem Rich-Text-Editor eingegeben und können dadurch im {{designer/}} beliebig formatiert werden |
|
111 |
+ |
|
112 |
+=== #13 Mache Pflichtfelder in jeder Situation deutlich sichtbar === |
|
113 |
+ |
|
114 |
+* Durch das //Leitfaden-Plugin// werden die Sterne, durch die Pflichtfelder gekennzeichnet werden, deutlich vergrößert |
|
115 |
+* Überschriften und Beschriftungen von Schaltflächen sind in FORMCYCLE bereits standardmäßig in Fettschrift und Fließtexte sind auch standardmäßig in normaler Schrift |
|
116 |
+ |
|
117 |
+=== #14 Hebe Schaltflächen hervor und beschrifte sie === |
|
118 |
+ |
|
119 |
+* Bei den Kontrollschaltflächen von wiederholten Elementen werden werden durch das //Leitfaden-Plugin// entsprechend ihrer Funktion beschriftet und die Icons heben sich farblich deutlich ab |
|
120 |
+ |
|
121 |
+=== #15 Vermeide doppelte Eingaben === |
|
122 |
+ |
|
123 |
+* Durch Verwendung von Auswahlfeldern mit Radiobuttons kann der Bürger gefragt werden, ob vorangegangene Eingaben oder ob er abweichende Daten eingeben möchte |
|
124 |
+Standardfunktionalität von FC: Per RB abfragen, ob Angaben von vorher bereits eingegebenen abweichen, Weitere zunächst versteckte Formularfelder werden dann über "sichtbar wenn" bedingungen einblenden. |
|
125 |
+* Die Felder für abweichende Daten sind zunächst versteckt und werden über [[//Sichtbar wenn//-Bedingungen>>Formcycle.FormDesigner.ElementProperties.Constraints]] sichtbar |
|
126 |
+* Um die abhängig sichtbaren Eingabeelemente gruppieren zu können, können diese Beispielsweise in einen Container oder einen [[Unsichtbaren Container>>TODO]] platziert werden |
|
127 |
+ |
|
128 |
+=== #16 Verwende vorausgefüllte Standardtexte als Beispielangabe === |
|
129 |
+ |
|
130 |
+* Platzhalter können bei allen Eingabeelementtypen für Text unter [[Label {{rarrow/}} Platzhalter>>TODO]] eingetragen werden |
|
131 |
+ |
|
132 |
+=== #17 Gib proaktiv hilfreiche Hinweise und Erklärungen === |
|
133 |
+ |
|
134 |
+* Hilfetexte können standardmäßig für alle Eingabeelemente in FORMCYCLE definiert werden |
|
135 |
+* Durch das //Leitfaden-Plugin// werden sie standardmäßig geöffnet werden, wenn das Feld ausgewählt wird |
|
136 |
+ |
|
137 |
+=== #18 Biete so oft wie möglich Auswahlfelder an === |
|
138 |
+{{velocity}} |
|
139 |
+##* Mehrstufige Abfrage können mit Radiobuttons für die wichtigsten Auswahloptionen und Auswahlfeldern für sonstige Auswahlen umgesetzt werden |
|
140 |
+##, bei den können mit FORMCYCLE einfach mit [[Sichtbarkeitsbedingungen>>Formcycle.FormDesigner.ElementProperties.Constraints]] umgesetzt werden. |
|
141 |
+{{/velocity}} |
|
142 |
+* Dropdown-Auswalelemente sind eine Ansichtsform des Elementtyps [[Auswahl>>Formcycle.FormDesigner.FormElements.Selection]] |
|
143 |
+* Wenn Abfragen (z.B. Anrede, Staatsbürgerschaft, etc.) häufiger in Formularen vorkommen, können diese als [[Datenquelle>>TODO]] hinterlegt und dadurch einfach eingebunden und für alle Formulare zentral gepflegt werden. |
|
144 |
+ |
|
145 |
+=== #19 Hilf deinen Bürgern Dokumente anzuhängen === |
|
146 |
+ |
|
147 |
+* Das //Leitfaden-Plugin// passt das Aussehen des [[Uploadelements>>Formcycle.FormDesigner.FormElements.Upload]] so an, dass die Standardansicht des verwendeten Webbrowsers durch eine neue Schaltfläche ersetzt wird |
|
148 |
+* Dadurch wird Schaltfläche situationsabhängig beschriftet und die verunsichernde Darstellung des gesamten Dateipfades der Datei in //Microsoft Internet Explorer// und //Edge (Alt)// entfällt |
|
149 |
+ |
|
150 |
+=== #20 Überprüfe die Angaben deiner Bürger === |
|
151 |
+ |
|
152 |
+* An Eingabefeldern können im {{designer/}} einfache Validatoren ausgewählt werden |
|
153 |
+* Zusätzliche Köntextabhängige Prüfungen können per JavaScript vorgenommen werden |
|
154 |
+ |
|
155 |
+=== #21 Mache Fehler sichtbar und erkläre sie === |
|
156 |
+ |
|
157 |
+* FORMCYCLE markiert standardmäßig Felder, bei denen Angaben fehlen oder nicht valide sind und zeigt eine passende Fehlermeldung an. |
|
158 |
+* Texte von Fehlermeldungen können im FORMCYCLE Backend unter [[I18N-Variablen>>TODO]] gepflegt werden oder [[per JavaScript>>TODO]] im Formular individuell überschrieben werden |
|
159 |
+* Das Aussehen von Fehlermeldungen kann über [[CSS>>TODO]] zusätzlich angepasst werden |
|
160 |
+ |
|
161 |
+=== #22 Unterstütze die AutoFill-Funktion der Browser === |
|
162 |
+ |
|
163 |
+* In FORMCYCLE ab Version 6.6.10 für Eingabefelder unter //Erweitert {{rarrow/}} Automatisch ausfüllen// konfigurierbar |
|
164 |
+* Alternativ können die entsprechenden Attribute auch bei //Erweitert {{rarrow/}} Automatisch ausfüllen// festgelegt werden |
|
165 |
+ |
|
166 |
+=== #23 Kommuniziere mit deinen Bürgern auf Augenhöhe === |
|
167 |
+ |
|
168 |
+* Zusätzliche Hinweise können als als [[Textelement>>Formcycle.FormDesigner.FormElements.Text]] im Formular eingefügt werden |
|
169 |
+ |
|
170 |
+=== #24 Halte deine Bürger auf dem Laufenden === |
|
171 |
+ |
|
172 |
+* Bei normaler Bearbeitung des Formulars durch die Sachbearbeiter kann nach jeder Bearbeitung eine E-Mail-Aktion zum Informieren des Kunden verwendet werden |
|
173 |
+* Analog kann für Vorgänge, bei denen der Bürger sich mit der AKDB authentifiziert hat, [[eine Nachricht an den AKDB-Postkorb gesendet werden>>Formcycle.PluginDocumentation.AkdbBuergerkontoServicePlugin||anchor="HAKDBPostkorbanbindunginderStatusverarbeitung"]] |
|
174 |
+* Über Statusverarbeitung kann zum Beispiel mit einem [[Zeitgesteuerten Statuswechsel>>Formcycle/UserInterface.MyForms.WorkflowProcessing.States||anchor="HZeigesteuerterStatuswechsel"]] nach einer definierten Zeitspanne in einen anderen Status gewechselt werden, in welchem dem Bürger eine automatische Statusoinformation zugesendet wird |
|
175 |
+ |
|
176 |
+ |
36 |
36 |
== Technische Dokumentation des Leitfaden-Plugins == |
37 |
37 |
|
38 |
38 |
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. |