Wiki-Quellcode von Neuen Assistenten anlegen

Version 1038.75 von MACH formsolutions am 16.07.2025

version	line-number	content
1036.2	1	{{toc depth="3"/}}
1028.6	2
1035.1	3	So legen Sie einen neuen Assistenten an.
1028.16	4
1031.1	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]].
1028.7	6
1036.2	7	= Voraussetzungen =
1.1	8
1028.2	9	* Mandantenrecht „Assistenten“
	10	* Benutzerrecht „Assistenten anlegen“
	11
1036.2	12	= Ablaufübersicht =
1028.3	13
1028.4	14	1. Formulareditor öffnen
1028.14	15	1. Eingabemaske "Neuer Assistent" öffnen
1028.4	16	1. Pflichtangaben ausfüllen
1031.1	17	11. Typ
	18	11. Artikelnummer
	19	11. Titel
	20	11. Kategorie
1028.5	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
1028.3	24
1028.6	25	Sie haben einen neuen Assistenten angelegt.
	26
1036.2	27	= Anlegen eines neuen Assistenten =
1028.3	28
1023.1	29	Wählen Sie im Hauptmenü „Sortiment“ den Punkt „Assistenten erstellen/bearbeiten“.
1.1	30
1028.14	31	Sie sind nun im Formulareditor.
1023.1	32
1031.1	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.
1028.15	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.
1023.1	36
1038.37	37	[[image:NeuerAS.png\|\|alt="Neuer Assistent erstellen" data-xwiki-image-style-border="true"]]
1.1	38
1031.1	39	----
1.1	40
1036.2	41	== Eingabemaske „Neuer Assistent“ ==
1.1	42
1031.1	43	\|=Reiter\|=
1031.3	44	\|Allgemeines\|Grundkonfiguration des Assistenten
	45	Einstellungen für den Suchfilter "Fachverfahren" und die Funktion "Druckvorlage"
1032.1	46	\|Detailangaben\|Beschreibung des Assistenten
1032.2	47	Notizfelder für interne Dokumentation
1032.5	48	\|LeiKa/OZG/FIM\|Zuordnung des Dienstes zu Schlüsseln des Leistungskatalogs/OZG-ID und FIM-ID
1031.3	49	\|Datenschutz\|assistentenspezifische Datenschutzerklärung
1032.1	50	\|Barrierefreiheit\|assistentenspezifische Erklärung zur Barrierefreiheit
1038.39	51	\|Versionsdetails\|Start- und Enddatum der Assistentenversion
1034.1	52	Versionsstatus: Entwurf/zur Freigabe bereit/Freigegeben
1028.19	53
1036.2	54	== Allgemeines ==
1.1	55
1038.39	56	=== Typ ===
1038.38	57
1038.43	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.
1038.37	59
1038.39	60	Formularassistent[[image:@NeuerASFormularassistent.jpg\|\|alt="Assistent der ein PDF befüllt" data-xwiki-image-style-alignment="end" height="300" width="377"]]
1038.47	61	Ein Assistent, der die Felder eines [[PDF-Formulars>>Main.06_PDF-Formulare]] befüllt.
1038.45	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.
1.1	63
1038.47	64	Im Vorfeld muss ein entsprechendes PDF-Formular erstellt und im Kundenbereich angelegt werden.
1038.50	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.
1038.58	66
1038.60	67	Für Formularassistenten benötigte Angaben:
1038.58	68
1038.65	69	* Die Formularnummer des im Kundenbereich angelegten PDF-Formulars, für das der Assistent erstellt wird.
1038.66	70	* Die zu verwendende Versionsnummer des gewählten PDF-Formulars.
1038.58	71
1038.51	72	{{html}}<br style="clear:both" />{{/html}}
1038.50	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"]]
1038.51	74	Ein Assistent, der aus den eingegebenen Daten ein dynamisch generiertes PDF-Formular erstellt.
1.1	75
1038.57	76	Durch die Logik beim Ausfüllen und Konfigurationsmöglichkeiten der Formularkomponenten enthält die Ausgabe nur die relevanten, bzw. die festgelegten Elemente.
1038.51	77
1038.57	78	Es wird kein vorgefertigtes PDF-Formular benötigt und kein Mapping der Felder angelegt.
	79	{{html}}<br style="clear:both" />{{/html}}
1038.51	80
1038.66	81	=== Artikelnummer und Titel ===
1.1	82
1038.68	83	Die Artikelnummer ist die eindeutige Artikelbezeichnung eines Assistenten.
1038.71	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.
1038.66	87
1038.74	88	Der Titel sollte aussagekräftig aber kompakt formuliert sein.
	89	Er ist sichtbar
1038.69	90
1038.74	91	* als Seitentitel in der Bürgersicht beim Ausfüllen des Assistenten
1038.75	92	* als Titel des generierten PDF-Formulars und der Druckvorlage
	93	* im Kundenbereich in der Suche, zusammen mit der Artikelnummer
