Zum Inhalt springen
Zuletzt geändert von MACH ProForms GmbH am 28.03.2025
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 im Formulareditor 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.machproforms.de/dsb)` 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 > Dieses 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 für eine Komponente in einer [[Objektgruppe|Main.05_Assistenten.04_Assistentenbauoberfläche.03_Bibliothek]] einen Context-Identifier konfigurieren, muss sich die korrespondierende Komponente ebenfalls in einer Objektgruppe befinden. Auch hier gilt, dass die Namen gleich sein müssen.
52 >
53 > 2.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.
54
55 * **Anzeige erzwingen**
56 Wenn ein Context-Identifier definiert wurde und 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 Komponentenkonfiguration gesetzt wurde.
57 * **Wert wird als Verweis von anderen Komponenten verwendet**
58 „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.
59 * **Anzeige im Assistenten**
60 Mit der Auswahl „Anzeige im Assistent“, kann angegeben werden, ob die Komponente im Ausfüllprozess angezeigt werden soll oder nicht. Standardmäßig ist dieser Wert auf „Immer" gesetzt.
61 Durch Aktivierungsregeln können Komponenten unabhängig von dieser Grundeinstellung ein- und ausgeblendet werden.
62 * **Anzeige im PDF-Formular**
63 Die Auswahl „Anzeige im PDF“ existiert nur bei Komponenten in Assistenten vom Typ „Assistent mit generiertem PDF“.
64 Hier kann angegeben werden, wann das Feld im generierten PDF-Formular angezeigt werden soll. Standardmäßig ist „Wenn Wert vorhanden“ gesetzt.
65 * **Anzeige in Druckvorlage**
66 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.
67 Hier kann angegeben werden, ob die Komponente in der [[Druckvorlage|Main.05_Assistenten.10_Druckvorlagen]] des Assistenten angezeigt werden soll. Standardmäßig ist der Wert „Immer“ gesetzt.
68
69 > {{icon name="far fa-info-circle" size="3"/}} _**Hinweis:**_ Bei Druckvorlagen werden Regeln, definierte Standardwerte, Platzhalter, Zeilen und Pflichtfelder nicht beachtet.
70
71 #### Rubrik „Hinweistext“
72
73 > {{icon name="far fa-info-circle" size="3"/}} _**Hinweis:**_
74
75 1. Diese Rubrik steht nicht bei den Komponenten Autovervollständigung, Webservice, Objektgruppen, Text, Geo-Koordinaten und verstecktes Feld zur Verfügung.
76 1. Weiterhin kann bei kundenspezifischen Änderungen die Barrierefreiheit der Anwendung beeinträchtigt werden.
77 1. Der hinterlegte Hinweistext bei der Komponente "Schaltfläche" wird über Mouseover dem Nutzer sichtbar.
78
79 * **Hinweis**
80 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.
81
82 #### Rubrik „Erläuternder Text“
83
84 > {{icon name="far fa-info-circle" size="3"/}} _**Hinweis:**_
85
86 1. Diese Rubrik steht nur bei Objektgruppen und Geo-Koordinaten zur Verfügung.
87 1. Der hinterlegte Text wird **vor** der Bezeichnung öffentlich angezeigt.
88 1. Weiterhin kann bei kundenspezifischen Änderungen die Barrierefreiheit der Anwendung beeinträchtigt werden.
89
90 * **Titel**
91 Hier kann eine Überschrift für den erläuternder Text hinterlegt werden.
92
93 > {{icon name="far fa-info-circle" size="3"/}} _**Hinweis:**_
94 >
95 > Der Titel wird als Überschriftsebene 2 dargestellt (h2).
96
97 * **Text**
98 Hier kann eine erläuternder Text hinterlegt werden.
99
100 > {{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.
101
102 #### Rubrik „Spezielle Einstellungen“
103
104 Die Rubrik „Spezielle Einstellungen“ enthält je nach Komponente unterschiedlichste Auswahlmöglichkeiten. Nachfolgend werden die generellen sowie spezifischen Einstellungsmöglichkeiten aufgeführt.
105
106 > {{icon name="far fa-info-circle" size="3"/}} _**Hinweis:**_ Bei Text-Komponenten wird hier der definierte Text hinterlegt.
107
108 ##### Generelle spezielle Einstellungen
109
110 * **Schreibschutz**
111 Ü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.
112 * **Pflichtfeld**
113 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.
114
115 > {{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.
116
117 * **Platzhalter**
118 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.
119 * **Standardwert**
120 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.
121
122 ##### Komponentenspezifische Einstellungen
123
124 * **Textfeld (einzeilig)/(mehrzeiliges)**
125 * **Spezialtyp**
126 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.
127
128 > {{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.
129
130 * **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.
131 * **Ausgabe im PDF**
132
133 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.
134
135 > {{icon name="far fa-info-circle" size="3"/}} _**Hinweis:**_
136 >
137 > Diese Einstellung steht nur bei einem generierten Assistenten zur Verfügung. * **Regulärer Ausdruck**
138 >
139 > Hierüber kann ein regulärer Ausdruck (Zeichenkette) definiert werden, der zur Validierung der Nutzereingabe verwendet wird. Beispiel: "[a-z]*"
140
141 > {{icon name="far fa-info-circle" size="3"/}} _**Hinweis:**_
142 >
143 > 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).
144
145 * **Datums-/Uhrzeitfeld**
146 * **Darstellung**
147 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.
148 * **Wochenende ausschließen**
149 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.
150
151 > {{icon name="far fa-info-circle" size="3"/}} _**Hinweis:**_
152 >
153 > Diese Einstellung steht nicht mit der Darstellung "Zeit" zur Verfügung.
154
155 * **Tage ausschließen**
156 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]].
157
158 > {{icon name="far fa-info-circle" size="3"/}} _**Hinweis:**_
159 >
160 > Diese Einstellung steht nicht mit der Darstellung "Zeit" zur Verfügung.
161
162 * **Die Eingabe muss vor/nach einem Datum sein.**
163 Ü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.
164 * **Die Eingabe darf maximal vor/nach dem Ausfülldatum liegen.**
165 Ü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.
166
167 > {{icon name="far fa-info-circle" size="3"/}} _**Hinweis:**_
168 >
169 > Bei dem Eingabefeld "Die Eingabe darf maximal vor dem Ausfülldatum liegen" muss mit einer Negativzahl bestückt werden. Beispiel: -2.
170
171 * **Numerisches Feld / Dezimalfeld**
172 * **Spezialtyp**
173 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.
174 * **Dezimalzahl**
175 Hierüber kann angegeben werden, ob es sich bei der angegebenen Zahl um eine Dezimalzahl handeln soll.
176 * **Anzahl Nachkommastellen**
177 Sofern die Einstellung Dezimalzahl auf "Ja" gestellt wurde, kann zusätzlich angegeben werden, wie viele Nachkommstellen bei der Eingabe zugelassen sind.
178 * **Minimaler/Maximaler Wert**
179 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.
180 * **Regulärer Ausdruck**
181 Hierüber kann ein regulärer Ausdruck (Zeichenkette) definiert werden, der zur Validierung der Nutzereingabe verwendet wird. Beispiel: "[a-z]*"
182
183 > {{icon name="far fa-info-circle" size="3"/}} _**Hinweis:**_
184 >
185 > 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).
186
187 * **Datei-Hochladen**
188 * **Dateityp**
189 Ü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.
190 * **Maximale Dateigröße**
191 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.
192 * **Bezeichnung technisch als Dateiname verwenden**
193 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.
194 * **Text**
195 * **Titel**
196 Hier kann eine Überschrift, die als Überschriftenebene 2 (h2) dargestellt wird, hinterlegt werden.
197 * **Text**
198 Hier kann mitttels dem Editor ein Text hinterlegt und konfiguriert werden.
199
200 > {{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.
201
202 * **Kontrollkästchen**
203 * **An-Wert**
204 Hier ist der Wert hinterlegt, der dem ausgewählten Werten der Bürgersicht entspricht.
205 * **Aus-Wert**
206 Hier ist der Wert hinterlegt, der dem nicht ausgewählten Werten der Bürgersicht entspricht.
207 * **Dropdown/Optionsfelder**
208 * **Darstellung**
209 Hierüber kann definiert werden, ob die Komponente als Radiobuttons oder eine Dropdown-Liste dargestellt werden soll.
210 * **Einträge alphabetisch sortieren**
211 Mit dieser Einstellung kann eine alphabetische Sortierung der Werte an der Komponente konfiguriert werden.
212 * **Einträge aus Liste**
213 Hierüber kann eine Liste ausgewählt werden aus der Listenverwaltung.
214 * **Darstellung der Werte**
215 Hierüber kann eingestellt werden, ob die Werte nebeneinader oder untereinander erscheinen sollen.
216 * **Bezeichnung öffentlich**
217 Hierüber kann die Bezeichnung die der Bürger sieht hinterlegt werden.
218 * **Wert**
219 Hierüber kann der Wert der im XML und im PDF abgedruckt wird, hinterlegt werden.
220 * **Vorauswahl**
221 Hierüber kann hinterlegt werden, welcher Wert vorausgewählt sein soll.
222
223 > {{icon name="far fa-info-circle" size="3"/}} _**Hinweis:**_
224 >
225 > 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.
226
227 * **Geo-Koordinaten**
228 * **Liste auswählen**
229 Hierüber kann eine Liste ausgewählt werden aus der Listenverwaltung.
230 * **Bezeichnung technisch**
231 Diese Spalte spiegelt die technische Bezeichnung der hinterlegten Komponenten wieder die sich in der Geo-Koordinaten-Komponente befindet.
232 * **Geo-Koordinaten Feld**
233 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.
234 * **Listenfeld**
235 Diese Spalte spiegelt die Spaltenüberschrift der ausgewählten Liste wieder.
236 * **Nur ab Feldanfang suchen?**
237 Diese Spalte gibt an, ob die eingegebenen Werte nur ab Feldanfang gesucht werden sollen.
238 * **Groß-Klein-Schreibung ignorieren?**
239 Diese Spalte gibt an, ob die Groß- und Kleinschreibung berücksichtigt werden soll.
240 * **Prioritätsstufe**
241 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.
242 * **WMS-Basis URL**
243 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>?
244 * **WMS-Layer**
245 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
246 * **Anzeigename**
247 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.
248 * **Auto-Vervollständigung**
249 * **Art des Services**
250 Hier muss die Auswahl „Vorkonfigurierte Datenliste“ ausgewählt werden.
251 * **Liste auswählen**
252 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.
253 * **Art der Validierung**
254 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.
255 * **Verstecktes Feld**
256 * **Wert**
257 Hierüber kann der Wert definiert werden, den das versteckte Feld enthalten soll.
258 * **Schaltfläche**
259 * **Funktionalität**
260 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.
261 * **externe Ressource**
262 * **Einbindungsart**
263 Hierüber definieren Sie die Einbindungsart der extern hinterlegten Ressource.
264 * **URL**
265 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>
266 * **Breite**
267 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.
268 * **Höhe**
269 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.
270
271 #### Rubrik „Automatische Befüllung von Feldern“
272
273 ##### Bei kopierten Komponenten
274
275 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]].
276
277 ##### Bei verknüpften Komponenten
278
279 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:
280
281 * **Zuordnung Vorbefüllung**
282 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.
283 * **Anzeige im Assistent**
284 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.
285 * **Anzeige im PDF**
286 Hier kann angegeben werden, wann das Feld im generierten PDF-Formular angezeigt werden soll.
287 * **Anzeige in der Druckvorlage**
288 Hier kann angegeben werden, ob die Komponente in der [[Druckvorlage|Main.05_Assistenten.10_Druckvorlagen]] des Assistenten angezeigt werden soll.
289
290 > {{icon name="far fa-info-circle" size="3"/}} _**Hinweis:**_
291
292 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.
293 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.
294
295 ![[Ansicht der Konfiguration einer verknüpften Komponente|@KonfiKomponenteVerknüpfungKonfiguration.jpg]]
296
297 ---
298
299 ### Visuelle Übersicht mittels Icons
300
301 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 Formulareditor zur Verfügung.
302
303 ![[Visuelle Übersicht außerhalb der Konfiguration von Komponenten|@KonfiVisuelleÜbersicht.jpg]]
304
305 * ![[Icon für die Anzeige im Assistent|@KonfiIconAssistent.jpg]] **Anzeige im Assistent**
306 Einstellung für die Anzeige oder nicht anzeige im Ausfüllprozess des Assistenten.
307 * ![[Icon für die Anzeige im generierten PDF-Formular|@KonfiIconPDF.jpg]] **Anzeige im generierten PDF-Formular**
308 Einstellung für die Anzeige oder nicht anzeige im generierten PDF-Formular.
309 * ![[Icon für die Anzeige in der Druckvorlage|@KonfiIconDruckvorlage.jpg]] **Anzeige in der Druckvorlage**
310 Einstellung für die Anzeige oder nicht anzeige in der Druckvorlage.
311 * ![[Icon für die Anzeige eines ContextIdentifiers|@KonfiIconCI.jpg]] **Anzeige eines hinterlegen ContextIdentifiers**
312 Einstellung, ob ein ContextIdentifier hinterlegt ist oder nicht. Weiterhin wird der entsprechende ContextIdentifier Pfad aufgeführt.
313 * ![[Icon für die Anzeige einer Zuordnung Vorbefüllung|@KonfiIconZuordnungVorbefüllung.jpg]] **Anzeige einer hinterlegten Zuordnung Vorbefüllung**
314 Einstellung, ob eine Zuordnung Vorbefüllung hinterlegt ist oder nicht. Weiterhin wird die entsprechende Zuordnung aufgeführt.
315 * ![[Icon für die Anzeige einer Komponentenregel|@KonfiIconRegeln.jpg]] **Anzeige einer hinterlegten Komponentenregel**
316 Einstellung, ob eine Komponentenregel hinterlegt ist oder nicht.
317
318 > {{icon name="far fa-info-circle" size="3"/}} _**Hinweis:**_
319 >
320 > Bitte beachten Sie, mittels Mouseover über den Icons, wird auch textuell angezeigt, für was das entsprechende Icon steht.
321
322 Mittels den Farben wird der jeweilige Status angezeigt. Die Farben signalisieren hierbei folgendes:
323
324 * **Grün**
325 Signalisiert, dass eine Konfiguration oder Anzeige (immer) hinterlegt ist.
326 * **Gelb** (nur bei Anzeige im generierten PDF-Formular)
327 Diese Komponente wird analog zur Einstellung in der Komponente „Wenn Wert vorhanden“ nur wenn ein Wert vorhanden ist angezeigt.
328 * **Rot**
329 Signalisiert, dass eine keine Konfiguration oder Anzeige (niemals) hinterlegt ist.
330
331 > {{icon name="far fa-info-circle" size="3"/}} _**Hinweis:**_
332 >
333 > Die jeweiligen Icons „Anzeige im generierten PDF-Formular“ und „Anzeige in der Druckvorlage“ werden nur angezeigt, wenn der Assistent in den Assistenteneigenschaften entsprechend konfiguriert wurde.
334
335 ---
336
337 ### Konfiguration von Komponentengruppen
338
339 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 Komponentengruppenebene eine andere Einstellung vorgenommen, richten sich die einzelnen Komponenten an der obersten Ebene aus.
340
341 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.
342
343 ![[Visuelle Übersicht Komponentengruppen|@KonfiGruppen.jpg]]
344
345 ---
346
347 ### Komponente als Vorlage speichern ![[Schaltfläche, um die Komponente als Vorlage zu speichern|@KonfialsVorlagespeichern.jpg]]
348
349 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.
350
351 > {{icon name="far fa-info-circle" size="3"/}} _**Hinweis:**_
352 >
353 > Wenn Sie eine Gruppe in Ihre Kundenbibliothek abspeichern möchten, müssen Sie die Schaltfläche „als Vorlage speichern“ der Gruppe nutzen.
354
355 ![[Verschiedene Arten von Speichern als Vorlage|@KonfiSpeichernVorlage.jpg]]
356
357 ---
358
359 ### Komponente löschen ![[Schaltfläche, um die Komponente zu löschen|@KonfiKomponentelöschen.jpg]]
360
361 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.
362
363 ---
364
365 ### Komponentenregel ![[Schaltfläche, um der Komponente Regeln hinzuzufügen|@KonfiRegel.jpg]]
366
367 Ü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.
368
369 ---
370
371 ## Einstellung der Komponentenbreite
372
373 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.
374
375 > {{icon name="far fa-info-circle" size="3"/}} _**Hinweis:**_
376 >
377 > 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.
378
379 ![[Ansicht der Breiteneinstellung der Komponenten|@KonfiBreite.jpg]]
380
381 ### Spezielle Aktionen zum Umwandeln von Schaltflächen
382
383 Um eine Datumsfeldgruppe in Objektgruppe umwandeln kann man folgende Schaltfläche verwenden
384
385 ![[Datumsfeldgruppe in Objektgruppe umwandeln|UmwandelnDatumsfeldgruppe.png]]
386
387 Um eine Objektgruppe in eine Datumsfeldgruppe umwandeln kann man folgende Schaltfläche verwenden
388
389 ![[Umwandeln in Objektgruppe|UmwandelnObjektgruppe.png]]