Wiki-Quellcode von Dynamische Listen

Zuletzt geändert von MACH ProForms GmbH am 15.08.2024

version	line-number	content
404.1	1	Neben [[statischen Listen\|Main.05_Assistenten.04_Assistentenbauoberfläche.08_Listen.01_Listenverwaltung]] bietet MACH formsolutions mit dynamischen Listen die Möglichkeit, Listenwerte auf zeitliche Gültigkeit und Verfügbarkeit nach Anzahl zu prüfen. Mit dieser Funktion lassen sich beispielsweise Gutscheinaktionen oder Anmeldungen zu einer Veranstaltung mit begrenzter Teilnehmeranzahl umsetzen.
1.1	2
404.1	3	Im Ausfüllprozess des Assistenten wird geprüft, ob der eingegebene Wert vorhanden ist und ob dieser noch gültig ist.
	4
	5	* Gültige Werte werden nach Auswahl für 30 Minuten reserviert. Wird der Assistent in diesem Zeitraum nicht eingereicht, so ist der Wert nach Ablauf der 30 Minuten wieder verfügbar.
	6	* Bei Einreichung des Assistenten wird die verfügbare Anzahl reduziert, sofern vorhanden.
	7	* Für ungültige Werte ist die Fehlermeldung konfigurierbar.
	8
1.1	9	## Erstellung einer dynamischen Liste
	10
404.1	11	Bei der Erstellung einer [[CSV\|Main.05_Assistenten.04_Assistentenbauoberfläche.08_Listen.03_ErstellungeinerCSV-Datei]]-Liste ist es egal, in welcher Reihenfolge die Spalten und Werte erstellt werden. Wichtig bei der Erstellung ist nur, dass Spaltenüberschriften definiert werden.
1.1	12
404.1	13	> {{icon name="far fa-info-circle" size="3"/}} _Hinweis:_
	14	>
133.1	15	> Wird ein Wert in der Spalte "Gültig bis" eingetragen muss beachtet werden, dass dieses Datum nicht inklusive ist. Das heißt, die Gültigkeit geht nur bis am Vortag um Mitternacht.
1.1	16
	17	![[Aufbau einer dynamischen Liste\|@DynamischeListenExcelAufbau.jpg]]
	18
	19	## Hinterlegung einer dynamischen Liste in der Listenverwaltung
	20
	21	Die erstellte CSV-Liste muss in der [[Listenverwaltung\|Main.05_Assistenten.04_Assistentenbauoberfläche.08_Listen.01_Listenverwaltung]] hinterlegt werden. Bei der Konfiguration der Einstellungen müssen neben den normalen Angaben folgende Punkte beachtet werden:
	22
	23	1. Auswahl Listentyp „Dynamisch“
404.1	24	1. CSV-Datei hochladen
	25	1. Optional: Fehlertexte unter „Fehlertext keinen/eindeutigen Wert“ und „Fehlertext für ungültigen Wert“ angeben.
	26	1. Schaltfläche „Speichern“ betätigen
	27	1. Angabe der Parameter „Schlüssel“, „Gültigkeit von“, „Gültigkeit bis“ und „Anzahl“ anlog der Spalten in der CSV-Liste {{icon name="far fa-info-circle" size="3"/}} Hinweis: Die Auswahlfelder erscheinen erst nach dem ersten Mal speichern.
	28	1. CSV-Datei hochladen
	29	1. Schaltfläche „Speichern“ betätigen
1.1	30
404.1	31	> {{icon name="far fa-info-circle" size="3"/}} _Hinweis:_
1.1	32
404.1	33	1. Die CSV-Liste muss insgesamt zweimal hochgeladen werden.
	34	1. Nach dem ersten Mal erscheinen weitere Felder.
	35	1. Nachdem diese eingestellt wurden, muss nochmals die Liste hochgeladen und gespeichert werden.
	36
	37
	38
