Wiki-Quellcode von Neuen Assistenten anlegen

Version 1028.9 von MACH formsolutions am 14.04.2025

version	line-number	content
1028.7	1	Lernen Sie, einen komplett neuen Assistenten anzulegen.
1028.6	2
1028.9	3	Informationen zum Abspeichern eines vorhandenen Assistenten finden Sie im Artikel
1028.7	4
1028.3	5	## Voraussetzungen
1.1	6
1028.2	7	* Mandantenrecht „Assistenten“
	8	* Benutzerrecht „Assistenten anlegen“
	9
1028.3	10	## Ablaufübersicht
	11
1028.4	12	1. Formulareditor öffnen
	13	1. Dialogfeld "Neuer Assistent" öffnen
	14	1. Pflichtangaben ausfüllen
	15	1. Typ
	16	1. Artikelnummer
	17	1. Titel
	18	1. Kategorie
1028.5	19	1. gegebenenfalls optionale Angaben ausfüllen
	20	1. Dialogfeld mit "Speichern"-Schaltfläche verlassen
	21	1. Assistent speichern mit "Speichern"-Schaltfläche in der Hauptwerkzeugleiste
1028.3	22
1028.6	23	Sie haben einen neuen Assistenten angelegt.
	24
1028.3	25	## Anlegen eines neuen Assistenten
	26
1023.1	27	Wählen Sie im Hauptmenü „Sortiment“ den Punkt „Assistenten erstellen/bearbeiten“.
1.1	28
1023.1	29	Sie sind nun in der Metaformularadministration.
	30
	31	In der [[Hauptwerkzeugleiste\|Main.05_Assistenten.01_Hauptwerkzeugleiste]] öffnen Sie mit der Schaltfläche „Neuen Assistenten erstellen“ die Eingabemaske „Neuer Assistent“.
	32	Hier erfassen Sie die Details zum neuen Assistenten.
	33
	34	> {{icon name="far fa-info-circle" size="3"/}} _Hinweis:_
	35
1028.1	36	* Ein neu angelegter Assistent ist noch nicht gespeichert. Beim Verlassen des Formulareditors ohne zu Speichern wird der Assistent verworfen.
1023.1	37
1026.1	38	![[Neuer Assistent erstellen\|NeuerAS.png]]
1.1	39
1023.1	40	---
1.1	41
	42	## Eingabemaske „Neuer Assistent“
	43
	44	Die Eingabemaske „Neuer Assistent“ ist in vier Rubriken gegliedert, unter denen Grunddaten für den Assistenten definiert werden müssen. Folgende Rubriken stehen zur Verfügung:
	45
	46	### Rubrik „Allgemeines“
	47
1023.1	48	* Typ
1028.1	49	Über die Auswahl „Typ“ kann ausgewählt werden, ob es sich bei dem neu anzulegenden Assistenten um einen Assistenten mit einem PDF-Formular „Formularassistent“ oder einen Assistenten mit einem „generiertem PDF-Formular“ handeln soll. Diese Entscheidung sollte vorab gründlich überlegt werden, da eine Umstellung im Nachgang möglich aber doch einige Änderungen mit sich bringen würde.
1023.1	50	* Formularassistent
	51	„Formularassistenten“ sind Assistenten, die ein [[PDF-Formular\|Main.06_PDF-Formulare]] befüllen. Hierzu muss im Vorfeld ein entsprechendes PDF-Formular erstellt und im Kundenbereich angelegt werden. Jedes Feld, das im Assistenten erstellt wird, muss, sofern nicht korrekt benannt, auf die Felder des PDF-Formulars [[zugeordnet\|Main.05_Assistenten.04_Assistentenbauoberfläche.06_Mapping]] werden.
1.1	52
1026.2	53	> {{icon name="far fa-info-circle" size="3"/}} _Hinweis:_
1.1	54
1027.1	55	1. MACH ProForms bietet ein vielseitiges Sortiment von PDF-Formularen, die Sie nutzen können, an.
	56	1. Es können nur eigene PDF-Formulare (Kundenfassungen) hinterlegt werden.
	57	Sofern ein Verlagspdf-Formular genutzt werden soll, muss das Formular erst als Kundenfassung in die MACH formsolutions Plattform hochgeladen werden.
	58
