Wiki-Quellcode von Neuen Assistenten anlegen

Version 123.1 von MACH formsolutions am 24.08.2020

version	line-number	content
1.1	1	Um einen neuen Assistenten anlegen zu können, muss unter dem Hauptmenüpunkt „Sortiment“ der Menüpunkt „Assistenten erstellen/bearbeiten“ ausgewählt werden. In der darauf folgenden Metaformularadministration muss nun in der „[[Hauptwerkzeugleiste\|Main.05_Assistenten.01_Hauptwerkzeugleiste]]“ die Schaltfläche „Neuen Assistenten erstellen“ betätigt werden. Daraufhin erscheint die Eingabemaske „Neuer Assistent“ in der die Details zum Assistenten erfasst werden müssen.
	2
91.1	3	>*Hinweis:*
	4	> 1. Nur Benutzer eines Mandanten der das [[Mandantenrecht\|Main.07_Einstellungen-Fachadministration.01_Mandanten.01_Rechte]] „Assistenten“ sowie das [[Benutzerrecht\|Main.07_Einstellungen-Fachadministration.02_Benutzer.01_Benutzerrollen]] „Assistenten anlegen“ besitzt, kann neue Assistenten anlegen.
	5	> 2. Der Benutzer wird nach dem Anlegen des neuen Assistenten in die „[[Assistentenbauoberfläche\|Main.05_Assistenten.04_Assistentenbauoberfläche]]“ weitergeleitet. Hier muss der Assistenten über die Schaltfläche „[[Speichern\|Main.05_Assistenten.04_Assistentenbauoberfläche.13_Assistentenspeichern]]“ in der „Hauptwerkzeugleiste“ gespeichert werden, da ansonsten beim Verlassen der Assistentenbauoberfläche ohne zu Speichern der neu angelegte Assistent gelöscht wird.
1.1	6
	7	![[Neuer Assistent erstellen\|@NeuerASIcon.jpg]]
	8
	9	___
	10
	11	## Eingabemaske „Neuer Assistent“
	12
	13	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:
	14
	15	### Rubrik „Allgemeines“
	16
	17	- Typ<br />
	18	Ü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 am Assistentenbau mit sich bringen würde.<br />
	19
	20	- Formularassistent <br />
	21	„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.<br />
	22
117.1	23	>_Hinweis:_
	24	> Form-Solutions bietet ein vielseitiges Sortiment von PDF-Formularen, die Sie nutzen können, an.<br />
1.1	25
	26	![[Assistent der ein PDF befüllt\|@NeuerASFormularassistent.jpg]]
	27
	28	- Assistent mit generiertem PDF-Formular<br />
	29
	30	Bei der Auswahl „Assistent mit generiertem PDF-Formular“ wird ein generiertes PDF-Formular von Form-Solutions 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.<br />
	31
117.1	32	>_Hinweis:_
	33	> Form-Solutions bietet auch hier ein vielseitiges Sortiment, das Sie nutzen können, an.<br />
1.1	34
	35	![[Assistent der ein generiertes PDF befüllt\|@NeuerASgeneriertesPDF.jpg]]
	36	<br />
	37
	38	- Formularnummer<br />
	39	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.
	40	<br />
	41
	42	- Version<br />
	43	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 über den Formularserver 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.
	44	<br />
	45
	46	- Artikelnummer und Titel<br />
	47	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. 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.
	48	<br />
	49
	50	- Kategorie<br />
	51	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.<br />
117.1	52	>_Hinweis:_
	53	> Insgesamt stellt der Verlag 52 Kategorien zur Auswahl zur Verfügung.<br />
1.1	54
	55	![[Übersicht die zur Verfügung stehenden Kategorien\|@NeuerASKategorien.jpg]]
	56	<br />
	57
	58
	59	- Bundesland<br />
	60	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.
	61
117.1	62	> _Hinweis:_
	63	> Die Auswahl „Bundesland“ steht nur zur Verfügung, wenn der Mandant und Benutzer die entsprechenden Rechte für eine Verlagstätigkeit besitzt.<br />
1.1	64	<br />
	65
	66	- Fachverfahren<br />
	67	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.
	68
	69	<br />
	70
	71	- Als Druckvorlage verwendbar<br />
	72	Wird in den Assistenteneigenschaften die Auswahl „Als Druckvorlage verwendbar“ gesetzt, wird damit angegeben, dass nach dem Freigeben der Version des Assistenten dieser als eine [[Druckvorlage\|Main.05_Assistenten.10_Druckvorlagen]] sich eignet.
	73
117.1	74	> _Hinweis:_
	75	> 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.<br />
1.1	76
	77	<br />
	78
	79	___
	80
	81	### Rubrik „Detailangaben“
	82
	83	- Beschreibung/Historie/Interne Bemerkungen<br />
	84	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.
	85	<br />
	86
	87	- Zusätzliche Suchbegriffe<br />
	88	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.
	89	<br />
	90
117.1	91	- LeiKa-IDs<br />
1.1	92	Mit dem Eingabefeld „LeiKa-ID“ kann der entsprechende einheitliche Schlüssel des Leistungskatalogs der Verzeichnisse der Verwaltungsleistungen angegeben werden. Es kann ein oder mehrere LeiKa-IDs kommasepariert hinterlegt werden.
	93
117.1	94	![[Reiter Detailangaben\|@NeuerASDetialangaben.jpg]]
	95
1.1	96	___
	97
74.1	98	### Rubrik „LeiKa/OZG/FIM“
	99
117.1	100	#### Leika
74.1	101
117.1	102
	103	#### OZG
	104
	105	Diese Funktion steht derzeit noch nicht zur Verfügung.
	106
	107	#### FIM
	108
	109	> _Hinweis:_
	110	> Derzeit kann lediglich eine FIM ID hinterlegt werden. Eine Auswirkung auf die Komponentenkonfiguration besteht derzeit noch nicht.
	111
	112	Hier kann eine FIM ID hinterlegt werden. Die ID kenzzeichnet die Zordnung der Komponenten zur entsprechenden Festlegung aus dem Föderalen Informationsmanagement. Felder mit dieser Angabe können duch den Anwender nicht angepasst werden.
	113
74.1	114	___
	115
1.1	116	### Rubrik „Datenschutz“
	117
	118	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.
	119
117.1	120	> _Hinweis:_
	121	> 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	122
	123	___
	124
37.1	125	### Rubrik „Barrierefreiheit“
	126
	127	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.
	128
117.1	129	> _Hinweis:_
	130	> 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	131
	132	___
	133
1.1	134	### Rubrik „Versionsdetails“
	135
	136	- Start- und Enddatum<br />
	137	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.
	138
117.1	139	>_Hinweis:_
	140	> Das gesetzte Start- und Enddatum kann nach der Freigabe eines Assistenten nicht mehr geändert werden._**<br />
1.1	141	<br />
	142
	143	- Versionsstatus<br />
	144	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.
	145