Zum Inhalt springen

Wiki-Quellcode von Release 4.97.0

Zuletzt geändert von MACH ProForms GmbH am 28.03.2025
Zeige letzte Bearbeiter
1 = Allgemeines =
2
3 Diese Version enthält umfangreiche Erweiterungen, welche wir Ihnen in diesem Artikel im Detail vorstellen und auf Besonderheiten sowohl für Betreiber als auch für Nutzende hinweisen möchten.
4
5 [[~[~[image:01-multi.png~|~|alt="Klicken um Video abzuspielen" height="190" width="351"~]~]>>https://cloud.form-solutions.de/index.php/s/BikHktyH9XHnBsC]]
6
7 = Inhaltsverzeichnis =
8
9 {{toc/}}
10
11 = Informationen für Betreiber =
12
13 Durch eine Anpassung des Datenmodells und dem damit einhergehend Datenbank-Update verlängert sich abhängig von der Anzahl an Assistenten-Versionen und der zugewiesenen Serverressourcen (vCPU und RAM) die Installationszeit. Bei unseren Test- und Produktivsystemen hat sich eine durchschnittliche Zeit von ca. 30 Minuten ergeben. Die Zeit ist primär von folgenden Faktoren abhängig:
14
15 * Anzahl vCPUs und RAM - Beispiel: 8 vCPUs und 64 GB RAM
16 * Anzahl Version von Assistenten: MongoDB-Shell - //use metaform; db.assistant.countDocuments();// - Beispiel 51000
17
18 {{warning}}
19 Prüfen Sie, bevor das Update eingespielt wird, dass der Timeout für das Deployment
20
21 * des Wildfly entsprechend dem Artikel [[Deployment-Timeout>>url:https://wiki.form-solutions.de/wiki/admindoku/view/Main/01_Systemadministration/03_Installation/03_Abschliessend/01_Wildfly/03_Standalone/#HDeploymentTimeout]]
22 * in der //./fs/updatefunction.sh// in der Funktion //wait_isDeployed// der Timeout auf 6000
23
24 eingestellt ist.
25
26 Diese Werte können nach dem Update beibehalten und müssen nicht zurückgestellt werden.
27 {{/warning}}
28
29 (% class="box warningmessage" %)
30 (((
31 Sollten Sie über ein Test- oder Staging-System verfügen, welches als Replikationsziel auf ein weiteren Formular-Server von Ihnen verweist, so muss immer zuerst das Zielsystem für die Replikation aktualisiert werden bevor das Test- oder Staging-System mit der neuen Programmversion aktualisiert wird.
32 )))
33
34 {{info}}
35 Bitte berücksichtigen Sie auch die Hinweise zur "[[Replikationspause>>doc:Main.13_Release-Notes.An-Abkündigungen.WebHome]]".
36 {{/info}}
37
38 = Informationen für Nutzende =
39
40 == Tests und evtl. notwendige Anpassungen ==
41
42 Durch die neuen Möglichkeiten kann es notwendig sein, dass Sie Ihr mandantenspezifisches CSS anpassen bzw. erweitern müssen.
43
44 == Erweiterung Kardinalität ==
45
46 === Nutzen ===
47
48 Ab dieser Version ist es möglich, dass an allen Komponenten außer:
49
50 * Referenzkomponente
51 * Externe Ressource
52 * Webservice
53 * Schaltfläche
54 * Verstecktes Feld
55 * Kontrollkästchen
56
57 eine Kardinalität gesetzt werden kann. Diese Kardinalität kann auch in speziellen Konstellation wie z.B.:
58
59 * Objektgruppe in Objektgruppe
60 * Multi-Panel mit Multikomponenten
61
62 verwendet werden. Damit können Sie - ergänzend zu der Multi-Panel-Funktion - mit mehr Flexibilität beim Bau neuer bzw. Ändern bestehender Assistenten auf die Bedürfnisse der Nutzenden Ihrer Online-Dienste eingehen. Auch ist durch den Wegfall sich wiederholender Komponenten ein übersichtlicheres Arbeiten im Formulareditor von Vorteil.
63
64 (% id="cke_bm_170S" style="display:none" %) (%%)Short-Video:
65
66 [[~[~[image:02.png~|~|alt="Klicken um Video abzuspielen" height="189" width="351"~]~]>>https://cloud.form-solutions.de/index.php/s/RsJ3Yzj6EXgQZ5a]]
67
68 [[~[~[image:03.png~|~|alt="Klicken um Video abzuspielen" height="190" width="351"~]~]>>https://cloud.form-solutions.de/index.php/s/2NnTt8gNc4LLbZf]]
69
70
71 (% style="color:inherit; font-family:inherit; font-size:max(18px, min(20px, 14.4444px + 0.462963vw))" %)Verhalten Formulareditor
72
73 * Neue Eigenschaft "Minimale Anzahl Werte" = Min.-Kardinalität. Der Standardwert ist 0. Der maximale Wert ist 50. Die Anzahl kann nicht größer sein als die Max.-Kardinalität.
74 * Sobald die Pflichtfeld-Einstellung auf "Ja" umgestellt wird, kann auch die Min.-Kardinalität erhöht werden.
75 * Neue Eigenschaft "Maximale Anzahl Werte" = Max.-Kardinalität. Der Standardwert ist 1. Der maximale Wert ist 50. Die Anzahl kann nicht kleiner sein als die Min.-Kardinalität.
76 * Komponenten mit einer Kardinalität größer als 1 sind automatisch 100% breit. Die Einstellung ist deaktiviert und kann nicht verändert werden.
77 * Die neuen Eigenschaften Dynamische öffentliche und barrierefreie Bezeichnung wird angezeigt, wenn max. Kardinalität >1 ist. Die Bezeichnung wird angezeigt, wenn die Max.-Kardinalität größer 1 ist. Der Wert wird mit dem "Bezeichner öffentlich" vorbefüllt und automatisch mit einem Index versehen. Die Bezeichnung ist weiterhin editierbar und der Platzhalter für den Index kann an eine beliebige Stelle verschoben bzw. platziert werden.
78 * Die Option "Druckvorlage" bestimmt die Anzahl der Komponenten in der Druckvorlagenfunktion. Als Voraussetzung für diese Option ist die Assistenteneinstellung "Als Druckvorlage verwenden" zu aktivieren. Der Wert mit der Max.-Kardinalität vorbelegt - kann aber editiert werden. Der maximale Wert ist die Max.-Kardinalität.
79 * Die Eigenschaften "Beschriftung Entfernen-Schaltfläche" und "Beschriftung Hinzufügen-Schaltfläche" ist - wie die anderen Optionen auch - erst ab einer Max.-Kardinalität größer 1 zu sehen. Der Standardtext ist dabei "Entfernen" und "Hinzufügen" inkl. eines entsprechenden Icons.
80 * Es ist derzeit noch nicht möglich, die Komponenten mit einer Min.-Kardinalität größer als eins zu mappen. Diese Erweiterung wird in einer der nächsten Versionen hinzugefügt und betrifft dabei gleichzeitig auch die Multipanel-Funktionalität.
81 * Es ist derzeit noch nicht möglich, über den Klick-Editor Regeln für Komponenten mit einer Min.-Kardinalität größer als eins zu definieren. Dies ist ausschließlich über den Expertenmodus möglich.
82
83 === Verhalten Bürgersicht ===
84
85 * Komponenten mit einer Kardinalität größer als 1 sind automatisch 100% breit.
86 * Die Anzahl der initial angezeigten Komponenten beim Panelaufruf entspricht der Min.-Kardinalität.
87 * Die Komponenten, welche mindestens (Min.-Kardinalität) auszufüllen sind, werden mit einem Pflichtstern markiert.
88 * Ist die Anzahl der hinzugefügten Komponenten größer als die Min.-Kardinalität, können diese in beliebiger Reihenfolge entfernt werden. Dabei markiert (Pflichtstern) das System die verbliebenen Komponenten neu, so dass die Min.-Kardinalität eingehalten wird.
89 * Der Hinzufüge-Button ist nur dann aktiv, wenn die Min.-Kardinalität kleiner als die Max.-Kardinalität ist. Ist diese Grenze erreicht, wird der Button solange deaktiviert, bis die Grenze durch das Löschen unterschritten wird. Dem Nutzenden wird dieses Verhalten durch ein Tooltip am Button angezeigt.
90 * Der Entfernen-Button ist immer dann aktiv, wenn die aktuelle Anzahl der Komponenten größer als die Min.-Kardinalität ist. Dem Nutzenden wird dieses Verhalten durch ein Tooltip am Button angezeigt.
91 * __Hinweis__: Ist die Min.- gleich der Max.-Kardinalität, so sind beide Buttons nicht zu sehen.
92
93 === Verhalten Bürgersicht im Bezug auf die Barrierefreiheit ===
94
95 * Evtl. gesetzte Icons in den Buttons sind für Screenreader nicht zugänglich, nur die Beschriftung der Buttons wird dem Nutzenden vorgelesen.
96 * Die Buttons sind Funktionsbuttons und enthalten Texte für den Screenreader, um klarzustellen, welche Komponente hinzugefügt bzw. gelöscht werden kann. Daher benötigten die Buttons keinen zusätzlichen Alternativtext.
97 * Nach Betätigen des Hinzufügen-Buttons wird der Fokus auf die neu hinzugefügte Komponente gesetzt.
98 * Nach Entfernen einer Komponente wird der Fokus automatisch auf die nächste Komponente oder den Hinzufügen-Button, wenn dieser den aktiven Status hat, gesetzt.
99 * Sind die Buttons inaktiv, so werden die Begründung, warum sie inaktiv sind, vorgelesen.
100 * Alle Komponenten sind mit Screenreader-Bezeichnern ausgestattet, die u.a. auch einen dynamischen Index enthalten können. Dabei wird der Index ebenfalls mit vorgelesen.
101 * Die "Dynamische barrierefreie Bezeichnung" ist die Ersatzbeschriftung, die im Screenreader vorgelesen wird, wenn die reguläre Beschriftung des Feldes nicht aussagekräftig genug bzw. leer ist. Wichtig: Wenn die Ersatzbeschriftung gesetzt ist, wird die allgemeine Beschriftung nicht mehr vorgelesen. Wenn ein Hinweistext vorhanden ist, muss dieser ebenfalls in die Ersatzbeschriftung eingetragen werden. Der Hinweistext wird ansonsten nicht vom Screenreader erfasst.
102
103 == Erweiterung Rahmenanzeige ==
104
105 === Nutzen ===
106
107 Im Formulareditor kann für die Komponenten "Objektgruppe" und "Text" die neue Option "Rahmenanzeige" eingestellt werden. Die neue Option ist für beide Komponenten unter der Gruppe "Spezielle Einstellungen" zu finden. Die Rahmen können u.a. zur Strukturierung bzw. Hervorhebung in der Bürgersicht eingesetzt werden und unterstützen somit dem Nutzenden bei einem schnelleren Ausfüllprozess.
108
109 (% id="cke_bm_184S" style="display:none" %) (%%)Short-Video:
110
111 [[~[~[image:04.png~|~|alt="Klicken um Video abzuspielen" height="190" width="351"~]~]>>https://cloud.form-solutions.de/index.php/s/LNzPQKdzambkfmj]]
112
113
114
115 === Verhalten ===
116
117 * Der Rahmen ist auch sichtbar, wenn die Komponente zugeklappt ist
118 * Der Rahmen wird nicht in die Druckvorlage oder das generierte PDF-Dokument übernommen
119
120 == Erweiterung Auf- und Zuklappen ==
121
122 === Nutzen ===
123
124 Im Formulareditor kann für die Komponenten "Objektgruppe" und "Text" die neue Option "Zuklappen" ausgewählt werden. Die neue Option ist für beide Komponenten unter der Gruppe "Spezielle Einstellungen" zu finden. Diese Funktionalität hilft dem Nutzenden in der Bürgersicht sich bei längeren Panelseiten schnell und effektiv zu orientieren. U.a. kann diese Funktion auch zum "Abhaken" bereits ausgefüllter Bereiche (Objektgruppen) dienen, in dem diese zugeklappt werden.
125
126 (% id="cke_bm_193S" style="display:none" %) (%%)Short-Video:
127
128 [[~[~[image:05.png~|~|alt="Klicken um Video abzuspielen" height="190" width="351"~]~]>>https://cloud.form-solutions.de/index.php/s/3nFz9nHwWxtncnL]]
129
130
131
132 === Verhalten ===
133
134 * Die Option ist in Kombination mit der Option "Rahmenanzeige" einsetzbar
135 * Bei der Objektgruppe befindet sich das Icon zum Auf- und Zuklappen in der rechten oberen Ecke
136 * In der zugeklappten Ansicht der Objektgruppe wird die öffentliche (dynamische) Bezeichnung angezeigt
137 * Bei der Textkomponente befindet sich das Icon zum Auf- und Zuklappen am unteren Ende auf der ganzen Breite der Komponente
138 * In der zugeklappten Ansicht der Textkomponente wird die öffentliche (dynamische) Bezeichnung angezeigt. Wenn kein öffentlicher Bezeichner vorhanden ist, werden die ersten 3 Zeilen des hinterlegten Textes angezeigt
139 * Das Auf- und Zuklappen hat keinen Einfluss auf das generierte PDF-Dokument. Alle Komponenten werden entsprechend der Einstellung vollständig angezeigt.
140 * Zugeklappten Objektgruppen werden automatisch aufgeklappt, sobald ein Validierungsfehler in der Objektgruppe erkannt wurde. Somit kann der Nutzenden die Eingabe korrigieren, ohne alle zugeklappten Objektgruppen "anzufassen".
141
142 === Verhalten Bürgersicht im Bezug auf die Barrierefreiheit ===
143
144 * Die Zuklapp-Funktion für Objektgruppen wird vom Screenreader erkannt, ist steuerbar und erscheint in der Funktionsliste. Der Screenreader liest den öffentlichen (dynamischen) Bezeichner einer Komponente, der zu- oder aufgeklappt Komponente vor.
145 * Bei Validierungsmeldungen in geschlossenen Objektgruppen wird die Gruppe automatisch geöffnet und der Fokus liegt auf der ersten nicht validen Komponente.
146
147 == Erweiterung Titel und Text im Formulareditor ==
148
149 === Nutzen ===
150
151 Für ein einheitliches Bedienungskonzept wurden die nachfolgenden Änderungen am "Titel und Text" von Komponenten vorgenommen. Die Anpassung dient auch dazu, dass neue Assistentenbauer bzw. Assistentenbauerinnen die nicht häufig mit dem System arbeiten, sich einfacher in der Programmoberfläche zurechtfinden.
152
153 === Komponenten Alle ===
154
155 * In der Gruppe "Allgemeine Einstellungen" wurden die Eigenschaften "Bezeichner öffentlich", "Bezeichner intern", "Bezeichner technisch", "Bezeichner barrierefrei" für alle Komponenten gleich angeordnet.
156 * Alle weiteren Eigenschaften in dieser Gruppe wurden, je nach Komponente und zur Verfügung stehender Funktionalität, in gleicher Weise angeordnet.
157
158 === Komponente Objektgruppe ===
159
160 * Neue Eigenschaft "Erklärung Pflichtgruppe" in der Gruppe "Spezielle Einstellungen"
161 * Die Erklärung ist unterhalb des "Text" und oberhalb der ersten Komponente zu sehen
162 * Die Eigenschaft "Bezeichner öffentlich" kann ab sofort über die zusätzliche Einstellung "Überschrift-Stil" beeinflusst werden
163 * Die Pflichtgruppenmarkierung wird hinter der Überschrift angezeigt
164 * Die Eigenschaft "Titel" in der Gruppe "Erläuternder Text" wurde entfernt - der gewünschte Text kann entweder im "Bezeichner öffentlich" oder in "Erklärung Pflichtgruppe" hinterlegt werden
165 * Automatisches Datenbankupdate
166 ** "Bezeichnung öffentlich" werden in "Erklärung Pflichtgruppe" verschoben
167 ** Die Eigenschaft "Titel" aus der Gruppe "Erläuternder Text" wird in "Bezeichnung öffentlich" verschoben
168 ** Alle Gruppen, die keine Komponenten und ausschließlich einen "Titel" in den Eigenschaften aufweisen, werden automatisch in eine Text-Komponente umgewandelt
169
170 === Komponente Text ===
171
172 * Neue Eigenschaft "Bezeichnung öffentlich"
173 * Die Eigenschaft "Bezeichner öffentlich" kann ab sofort über die zusätzliche Einstellung "Überschrift-Stil" beeinflusst werden
174 * Die Eigenschaft "Titel" in der Gruppe "Erläuternder Text" wurde entfernt - der gewünschte Text kann entweder im "Bezeichner öffentlich" oder in "Erklärung Pflichtgruppe" hinterlegt werden
175 * Automatisches Datenbankupdate
176 ** Die Eigenschaft "Titel" aus der Gruppe "Spezielle Einstellungen" wird in "Bezeichnung öffentlich" verschoben
177
178 === Hinweis für bestehende Assistenten ===
179
180 Sollten Sie in den Komponenten "Text" und/oder "Objektgruppe" in der Eigenschaft "Text" die Formatvorlage "Überschrift" verwenden, so wird diese beim erneuten Abspeichern der Komponente entfernt. Bitte übernehmen Sie daher bei Veränderungen an den Komponenten die Überschrift in die Eigenschaft "Bezeichnung öffentlich". Sollte Ihr "Text" über mehr als eine Überschrift verfügen, so trennen Sie die einzelnen Abschnitte in neue Komponenten auf.
181
182 Hintergrund: Die Formatvorlage steht Ihnen ab sofort in der Eigenschaft "Bezeichnung öffentlich" zur Verfügung.
183
184 == Erweiterung Bearbeitungsdialog im Formulareditor ==
185
186 Im Formulareditor wurde der Bearbeitungsdialog für Komponenten und der Veröffentlichungen angepasst. Die Komponenten orientieren sich nun immer linksbündig und das Vergrößern des Dialoges verlängert bzw. verbreitert die Eingabemöglichkeiten (ggf. Scrollbar).
187
188 Zudem wurde die Position der Buttons wie z.B. "Übernehmen" und "Abbrechen" so optimiert, dass diese in jeder Bildschirmauflösung gut (ggf. Scrollbar) erreichbar sind.
189
190 [[image:1717344920901-109.png||alt="Bearbeitungsdialog" height="71" width="450"]]
191
192 Der Dialog passt sich somit an die zur Verfügung stehende Auflösung an und muss nicht wie bisher manuell Angepasst werden.