1024.1	59	![[Assistent der ein PDF befüllt\|@NeuerASFormularassistent.jpg]] * Assistent mit generiertem PDF-Formular
1027.1	60	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.
1.1	61
1023.1	62	> {{icon name="far fa-info-circle" size="3"/}} _Hinweis:_
	63	>
1027.1	64	> MACH ProForms bietet auch hier ein vielseitiges Sortiment, das Sie nutzen können, an.
1.1	65
1023.1	66	![[Assistent der ein generiertes PDF befüllt\|@NeuerASgeneriertesPDF.jpg]]
1.1	67
1023.1	68	* Formularnummer
1.1	69	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.
1023.1	70	* Version
1026.2	71	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.
1023.1	72	* Artikelnummer und Titel
1024.1	73	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.
1023.1	74	* Kategorie
	75	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.
1.1	76
1023.1	77	> {{icon name="far fa-info-circle" size="3"/}} _Hinweis:_
	78	>
	79	> Insgesamt stellt der Verlag 52 Kategorien zur Auswahl zur Verfügung.
1.1	80
1023.1	81	![[Übersicht die zur Verfügung stehenden Kategorien\|@NeuerASKategorien.jpg]]
1.1	82
1023.1	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.
1.1	85
1023.1	86	> {{icon name="far fa-info-circle" size="3"/}} _Hinweis:_
	87	>
	88	> Die Auswahl „Bundesland“ steht nur zur Verfügung, wenn der Mandant und Benutzer die entsprechenden Rechte für eine Verlagstätigkeit besitzt.
1.1	89
1023.1	90	* Fachverfahren
1.1	91	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.
1023.1	92	* Als Druckvorlage verwendbar
222.1	93	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	94
1023.1	95	> {{icon name="far fa-info-circle" size="3"/}} _Hinweis:_
	96	>
	97	> Die entsprechenden [[Konfigurationen\|Main.05_Assistenten.04_Assistentenbauoberfläche.04_KonfigurationvonKomponenten]] an den Komponenten für die Druckvorlage wird nur freigeschaltet, wenn der Haken bei „Als Druckvorlage verwenden“ bereits beim Assistenten anlegen/überarbeiten gesetzt ist.
1.1	98
1023.1	99	---
1.1	100
	101	### Rubrik „Detailangaben“
	102
1023.1	103	* Beschreibung/Historie/Interne Bemerkungen
1.1	104	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.
1023.1	105	* Zusätzliche Suchbegriffe
1.1	106	Unter den „zusätzlichen Suchbegriffen“ können weitere Themengebiete bzw. Synonyme für diesen Assistenten angegeben werden. Diese zusätzlichen Suchbegriffe haben Auswirkungen auf die [[Suche\|Main.04_Suche]] im Kundenbereich. Daher sollten diese Suchbegriffe immer eindeutig und einen großen Bereich von Synonymen und Themen abdecken.
	107
117.1	108	![[Reiter Detailangaben\|@NeuerASDetialangaben.jpg]]
	109
1023.1	110	---
1.1	111
74.1	112	### Rubrik „LeiKa/OZG/FIM“
	113
128.1	114	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.
	115
	116	![[Ansicht des Reiters LeiKa/OZG/FIM\|@NeuerASOZG.jpg]]
	117
140.1	118	#### LeiKa
74.1	119
128.1	120	##### Neue Leistung hinzufügen
117.1	121
128.1	122	Über die Schaltfläche "Leistungen hinzufügen" gelangt man in die Such- und Auswahlübersicht, um neue LeiKa-IDs zu suchen und zu hinterlegen.
	123
	124	![[Schaltfläche neue Leistung hinzufügen\|@NeuerASOZGNeueLeistung.jpg]]
	125
	126	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.
	127
	128	![[Suche der LeiKa IDs\|@NeuerASOZGNeueLeistungSuche.jpg]]
	129
1023.1	130	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	131
	132	![[Leistungen markieren und übernehmen\|@NeuerASOZGNeueLeistungHinzufügen.jpg]]
	133
	134	##### Detailansicht
	135
