Wiki-Quellcode von Neuen Assistenten anlegen

Version 1042.1 von MACH formsolutions am 19.08.2025

version	line-number	content
1042.1	1	Inhaltsverzeichnis
	2
1039.2	3	{{toc depth="2"/}}
1028.6	4
1035.1	5	So legen Sie einen neuen Assistenten an.
1028.16	6
1031.1	7	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	8
1036.2	9	= Voraussetzungen =
1.1	10
1028.2	11	* Mandantenrecht „Assistenten“
	12	* Benutzerrecht „Assistenten anlegen“
	13
1036.2	14	= Ablaufübersicht =
1028.3	15
1028.4	16	1. Formulareditor öffnen
1028.14	17	1. Eingabemaske "Neuer Assistent" öffnen
1028.4	18	1. Pflichtangaben ausfüllen
1031.1	19	11. Typ
	20	11. Artikelnummer
	21	11. Titel
	22	11. Kategorie
1028.5	23	1. gegebenenfalls optionale Angaben ausfüllen
	24	1. Dialogfeld mit "Speichern"-Schaltfläche verlassen
	25	1. Assistent speichern mit "Speichern"-Schaltfläche in der Hauptwerkzeugleiste
1028.3	26
1028.6	27	Sie haben einen neuen Assistenten angelegt.
	28
1036.2	29	= Anlegen eines neuen Assistenten =
1028.3	30
1023.1	31	Wählen Sie im Hauptmenü „Sortiment“ den Punkt „Assistenten erstellen/bearbeiten“.
1.1	32
1028.14	33	Sie sind nun im Formulareditor.
1023.1	34
1031.1	35	In der [[Hauptwerkzeugleiste>>Main.05_Assistenten.01_Hauptwerkzeugleiste]] öffnen Sie mit der Schaltfläche „Neuen Assistenten erstellen“ die Eingabemaske „Neuer Assistent“.
	36	Hier erfassen Sie die Details zum neuen Assistenten.
1028.15	37	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	38
1038.37	39	[[image:NeuerAS.png\|\|alt="Neuer Assistent erstellen" data-xwiki-image-style-border="true"]]
1.1	40
1031.1	41	----
1.1	42
1036.2	43	== Eingabemaske „Neuer Assistent“ ==
1.1	44
1031.1	45	\|=Reiter\|=
1031.3	46	\|Allgemeines\|Grundkonfiguration des Assistenten
	47	Einstellungen für den Suchfilter "Fachverfahren" und die Funktion "Druckvorlage"
