Allgemeines

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.

Inhaltsverzeichnis

• Allgemeines
• Inhaltsverzeichnis
• Informationen für Betreiber
• Informationen für Nutzende
  • Tests und evtl. notwendige Anpassungen
  • Erweiterung Kardinalität
    • Nutzen
    •  Verhalten Assistentenbaukasten
    • Verhalten Bürgersicht
    • Verhalten Bürgersicht im Bezug auf die Barrierefreiheit
  • Erweiterung Rahmenanzeige
    • Nutzen
    • Verhalten
  • Erweiterung Auf- und Zuklappen
    • Nutzen
    • Verhalten
    • Verhalten Bürgersicht im Bezug auf die Barrierefreiheit
  • Erweiterung Titel und Text im Assistentenbaukasten
    • Nutzen
    • Komponenten Alle
    • Komponente Objektgruppe
    • Komponente Text
    • Hinweis für bestehende Assistenten
  • Erweiterung Bearbeitungsdialog im Assistentenbaukasten

Informationen für Betreiber

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:

• Anzahl vCPUs und RAM - Beispiel: 8 vCPUs und 64 GB RAM
• Anzahl Version von Assistenten: MongoDB-Shell - use metaform; db.assistant.countDocuments(); - Beispiel 51000

Informationen für Nutzende

Tests und evtl. notwendige Anpassungen

Durch die neuen Möglichkeiten kann es notwendig sein, dass Sie Ihr mandantenspezifisches CSS anpassen bzw. erweitern müssen.

Erweiterung Kardinalität

Nutzen

Ab dieser Version ist es möglich, dass an allen Komponenten außer:

• Referenzkomponente
• Externe Ressource
• Webservice
• Schaltfläche
• Verstecktes Feld
• Kontrollkästchen

eine Kardinalität gesetzt werden kann. Diese Kardinalität kann auch in speziellen Konstellation wie z.B.:

• Objektgruppe in Objektgruppe
• Multi-Panel mit Multikomponenten

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.

 Short-Video:

 Verhalten Assistentenbaukasten

• 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.
• Sobald die Pflichtfeld-Einstellung auf "Ja" umgestellt wird, kann auch die Min.-Kardinalität erhöht werden.
• 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.
• Komponenten mit einer Kardinalität größer als 1 sind automatisch 100% breit. Die Einstellung ist deaktiviert und kann nicht verändert werden.
• 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.
• 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.
• 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.
• 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.
• 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.

Verhalten Bürgersicht

• Komponenten mit einer Kardinalität größer als 1 sind automatisch 100% breit.
• Die Anzahl der initial angezeigten Komponenten beim Panelaufruf entspricht der Min.-Kardinalität.
• Die Komponenten, welche mindestens (Min.-Kardinalität) auszufüllen sind, werden mit einem Pflichtstern markiert.
• 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.
• 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.
• 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.
• Hinweis: Ist die Min.- gleich der Max.-Kardinalität, so sind beide Buttons nicht zu sehen.

Verhalten Bürgersicht im Bezug auf die Barrierefreiheit

• Evtl. gesetzte Icons in den Buttons sind für Screenreader nicht zugänglich, nur die Beschriftung der Buttons wird dem Nutzenden vorgelesen.
• 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.
• Nach Betätigen des Hinzufügen-Buttons wird der Fokus auf die neu hinzugefügte Komponente gesetzt.
• 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.
• Sind die Buttons inaktiv, so werden die Begründung, warum sie inaktiv sind, vorgelesen.
• Alle Komponenten sind mit Screenreader-Bezeichnern ausgestattet, die u.a. auch einen dynamischen Index enthalten können. Dabei wird der Index ebenfalls mit vorgelesen.
• 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.

Erweiterung Rahmenanzeige

Nutzen

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.

 Short-Video:

Verhalten

• Der Rahmen ist auch sichtbar, wenn die Komponente zugeklappt ist
• Der Rahmen wird nicht in die Druckvorlage oder das generierte PDF-Dokument übernommen

Erweiterung Auf- und Zuklappen

Nutzen

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.

 Short-Video:

Verhalten

• Die Option ist in Kombination mit der Option "Rahmenanzeige" einsetzbar
• Bei der Objektgruppe befindet sich das Icon zum Auf- und Zuklappen in der rechten oberen Ecke
• In der zugeklappten Ansicht der Objektgruppe wird die öffentliche (dynamische) Bezeichnung angezeigt
• Bei der Textkomponente befindet sich das Icon zum Auf- und Zuklappen am unteren Ende auf der ganzen Breite der Komponente
• 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
• Das Auf- und Zuklappen hat keinen Einfluss auf das generierte PDF-Dokument. Alle Komponenten werden entsprechend der Einstellung vollständig angezeigt.
• 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".

Verhalten Bürgersicht im Bezug auf die Barrierefreiheit

• 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.
• Bei Validierungsmeldungen in geschlossenen Objektgruppen wird die Gruppe automatisch geöffnet und der Fokus liegt auf der ersten nicht validen Komponente.

Erweiterung Titel und Text im Assistentenbaukasten

Nutzen

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.

Komponenten Alle

• In der Gruppe "Allgemeine Einstellungen" wurden die Eigenschaften "Bezeichner öffentlich", "Bezeichner intern", "Bezeichner technisch", "Bezeichner barrierefrei" für alle Komponenten gleich angeordnet.
• Alle weiteren Eigenschaften in dieser Gruppe wurden, je nach Komponente und zur Verfügung stehender Funktionalität, in gleicher Weise angeordnet.

Komponente Objektgruppe

• Neue Eigenschaft "Erklärung Pflichtgruppe" in der Gruppe "Spezielle Einstellungen"
• Die Erklärung ist unterhalb des "Text" und oberhalb der ersten Komponente zu sehen
• Die Eigenschaft "Bezeichner öffentlich" kann ab sofort über die zusätzliche Einstellung "Überschrift-Stil" beeinflusst werden
• Die Pflichtgruppenmarkierung wird hinter der Überschrift angezeigt
• 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
• Automatisches Datenbankupdate
  • "Bezeichnung öffentlich" werden in "Erklärung Pflichtgruppe" verschoben
  • Die Eigenschaft "Titel" aus der Gruppe "Erläuternder Text" wird in "Bezeichnung öffentlich" verschoben
  • Alle Gruppen, die keine Komponenten und ausschließlich einen "Titel" in den Eigenschaften aufweisen, werden automatisch in eine Text-Komponente umgewandelt

Komponente Text

• Neue Eigenschaft "Bezeichnung öffentlich"
• Die Eigenschaft "Bezeichner öffentlich" kann ab sofort über die zusätzliche Einstellung "Überschrift-Stil" beeinflusst werden
• 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
• Automatisches Datenbankupdate
  • Die Eigenschaft "Titel" aus der Gruppe "Spezielle Einstellungen" wird in "Bezeichnung öffentlich" verschoben

Hinweis für bestehende Assistenten

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.

Hintergrund: Die Formatvorlage steht Ihnen ab sofort in der Eigenschaft "Bezeichnung öffentlich" zur Verfügung.

Erweiterung Bearbeitungsdialog im Assistentenbaukasten

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).

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.

Der Dialog passt sich somit an die zur Verfügung stehende Auflösung an und muss nicht wie bisher manuell Angepasst werden.