1023.1	136	Über die Schaltfläche "Leistung betrachten" können die Details zur Leistung angezeigt werden.
128.1	137
1023.1	138	* LeiKa-ID
128.1	139	Hier wird die offizielle ID der Leistung nach dem Leistungskatalog aufgeführt.
1023.1	140	* Verrichtung
128.1	141	Hier wird die offizielle Verrichtung der Leistung nach dem Leistungskatalog aufgeführt. Die Verrichtung beschreibt das Verwaltungshandeln eines Leistungsobjektes.
1023.1	142	* Bezeichnung
128.1	143	Hier wird offizielle Bezeichnung der Leistung nach dem Leistungskatalog aufgeführt.
1023.1	144	* Weiterführende Links
128.1	145	Hier werden zusätzliche Referenzen als Links zur ausgewählten Leistung aufgeführt.
	146
	147	![[Detailansicht der einzelnen Leistungen\|@NeuerASOZGNeueLeistungInfo.jpg]]
	148
	149	##### Leistung löschen
	150
1023.1	151	Über die Schaltfläche "Leistungen entfernen" kann eine LeiKa ID aus der Detailübersicht entfernt werden.
128.1	152
1023.1	153	> {{icon name="far fa-info-circle" size="3"/}} Hinweis:
	154	>
128.1	155	> Die Leistung wird direkt entfernt aus den Assistenteneigenschaften. Eine zusätzliche Speicherung über die Schaltfläche "Speichern" ist nicht notwendig.
	156
	157	![[Leistungen löschen\|@NeuerASOZGNeueLeistungLöschen.jpg]]
	158
491.1	159	##### Zugehörige OZG-Leistung anzeigen
	160
	161	Ü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".
	162
	163	![[Zugehörige OZG-Leistungen anzeigen Icon\|@NeuerASOZGLeistung.jpg]]
	164
117.1	165	#### OZG
	166
491.1	167	In dem Reiter werden alle OZG-Leistungen aufgeführt. Diese werden nach der Hinterlegung der LeiKa IDs automatisch eingefügt.
117.1	168
491.1	169	![[Ansicht OZG Reiter in den Assistenteneigenschaften\|@NeuerASOZGReiter.jpg]]
140.1	170
534.1	171	##### Detailansicht
	172
1023.1	173	Über die Schaltfläche "Leistung betrachten" können die Details zur Leistung angezeigt werden.
534.1	174
1023.1	175	* OZG-ID
	176	Hier wird der fünfstellige und eindeutige Schlüssel der die OZG-Leistung identifiziert angezeigt.
	177	* Leistungsbezeichnung
	178	Der Begriff OZG-Leistung beschreibt ein Leistungsbündel, welches sich aus mehreren LeiKa-Leistungen zusammensetzt, die aus Nutzersicht zusammenhängen.
	179	* Themenfeld
	180	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.
	181	* Lebens-/Geschäftslage
	182	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.
	183	* Federführendes Bundesland
	184	Die Themenfelder sind verschiedenen Federführern zugeteilt. Mindestens ein Bundesland und ein Bundesressort haben als "Tandem" die Federführung einzelner Themenfelder inne.
	185	* Umsetzendes Bundesland
	186	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.
	187	* Prioriät (föderale Leistungen)
	188	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>
	189	* Prioriät (Bundesleistungen)
	190	Hier wird unterschieden zwischen priorisierten Leistungen, die vorrangig digitalisiert werden (Wert 1), und nicht priorisierten Leistungen (Wert 2), die nachrangig digitalisiert werden.
	191	* OZG-Zuständigkeit
	192	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	193
117.1	194	#### FIM
	195
140.1	196	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	197
1023.1	198	> {{icon name="far fa-info-circle" size="3"/}} _Hinweis:_
	199	>
140.1	200	> Derzeit kann lediglich eine FIM ID von Mandanten mit einem "Verlagsrecht" hinterlegt werden. Eine Auswirkung besteht derzeit nocht nicht.
117.1	201
140.1	202	![[Ansicht FIM Eingabe in den Assistenteneigenschaften\|@NeuerASFIM.jpg]]
74.1	203
1023.1	204	---
	205