1032.1	48	\|Detailangaben\|Beschreibung des Assistenten
1032.2	49	Notizfelder für interne Dokumentation
1032.5	50	\|LeiKa/OZG/FIM\|Zuordnung des Dienstes zu Schlüsseln des Leistungskatalogs/OZG-ID und FIM-ID
1031.3	51	\|Datenschutz\|assistentenspezifische Datenschutzerklärung
1032.1	52	\|Barrierefreiheit\|assistentenspezifische Erklärung zur Barrierefreiheit
1038.39	53	\|Versionsdetails\|Start- und Enddatum der Assistentenversion
1034.1	54	Versionsstatus: Entwurf/zur Freigabe bereit/Freigegeben
1028.19	55
1036.2	56	== Allgemeines ==
1.1	57
1039.10	58	=== Typ ===
1038.38	59
1038.43	60	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	61
1038.39	62	Formularassistent[[image:@NeuerASFormularassistent.jpg\|\|alt="Assistent der ein PDF befüllt" data-xwiki-image-style-alignment="end" height="300" width="377"]]
1038.47	63	Ein Assistent, der die Felder eines [[PDF-Formulars>>Main.06_PDF-Formulare]] befüllt.
1038.45	64	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	65
1038.47	66	Im Vorfeld muss ein entsprechendes PDF-Formular erstellt und im Kundenbereich angelegt werden.
1038.50	67	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	68
1038.60	69	Für Formularassistenten benötigte Angaben:
1038.58	70
1038.65	71	* Die Formularnummer des im Kundenbereich angelegten PDF-Formulars, für das der Assistent erstellt wird.
1038.66	72	* Die zu verwendende Versionsnummer des gewählten PDF-Formulars.
1038.58	73
1038.51	74	{{html}}<br style="clear:both" />{{/html}}
1038.50	75	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	76	Ein Assistent, der aus den eingegebenen Daten ein dynamisch generiertes PDF-Formular erstellt.
1.1	77
1038.57	78	Durch die Logik beim Ausfüllen und Konfigurationsmöglichkeiten der Formularkomponenten enthält die Ausgabe nur die relevanten, bzw. die festgelegten Elemente.
1038.51	79
1038.80	80	Es wird kein vorgefertigtes PDF-Formular benötigt und kein Mapping der Felder erforderlich.
1038.57	81	{{html}}<br style="clear:both" />{{/html}}
1038.51	82
1039.10	83	=== Artikelnummer und Titel ===
1.1	84
1038.68	85	Die Artikelnummer ist die eindeutige Artikelbezeichnung eines Assistenten.
1038.71	86	Sie setzt sich aus den fixen Buchstaben „KFAS_“, für Kundenfassung, und einer frei wählbaren Bezeichnung zusammen. Beispielsweise „KFAS_Hundesteuermeldung“.
	87	Bei Formularassistenten wird die Artikelnummer mit der Formularnummer vorausgefüllt, kann jedoch geändert werden.
	88	Sonderzeichen sind in der Artikelnummer nicht erlaubt und mehr als 60 Zeichen werden nicht empfohlen.
1038.66	89
1038.74	90	Der Titel sollte aussagekräftig aber kompakt formuliert sein.
	91	Er ist sichtbar
1038.69	92
1038.74	93	* als Seitentitel in der Bürgersicht beim Ausfüllen des Assistenten
1038.75	94	* als Titel des generierten PDF-Formulars und der Druckvorlage
	95	* im Kundenbereich in der Suche, zusammen mit der Artikelnummer