1.1	39	![[Konfiguration einer dynamischen Liste in der Listenverwaltung\|@DynamischeListeKonfigListenverwaltung.jpg]]
	40
	41	## Konfiguration der Komponente für bsp. einen Gutscheincode
	42
	43	Für diese Variante wird eine [[Autovervollständigung\|Main.05_Assistenten.04_Assistentenbauoberfläche.08_Listen.02_Listennutzung.03_BeispieleListennutzung]] sowie ein Eingabetextfeld benötigt. Das Eingabetextfeld muss [[hierarchisch\|Main.05_Assistenten.04_Assistentenbauoberfläche.04_KonfigurationvonKomponenten]] unter die Autovervollständigung gepackt werden. Weiterhin müssen in der Konfiguration der Autovervollständigungskomponente unter dem Reiter „Spezielle Einstellungen“ folgende Einstellungen vorgenommen werden:
	44
	45	1. Liste auswählen
404.1	46	1. Art der Validierung „Nur Validierung“ auswählen
	47	1. Listenfeld hinterlegen
1.1	48
404.1	49	> {{icon name="far fa-info-circle" size="3"/}} _Hinweis:_
94.1	50
404.1	51	1. Eine Nutzung der dynamischen Liste in einem Multipanel ist derzeit nicht möglich.
	52	1. Eine Nutzung von mehreren dynamischen Listen in einem Assistenten oder das Ein-/Ausblenden von Komponenten mit einer dynamischen Liste wird nicht empfohlen, da dies zu doppelten Buchungen führen kann.
	53	1. Eine Nutzung der Funktion "Zwischenspeichern" im Assistenten mit einer dynamischen Liste wird nicht empfohlen, da dies zu einer Überbuchung führen kann.
	54
	55
	56
1.1	57	![[Konfiguration der Komponente Autovervollständigung für ein Gutscheincode\|@DynamischeListenKonfigKomponente.jpg]]
	58
	59	## Konfiguration der Komponente für bsp. eine Reservierung eines Termins
	60
	61	Für diese Variante wird eine [[Autovervollständigung\|Main.05_Assistenten.04_Assistentenbauoberfläche.08_Listen.02_Listennutzung.03_BeispieleListennutzung]] sowie ein Dropdown/Optionsfeld benötigt. Das Dropdown/Optionsfeld muss [[hierarchisch\|Main.05_Assistenten.04_Assistentenbauoberfläche.04_KonfigurationvonKomponenten]] unter die Autovervollständigung gepackt werden. In der Konfiguration des Dropdown/Optionsfeld muss unter dem Reiter „Spezielle Einstellungen“ die Option „Einträge aus Liste“ auf „Ja“ und die Liste „Einträge aus umgebender Autovervollständigung“ ausgewählt sein. Weiterhin müssen in der Konfiguration der Autovervollständigungskomponente unter dem Reiter „Spezielle Einstellungen“ folgende Einstellungen vorgenommen werden:
	62
	63	1. Liste auswählen
404.1	64	1. Art der Validierung „Autovervollständigung und Validierung“ auswählen
	65	1. Listenfeld hinterlegen
1.1	66
404.1	67	> {{icon name="far fa-info-circle" size="3"/}} _Hinweis:_
94.1	68
404.1	69	1. Eine Nutzung der dynamischen Liste in einem Multipanel ist derzeit nicht möglich.
	70	1. Eine Nutzung von mehreren dynamischen Listen in einem Assistenten oder das Ein-/Ausblenden von Komponenten mit einer dynamischen Liste wird nicht empfohlen, da dies zu doppelten Buchungen führen kann.
	71	1. Eine Nutzung der Funktion "Zwischenspeichern" im Assistenten mit einer dynamischen Liste wird nicht empfohlen, da dies zu einer Überbuchung führen kann.
	72	1. Eine Anzeige der noch verfügbaren Termine ist nicht vorhanden.
1.1	73
404.1	74
1.1	75
404.1	76	![[Konfiguration der Komponente Autovervollständigung für einen Termin\|@DynamischeListenKonfigKomponenteDropdown.jpg]]