1.1	206	### Rubrik „Datenschutz“
	207
	208	Hier kann mittels des Editors eine individuelle Datenschutzerklärung hinterlegt werden. Diese Datenschutzerklärung wird bei der [[Einwilligungserklärung\|Main.05_Assistenten.02_VeröffentlichungvonAssistenten]] und im Ausfüllprozess des Assistenten unten in der Verlinkung „Datenschutzerklärung“ angezeigt. Sofern hier keine Datenschutzerklärung hinterlegt wird, wird die vom [[Mandanten\|Main.07_Einstellungen-Fachadministration.01_Mandanten]] hinterlegte Datenschutzerklärung verwendet. Ist auch dort kein Text hinterlegt, wird der Text: Keine Daten hinterlegt! angezeigt.
	209
1023.1	210	> {{icon name="far fa-info-circle" size="3"/}} _Hinweis:_
	211	>
117.1	212	> Dieser Inhalt wird überschrieben, sofern bei der [[Veröffentlichung\|Main.05_Assistenten.02_VeröffentlichungvonAssistenten]] eines Assistenten eine individuelle Datenschutzerklärung definiert wurde. Weiterhin können kundenspezifische Änderungen die Barrierefreiheit der Anwendung beeinträchtigten.
1.1	213
1023.1	214	---
1.1	215
37.1	216	### Rubrik „Barrierefreiheit“
	217
	218	Hier kann mittels des Editors eine individuelle Erklärung zur Barrierefreiheit hinterlegt werden. Diese Erklärung zur Barrierefreiheit wird bei der [[Einwilligungserklärung\|Main.05_Assistenten.02_VeröffentlichungvonAssistenten]] und im Ausfüllprozess des Assistenten unten in der Verlinkung „Erklärung zur Barrierefreiheit“ angezeigt. Sofern hier keine Erklärung zur Barrierefreiheit hinterlegt wird, wird die vom [[Mandanten\|Main.07_Einstellungen-Fachadministration.01_Mandanten]] hinterlegte Erklärung zur Barrierefreheit verwendet. Ist auch dort kein Text hinterlegt, wird der Text: Keine Daten hinterlegt! angezeigt.
	219
1023.1	220	> {{icon name="far fa-info-circle" size="3"/}} _Hinweis:_
	221	>
117.1	222	> Dieser Inhalt wird überschrieben, sofern bei der [[Veröffentlichung\|Main.05_Assistenten.02_VeröffentlichungvonAssistenten]] eines Assistenten eine individuelle Erklärung zur Barrierefreiheit definiert wurde. Weiterhin können kundenspezifische Änderungen die Barrierefreiheit der Anwendung beeinträchtigten.
37.1	223
1023.1	224	---
37.1	225
1.1	226	### Rubrik „Versionsdetails“
	227
1023.1	228	* Start- und Enddatum
1.1	229	Das „Startdatum“ wird automatisch beim Anlegen eines neuen Assistenten mit dem aktuellen Datum befüllt. Mit dem Eingabefeld wird festgelegt, wann der Assistent nach der [[Veröffentlichung\|Main.05_Assistenten.02_VeröffentlichungvonAssistenten]] zur Verfügung stehen soll. Eine Eingabe des „Enddatums“ ist nicht zwangsläufig nötig. Soll jedoch der Assistent dem Ausfüller ab einem bestimmten Datum nicht mehr zur Verfügung stehen, muss das Enddatum angegeben werden.
	230
1023.1	231	> {{icon name="far fa-info-circle" size="3"/}} _Hinweis:_
	232	>
	233	> Das gesetzte Start- und Enddatum kann nach der Freigabe eines Assistenten nicht mehr geändert werden._**
1.1	234
1023.1	235	* Versionsstatus
1.1	236	Der „Versionsstatus“ gibt an, in welchem Status sich der Assistent zum aktuellen Zeitpunkt befindet. Beim Anlegen wird der Status automatisch auf den Status „Entwurf“ eingestellt. Bei der [[Veröffentlichung\|Main.05_Assistenten.02_VeröffentlichungvonAssistenten]] muss der Assistent auf „Freigegeben“ gesetzt werden.