Zum Inhalt springen

Wiki-Quellcode von Neuen Assistenten anlegen

Version 1039.10 von MACH formsolutions am 17.07.2025
Zeige letzte Bearbeiter
1 {{toc depth="2"/}}
2
3 So legen Sie einen neuen Assistenten an.
4
5 Sie möchten einen Verlagsassistenten oder eine bestehende Kundenfassung als Grundlage nutzen? Informationen zum Abspeichern eines vorhandenen Assistenten unter neuer Artikelnummer finden Sie im Artikel [[Assistenten speichern>>doc:Main.05_Assistenten.04_Assistentenbauoberfläche.13_Assistentenspeichern.WebHome]].
6
7 = Voraussetzungen =
8
9 * Mandantenrecht „Assistenten“
10 * Benutzerrecht „Assistenten anlegen“
11
12 = Ablaufübersicht =
13
14 1. Formulareditor öffnen
15 1. Eingabemaske "Neuer Assistent" öffnen
16 1. Pflichtangaben ausfüllen
17 11. Typ
18 11. Artikelnummer
19 11. Titel
20 11. Kategorie
21 1. gegebenenfalls optionale Angaben ausfüllen
22 1. Dialogfeld mit "Speichern"-Schaltfläche verlassen
23 1. Assistent speichern mit "Speichern"-Schaltfläche in der Hauptwerkzeugleiste
24
25 Sie haben einen neuen Assistenten angelegt.
26
27 = Anlegen eines neuen Assistenten =
28
29 Wählen Sie im Hauptmenü „Sortiment“ den Punkt „Assistenten erstellen/bearbeiten“.
30
31 Sie sind nun im Formulareditor.
32
33 In der [[Hauptwerkzeugleiste>>Main.05_Assistenten.01_Hauptwerkzeugleiste]] öffnen Sie mit der Schaltfläche „Neuen Assistenten erstellen“ die Eingabemaske „Neuer Assistent“.
34 Hier erfassen Sie die Details zum neuen Assistenten.
35 Speichern Sie den Assistenten nach dem Verlassen der Eingabemaske mit der "Speichern"-Schaltfläche in der Hauptwerkzeugleiste. Beim Schließen des Formulareditors ohne zu Speichern wird der Assistent verworfen.
36
37 [[image:NeuerAS.png||alt="Neuer Assistent erstellen" data-xwiki-image-style-border="true"]]
38
39 ----
40
41 == Eingabemaske „Neuer Assistent“ ==
42
43 |=Reiter|=
44 |Allgemeines|Grundkonfiguration des Assistenten
45 Einstellungen für den Suchfilter "Fachverfahren" und die Funktion "Druckvorlage"
46 |Detailangaben|Beschreibung des Assistenten
47 Notizfelder für interne Dokumentation  
48 |LeiKa/OZG/FIM|Zuordnung des Dienstes zu Schlüsseln des Leistungskatalogs/OZG-ID und FIM-ID
49 |Datenschutz|assistentenspezifische Datenschutzerklärung
50 |Barrierefreiheit|assistentenspezifische Erklärung zur Barrierefreiheit
51 |Versionsdetails|Start- und Enddatum der Assistentenversion
52 Versionsstatus: Entwurf/zur Freigabe bereit/Freigegeben
53
54 == Allgemeines ==
55
56 === Typ ===
57
58 Legen Sie fest, ob Sie einen **Formularassistenten **anlegen, der die Felder eines bestehenden PDF-Formulars befüllt, oder einen **Assistenten mit generiertem PDF-Formular, **der je nach eingegebenen Daten die Ausgabe dynamisch erzeugt.
59
60 **Formularassistent**[[image:@NeuerASFormularassistent.jpg||alt="Assistent der ein PDF befüllt" data-xwiki-image-style-alignment="end" height="300" width="377"]]
61 Ein Assistent, der die Felder eines [[PDF-Formulars>>Main.06_PDF-Formulare]] befüllt.
62 Die im Assistenten angelegten Felder werden durch [[Mapping>>doc:Main.05_Assistenten.04_Assistentenbauoberfläche.06_Mapping.WebHome]] den Feldern des PDF-Formulars zugeordnet.
63
64 Im Vorfeld muss ein entsprechendes PDF-Formular erstellt und im Kundenbereich angelegt werden.
65 Sie können auch ein PDF-Formular aus dem vielseitigen **MACH formsolutions Verlagssortiment** mit einem eigenen Formularassistenten verwenden. Dazu laden Sie das Formular herunter und legen es anschließend in Ihrem Mandanten als Kundenfassungsformular an.
66
67 Für Formularassistenten benötigte Angaben:
68
69 * Die **Formularnummer **des im Kundenbereich angelegten PDF-Formulars, für das der Assistent erstellt wird.
70 * Die zu verwendende **Versionsnummer** des gewählten PDF-Formulars.
71
72 {{html}}<br style="clear:both" />{{/html}}
73 **Assistent mit generiertem PDF-Formular**[[image:@NeuerASgeneriertesPDF.jpg||alt="Assistent der ein generiertes PDF befüllt" data-xwiki-image-style-alignment="end" height="300" width="341"]]
74 Ein Assistent, der aus den eingegebenen Daten ein dynamisch generiertes PDF-Formular erstellt.
75
76 Durch die Logik beim Ausfüllen und Konfigurationsmöglichkeiten der Formularkomponenten enthält die Ausgabe nur die relevanten, bzw. die festgelegten Elemente.
77
78 Es wird kein vorgefertigtes PDF-Formular benötigt und kein Mapping der Felder erforderlich.
79 {{html}}<br style="clear:both" />{{/html}}
80
81 === Artikelnummer und Titel ===
82
83 Die **Artikelnummer **ist die eindeutige Artikelbezeichnung eines Assistenten.
84 Sie setzt sich aus den fixen Buchstaben „KFAS_“, für Kundenfassung, und einer frei wählbaren Bezeichnung zusammen. Beispielsweise „KFAS_Hundesteuermeldung“.
85 Bei Formularassistenten wird die Artikelnummer mit der Formularnummer vorausgefüllt, kann jedoch geändert werden.
86 Sonderzeichen sind in der Artikelnummer nicht erlaubt und mehr als 60 Zeichen werden nicht empfohlen.
87
88 Der **Titel** sollte aussagekräftig aber kompakt formuliert sein.
89 Er ist sichtbar
90
91 * als Seitentitel in der Bürgersicht beim Ausfüllen des Assistenten
92 * als Titel des generierten PDF-Formulars und der Druckvorlage
93 * im Kundenbereich in der Suche, zusammen mit der Artikelnummer
94
95 === Kategorie ===
96
97 [[image:@NeuerASKategorien.jpg||alt="Übersicht die zur Verfügung stehenden Kategorien" data-xwiki-image-style-alignment="end" height="300" width="369"]]Themenkreis, zu dem der neue Assistent gehört.
98 Diese Zuordnung dient als Filter bei der Suche im Kundenbereich und zur Einschränkuing der verfügbaren Formularauswahl durch die [[Sortimentsauswahl>>Main.07_Einstellungen-Fachadministration.01_Mandanten.02_Sortiment]]-Einstellung für Mandanten oder Benutzergruppen.
99
100 === Bundesland ===
101
102 Voraussetzung: Mandantenrecht "Verlagstätigkeit"
103
104 Bundeslandauswahl, für die der neue Assistent zur Verfügung stehen soll. Wird kein Bundesland ausgewählt, steht der Assistent bundesweit zur Verfügung.
105 Diese Zuordnung dient als Filter bei der Suche im Kundenbereich und zur Einschränkuing der verfügbaren Formularauswahl für Mandanten, durch Zuordnung von Bundesländern in den Mandanteneinstellungen.
106
107 So wählen Sie mehrere Bundesländer aus:
108 Halten Sie die Taste „Strg“ gedrückt und klicken Sie auf die einzelnen Bundesländer um diese aus- und abzuwählen.
109
110 === Fachverfahren ===
111
112 Liste der Fachverfahren, für die der Assistent vorbereitet ist.
113 Diese Zuordnung dient als Filter bei der Suche im Kundenbereich.
114
115 Tragen Sie mehrere Fachverfahren gegebenenfalls kommasepariert ein.
116
117 === Als Druckvorlage verwendbar ===
118
119 Aktivieren Sie die Option **Als Druckvorlage verwendbar**, um eine fertiggestellte Version des Assistenten als [[Druckvorlage>>Main.05_Assistenten.10_Druckvorlagen]] mit unausgefüllten Feldern verfügbar zu machen.
120
121 Diese Einstellung aktiviert im Formulareditor an den Komponenten und Bausteinen die Konfigurationsoptionen für die Anzeige in der Druckvorlage.
122
123 ----
124
125 == Detailangaben ==
126
127 Die Eingabefelder **Beschreibung**, **Historie** und **interne Bemerkungen** stehen für interne Zwecke zur Verfügung. Beispielsweise für Notizen, wann, wer welche Änderungen am Assistenten vorgenommen hat.
128 Diese Einträge sind rein intern und werden nur in diesem Dialog angezeigt.
129
130 === Zusätzliche Suchbegriffe ===
131
132 Die zusätzlichen Suchbegriffe haben keine Auswirkung auf die Suche im Kundenbereich.
133
134 ----
135
136 == LeiKa/OZG/FIM ==
137
138 Im Reiter "LeiKa/OZG/FIM" können die einheitlichen Schlüssel des Leistungskatalogs der Verzeichnisse der Verwaltungsleistungen sowie eine Zuordnung der Komponenten zur entsprechenden Festlegung aus dem Förderalen Informationsmanagement (FIM) hinterlegt werden.
139
140
141 (% class="wikigeneratedid" id="HLeiKa" %)
142 LeiKa
143
144 (% class="wikigeneratedid" id="HNeueLeistunghinzufFCgen" %)
145 Neue Leistung hinzufügen
146
147 Über die Schaltfläche "Leistungen hinzufügen" gelangt man in die Such- und Auswahlübersicht, um neue LeiKa-IDs zu suchen und zu hinterlegen.
148
149 [[image:@NeuerASOZGNeueLeistung.jpg||alt="Schaltfläche neue Leistung hinzufügen"]]
150
151 In der Suchleiste kann ein entsprechender Suchbegriff oder eine ID eingegeben werden. Nach dem Betätigen der Schaltfläche "Suchen" erscheinen in der Trefferliste die passenden Ergebnisse.
152
153 [[image:@NeuerASOZGNeueLeistungSuche.jpg||alt="Suche der LeiKa IDs"]]
154
155 In der Trefferliste können die einzelnen LeiKa-IDs über den Haken ausgewählt werden und mit der Schaltfläche "Ausgewählte Leistungen übernehmen" übernommen werden.
156
157 (% class="wikigeneratedid" id="HDetailansicht" %)
158 Detailansicht
159
160 Über die Schaltfläche "Leistung betrachten" können die Details zur Leistung angezeigt werden.
161
162 * (((
163 **LeiKa-ID**
164 Hier wird die offizielle ID der Leistung nach dem Leistungskatalog aufgeführt.
165 )))
166 * (((
167 **Verrichtung**
168 Hier wird die offizielle Verrichtung der Leistung nach dem Leistungskatalog aufgeführt. Die Verrichtung beschreibt das Verwaltungshandeln eines Leistungsobjektes.
169 )))
170 * (((
171 **Bezeichnung**
172 Hier wird offizielle Bezeichnung der Leistung nach dem Leistungskatalog aufgeführt.
173 )))
174 * (((
175 **Weiterführende Links**
176 Hier werden zusätzliche Referenzen als Links zur ausgewählten Leistung aufgeführt.
177 )))
178
179 [[image:@NeuerASOZGNeueLeistungInfo.jpg||alt="Detailansicht der einzelnen Leistungen"]]
180
181 (% class="wikigeneratedid" id="HLeistunglF6schen" %)
182 Leistung löschen
183
184 Über die Schaltfläche "Leistungen entfernen" kann eine LeiKa ID aus der Detailübersicht entfernt werden.
185
186 (% class="wikigeneratedid" id="HZugehF6rigeOZG-Leistunganzeigen" %)
187 Zugehörige OZG-Leistung anzeigen
188
189 Über die Schaltfläche "Zugehörige OZG-Leistung anzeigen" kommt man zu der entsprechenden OZG-Leistung die für die hinterlegte LeiKa ID vorhanden ist. Eine Übersicht aller OZG-Leistungen findet man im Reiter "OZG".
190
191 [[image:@NeuerASOZGLeistung.jpg||alt="Zugehörige OZG-Leistungen anzeigen Icon"]]
192
193 (% class="wikigeneratedid" id="HOZG" %)
194 OZG
195
196 In dem Reiter werden alle OZG-Leistungen aufgeführt. Diese werden nach der Hinterlegung der LeiKa IDs automatisch eingefügt.
197
198 [[image:@NeuerASOZGReiter.jpg||alt="Ansicht OZG Reiter in den Assistenteneigenschaften"]]
199
200 (% class="wikigeneratedid" id="HDetailansicht-1" %)
201 Detailansicht
202
203 Über die Schaltfläche "Leistung betrachten" können die Details zur Leistung angezeigt werden.
204
205 * (((
206 **OZG-ID**
207 Hier wird der fünfstellige und eindeutige Schlüssel der die OZG-Leistung identifiziert angezeigt.
208 )))
209 * (((
210 **Leistungsbezeichnung**
211 Der Begriff OZG-Leistung beschreibt ein Leistungsbündel, welches sich aus mehreren LeiKa-Leistungen zusammensetzt, die aus Nutzersicht zusammenhängen.
212 )))
213 * (((
214 **Themenfeld**
215 Ein Themenfeld setzt sich aus mehreren inhaltlich verwandten Lebens- und/oder Geschäftslagen zusammen. Die 63 Lebens- und Geschäftslagen sind in 14 Themenfeldern zusammengefasst. Ein Themenfeld kann sowohl Leistungen für Bürger:innen als auch für Unternehmen enthalten. Die Bündelung in Themenfeldern dient zum einen dazu, dass Leistungen, die aus Nutzer:innensicht zusammenhängen, auch bei der Digitalisierung im Zusammenhang betrachtet werden und zum anderen als Grundlage für die aufgabenteilige Umsetzung.
216 )))
217 * (((
218 **Lebens-/Geschäftslage**
219 Um die Umsetzung des OZG aus Nutzersicht zu unterstützen, sind die Verwaltungsleistungen im OZG-Umsetzungskatalog nach Lebenslagen von Bürgern, sowie nach Geschäftslagen von Unternehmen gegliedert. Dabei wird jede OZG-Leistung genau einer Lage zugeordnet, kann jedoch sekundär einer oder wenigen weiteren Lagen zugeordnet sein. Es gibt Verwaltungsleistungen, die nicht bestimmten Lebens- und Geschäftslagen zuordenbar sind, beispielsweise Identitäts- und sonstige Nachweise. Solche Leistungen sind im Themenfeld Querschnittsleistungen zusammengefasst.
220 )))
221 * (((
222 **Federführendes Bundesland**
223 Die Themenfelder sind verschiedenen Federführern zugeteilt. Mindestens ein Bundesland und ein Bundesressort haben als "Tandem" die Federführung einzelner Themenfelder inne.
224 )))
225 * (((
226 **Umsetzendes Bundesland**
227 Das Bundesland, welches die Digitalisierung einer oder mehrerer OZG-Leistungen in einem Umsetzungsprojekt verantwortet. In der Regel ist dies das im Themenfeld federführende Bundesland, es kann aber in Einzelfällen abweichen.
228 )))
229 * (((
230 **Prioriät (föderale Leistungen)**
231 Die Themenfelder priorisieren die ihnen zugeordneten OZG-Leistungen anhand festgelegter Kriterien.Die Priorität bestimmt, in welchem Umfang eine OZG-Leistung in der Umsetzungsplanung betrachtet wird: 1 = Laborleistung, 2 = Laborkandidat, 3 = Leistung mittlerer Priorität, 4 = z. Z. keine Digitalisierung. Ist die Priorität "noch offen", steht eine Priorisierung aus oder die OZG-Leistung enthält keine im Digitalisierungsprogramm Föderal bearbeitete Leistungen. Weitere Informationen finden Sie hier: [[https:~~/~~/leitfaden.ozg-umsetzung.de/display/OZG/5.3+Priorisierung+der+Leistungen+im+Themenfeld>>https://leitfaden.ozg-umsetzung.de/display/OZG/5.3+Priorisierung+der+Leistungen+im+Themenfeld]]
232 )))
233 * (((
234 **Prioriät (Bundesleistungen)**
235 Hier wird unterschieden zwischen priorisierten Leistungen, die vorrangig digitalisiert werden (Wert 1), und nicht priorisierten Leistungen (Wert 2), die nachrangig digitalisiert werden.
236 )))
237 * (((
238 **OZG-Zuständigkeit**
239 Die Zuständigkeit einer OZG-Leistung ist eine Aggregation der LeiKa-Typen aller enthaltenen LeiKa-Leistungen. Liegt nur ein Typ vor, gilt dieser auch für die OZG-Leistung. Liegen mehrere Typen vor, handelt es sich um eine Mischleistung. Besonders gekennzeichnet werden Mischleistungen, die LeiKa-Leistungen des Typs 1 enthalten.
240 )))
241
242 (% class="wikigeneratedid" id="HFIM" %)
243 FIM
244
245 Hier kann eine FIM ID hinterlegt werden. Die ID kennzeichnet die Zuordnung der Komponenten zur entsprechenden Festlegung aus dem Föderalen Informationsmanagement. Felder mit dieser Angabe können durch den Anwender nicht angepasst werden.
246
247 >{{icon name="far fa-info-circle" size="3"/}} **//Hinweis~://**
248 >Derzeit kann lediglich eine FIM ID von Mandanten mit einem "Verlagsrecht" hinterlegt werden. Eine Auswirkung besteht derzeit nocht nicht.
249
250 [[image:@NeuerASFIM.jpg||alt="Ansicht FIM Eingabe in den Assistenteneigenschaften"]]
251
252 ----
253
254 (% class="wikigeneratedid" id="HDatenschutz" %)
255 Datenschutz
256
257 Geben Sie hier eine **Datenschutzerklärung** spezifisch für den Assistenten ein.
258
259 Dieser Text wird bei der [[Einwilligungserklärung>>Main.05_Assistenten.02_VeröffentlichungvonAssistenten]] angezeigt, sowie in der Fußzeile der Bürgersicht über die Verlinkung „Datenschutzhinweis“.
260
261 **Priorisierung der konfigurierten Erklärungstexte:**
262
263 1. (((
264 Veröffentlichungskonfiguration
265 Wenn in der Veröffentlichungskonfiguration eine individuelle Datenschutzerklärung hinterlegt ist, wird diese angezeigt
266 )))
267 1. (((
268 Assistentenkonfiguration
269 Ist kein Erklärungstext in der Veröffentlichungskonfiguration hinterlegt, prüft das System, ob im Assistenten ein Text konfiguriert ist, und zeigt diesen an.
270 )))
271 1. (((
272 Mandantenkonfiguration
273 Wenn weder in der Veröffentlichungskonfiguration, noch im Assistenten ein Text definiert ist, wird die mandantenspezifische Datenschutzerklärung angezeigt.
274 )))
275
276 ----
277
278 (% class="wikigeneratedid" id="HBarrierefreiheit" %)
279 Barrierefreiheit
280
281 Geben Sie hier eine **Erklärung zur Barrierefreiheit** spezifisch für den Assistenten ein.
282
283 Dieser Text wird bei der [[Einwilligungserklärung>>Main.05_Assistenten.02_VeröffentlichungvonAssistenten]] angezeigt, sowie in der Fußzeile der Bürgersicht über die Verlinkung „Erklärung zur Barrierefreiheit“.
284
285 **Priorisierung der konfigurierten Erklärungstexte:**
286
287 1. (((
288 Veröffentlichungskonfiguration
289 Wenn in der Veröffentlichungskonfiguration eine individuelle Erklärung zur Barrierefreiheit hinterlegt ist, wird diese angezeigt
290 )))
291 1. (((
292 Assistentenkonfiguration
293 Ist kein Erklärungstext in der Veröffentlichungskonfiguration hinterlegt, prüft das System, ob im Assistenten ein Text konfiguriert ist, und zeigt diesen an.
294 )))
295 1. (((
296 Mandantenkonfiguration
297 Wenn weder in der Veröffentlichungskonfiguration, noch im Assistenten ein Text definiert ist, wird die mandantenspezifische Erklärung zur Barrierefreiheit angezeigt.
298 )))
299
300 ----
301
302 (% class="wikigeneratedid" id="HVersionsdetails" %)
303 Versionsdetails
304
305 (% class="wikigeneratedid" id="HStart-undEnddatum" %)
306 Start- und Enddatum
307
308 Mit dem **Startdatum** wird festgelegt, ab wann der Assistent (die Assistentenversion) nach der [[Veröffentlichung>>Main.05_Assistenten.02_VeröffentlichungvonAssistenten]] zur Verfügung stehen soll. Das Startdatum wird beim Anlegen eines neuen Assistenten (einer Assistentenversion) mit dem aktuellen Datum befüllt.
309
310 Die Angabe **Enddatum** ist optional. Wenn ein Enddatum eingegeben ist, steht der Assistent ab diesem Datum nicht mehr zum Ausfüllen zur Verfügung.
311
312 (% class="wikigeneratedid" id="HVersionsstatus" %)
313 Versionsstatus
314
315 Der **Versionsstatus **zeigt den Stand der Assistentenversion.
316
317 * (((
318 **Entwurf**: Im Entwurfsstatus wird der Assistent bearbeitet. Beim Anlegen einer neuen Version ist der Status Entwurf eingestellt.
319 )))
320 * (((
321 **zur Freigabe bereit**: Zwischenstatus für fertiggestellte Assistenten(versionen), die noch nicht freigegeben sind.
322 )))
323 * (((
324 **Freigegeben**: Der Assistent kann nicht mehr bearbeitet werden und steht zur [[Veröffentlichung>>Main.05_Assistenten.02_VeröffentlichungvonAssistenten]] zur Verfügung.
325 )))
326
327 Mit der Freigabe eines Assistenten (einer Assistentenversion) werden die Angaben und Einstellungen in diesem Dialog final festgelegt und können nicht mehr geändert werden. Das betrifft zum Beispiel das Start- und Enddatum und die Einstellung Druckvorlage. Auch die Inhalte der Assistentenversion können nicht mehr verändert werden.
328 Um die Eigenschaften und Inhalte einer Assistentenversion zu ändern, muss der Assistent als neue Version im Status Entwurf gespeichert werden. [[Aktualisieren von Assistenten ~| MACH formsolutions Anwenderdokumentation>>doc:Main.05_Assistenten.05_Assistentenaktualisieren.WebHome]]