Wiki-Quellcode von Neuen Assistenten anlegen

Version 1038.46 von MACH formsolutions am 16.07.2025

Zeige letzte Bearbeiter
1 {{toc depth="3"/}}
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. Im Vorfeld muss ein entsprechendes PDF-Formular erstellt und im Kundenbereich angelegt werden.
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 MACH ProForms bietet ein vielseitiges Sortiment von PDF-Formularen, die Sie nutzen können, an.
65
66 Es können nur eigene PDF-Formulare (Kundenfassungen) hinterlegt werden.
67 Sofern ein Verlagspdf-Formular genutzt werden soll, muss das Formular erst als Kundenfassung in die MACH formsolutions Plattform hochgeladen werden.
68
69 ~* **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"]]
70 Bei der Auswahl „Assistent mit generiertem PDF-Formular“ wird ein generiertes PDF-Formular von MACH formsolutions erstellt. Dieses generierte PDF-Formular wird wie ein hinterlegtes PDF-Formular befüllt. Der Vorteil hierbei ist, dass kein PDF-Formular im Vorfeld erstellt und im System eingebunden werden muss. Weiterhin kann bei der [[Konfiguration der Komponenten>>Main.05_Assistenten.04_Assistentenbauoberfläche.04_KonfigurationvonKomponenten]] beim Erstellen des Assistenten angegeben werden, welche ausgefüllten Daten das generierte PDF-Formular enthalten soll oder nicht. Die Gestaltung des Layouts ist nur bedingt möglich.
71
72 >{{icon name="far fa-info-circle" size="3"/}} **//Hinweis~://**
73 >MACH ProForms bietet auch hier ein vielseitiges Sortiment, das Sie nutzen können, an.
74
75 * **Formularnummer**
76 In dem Eingabefeld „Formularnummer“ muss die Formularnummer für das im Kundenbereich hinterlegte PDF-Formular angegeben werden. Dieses Eingabefeld steht nur bei der vorherigen Auswahl des Typs „Formularassistent“ zur Verfügung. Dieses Eingabefeld ist nur bei der Auswahl „Formularassistent“ notwendig.
77 * **Version**
78 Mit der „Version“ kann nach der Eingabe einer Formularnummer angegeben werden, auf welche Version des angegebenen PDF-Formulars zugegriffen werden soll. Der höchste Wert entspricht der aktuellsten in der MACH formsolutions Plattform verfügbaren PDF-Formular-Version. Dieses Eingabefeld steht nur bei der vorherigen Auswahl des Typs „Formularassistent“ zur Verfügung. Dieses Eingabefeld ist nur bei der Auswahl „Formularassistent“ notwendig.
79 * **Artikelnummer und Titel**
80 Die „Artikelnummer“ ist die einzigartige Nummer eines Assistenten. Diese Artikelnummer setzt sich aus den fixen Buchstaben „KFAS_“ und einer frei wählbaren Bezeichnung wie beispielsweise „KFAS_Hundesteuermeldung“ zusammen. Sonderzeichen dürfen hier nicht verwendet werden und mehr als 60 Zeichen werden nicht empfohlen. Bei einem Formularassistenten wird die Artikelnummer entsprechend der Formularnummer vor befüllt. Dennoch kann die Artikelnummer abgeändert werden. Der „Titel“ ist für den Ausfüller des Assistenten sichtbar und wird im Ausfüllassistenten über jeder [[Panelseite>>Main.05_Assistenten.04_Assistentenbauoberfläche.01_PanelhinzufügenPanelwerkzeugleiste]] sowie bei einem generierten PDF-Formular/Druckvorlage sichtbar sein. Dieser Titel sollte daher aussagekräftig formuliert werden. Beide Eingabefelder werden in der Trefferliste der [[Suche>>Main.04_Suche]] im Kundenbereich angezeigt bzw. der Assistent kann über diese Felder in der Suche gefunden werden.
81 * **Kategorie**[[image:@NeuerASKategorien.jpg||alt="Übersicht die zur Verfügung stehenden Kategorien" data-xwiki-image-style-alignment="end" height="300" width="369"]]
82 Mit der „Kategorie“ kann angegeben werden, zu welchem Themenkreis der neue Assistent gehört. Sollte eine [[Sortimentsauswahl>>Main.07_Einstellungen-Fachadministration.01_Mandanten.02_Sortiment]] für den Mandanten des Benutzers definiert worden sein, wird dem Ersteller des Assistenten nur ein bestimmter Kreis von Kategorien zur Verfügung stehen.
83 * **Bundesland**
84 Hier kann angegeben werden, für welches spezifische Bundesland dieser Assistent zur Verfügung stehen soll. Soll der Assistent für mehrere Bundesländer zur Verfügung stehen, kann mittels Drücken der Taste „Strg“ und einem Klick auf die einzelnen Bundesländer diese ausgewählt werden. Sofern gar keine Auswahl stattfindet, wird der Assistent als „bundesweit“ gekennzeichnet.
85
86 >{{icon name="far fa-info-circle" size="3"/}} **//Hinweis~://**
87 >Die Auswahl „Bundesland“ steht nur zur Verfügung, wenn der Mandant und Benutzer die entsprechenden Rechte für eine Verlagstätigkeit besitzt.
88
89 * **Fachverfahren**
90 Hier kann angegeben werden, für welches bzw. welche spezifische/n Fachverfahren dieser Assistent geeignet ist. Über ein Komma müssen die verschiedenen Fachverfahren separiert eingetragen werden. In der [[Suche>>Main.04_Suche.02_DetaillierteSuche]] kann dann über die Filterkategorie "Fachverfahren" nach den entsprechenden Assistenten mit dem hinterlegten Fachverfahren gefiltert werden.
91 * **Als Druckvorlage verwendbar**
92 Wird in den Assistenteneigenschaften die Auswahl „Als Druckvorlage verwendbar“ gesetzt, wird damit angegeben, dass sich nach dem Freigeben der Version des Assistenten dieser als eine [[Druckvorlage>>Main.05_Assistenten.10_Druckvorlagen]] eignet.
93
94 >{{icon name="far fa-info-circle" size="3"/}} **//Hinweis~://**
95 >Die [[Konfigurationen>>Main.05_Assistenten.04_Assistentenbauoberfläche.04_KonfigurationvonKomponenten]] an den Komponenten für die Druckvorlage sind deaktiviert, wenn in der Assistentenkonfiguration die Druckvorlage ausgeschaltet ist.
96
97 ----
98
99 == Detailangaben ==
100
101 * **Beschreibung/Historie/Interne Bemerkungen**
102 Die Eingabefelder „Beschreibung“, „Historie“ und „interne Bemerkungen“ stehen für interne Zwecke zur Verfügung. Hierüber kann beispielsweise angegeben werden, wann und wer Änderungen an dem Assistenten vorgenommen hat. Diese Felder sowie Einträge sind außer in diesem Bereich für niemanden ersichtlich.
103 * **Zusätzliche Suchbegriffe**
104 Die zusätzlichen Suchbegriffe haben keine Auswirkung auf die [[Suche>>Main.04_Suche]] im Kundenbereich.
105
106 ----
107
108 == LeiKa/OZG/FIM ==
109
110 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.
111
112
113 ===== LeiKa =====
114
115 ===== Neue Leistung hinzufügen =====
116
117 Über die Schaltfläche "Leistungen hinzufügen" gelangt man in die Such- und Auswahlübersicht, um neue LeiKa-IDs zu suchen und zu hinterlegen.
118
119 [[image:@NeuerASOZGNeueLeistung.jpg||alt="Schaltfläche neue Leistung hinzufügen"]]
120
121 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.
122
123 [[image:@NeuerASOZGNeueLeistungSuche.jpg||alt="Suche der LeiKa IDs"]]
124
125 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.
126
127 ===== Detailansicht =====
128
129 Über die Schaltfläche "Leistung betrachten" können die Details zur Leistung angezeigt werden.
130
131 * **LeiKa-ID**
132 Hier wird die offizielle ID der Leistung nach dem Leistungskatalog aufgeführt.
133 * **Verrichtung**
134 Hier wird die offizielle Verrichtung der Leistung nach dem Leistungskatalog aufgeführt. Die Verrichtung beschreibt das Verwaltungshandeln eines Leistungsobjektes.
135 * **Bezeichnung**
136 Hier wird offizielle Bezeichnung der Leistung nach dem Leistungskatalog aufgeführt.
137 * **Weiterführende Links**
138 Hier werden zusätzliche Referenzen als Links zur ausgewählten Leistung aufgeführt.
139
140 [[image:@NeuerASOZGNeueLeistungInfo.jpg||alt="Detailansicht der einzelnen Leistungen"]]
141
142 ===== Leistung löschen =====
143
144 Über die Schaltfläche "Leistungen entfernen" kann eine LeiKa ID aus der Detailübersicht entfernt werden.
145
146 ===== Zugehörige OZG-Leistung anzeigen =====
147
148 Ü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".
149
150 [[image:@NeuerASOZGLeistung.jpg||alt="Zugehörige OZG-Leistungen anzeigen Icon"]]
151
152 ===== OZG =====
153
154 In dem Reiter werden alle OZG-Leistungen aufgeführt. Diese werden nach der Hinterlegung der LeiKa IDs automatisch eingefügt.
155
156 [[image:@NeuerASOZGReiter.jpg||alt="Ansicht OZG Reiter in den Assistenteneigenschaften"]]
157
158 ===== Detailansicht =====
159
160 Über die Schaltfläche "Leistung betrachten" können die Details zur Leistung angezeigt werden.
161
162 * **OZG-ID**
163 Hier wird der fünfstellige und eindeutige Schlüssel der die OZG-Leistung identifiziert angezeigt.
164 * **Leistungsbezeichnung**
165 Der Begriff OZG-Leistung beschreibt ein Leistungsbündel, welches sich aus mehreren LeiKa-Leistungen zusammensetzt, die aus Nutzersicht zusammenhängen.
166 * **Themenfeld**
167 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.
168 * **Lebens-/Geschäftslage**
169 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.
170 * **Federführendes Bundesland**
171 Die Themenfelder sind verschiedenen Federführern zugeteilt. Mindestens ein Bundesland und ein Bundesressort haben als "Tandem" die Federführung einzelner Themenfelder inne.
172 * **Umsetzendes Bundesland**
173 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.
174 * **Prioriät (föderale Leistungen)**
175 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]]
176 * **Prioriät (Bundesleistungen)**
177 Hier wird unterschieden zwischen priorisierten Leistungen, die vorrangig digitalisiert werden (Wert 1), und nicht priorisierten Leistungen (Wert 2), die nachrangig digitalisiert werden.
178 * **OZG-Zuständigkeit**
179 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.
180
181 ===== FIM =====
182
183 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.
184
185 >{{icon name="far fa-info-circle" size="3"/}} **//Hinweis~://**
186 >Derzeit kann lediglich eine FIM ID von Mandanten mit einem "Verlagsrecht" hinterlegt werden. Eine Auswirkung besteht derzeit nocht nicht.
187
188 [[image:@NeuerASFIM.jpg||alt="Ansicht FIM Eingabe in den Assistenteneigenschaften"]]
189
190 ----
191
192 == Datenschutz ==
193
194 Geben Sie hier eine **Datenschutzerklärung** spezifisch für den Assistenten ein.
195
196 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“.
197
198 **Priorisierung der konfigurierten Erklärungstexte:**
199
200 1. Veröffentlichungskonfiguration
201 Wenn in der Veröffentlichungskonfiguration eine individuelle Datenschutzerklärung hinterlegt ist, wird diese angezeigt
202 1. Assistentenkonfiguration
203 Ist kein Erklärungstext in der Veröffentlichungskonfiguration hinterlegt, prüft das System, ob im Assistenten ein Text konfiguriert ist, und zeigt diesen an.
204 1. Mandantenkonfiguration
205 Wenn weder in der Veröffentlichungskonfiguration, noch im Assistenten ein Text definiert ist, wird die mandantenspezifische Datenschutzerklärung angezeigt.
206
207 ----
208
209 == Barrierefreiheit ==
210
211 Geben Sie hier eine **Erklärung zur Barrierefreiheit** spezifisch für den Assistenten ein.
212
213 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“.
214
215 **Priorisierung der konfigurierten Erklärungstexte:**
216
217 1. Veröffentlichungskonfiguration
218 Wenn in der Veröffentlichungskonfiguration eine individuelle Erklärung zur Barrierefreiheit hinterlegt ist, wird diese angezeigt
219 1. Assistentenkonfiguration
220 Ist kein Erklärungstext in der Veröffentlichungskonfiguration hinterlegt, prüft das System, ob im Assistenten ein Text konfiguriert ist, und zeigt diesen an.
221 1. Mandantenkonfiguration
222 Wenn weder in der Veröffentlichungskonfiguration, noch im Assistenten ein Text definiert ist, wird die mandantenspezifische Erklärung zur Barrierefreiheit angezeigt.
223
224 ----
225
226 == Versionsdetails ==
227
228 === Start- und Enddatum ===
229
230 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.
231
232 Die Angabe **Enddatum** ist optional. Wenn ein Enddatum eingegeben ist, steht der Assistent ab diesem Datum nicht mehr zum Ausfüllen zur Verfügung.
233
234 === Versionsstatus ===
235
236 Der **Versionsstatus **zeigt den Stand der Assistentenversion.
237
238 * **Entwurf**: Im Entwurfsstatus wird der Assistent bearbeitet. Beim Anlegen einer neuen Version ist der Status Entwurf eingestellt.
239 * **zur Freigabe bereit**: Zwischenstatus für fertiggestellte Assistenten(versionen), die noch nicht freigegeben sind.
240 * **Freigegeben**: Der Assistent kann nicht mehr bearbeitet werden und steht zur [[Veröffentlichung>>Main.05_Assistenten.02_VeröffentlichungvonAssistenten]] zur Verfügung.
241
242 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.
243 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]]