1038.74	94
1038.75	95	=== Kategorie[[image:@NeuerASKategorien.jpg\|\|alt="Übersicht die zur Verfügung stehenden Kategorien" data-xwiki-image-style-alignment="end" height="300" width="369"]]
	96	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. ===
1038.72	97
1038.57	98	Bundesland
1023.1	99	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.
1.1	100
1031.1	101	>{{icon name="far fa-info-circle" size="3"/}} //Hinweis~://
	102	>Die Auswahl „Bundesland“ steht nur zur Verfügung, wenn der Mandant und Benutzer die entsprechenden Rechte für eine Verlagstätigkeit besitzt.
1.1	103
1031.1	104	* Fachverfahren
	105	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.
	106	* Als Druckvorlage verwendbar
	107	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.
1.1	108
1031.1	109	>{{icon name="far fa-info-circle" size="3"/}} //Hinweis~://
1032.3	110	>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.
1.1	111
1031.1	112	----
1.1	113
1036.3	114	== Detailangaben ==
1.1	115
1031.1	116	* Beschreibung/Historie/Interne Bemerkungen
1.1	117	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.
1031.1	118	* Zusätzliche Suchbegriffe
1032.4	119	Die zusätzlichen Suchbegriffe haben keine Auswirkung auf die [[Suche>>Main.04_Suche]] im Kundenbereich.
1.1	120
1031.1	121	----
1.1	122
1036.3	123	== LeiKa/OZG/FIM ==
74.1	124
128.1	125	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.
	126
	127
1031.1	128	===== LeiKa =====
74.1	129
1031.1	130	===== Neue Leistung hinzufügen =====
117.1	131
128.1	132	Über die Schaltfläche "Leistungen hinzufügen" gelangt man in die Such- und Auswahlübersicht, um neue LeiKa-IDs zu suchen und zu hinterlegen.
	133
1031.1	134	[[image:@NeuerASOZGNeueLeistung.jpg\|\|alt="Schaltfläche neue Leistung hinzufügen"]]
128.1	135
	136	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.
	137
1031.1	138	[[image:@NeuerASOZGNeueLeistungSuche.jpg\|\|alt="Suche der LeiKa IDs"]]
128.1	139
1023.1	140	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.
128.1	141
1031.1	142	===== Detailansicht =====
128.1	143
1023.1	144	Über die Schaltfläche "Leistung betrachten" können die Details zur Leistung angezeigt werden.
128.1	145
1031.1	146	* LeiKa-ID
128.1	147	Hier wird die offizielle ID der Leistung nach dem Leistungskatalog aufgeführt.
1031.1	148	* Verrichtung
128.1	149	Hier wird die offizielle Verrichtung der Leistung nach dem Leistungskatalog aufgeführt. Die Verrichtung beschreibt das Verwaltungshandeln eines Leistungsobjektes.
1031.1	150	* Bezeichnung
128.1	151	Hier wird offizielle Bezeichnung der Leistung nach dem Leistungskatalog aufgeführt.
1031.1	152	* Weiterführende Links
128.1	153	Hier werden zusätzliche Referenzen als Links zur ausgewählten Leistung aufgeführt.
	154
1031.1	155	[[image:@NeuerASOZGNeueLeistungInfo.jpg\|\|alt="Detailansicht der einzelnen Leistungen"]]
128.1	156
1031.1	157	===== Leistung löschen =====
128.1	158
1023.1	159	Über die Schaltfläche "Leistungen entfernen" kann eine LeiKa ID aus der Detailübersicht entfernt werden.
128.1	160
1031.1	161	===== Zugehörige OZG-Leistung anzeigen =====
491.1	162
	163	Ü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".
	164
1031.1	165	[[image:@NeuerASOZGLeistung.jpg\|\|alt="Zugehörige OZG-Leistungen anzeigen Icon"]]
491.1	166
1031.1	167	===== OZG =====
117.1	168
491.1	169	In dem Reiter werden alle OZG-Leistungen aufgeführt. Diese werden nach der Hinterlegung der LeiKa IDs automatisch eingefügt.
117.1	170
1031.1	171	[[image:@NeuerASOZGReiter.jpg\|\|alt="Ansicht OZG Reiter in den Assistenteneigenschaften"]]
140.1	172
1031.1	173	===== Detailansicht =====
534.1	174
1023.1	175	Über die Schaltfläche "Leistung betrachten" können die Details zur Leistung angezeigt werden.
534.1	176
1031.1	177	* OZG-ID
1023.1	178	Hier wird der fünfstellige und eindeutige Schlüssel der die OZG-Leistung identifiziert angezeigt.
1031.1	179	* Leistungsbezeichnung
1023.1	180	Der Begriff OZG-Leistung beschreibt ein Leistungsbündel, welches sich aus mehreren LeiKa-Leistungen zusammensetzt, die aus Nutzersicht zusammenhängen.
1031.1	181	* Themenfeld
1023.1	182	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.
1031.1	183	* Lebens-/Geschäftslage
1023.1	184	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.
1031.1	185	* Federführendes Bundesland
1023.1	186	Die Themenfelder sind verschiedenen Federführern zugeteilt. Mindestens ein Bundesland und ein Bundesressort haben als "Tandem" die Federführung einzelner Themenfelder inne.
1031.1	187	* Umsetzendes Bundesland
1023.1	188	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.
1031.1	189	* Prioriät (föderale Leistungen)
	190	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]]
	191	* Prioriät (Bundesleistungen)
