Zum Inhalt springen

Wiki-Quellcode von Release 4.97.0

Version 62.1 von fweise am 07.06.2024
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:2024-05-29 16 18 24.png||alt="Klicken um Video abzuspielen" height="197" width="351"]]>>https://cloud.form-solutions.de/index.php/s/MJBEbS5nB9QKitd]]
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.
14
15 {{warning}}
16 Prüfen Sie, bevor das Update eingespielt wird, dass der Timeout für das Deployment 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]] eingestellt ist. Diese Werte können nach dem Update beibehalten und müssen nicht zurückgestellt werden.
17 {{/warning}}
18
19 (% class="box warningmessage" %)
20 (((
21 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.
22 )))
23
24 {{info}}
25 Bitte berücksichtigen Sie auch die Hinweise zur "[[Replikationspause>>doc:Main.13_Release-Notes.An-Abkündigungen.WebHome]]".
26 {{/info}}
27
28 = Informationen für Nutzende =
29
30 == Tests und evtl. notwendige Anpassungen ==
31
32 Durch die neuen Möglichkeiten kann es notwendig sein, dass Sie Ihr mandantenspezifisches CSS anpassen bzw. erweitern müssen.
33
34 == Erweiterung Kardinalität ==
35
36 === Nutzen ===
37
38 Ab dieser Version ist es möglich, dass an allen Komponenten außer:
39
40 * Referenzkomponente
41 * Externe Ressource
42 * Webservice
43 * Schaltfläche
44 * Verstecktes Feld
45 * Kontrollkästchen
46
47 eine Kardinalität gesetzt werden kann. Diese Kardinalität kann auch in speziellen Konstellation wie z.B.:
48
49 * Objektgruppe in Objektgruppe
50 * Multi-Panel mit Multikomponenten
51
52 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 Assistentenbaukasten von Vorteil.
53
54 (% id="cke_bm_170S" style="display:none" %) (%%)Short-Video:
55
56 [[[[image:2024-05-29 16 33 01.png||alt="Klicken um Video abzuspielen" height="197" width="351"]]>>https://cloud.form-solutions.de/index.php/s/SRmSBQm9JodRRa5]]
57
58 [[[[image:2024-05-29 16 35 08.png||alt="Klicken um Video abzuspielen" height="197" width="351"]]>>https://cloud.form-solutions.de/index.php/s/iikPPmQFejzEGEC]]
59
60
61 === (% id="cke_bm_170S" style="display:none" %) (%%)Verhalten Assistentenbaukasten ===
62
63 * 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.
64 * Sobald die Pflichtfeld-Einstellung auf "Ja" umgestellt wird, kann auch die Min.-Kardinalität erhöht werden.
65 * 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.
66 * Komponenten mit einer Kardinalität größer als 1 sind automatisch 100% breit. Die Einstellung ist deaktiviert und kann nicht verändert werden.
67 * 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.
68 * 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.
69 * 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.
70
71 === Verhalten Bürgersicht ===
72
73 * Komponenten mit einer Kardinalität größer als 1 sind automatisch 100% breit.
74 * Die Anzahl der initial angezeigten Komponenten beim Panelaufruf entspricht der Min.-Kardinalität.
75 * Die Komponenten, welche mindestens (Min.-Kardinalität) auszufüllen sind, werden mit einem Pflichtstern markiert.
76 * 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.
77 * 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.
78 * 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.
79 * __Hinweis__: Ist die Min.- gleich der Max.-Kardinalität, so sind beide Buttons nicht zu sehen.
80
81 === Verhalten Bürgersicht im Bezug auf die Barrierefreiheit ===
82
83 * Evtl. gesetzte Icons in den Buttons sind für Screenreader nicht zugänglich, nur die Beschriftung der Buttons wird dem Nutzenden vorgelesen.
84 * 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.
85 * Nach Betätigen des Hinzufügen-Buttons wird der Fokus auf die neu hinzugefügte Komponente gesetzt.
86 * 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.
87 * Sind die Buttons inaktiv, so werden die Begründung, warum sie inaktiv sind, vorgelesen.
88 * Alle Komponenten sind mit Screenreader-Bezeichnern ausgestattet, die u.a. auch einen dynamischen Index enthalten können. Dabei wird der Index ebenfalls mit vorgelesen.
89 * 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.
90
91 == Erweiterung Rahmenanzeige ==
92
93 === Nutzen ===
94
95 Im Assistentenbaukasten 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.
96
97 (% id="cke_bm_184S" style="display:none" %) (%%)Short-Video:
98
99 [[[[image:2024-05-29 16 28 18.png||alt="Klicken um Video abzuspielen" height="198" width="351"]]>>https://cloud.form-solutions.de/index.php/s/9zr6JxFwtz7jAf6]]
100
101
102
103 === Verhalten ===
104
105 * Der Rahmen ist auch sichtbar, wenn die Komponente zugeklappt ist
106 * Der Rahmen wird nicht in die Druckvorlage oder das generierte PDF-Dokument übernommen
107
108 == Erweiterung Auf- und Zuklappen ==
109
110 === Nutzen ===
111
112 Im Assistentenbaukasten 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.
113
114 (% id="cke_bm_193S" style="display:none" %) (%%)Short-Video:
115
116 [[[[image:2024-05-29 16 30 51.png||alt="Klicken um Video abzuspielen" height="198" width="352"]]>>https://cloud.form-solutions.de/index.php/s/azwJ7XzEcYB2sJS]]
117
118
119
120 === Verhalten ===
121
122 * Die Option ist in Kombination mit der Option "Rahmenanzeige" einsetzbar
123 * Bei der Objektgruppe befindet sich das Icon zum Auf- und Zuklappen in der rechten oberen Ecke
124 * In der zugeklappten Ansicht der Objektgruppe wird die öffentliche (dynamische) Bezeichnung angezeigt
125 * Bei der Textkomponente befindet sich das Icon zum Auf- und Zuklappen am unteren Ende auf der ganzen Breite der Komponente
126 * 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
127 * Das Auf- und Zuklappen hat keinen Einfluss auf das generierte PDF-Dokument. Alle Komponenten werden entsprechend der Einstellung vollständig angezeigt.
128 * 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".
129
130 === Verhalten Bürgersicht im Bezug auf die Barrierefreiheit ===
131
132 * 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.
133 * Bei Validierungsmeldungen in geschlossenen Objektgruppen wird die Gruppe automatisch geöffnet und der Fokus liegt auf der ersten nicht validen Komponente.
134
135 == Erweiterung Titel und Text im Assistentenbaukasten ==
136
137 === Nutzen ===
138
139 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.
140
141 === Komponenten Alle ===
142
143 * In der Gruppe "Allgemeine Einstellungen" wurden die Eigenschaften "Bezeichner öffentlich", "Bezeichner intern", "Bezeichner technisch", "Bezeichner barrierefrei" für alle Komponenten gleich angeordnet.
144 * Alle weiteren Eigenschaften in dieser Gruppe wurden, je nach Komponente und zur Verfügung stehender Funktionalität, in gleicher Weise angeordnet.
145
146 === Komponente Objektgruppe ===
147
148 * Neue Eigenschaft "Erklärung Pflichtgruppe" in der Gruppe "Spezielle Einstellungen"
149 * Die Erklärung ist unterhalb des "Text" und oberhalb der ersten Komponente zu sehen
150 * Die Eigenschaft "Bezeichner öffentlich" kann ab sofort über die zusätzliche Einstellung "Überschrift-Stil" beeinflusst werden
151 * Die Pflichtgruppenmarkierung wird hinter der Überschrift angezeigt
152 * 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
153 * Automatisches Datenbankupdate
154 ** "Bezeichnung öffentlich" werden in "Erklärung Pflichtgruppe" verschoben
155 ** Die Eigenschaft "Titel" aus der Gruppe "Erläuternder Text" wird in "Bezeichnung öffentlich" verschoben
156 ** Alle Gruppen, die keine Komponenten und ausschließlich einen "Titel" in den Eigenschaften aufweisen, werden automatisch in eine Text-Komponente umgewandelt
157
158 === Komponente Text ===
159
160 * Neue Eigenschaft "Bezeichnung öffentlich"
161 * Die Eigenschaft "Bezeichner öffentlich" kann ab sofort über die zusätzliche Einstellung "Überschrift-Stil" beeinflusst werden
162 * 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
163 * Automatisches Datenbankupdate
164 ** Die Eigenschaft "Titel" aus der Gruppe "Spezielle Einstellungen" wird in "Bezeichnung öffentlich" verschoben
165
166 == Erweiterung Bearbeitungsdialog im Assistentenbaukasten ==
167
168 Im Assistentenbaukasten 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).
169
170 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.
171
172 [[image:1717344920901-109.png||alt="Bearbeitungsdialog" height="71" width="450"]]
173
174 Der Dialog passt sich somit an die zur Verfügung stehende Auflösung an und muss nicht wie bisher manuell Angepasst werden.