Wiki-Quellcode von Release 4.97.0

Zuletzt geändert von MACH ProForms GmbH am 28.03.2025

version	line-number	content
50.2	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
75.1	5	[[~[~[image:01-multi.png~\|~\|alt="Klicken um Video abzuspielen" height="190" width="351"~]~]>>https://cloud.form-solutions.de/index.php/s/BikHktyH9XHnBsC]]
50.2	6
	7	= Inhaltsverzeichnis =
	8
	9	{{toc/}}
	10
	11	= Informationen für Betreiber =
	12
65.1	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:
50.2	14
65.1	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
50.2	18	{{warning}}
74.1	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.
50.2	27	{{/warning}}
	28
60.1	29	(% class="box warningmessage" %)
	30	(((
61.1	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.
60.1	32	)))
	33
50.2	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
56.1	46	=== Nutzen ===
	47
50.2	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
61.1	60	* Multi-Panel mit Multikomponenten
50.2	61
75.1	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.
50.2	63
	64	(% id="cke_bm_170S" style="display:none" %) (%%)Short-Video:
	65
75.1	66	[[~[~[image:02.png~\|~\|alt="Klicken um Video abzuspielen" height="189" width="351"~]~]>>https://cloud.form-solutions.de/index.php/s/RsJ3Yzj6EXgQZ5a]]
50.2	67
75.1	68	[[~[~[image:03.png~\|~\|alt="Klicken um Video abzuspielen" height="190" width="351"~]~]>>https://cloud.form-solutions.de/index.php/s/2NnTt8gNc4LLbZf]]
50.2	69
	70
76.1	71	(% style="color:inherit; font-family:inherit; font-size:max(18px, min(20px, 14.4444px + 0.462963vw))" %)Verhalten Formulareditor
50.2	72
51.1	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.
52.1	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.
63.1	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.
50.2	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.
61.1	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.
50.2	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
62.1	95	* Evtl. gesetzte Icons in den Buttons sind für Screenreader nicht zugänglich, nur die Beschriftung der Buttons wird dem Nutzenden vorgelesen.
53.1	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.
50.2	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.
62.1	99	* Sind die Buttons inaktiv, so werden die Begründung, warum sie inaktiv sind, vorgelesen.
50.2	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.
53.1	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.
50.2	102
	103	== Erweiterung Rahmenanzeige ==
	104
57.1	105	=== Nutzen ===
50.2	106
75.1	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.
57.1	108
50.2	109	(% id="cke_bm_184S" style="display:none" %) (%%)Short-Video:
	110
75.1	111	[[~[~[image:04.png~\|~\|alt="Klicken um Video abzuspielen" height="190" width="351"~]~]>>https://cloud.form-solutions.de/index.php/s/LNzPQKdzambkfmj]]
50.2	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
57.1	122	=== Nutzen ===
50.2	123
75.1	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.
57.1	125
50.2	126	(% id="cke_bm_193S" style="display:none" %) (%%)Short-Video:
	127
75.1	128	[[~[~[image:05.png~\|~\|alt="Klicken um Video abzuspielen" height="190" width="351"~]~]>>https://cloud.form-solutions.de/index.php/s/3nFz9nHwWxtncnL]]
50.2	129
	130
	131
	132	=== Verhalten ===
	133
61.1	134	* Die Option ist in Kombination mit der Option "Rahmenanzeige" einsetzbar
50.2	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
75.1	147	== Erweiterung Titel und Text im Formulareditor ==
50.2	148
57.1	149	=== Nutzen ===
50.2	150
62.1	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.
57.1	152
50.2	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.
62.1	156	* Alle weiteren Eigenschaften in dieser Gruppe wurden, je nach Komponente und zur Verfügung stehender Funktionalität, in gleicher Weise angeordnet.
50.2	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
62.1	168	** Alle Gruppen, die keine Komponenten und ausschließlich einen "Titel" in den Eigenschaften aufweisen, werden automatisch in eine Text-Komponente umgewandelt
50.2	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
64.1	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
75.1	184	== Erweiterung Bearbeitungsdialog im Formulareditor ==
50.2	185
75.1	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).
50.2	187
61.1	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.
55.1	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.