1023.1	192	Hier wird unterschieden zwischen priorisierten Leistungen, die vorrangig digitalisiert werden (Wert 1), und nicht priorisierten Leistungen (Wert 2), die nachrangig digitalisiert werden.
1031.1	193	* OZG-Zuständigkeit
1023.1	194	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.
534.1	195
1031.1	196	===== FIM =====
117.1	197
140.1	198	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.
128.1	199
1031.1	200	>{{icon name="far fa-info-circle" size="3"/}} //Hinweis~://
	201	>Derzeit kann lediglich eine FIM ID von Mandanten mit einem "Verlagsrecht" hinterlegt werden. Eine Auswirkung besteht derzeit nocht nicht.
117.1	202
1031.1	203	[[image:@NeuerASFIM.jpg\|\|alt="Ansicht FIM Eingabe in den Assistenteneigenschaften"]]
74.1	204
1031.1	205	----
1023.1	206
1036.3	207	== Datenschutz ==
1.1	208
1038.35	209	Geben Sie hier eine Datenschutzerklärung spezifisch für den Assistenten ein.
1.1	210
1038.36	211	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“.
1.1	212
1038.35	213	Priorisierung der konfigurierten Erklärungstexte:
	214
	215	1. Veröffentlichungskonfiguration
1038.37	216	Wenn in der Veröffentlichungskonfiguration eine individuelle Datenschutzerklärung hinterlegt ist, wird diese angezeigt
1038.35	217	1. Assistentenkonfiguration
1038.37	218	Ist kein Erklärungstext in der Veröffentlichungskonfiguration hinterlegt, prüft das System, ob im Assistenten ein Text konfiguriert ist, und zeigt diesen an.
1038.35	219	1. Mandantenkonfiguration
1038.37	220	Wenn weder in der Veröffentlichungskonfiguration, noch im Assistenten ein Text definiert ist, wird die mandantenspezifische Datenschutzerklärung angezeigt.
1038.35	221
1031.1	222	----
1.1	223
1036.3	224	== Barrierefreiheit ==
37.1	225
1038.22	226	Geben Sie hier eine Erklärung zur Barrierefreiheit spezifisch für den Assistenten ein.
37.1	227
1038.21	228	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“.
1038.18	229
1038.35	230	Priorisierung der konfigurierten Erklärungstexte:
37.1	231
1038.34	232	1. Veröffentlichungskonfiguration
1038.25	233	Wenn in der Veröffentlichungskonfiguration eine individuelle Erklärung zur Barrierefreiheit hinterlegt ist, wird diese angezeigt
1038.34	234	1. Assistentenkonfiguration
1038.37	235	Ist kein Erklärungstext in der Veröffentlichungskonfiguration hinterlegt, prüft das System, ob im Assistenten ein Text konfiguriert ist, und zeigt diesen an.
1038.34	236	1. Mandantenkonfiguration
1038.33	237	Wenn weder in der Veröffentlichungskonfiguration, noch im Assistenten ein Text definiert ist, wird die mandantenspezifische Erklärung zur Barrierefreiheit angezeigt.
1038.23	238
1031.1	239	----
37.1	240
1036.3	241	== Versionsdetails ==
1.1	242
1036.4	243	=== Start- und Enddatum ===
1036.3	244
1036.7	245	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.
1.1	246
1037.1	247	Die Angabe Enddatum ist optional. Wenn ein Enddatum eingegeben ist, steht der Assistent ab diesem Datum nicht mehr zum Ausfüllen zur Verfügung.
1036.5	248
1037.4	249	=== Versionsstatus ===
	250
1038.2	251	Der Versionsstatus zeigt den Stand der Assistentenversion.
1037.4	252
1038.13	253	* Entwurf: Im Entwurfsstatus wird der Assistent bearbeitet. Beim Anlegen einer neuen Version ist der Status Entwurf eingestellt.
1038.14	254	* zur Freigabe bereit: Zwischenstatus für fertiggestellte Assistenten(versionen), die noch nicht freigegeben sind.
	255	* Freigegeben: Der Assistent kann nicht mehr bearbeitet werden und steht zur [[Veröffentlichung>>Main.05_Assistenten.02_VeröffentlichungvonAssistenten]] zur Verfügung.
1038.2	256
1038.15	257	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.
1038.16	258	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]]