Von Version < 7.16 >
bearbeitet von gru
am 06.05.2021, 11:38
Auf Version < 7.18 >
bearbeitet von gru
am 10.05.2021, 10:24
< >
Änderungskommentar: Es gibt keinen Kommentar für diese Version

Zusammenfassung

Details

Seiteneigenschaften
Inhalt
... ... @@ -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>>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]].
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.
... ... @@ -130,6 +130,12 @@
130 130  }
131 131  {{/code}}
132 132  
274 +== Versionshistorie ==
275 +
276 +=== 1.1.2 ===
277 +
278 +* Initiales öffentliches Release des //Leitfaden-Plugins//.
279 +
133 133  {{velocity}}
134 134  ##== Weitere Anpassungen am Aussehen der Formulare ==
135 135  ##
Copyright 2000-2025