Zuletzt geändert von Form-Solutions GmbH am 24.11.2023
Zeige letzte Bearbeiter
1 ## Komponentenwerkzeugleiste
2
3 Jede Komponente verfügt nach dem Hinzufügen in ein Panel über eine sogenannte „Komponentenwerkzeugleiste“. Die Komponentenwerkzeugleiste enthält Schaltflächen mit der die Komponente konfiguriert, als neue „[[Vorlage|Main.05_Assistenten.04_Assistentenbauoberfläche.03_Bibliothek]]“ gespeichert, gelöscht oder mit „[[Aktivierungsregeln/Berechnungsregeln|Main.05_Assistenten.04_Assistentenbauoberfläche.07_Regelbau.02_KomponentenbasierteRegeln]]“ versehen werden kann. Weiterhin wird beim Einfügen einer neuen Komponente eine visuelle Übersicht der Anzeigeeinstellungen außerhalb der Komponente ersichtlich.
4
5 ![[Übersicht der Komponentenwerkzeugleiste|@KonfiKomponentenWerkzeugleiste.jpg]]
6
7 ### Komponente konfigurieren ![[Schaltfläche der Komponenten Konfiguration|@KonfiKomponentenKonfiguration.jpg]]
8
9 Um die Komponente konfigurieren zu können, muss die Schaltfläche „Konfigurieren“ betätigt werden. Daraufhin öffnet sich die Eingabemaske „Komponenten "XY" konfigurieren“.
10
11 #### Eingabemaske „Komponente "XY" konfigurieren“
12
13 In dieser Eingabemaske können, je nach Komponente, Konfigurationen in zwei bis vier Rubriken vorgenommen werden.
14
15 ![[Ansicht, in der die Komponente konfiguriert werden kann|@KonfiAnsichtKonfiguration.jpg]]
16
17 #####
18
19 ##### Rubrik „Allgemeine Einstellungen“
20
21 * **Bezeichnung**
22 * **intern**
23 Die interne Beschriftung der Komponente ist nur in der Assistentenbauoberfläche sichtbar.
24 * **öffentlich**
25 Die Beschriftung der Komponente im Assistenten. Mit einer kurzen aber aussagekräftigen Bezeichnung wird erläutert, was in der Komponente eingetragen/angegeben werden soll.
26 Achten Sie auf einfache Sprache bei der Beschriftung.
27 Dieses Feld wird von Screenreadern vorgelesen, wenn keine "Bezeichnung barrierefrei" vorhanden ist. Soll die "Bezeichnung öffentlich" leer gelassen werden, muss zwingend eine "Bezeichnung barrierefrei" hinterlegt werden.
28 Formatierungen wie  `[Link zu Datenschutzbestimmungen](https://www.form-solutions.de/)` oder `**Fettschrift**` sind im Text möglich.
29 * **technisch**
30 Die „Bezeichnung technisch“ wird für [[Regeln|Main.05_Assistenten.04_Assistentenbauoberfläche.07_Regelbau]] sowie für das Befüllen eines [[PDF-Formulars|Main.05_Assistenten.03_NeuenAssistentenanlegen]] benötigt.
31 * Für das Befüllen eines PDF-Formulares sollte sie identisch mit der „Bezeichnung technisch“ im PDF-Formular sein.
32 * Bei Assistenten mit generiertem PDF-Formular kann die Bezeichnung technisch im Rahmen folgender Vorgaben frei gewählt werden:
33 Sie soll kurz und prägnant den Komponenteninhalt oder -zweck wiedergeben.
34 Die Bezeichnung muss im Assistenten einmalig sein. Im ganzen Assistenten darf die gleiche technische Bezeichnung bei keiner weiteren Komponente verwendet werden.
35 Es dürfen keine Leerzeichen, Umlaute oder Sonderzeichen (z.B. ! . " § $ % & { } = ? \ ´ ` * + ~ # ' : , | < > ^ @ €) vorkommen.
36 Beispiele: Gesamtkosten; AnzahlHunde; ZaehlerNr; Strassenname; CundA; Paragraph12a
37 * **barrierefrei**
38 Diese „Ersatzbeschriftung“, wird von [[Screenreadern|Main.16_Barrierefreiheit]] statt der "Bezeichnung öffentlich" vorgelesen.
39 Soll die "Bezeichnung öffentlich" leer gelassen werden, muss zwingend eine "Bezeichnung barrierefrei" hinterlegt werden.
40 Text aus dem Eingabefeld „Hinweistext“ muss in dieses Feld übernommen werden, um von Screenreadern erfasst zu werden.
41 * **Zuordnung Vorbefüllung**
42 Über dieses Auswahlfeld kann ausgewählt werden, mit welchem Feld aus der [[eID|Main.07_Einstellungen-Fachadministration.03_Module.05_eID]] oder dem Portal die Komponente [[vorbefüllt|Main.05_Assistenten.04_Assistentenbauoberfläche.11_VorbefüllungvonAssistenten]] werden soll. Die Zuordnung der Felder kann auf mehrere Felder im Assistenten erfolgen. Sobald eine Zuordnung stattfindet und der Assistent mit dem eID-Prozess gestartet wird, wird die Komponente entsprechend mit dem Wert vorbefüllt und automatisch schreibgeschützt.
43
44 > {{icon name="far fa-info-circle" size="3"/}} _**Hinweis:**_
45 >
46 > Deses Auswahlfeld steht nur bei bestimmten kopierten Komponenten zur Verfügung. Weiterhin ist zu beachten, dass diese Zuordnung vor dem Context-Identifier Priorität hat.
47
48 * **Context-Identifier**
49 Der „Context-Identifier“ verbindet die Inhaltswerte logisch gleicher Felder. Wenn beispielsweise ein Hundehalter für die Hundesteuer eine Lastschriftermächtigung erteilen möchte, entspricht der Inhalt vom Feld „Hundehalter Familienname“ dem Wert von „Kontoinhaber Familienname“. Der Ausfüller des Ausfüllassistenten muss das Feld „Familienname“ nur einmal ausfüllen. Die Wirkung von einem Context-Identifier wird nur „aktiv“, wenn bei beiden Komponenten auf den verschiedenen Panels die gleiche Objektbenamung und der identische Context-Identifier Schlüssel in der Konfiguration eingetragen wurde. Weiterhin kann der Context-Identifier für eine [[Vorbefüllung|Main.05_Assistenten.04_Assistentenbauoberfläche.11_VorbefüllungvonAssistenten]] mittels eID, URL Parameter oder den Sachbearbeiterdatensätzen genutzt werden.
50
51 > {{icon name="far fa-info-circle" size="3"/}} _**Hinweis:**_ 1. Wenn Sie in einer [[Objektgruppe|Main.05_Assistenten.04_Assistentenbauoberfläche.03_Bibliothek]] einen Context-Identifier hinterlegen, muss um dieselbe Komponente auf dem anderen Panel auch eine Objektgruppe eingefügt werden. 1. Weiterhin greift der Context-Identifier Objektebenen übergreifend. Das heißt, wird bei einer Objektgruppe ein Context-Identifier angegeben, greifen zusätzliche Context-Identifier, die in den einzelnen Komponenten in der Objektgruppe hinterlegt wurden, nicht.
52
53 * **Anzeige erzwingen**
54 Wenn ein Context-Identifier definiert wurde und es dieselbe Komponente, mit derselben Benamung noch einmal im Assistenten vorhanden ist, wird die zweite gleichlautende Komponente angezeigt. Weiterhin können Änderungen hierbei vorgenommen werden, ohne dass die vorgehende identische Komponente geändert wird. Hierbei spielt es keine Rolle bei welcher Komponente der Haken „Anzeige erzwingen“ in der Komponenten Konfiguration gesetzt wurde.
55 * **Wert wird als Verweis von anderen Komponenten verwendet**
56 „Der Wert wird als Verweis von anderen Komponenten verwendet“ setzt man zusätzlich zum Context-Identifier auf „Ja“, wenn man möchte, dass Änderungen in allen identischen Komponenten automatisch übernommen werden sollen. Beispielsweise hat man zwei Komponenten auf verschiedenen Panels mit demselben Context-Identifier Schlüssel. Sollte sich bei der zweiten Komponente beispielsweise der Familienname von „Meier“ auf „Müller“ ändern, ändert sich in der ersten Komponente der Familienname auch von „Meier“ auf „Müller“. Bei der Auswahl „Nein“ wird der Familienname der ersten Komponente nicht überschrieben.
57 * **Anzeige im Assistenten**
58 Mit der Auswahl „Anzeige im Assistenten“, die immer zur Verfügung steht, kann angegeben werden, ob die Komponente im Ausfüllprozess angezeigt werden soll oder nicht. Standardmäßig ist dieser Wert auf „Immer“ angezeigt gesetzt.
59
60 > {{icon name="far fa-info-circle" size="3"/}} _**Hinweis:**_
61 >
62 > Bei vorhandenen Regeln, die beispielsweise eine Komponente ausblenden, werden bevorzugt ausgeführt als beispielsweise die Anzeige Einstellung Anzeige im Assistent immer.
63
64 * **Anzeige im PDF-Formular**
65 Die Auswahl „Anzeige im PDF“ erscheint in der Konfiguration einer Komponente nur, wenn bei einem Assistenten in den [[Assistenteneigenschaften|Main.05_Assistenten.03_NeuenAssistentenanlegen]] die Auswahl unter Typ „Assistent mit generiertem PDF“ ausgewählt wurde. Hier kann angegeben werden, wann das Feld im generierten PDF-Formular angezeigt werden soll. Standardmäßig ist dieser Wert auf „Wenn Wert vorhanden“ gesetzt.
66
67 > {{icon name="far fa-info-circle" size="3"/}} _**Hinweis:**_
68 >
69 > Bei vorhandenen Regeln, die beispielsweise eine Komponente ausblenden, werden bevorzugt ausgeführt als beispielsweise die Anzeige Einstellung Anzeige im PDF-Formular immer.
70
71 * **Anzeige in Druckvorlage**
72 Die Auswahl „Anzeige in Druckvorlage“ erscheint in der Konfiguration einer Komponente nur, wenn bei einem Assistenten in den [[Assistenteneigenschaften|Main.05_Assistenten.03_NeuenAssistentenanlegen]] die Auswahl „Als Druckvorlage verwenden“ ausgewählt wurde. Hier kann angegeben werden, ob die Komponente in der [[Druckvorlage|Main.05_Assistenten.10_Druckvorlagen]] des Assistenten angezeigt werden soll. Standardmäßig ist dieser Wert auf „Immer“ gesetzt.
73
74 > {{icon name="far fa-info-circle" size="3"/}} _**Hinweis:**_ Bei Druckvorlagen werden Regeln, definierte Standardwerte, Platzhalter, Zeilen und Pflichtfelder nicht beachtet.
75
76 #### Rubrik „Hinweistext“
77
78 > {{icon name="far fa-info-circle" size="3"/}} _**Hinweis:**_
79
80 1. Diese Rubrik steht nicht bei den Komponenten Autovervollständigung, Webservice, Objektgruppen, Text, Geo-Koordinaten und verstecktes Feld zur Verfügung.
81 1. Weiterhin kann bei kundenspezifischen Änderungen die Barrierefreiheit der Anwendung beeinträchtigt werden.
82 1. Der hinterlegte Hinweistext bei der Komponente "Schaltfläche" wird über Mouseover dem Nutzer sichtbar.
83
84 * **Hinweis**
85 Hier können sinnvolle und notwendige Hinweise oder Gesetzestexte, die für den Ausfüller in einem gelben Infobutton neben der Komponente erscheinen sollen, hinterlegt werden. Dabei kann mit der Hilfe eines Texteditors der Text auf verschiedenste weiße formatiert werden.
86
87 #### Rubrik „Erläuternder Text“
88
89 > {{icon name="far fa-info-circle" size="3"/}} _**Hinweis:**_
90
91 1. Diese Rubrik steht nur bei Objektgruppen und Geo-Koordinaten zur Verfügung.
92 1. Der hinterlegte Text wird **vor** der Bezeichnung öffentlich angezeigt.
93 1. Weiterhin kann bei kundenspezifischen Änderungen die Barrierefreiheit der Anwendung beeinträchtigt werden.
94
95 * **Titel**
96 Hier kann eine Überschrift für den erläuternder Text hinterlegt werden.
97
98 > {{icon name="far fa-info-circle" size="3"/}} _**Hinweis:**_
99 >
100 > Der Titel wird als Überschriftsebene 2 dargestellt (h2).
101
102 * **Text**
103 Hier kann eine erläuternder Text hinterlegt werden.
104
105 > {{icon name="far fa-info-circle" size="3"/}} _**Hinweis:**_ 1. Achten Sie auf eine leichte Sprache. 1. Achten Sie auf eine barrierefreie Gestaltung der Texte. 1. Es stehen die Überschriftenebenen 3 bis 6 zur Verfügung.
106
107 #### Rubrik „Spezielle Einstellungen“
108
109 Die Rubrik „Spezielle Einstellungen“ enthält je nach Komponente unterschiedlichste Auswahlmöglichkeiten. Nachfolgend werden die generellen sowie spezifischen Einstellungsmöglichkeiten aufgeführt.
110
111 > {{icon name="far fa-info-circle" size="3"/}} _**Hinweis:**_ Bei Text-Komponenten wird hier der definierte Text hinterlegt.
112
113 ##### Generelle spezielle Einstellungen
114
115 * **Schreibschutz**
116 Über diese Auswahl kann angegeben werden, ob ein Wert durch den Bürger eingetragen werden darf oder nicht. Meist wird ein Schreibschutz hinterlegt, wenn eine Vorbefüllung durch einen Context Identifier erfolgt. Der Schreibschutz bei Vorbefüllung durch die [[eID Funktion|Main.07_Einstellungen-Fachadministration.03_Module.05_eID]] ist unabhängig vorhanden, auch wenn an der Komponente die Einstellung Schreibschutz deaktiviert ist.
117 * **Pflichtfeld**
118 Hierüber kann definiert werden, ob eine Eingabe Pflicht für den Bürger ist. Sofern die Komponente als Pflicht deklariert wurde, wird eine entsprechende Kennzeichnung mittels einem "*" an der Komponente dem Bürger angezeigt. Die Kennzeichnung kann mittels [[CSS|Main.05_Assistenten.09_CSSEinstellungen]] verändert werden.
119
120 > {{icon name="far fa-info-circle" size="3"/}} _**Hinweis:**_ 1. Eine Änderung des Textes " * Es handelt sich um eine Pflichtangabe." ist nicht möglich. 1. Bei Verwendung der Google Translater Funktion wird de Hinweis "* Es handelt sich um eine Pflichtangabe." auch in die jeweilig ausgewählte Sprache übersetzt.
121
122 * **Platzhalter**
123 Hierüber kann definiert werden, ob ein Platzhalter im Eingabefeld dem Bürger angezeigt wird. Bei Klick in das Feld verschwindet der Platzhalter. Ein Platzhalter wird nicht in der Druckvorlage, im generiertem PDF oder befüllten PDF-Formular abgedruckt.
124 * **Standardwert**
125 Hierüber kann ein Standardwert hinterlegt werden, der im Ausfüllprozess die Komponente vorbefüllt. Dieser kann durch den Bürger, wenn kein Schreibschutz hinterlegt wurde, überschrieben werden. Der Standardwert wird in der Druckvorlage, im generiertem PDF oder befüllten PDF-Formular abgedruckt.
126
127 ##### Komponentenspezifische Einstellungen
128
129 * **Textfeld (einzeilig)/(mehrzeiliges)**
130 * **Spezialtyp**
131 Hierüber kann definiert werden, ob im Feld Telefonnummern, E-Mail-Adressen, Bankleitzahlen, Kontonummern oder Kfz-Kennzeichen eingetragen werden sollen. Bei einer Auswahl wird dann der eingegebene Wert validiert und ggf. eine entsprechende Fehlermeldung an den Bürger ausgegeben. Ist keine Spezialauswahl ausgewählt, kann der Bürger alles in die Komponente eintragen.
132
133 > {{icon name="far fa-info-circle" size="3"/}} _**Hinweis:**_ 1. In der Kennzeichenkomponente können nur Deutsche Kennzeichen erfasst werden. 1. Eine Erfassung von Sonderkennzeichen wie für Elektroautos oder Oldtimer ist auch möglich.
134
135 * **Minimale Länge/Maximale Zeichenanzahl/Anzahl Zeilen** Hierüber kann definiert werden, wie viele Zeichen minimal und maximal in die Komponente durch den Bürger eingetragen werden können. Wird diese unter- bzw. überschritten durch den Bürger, wird eine entsprechende Fehlermeldung dem Bürger ausgegeben. Zusätzlich kann bei einem mehrzeiligen Textfeld angegeben werden, wie viele Zeilen der Bürger im Textfeld nutzen kann.
136 * **Ausgabe im PDF**
137
138 Hierüber kann definiert werden, wie der eingetragene Wert vom Bürger im PDF-Formular ausgegeben werden soll. Bei der Auswahl Text wird der eingetragene Text vom Bürger normal ausgegeben. Bei der Auswahl Barcode 128 und QR Barcode werden wie in der Bezeichnung entsprechende Barcodes generiert und im PDF ausgegeben.
139
140 > {{icon name="far fa-info-circle" size="3"/}} _**Hinweis:**_
141 >
142 > Diese Einstellung steht nur bei einem generierten Assistenten zur Verfügung. * **Regulärer Ausdruck**
143 >
144 > Hierüber kann ein regulärer Ausdruck (Zeichenkette) definiert werden, der zur Validierung der Nutzereingabe verwendet wird. Beispiel: "[a-z]*"
145
146 > {{icon name="far fa-info-circle" size="3"/}} _**Hinweis:**_
147 >
148 > Der Ausdruck `[1-9]*, 3` lässt den ausgefüllten Wert 2,3 nicht zu, da im Backend eine Dezimalzahl (unabhängig von Kinfigurationseinstellungen) verarbeitet wird, und nicht der eingegebene String. Der Ausdruck `[1-9]*.3` lässt den Eintrag 2,3 und 2.3 zu, da im Backend kein Unterschied besteht und beides auf 2.3 gemappt wird. Notfalls kann ein Textfeld verwendet werden. Hier wird dann die Eingabe direkt als String ausgewertet. Bei dem regulären Ausdruck handelt sich es um Java (nicht JavaScript).
149
150 * **Datums-/Uhrzeitfeld**
151 * **Darstellung**
152 Hierüber kann definiert werden, wie die Komponente dargestellt werden soll. Hierbei kann ein Datum mit getrennten Feldern für Tag, Monat, Jahr, einem Datum mit einem Popup Kalender, einem Zeitfeld mit getrennten Feldern für Minute und Stunde oder einer Kombinationsmöglichkeit aus Datum und Zeit Feld ausgewählt werden. Standardmäßig ist die Auswahl Datum mit getrennten Feldern hinterlegt.
153 * **Wochenende ausschließen**
154 Mit dieser Einstellung kann definiert werden, ob bei der Eingabe im Datumsfeld kein Wochenende (Samstage und Sonntage) möglich ist. Bei einem Datum mit Popup wird im Kalender die entsprechenden Tage ausgegraut.
155
156 > {{icon name="far fa-info-circle" size="3"/}} _**Hinweis:**_
157 >
158 > Diese Einstellung steht nicht mit der Darstellung "Zeit" zur Verfügung.
159
160 * **Tage ausschließen**
161 Mit dieser Einstellung kann eine definiert werden, ob durch eine zuvor hinterlegte Liste mit bestimmten Tagen diese Tage nicht zur Eingabe/Auswahl im Datumsfeld zur Verfügung stehen. Wird die Einstellung auf "Ja" gestellt, muss in den nachfolgenden Feldern "Liste auswählen" und "Wertespalte" eine Liste aus der Listenverwaltung sowie die entsprechende Wertespalte ausgewählt werden. Eine Beschreibung als Beispiel der hinterlegten Liste finden Sie [[hier|Main.05_Assistenten.04_Assistentenbauoberfläche.08_Listen.02_Listennutzung.03_BeispieleListennutzung]].
162
163 > {{icon name="far fa-info-circle" size="3"/}} _**Hinweis:**_
164 >
165 > Diese Einstellung steht nicht mit der Darstellung "Zeit" zur Verfügung.
166
167 * **Die Eingabe muss vor/nach einem Datum sein.**
168 Über diese zwei Auswahlmöglichkeiten kann angegeben werden, ab bzw. vor welchem Datum die Eingabe durch den Bürger im Ausfüllprozess liegen muss. Beispielsweise kann somit sichergestellt werden, dass ein Datum nicht vor dem 01.01.2019 eingetragen wird.
169 * **Die Eingabe darf maximal vor/nach dem Ausfülldatum liegen.**
170 Über diese zwei Auswahlmöglichkeiten kann angegeben werden, dass die Eingabe maximal entsprechend der hinterlegten Anzahl von Tagen, Monaten oder Jahren vor bzw. nach dem Ausfülldatum liegen darf. Beispielsweise kann somit sichergestellt werden, dass eine Eingabe eines Datums durch den Bürger nur maximal zwei Tage nach dem Ausfülldatum liegen darf.
171
172 > {{icon name="far fa-info-circle" size="3"/}} _**Hinweis:**_
173 >
174 > Bei dem Eingabefeld "Die Eingabe darf maximal vor dem Ausfülldatum liegen" muss mit einer Negativzahl bestückt werden. Beispiel: -2.
175
176 * **Numerisches Feld / Dezimalfeld**
177 * **Spezialtyp**
178 Hierüber kann definiert werden, ob im Feld ein Geldbetrag eingegeben werden soll. Dies bestimmt nicht nur die Formatierung sond es wird zusätzlich ein Eurozeichen im Ausfüllprozess sowie im generierten PDF-Formular/Druckvorlage abgedruckt. Sofern keine Auswahl getroffen wird, kann eine beliebige Zahlenkombination eingetragen werden.
179 * **Dezimalzahl**
180 Hierüber kann angegeben werden, ob es sich bei der angegebenen Zahl um eine Dezimalzahl handeln soll.
181 * **Anzahl Nachkommastellen**
182 Sofern die Einstellung Dezimalzahl auf "Ja" gestellt wurde, kann zusätzlich angegeben werden, wie viele Nachkommstellen bei der Eingabe zugelassen sind.
183 * **Minimaler/Maximaler Wert**
184 Hierüber kann definiert werden, ob ein minimaler oder maximaler Wert bei der Eingabe zulässig ist. Sofern dies hinterlegt wurde wird bei einer falschen Eingabe dem Bürger eine Fehlermeldung ausgegeben.
185 * **Regulärer Ausdruck**
186 Hierüber kann ein regulärer Ausdruck (Zeichenkette) definiert werden, der zur Validierung der Nutzereingabe verwendet wird. Beispiel: "[a-z]*"
187
188 > {{icon name="far fa-info-circle" size="3"/}} _**Hinweis:**_
189 >
190 > Der Ausdruck `[1-9]*, 3` lässt den ausgefüllten Wert 2,3 nicht zu, da im Backend eine Dezimalzahl (unabhängig von Kinfigurationseinstellungen) verarbeitet wird, und nicht der eingegebene String. Der Ausdruck `[1-9]*.3` lässt den Eintrag 2,3 und 2.3 zu, da im Backend kein Unterschied besteht und beides auf 2.3 gemappt wird. Notfalls kann ein Textfeld verwendet werden. Hier wird dann die Eingabe direkt als String ausgewertet. Bei dem regulären Ausdruck handelt sich es um Java (nicht JavaScript).
191
192 * **Datei-Hochladen**
193 * **Dateityp**
194 Über diese Funktion wird bei den Mobilgeräten unterschieden, ob ein Zugriff auf die Kamera oder auch der Galerie gestattet ist. Gerade bei IOS-Betriebssystemen ist hier es notwendig auf die Eigenschaft "Keine Bild-Datei" die Komponente zu stellen, sodass die Kamera und Galerie zur Verfügung steht.
195 * **Maximale Dateigröße**
196 Hierüber kann definiert werden, welche maximale Dateigröße die antragstellende Person bei dieser Datei-Hochladen-Komponente hochladen kann. Standardmäßig sind 5 MB hinterlegt.
197 * **Bezeichnung technisch als Dateiname verwenden**
198 Hierüber kann definiert werden, ob der Dateiname der hochgeladenen Datei mit der technischen Bezeichnung der Komponente überschrieben werden soll. Beispielsweise ist die Komponente bei der technischen Bezeichnung mit dem Wert Lebenslauf benannt. So würde bei der Einstellung "Ja" die hochgeladene Datei dann den Dateinamen "Lebenslauf" erhalten.
199 * **Text**
200 * **Titel**
201 Hier kann eine Überschrift, die als Überschriftenebene 2 (h2) dargestellt wird, hinterlegt werden.
202 * **Text**
203 Hier kann mitttels dem Editor ein Text hinterlegt und konfiguriert werden.
204
205 > {{icon name="far fa-info-circle" size="3"/}} _**Hinweis:**_ 1. Achten Sie auf eine leichte Sprache. 1. Achten Sie auf eine barrierefreie Gestaltung der Texte. 1. Es stehen die Überschriftenebenen 3 bis 6 zur Verfügung.
206
207 * **Kontrollkästchen**
208 * **An-Wert**
209 Hier ist der Wert hinterlegt, der dem ausgewählten Werten der Bürgersicht entspricht.
210 * **Aus-Wert**
211 Hier ist der Wert hinterlegt, der dem nicht ausgewählten Werten der Bürgersicht entspricht.
212 * **Dropdown/Optionsfelder**
213 * **Darstellung**
214 Hierüber kann definiert werden, ob die Komponente als Radiobuttons oder eine Dropdown-Liste dargestellt werden soll.
215 * **Einträge alphabetisch sortieren**
216 Mit dieser Einstellung kann eine alphabetische Sortierung der Werte an der Komponente konfiguriert werden.
217 * **Einträge aus Liste**
218 Hierüber kann eine Liste ausgewählt werden aus der Listenverwaltung.
219 * **Darstellung der Werte**
220 Hierüber kann eingestellt werden, ob die Werte nebeneinader oder untereinander erscheinen sollen.
221 * **Bezeichnung öffentlich**
222 Hierüber kann die Bezeichnung die der Bürger sieht hinterlegt werden.
223 * **Wert**
224 Hierüber kann der Wert der im XML und im PDF abgedruckt wird, hinterlegt werden.
225 * **Vorauswahl**
226 Hierüber kann hinterlegt werden, welcher Wert vorausgewählt sein soll.
227
228 > {{icon name="far fa-info-circle" size="3"/}} _**Hinweis:**_
229 >
230 > Es werden maximal sieben Werte aus einer Dropdown-Komponente im gernerierten PDF und der Druckvorlage angezeigt. Wenn mehr als sieben Werte enthalten sind, wird nur ein einzeiliges Textfeld dargestellt.
231
232 * **Geo-Koordinaten**
233 * **Liste auswählen**
234 Hierüber kann eine Liste ausgewählt werden aus der Listenverwaltung.
235 * **Bezeichnung technisch**
236 Diese Spalte spiegelt die technische Bezeichnung der hinterlegten Komponenten wieder die sich in der Geo-Koordinaten-Komponente befindet.
237 * **Geo-Koordinaten Feld**
238 Dieses Feld legt fest, wie die Werte zwischen der grafischen Karte und den darunterliegenden Textfelder abzubilden sind. Somit werden bei Klick in die Karte die zugehörigen Eingabefelder befüllt und umgekehrt.
239 * **Listenfeld**
240 Diese Spalte spiegelt die Spaltenüberschrift der ausgewählten Liste wieder.
241 * **Nur ab Feldanfang suchen?**
242 Diese Spalte gibt an, ob die eingegebenen Werte nur ab Feldanfang gesucht werden sollen.
243 * **Groß-Klein-Schreibung ignorieren?**
244 Diese Spalte gibt an, ob die Groß- und Kleinschreibung berücksichtigt werden soll.
245 * **Prioritätsstufe**
246 Diese Spalte gibt die Priorität innerhalb der Autovervollständigung an. Somit kann ein Verhalten konfiguriert werden, bei dem sich diverse Komponenten anhand der Auswahl einer anderen Komponente befüllen.
247 * **WMS-Basis URL**
248 Hier muss ein Link hinterlegt werden, unter welchem eine Schnittstelle (Web Map Service) zum Abrufen von Auszügen von Karten erreichbar ist. Beispiel: <https://mapserver.de/ows>?
249 * **WMS-Layer**
250 Hier muss ein/mehrere Layer-Namethumb_down hinterlegt werden, die angezeigt werden sollen. Ein Layer beschreibt die Anzeigeart des Kartenmaterials. So kann beispielsweise die Anzeige von Luftbildern, Schwarz-Weiß, o.Ä. konfiguriert werden, sofern die verwendete Schnittstelle diese Optionen anbietet. Werden mehr als ein Layer definiert, erhält der Benutzer über ein Optionsfeld die Möglichkeit die Anzeigeart zu wechseln. Beispiel: karte:grau oder karte:grau,karte:ortsnamen
251 * **Anzeigename**
252 Für jeden WMS-Layer kann ein beschreibender Name definiert werden. Dieser wird anschließend für die Beschriftung des Optionsfelds verwendet. Beispiel: karte:grau ist als Layer hinterlegt. Als Anzeigename wird "Schwarz-Weiß Karte" verwendet.
253 * **Auto-Vervollständigung**
254 * **Art des Services**
255 Hier muss die Auswahl „Vorkonfigurierte Datenliste“ ausgewählt werden.
256 * **Liste auswählen**
257 Aus der Listenverwaltung kann eine Liste ausgewählt werden. Bei einer List mit mehr als 32 Spalten werden nur die ersten 32 Spalten automatisch sortiert und die restlichen Spalten werden unsortiert mitgeführt.
258 * **Art der Validierung**
259 Hier muss die Art „Nur Validierung“ ausgewählt werden. Somit wird später nach der Eingabe der Werte geprüft, ob diese den Werten in der hinterlegten Liste entsprechen. Ist dies nicht der Fall, wird dem Ausfüller eine Fehlermeldung angezeigt.
260 * **Verstecktes Feld**
261 * **Wert**
262 Hierüber kann der Wert definiert werden, den das versteckte Feld enthalten soll.
263 * **Schaltfläche**
264 * **Funktionalität**
265 Hierüber definieren Sie die Funktionalität der Schaltfläche. Beim Klick auf die Schaltfläche wird dann beispielsweise die Vorschau des bisher ausgefüllten PDF-Formulars angezeigt.
266 * **externe Ressource**
267 * **Einbindungsart**
268 Hierüber definieren Sie die Einbndungsart der extern hinterlegten Ressource.
269 * **URL**
270 Hier können Sie eine URL hinlegen. Der Inhalt der URL wird dann als externe Ressource im Panel eingebunden und dem Bürger angezeigt. Die URL muss beispielsweise wie folgt aussehen <https://www.musterstadt.de>
271 * **Breite**
272 Hierüber definieren Sie die Breite des eingebetteten Inhalts. Die Eingabe ist in Pixel (px). Standardmäßig ist die maximale Breite von 958 px hinterlegt.
273 * **Höhe**
274 Hierüber definieren Sie die Höhe des eingebetteten Inhalts. Die Eingabe ist in Pixel (px). Standardmäßig ist eine Höhe von 479 px hinterlegt.
275
276 #### Rubrik „Automatische Befüllung von Feldern“
277
278 ##### Bei kopierten Komponenten
279
280 In der Rubrik „Automatische Befüllung von Feldern“ werden alle Komponenten des geöffneten Panels aufgeführt. Diese Rubrik wird beispielsweise benötigt bei einer Dropdown-Komponente mit [[Listenbefüllung und automatischer Befüllung von Komponenten|Main.05_Assistenten.04_Assistentenbauoberfläche.08_Listen.02_Listennutzung.03_BeispieleListennutzung]].
281
282 ##### Bei verknüpften Komponenten
283
284 Bei verknüpften Komponenten steht in diesem Reiter „Automatische Befüllung von Feldern“ die Möglichkeit einzelne Komponenten innerhalb der Objektgruppe ein-/auszublenden sowie entsprechend einer Vorbefüllung zuzuordnen. Hierbei steht in der Konfiguration der Verknüpfung unter dem Reiter "Konfiguration der inneren Komponenten" eine Tabelle mit allen Komponenten in der Objektgruppe zur Verfügung. Die einzelnen Komponenten könne je nach Eigenschaft des Assistenten dann folgend konfiguriert werden:
285
286 * **Zuordnung Vorbefüllung**
287 Hierüber kann mittels einer Liste hinterlegt werden, mit welchem Wert die Komponente aus der [[Vorbefüllung|Main.05_Assistenten.04_Assistentenbauoberfläche.11_VorbefüllungvonAssistenten]] vorbefüllt werden soll.
288 * **Anzeige im Assistent**
289 Mit der Auswahl „Anzeige im Assistenten“, die immer zur Verfügung steht, kann angegeben werden, ob die Komponente im Ausfüllprozess angezeigt werden soll oder nicht.
290 * **Anzeige im PDF**
291 Hier kann angegeben werden, wann das Feld im generierten PDF-Formular angezeigt werden soll.
292 * **Anzeige in der Druckvorlage**
293 Hier kann angegeben werden, ob die Komponente in der [[Druckvorlage|Main.05_Assistenten.10_Druckvorlagen]] des Assistenten angezeigt werden soll.
294
295 > {{icon name="far fa-info-circle" size="3"/}} _**Hinweis:**_
296
297 1. Bei den Einstellungen Anzeige im Assistent, PDF und Druckvorlage ist die oberste Ebene ausschlaggebend. Das heißt, wenn innerhalb der Komponente beispielsweise Anzeige im Assistent "niemals" aber in der Verknüpfung auf "immer" eingestellt wurde, dann wird die Komponente immer angezeigt.
298 1. Weiterhin sind die Spalten Anzeige im PDF und Anzeige in der Druckvorlage nur vorhanden, wenn in den [[Assistenteneigenschaften|Main.05_Assistenten.03_NeuenAssistentenanlegen]] die Funktionen hinterlegt wurden.
299
300 ![[Ansicht der Konfiguration einer verknüpften Komponente|@KonfiKomponenteVerknüpfungKonfiguration.jpg]]
301
302 ---
303
304 ### Visuelle Übersicht mittels Icons
305
306 Um auch außerhalb der Konfiguration der Komponenten einen Überblick zu haben über die hinterlegten Anzeigeeinstellungen sowie den hinterlegten ContextIdentifier, die Zuordnung Vorbefüllung oder hinterlegte Komponentenregeln, steht eine visuelle Darstellung mittels Icons neben jeder Komponente im Assistentenbau zur Verfügung.
307
308 ![[Visuelle Übersicht außerhalb der Konfiguration von Komponenten|@KonfiVisuelleÜbersicht.jpg]]
309
310 * ![[Icon für die Anzeige im Assistent|@KonfiIconAssistent.jpg]] **Anzeige im Assistent**
311 Einstellung für die Anzeige oder nicht anzeige im Ausfüllprozess des Assistenten.
312 * ![[Icon für die Anzeige im generierten PDF-Formular|@KonfiIconPDF.jpg]] **Anzeige im generierten PDF-Formular**
313 Einstellung für die Anzeige oder nicht anzeige im generierten PDF-Formular.
314 * ![[Icon für die Anzeige in der Druckvorlage|@KonfiIconDruckvorlage.jpg]] **Anzeige in der Druckvorlage**
315 Einstellung für die Anzeige oder nicht anzeige in der Druckvorlage.
316 * ![[Icon für die Anzeige eines ContextIdentifiers|@KonfiIconCI.jpg]] **Anzeige eines hinterlegen ContextIdentifiers**
317 Einstellung, ob ein ContextIdentifier hinterlegt ist oder nicht. Weiterhin wird der entsprechende ContextIdentifier Pfad aufgeführt.
318 * ![[Icon für die Anzeige einer Zuordnung Vorbefüllung|@KonfiIconZuordnungVorbefüllung.jpg]] **Anzeige einer hinterlegten Zuordnung Vorbefüllung**
319 Einstellung, ob eine Zuordnung Vorbefüllung hinterlegt ist oder nicht. Weiterhin wird die entsprechende Zuordnung aufgeführt.
320 * ![[Icon für die Anzeige einer Komponentenregel|@KonfiIconRegeln.jpg]] **Anzeige einer hinterlegten Komponentenregel**
321 Einstellung, ob eine Komponentenregel hinterlegt ist oder nicht.
322
323 > {{icon name="far fa-info-circle" size="3"/}} _**Hinweis:**_
324 >
325 > Bitte beachten Sie, mittels Mouseover über den Icons, wird auch textuell angezeigt, für was das entsprechende Icon steht.
326
327 Mittels den Farben wird der jeweilige Status angezeigt. Die Farben signalisieren hierbei folgendes:
328
329 * **Grün**
330 Signalisiert, dass eine Konfiguration oder Anzeige (immer) hinterlegt ist.
331 * **Gelb** (nur bei Anzeige im generierten PDF-Formular)
332 Diese Komponente wird analog zur Einstellung in der Komponente „Wenn Wert vorhanden“ nur wenn ein Wert vorhanden ist angezeigt.
333 * **Rot**
334 Signalisiert, dass eine keine Konfiguration oder Anzeige (niemals) hinterlegt ist.
335
336 > {{icon name="far fa-info-circle" size="3"/}} _**Hinweis:**_
337 >
338 > Die jeweiligen Icons „Anzeige im generierten PDF-Formular“ und „Anzeige in der Druckvorlage“ qwrden nur angezeigt, wenn der Assistent in den Assistenteneigenschaften entsprechend konfiguriert wurde.
339
340 ---
341
342 ### Konfiguration von Komponentengruppen
343
344 Werden Komponentengruppen in einem Assistenten erstellt/eingefügt kann jede einzelne Komponente hinsichtlich den Anzeigeeinstellungen konfiguriert werden. Weiterhin kann in der obersten Ebene der Komponentengruppe diese Einstellungen vorgenommen werden. Hierbei gilt, wird in obersten Koponentengruppenebene eine andere Einstellung vorgenommen, richten sich die einzelnen Komponenten an der obersten Ebene aus.
345
346 Beispielsweise wird in den einzelnen Komponenten eingestellt „Anzeige immer in Druckvorlage“. In der obersten Ebene wird aber „Anzeige niemals in Druckvorlage“ eingestellt. So werden nun alle Komponenten in der Gruppe _nicht_ in der Druckvorlage angezeigt.
347
348 ![[Visuelle Übersicht Komponentengruppen|@KonfiGruppen.jpg]]
349
350 ---
351
352 ### Komponente als Vorlage speichern ![[Schaltfläche, um die Komponente als Vorlage zu speichern|@KonfialsVorlagespeichern.jpg]]
353
354 Mittels der Schaltfläche „als Vorlage speichern“ in der Komponentenwerkzeugleiste kann eine Komponente in die [[Kundenbibliothek|Main.05_Assistenten.04_Assistentenbauoberfläche.03_Bibliothek]] abgespeichert werden. Diese neue Komponente wird dann in die entsprechende Rubrik in der Kundenbibliothek abgelegt und kann in dem befindlichen Assistenten weiterverwendet bzw. in anderen Assistenten verwendet werden. Beim Speichern wird die definierten Einstellungen wie beispielsweise die Anzeigeeinstellungen oder die Definition von einem Context-Identifier mit gespeichert.
355
356 > {{icon name="far fa-info-circle" size="3"/}} _**Hinweis:**_
357 >
358 > Wenn Sie eine Gruppe in Ihre Kundenbibliothek abspeichern möchten, müssen Sie die Schaltfläche „als Vorlage speichern“ der Gruppe nutzen.
359
360 ![[Verschiedene Arten von Speichern als Vorlage|@KonfiSpeichernVorlage.jpg]]
361
362 ---
363
364 ### Komponente löschen ![[Schaltfläche, um die Komponente zu löschen|@KonfiKomponentelöschen.jpg]]
365
366 Mit der Hilfe der Schaltfläche „Löschen“ in der Komponentenwerkzeugleiste kann eine Komponente die zu viel oder nicht benötigt wird, gelöscht werden. Nach der Bestätigung der Sicherheitsfrage wird die Komponente von dem Panel gelöscht. Die Komponente kann jederzeit neu aus der Bibliothek in das Panel eingefügt und neu konfiguriert werden.
367
368 ---
369
370 ### Komponentenregel ![[Schaltfläche, um der Komponente Regeln hinzuzufügen|@KonfiRegel.jpg]]
371
372 Über die Schaltfläche „Bearbeitung der Aktivierungsregel/Berechnungsregel“ in der Komponentenwerkzeugleiste können der Komponente [[Regeln|Main.05_Assistenten.04_Assistentenbauoberfläche.07_Regelbau]] hinterlegt werden.
373
374 ---
375
376 ## Einstellung der Komponentenbreite
377
378 Jede Komponente enthält die Einstellung einer „Breitenangabe“. Über diese Breitenangabe kann angegeben werden, wie viel Platz die Komponente auf einem Panel im Ausfüllprozess erhält. Grundsätzlich wird immer beim Einfügen einer Standard-Komponente aus der [[Bibliothek|Main.05_Assistenten.04_Assistentenbauoberfläche.03_Bibliothek]] auf ein Panel eine Komponentenbreite von „100 Prozent“ vordefiniert. Dabei entsprechen 100 Prozent der Gesamtlänge einer Zeile im Panel (je nach Auflösung des Ausfüllgerätes wird die Gesamtlänge der Zeile entsprechend angepasst). Wird eine Komponente beispielsweise mit einer Breitenangabe von 50 Prozent definiert, dann kann eine zweite Komponente mit ebenfalls 50 Prozent im Ausfüllprozess daneben platziert werden. Eine neue Zeile beginnt immer, wenn die vorherige Zeile die Gesamtlänge von 100 Prozent erreicht hat.
379
380 > {{icon name="far fa-info-circle" size="3"/}} _**Hinweis:**_
381 >
382 > Die Angabe der Breite wirkt sich beim Nutzen eines generierten PDF-Formulars und in der Druckvorlage auch aus. Das heißt, sofern eine Komponente mit einer Breite mit 50 Prozent eingestellt wurde, wird die Komponente im generierten PDF/in der Druckvorlage mit dieser Breite abgedruckt.
383
384 ![[Ansicht der Breiteneinstellung der Komponenten|@KonfiBreite.jpg]]
385
386 ### Spezielle Aktionen zum Umwandeln von Schaltflächen
387
388 Um eine Datumsfeldgruppe in Objektgruppe umwandeln kann man folgende Schaltfläche verwenden
389
390 ![[Datumsfeldgruppe in Objektgruppe umwandeln|UmwandelnDatumsfeldgruppe.png]]
391
392 Um eine Objektgruppe in eine Datumsfeldgruppe umwandeln kann man folgende Schaltfläche verwenden
393
394 ![[Umwandeln in Objektgruppe|UmwandelnObjektgruppe.png]]

Navigation