Wiki-Quellcode von Neuen Assistenten anlegen

Version 1040.2 von MACH formsolutions am 17.07.2025

version	line-number	content
1039.2	1	{{toc depth="2"/}}
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
1039.10	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.80	78	Es wird kein vorgefertigtes PDF-Formular benötigt und kein Mapping der Felder erforderlich.
1038.57	79	{{html}}<br style="clear:both" />{{/html}}
1038.51	80
1039.10	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
1039.10	95	=== Kategorie ===
1038.72	96
1038.90	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.
1038.79	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.
1038.76	99
1039.10	100	=== Bundesland ===
1.1	101
1038.87	102	Voraussetzung: Mandantenrecht "Verlagstätigkeit"
	103
1038.89	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.
1038.90	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.
1038.80	106
1038.85	107	So wählen Sie mehrere Bundesländer aus:
1038.86	108	Halten Sie die Taste „Strg“ gedrückt und klicken Sie auf die einzelnen Bundesländer um diese aus- und abzuwählen.
1038.80	109
1039.10	110	=== Fachverfahren ===
1038.87	111
1038.91	112	Liste der Fachverfahren, für die der Assistent vorbereitet ist.
1038.95	113	Diese Zuordnung dient als Filter bei der Suche im Kundenbereich.
1038.88	114
1038.96	115	Tragen Sie mehrere Fachverfahren gegebenenfalls kommasepariert ein.
1038.95	116
1039.10	117	=== Als Druckvorlage verwendbar ===
1038.95	118
1039.9	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.
1038.95	120
1039.10	121	Diese Einstellung aktiviert im Formulareditor an den Komponenten und Bausteinen die Konfigurationsoptionen für die Anzeige in der Druckvorlage.
1038.99	122
1031.1	123	----
1.1	124
1039.1	125	== Detailangaben ==
1.1	126
1039.7	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.
1039.8	128	Diese Einträge sind rein intern und werden nur in diesem Dialog angezeigt.
1.1	129
1039.2	130	=== Zusätzliche Suchbegriffe ===
	131
	132	Die zusätzlichen Suchbegriffe haben keine Auswirkung auf die Suche im Kundenbereich.
	133
1031.1	134	----
1.1	135
1039.10	136	== LeiKa/OZG/FIM ==
74.1	137
1039.14	138	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	139	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	140
1040.1	141	Ausführliche Informationen zur Zuordnung der IDs siehe:
1039.15	142
1031.1	143	----
1023.1	144
1038.76	145	(% class="wikigeneratedid" id="HDatenschutz" %)
	146	Datenschutz
1.1	147
1038.35	148	Geben Sie hier eine Datenschutzerklärung spezifisch für den Assistenten ein.
1.1	149
1038.36	150	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	151
1038.35	152	Priorisierung der konfigurierten Erklärungstexte:
	153
1040.1	154	1. Veröffentlichungskonfiguration
1038.37	155	Wenn in der Veröffentlichungskonfiguration eine individuelle Datenschutzerklärung hinterlegt ist, wird diese angezeigt
1038.76	156	1. (((
	157	Assistentenkonfiguration
1038.37	158	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	159	)))
	160	1. (((
	161	Mandantenkonfiguration
1038.37	162	Wenn weder in der Veröffentlichungskonfiguration, noch im Assistenten ein Text definiert ist, wird die mandantenspezifische Datenschutzerklärung angezeigt.
1038.76	163	)))
1038.35	164
1031.1	165	----
1.1	166
1040.2	167	== Barrierefreiheit ==
37.1	168
1038.22	169	Geben Sie hier eine Erklärung zur Barrierefreiheit spezifisch für den Assistenten ein.
37.1	170
1038.21	171	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	172
1038.35	173	Priorisierung der konfigurierten Erklärungstexte:
37.1	174
1040.2	175	1. Veröffentlichungskonfiguration
1038.25	176	Wenn in der Veröffentlichungskonfiguration eine individuelle Erklärung zur Barrierefreiheit hinterlegt ist, wird diese angezeigt
1040.2	177	1. Assistentenkonfiguration
1038.37	178	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	179	1. Mandantenkonfiguration
1038.33	180	Wenn weder in der Veröffentlichungskonfiguration, noch im Assistenten ein Text definiert ist, wird die mandantenspezifische Erklärung zur Barrierefreiheit angezeigt.
1038.23	181
1031.1	182	----
37.1	183
1040.2	184	== Versionsdetails ==
1.1	185
1040.2	186	=== Start- und Enddatum ===
1036.3	187
1036.7	188	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	189
1037.1	190	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	191
1040.2	192	=== Versionsstatus ===
1037.4	193
1038.2	194	Der Versionsstatus zeigt den Stand der Assistentenversion.
1037.4	195
1040.2	196	* Entwurf: Im Entwurfsstatus wird der Assistent bearbeitet. Beim Anlegen einer neuen Version ist der Status Entwurf eingestellt.
	197	* zur Freigabe bereit: Zwischenstatus für fertiggestellte Assistenten(versionen), die noch nicht freigegeben sind.
	198	* Freigegeben: Der Assistent kann nicht mehr bearbeitet werden und steht zur [[Veröffentlichung>>Main.05_Assistenten.02_VeröffentlichungvonAssistenten]] zur Verfügung.
1038.2	199
1038.15	200	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	201	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]]