1038.74	96
1039.10	97	=== Kategorie ===
1038.72	98
1038.90	99	[[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.
1038.79	100	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.
1038.76	101
1039.10	102	=== Bundesland ===
1.1	103
1038.87	104	Voraussetzung: Mandantenrecht "Verlagstätigkeit"
	105
1038.89	106	Bundeslandauswahl, für die der neue Assistent zur Verfügung stehen soll. Wird kein Bundesland ausgewählt, steht der Assistent bundesweit zur Verfügung.
1038.90	107	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.
1038.80	108
1038.85	109	So wählen Sie mehrere Bundesländer aus:
1038.86	110	Halten Sie die Taste „Strg“ gedrückt und klicken Sie auf die einzelnen Bundesländer um diese aus- und abzuwählen.
1038.80	111
1039.10	112	=== Fachverfahren ===
1038.87	113
1038.91	114	Liste der Fachverfahren, für die der Assistent vorbereitet ist.
1038.95	115	Diese Zuordnung dient als Filter bei der Suche im Kundenbereich.
1038.88	116
1038.96	117	Tragen Sie mehrere Fachverfahren gegebenenfalls kommasepariert ein.
1038.95	118
1039.10	119	=== Als Druckvorlage verwendbar ===
1038.95	120
1039.9	121	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.
1038.95	122
1039.10	123	Diese Einstellung aktiviert im Formulareditor an den Komponenten und Bausteinen die Konfigurationsoptionen für die Anzeige in der Druckvorlage.
1038.99	124
1031.1	125	----
1.1	126
1039.1	127	== Detailangaben ==
1.1	128
1039.7	129	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.
1039.8	130	Diese Einträge sind rein intern und werden nur in diesem Dialog angezeigt.
1.1	131
1039.2	132	=== Zusätzliche Suchbegriffe ===
	133
	134	Die zusätzlichen Suchbegriffe haben keine Auswirkung auf die Suche im Kundenbereich.
	135
1031.1	136	----
1.1	137
1039.10	138	== LeiKa/OZG/FIM ==
74.1	139
1039.14	140	Zuordnung von LeiKa-ID der Leistung nach dem Leistungskatalog (LeiKa), OZG-ID der Leistung nach dem Onlinezugangsgesetz und FIM-ID des Föderalen Informationsmanagement (FIM).
1039.15	141	Diese Angaben werden in der [[Trefferliste>>doc:Main.04_Suche.03_Trefferliste.WebHome]] der Suche angezeigt und können als Filterkriterium genutzt werden.
1039.11	142
1041.1	143	Ausführliche Informationen zur Zuordnung der IDs siehe: [[Zuordnung LeiKa / OZG / FIM>>.]]
1039.15	144
1031.1	145	----
1023.1	146
1041.1	147	== Datenschutz ==
1.1	148
1038.35	149	Geben Sie hier eine Datenschutzerklärung spezifisch für den Assistenten ein.
1.1	150
1038.36	151	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	152
1038.35	153	Priorisierung der konfigurierten Erklärungstexte:
	154
1040.1	155	1. Veröffentlichungskonfiguration
1038.37	156	Wenn in der Veröffentlichungskonfiguration eine individuelle Datenschutzerklärung hinterlegt ist, wird diese angezeigt
1038.76	157	1. (((
	158	Assistentenkonfiguration
1038.37	159	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.76	160	)))
	161	1. (((
	162	Mandantenkonfiguration
1038.37	163	Wenn weder in der Veröffentlichungskonfiguration, noch im Assistenten ein Text definiert ist, wird die mandantenspezifische Datenschutzerklärung angezeigt.
1038.76	164	)))
1038.35	165
1031.1	166	----
1.1	167
1040.2	168	== Barrierefreiheit ==
37.1	169
1038.22	170	Geben Sie hier eine Erklärung zur Barrierefreiheit spezifisch für den Assistenten ein.
37.1	171
1038.21	172	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	173
1038.35	174	Priorisierung der konfigurierten Erklärungstexte:
37.1	175
1040.2	176	1. Veröffentlichungskonfiguration
1038.25	177	Wenn in der Veröffentlichungskonfiguration eine individuelle Erklärung zur Barrierefreiheit hinterlegt ist, wird diese angezeigt
1040.2	178	1. Assistentenkonfiguration
1038.37	179	Ist kein Erklärungstext in der Veröffentlichungskonfiguration hinterlegt, prüft das System, ob im Assistenten ein Text konfiguriert ist, und zeigt diesen an.
1040.2	180	1. Mandantenkonfiguration
1038.33	181	Wenn weder in der Veröffentlichungskonfiguration, noch im Assistenten ein Text definiert ist, wird die mandantenspezifische Erklärung zur Barrierefreiheit angezeigt.
1038.23	182
1031.1	183	----
37.1	184
1040.2	185	== Versionsdetails ==
1.1	186
1040.2	187	=== Start- und Enddatum ===
1036.3	188
1036.7	189	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	190
1037.1	191	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	192
1040.2	193	=== Versionsstatus ===
1037.4	194
1038.2	195	Der Versionsstatus zeigt den Stand der Assistentenversion.
1037.4	196
1040.2	197	* Entwurf: Im Entwurfsstatus wird der Assistent bearbeitet. Beim Anlegen einer neuen Version ist der Status Entwurf eingestellt.
	198	* zur Freigabe bereit: Zwischenstatus für fertiggestellte Assistenten(versionen), die noch nicht freigegeben sind.
	199	* Freigegeben: Der Assistent kann nicht mehr bearbeitet werden und steht zur [[Veröffentlichung>>Main.05_Assistenten.02_VeröffentlichungvonAssistenten]] zur Verfügung.
1038.2	200
1038.15	201	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	202	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]]