Wiki-Quellcode von Dynamische Listen
Zuletzt geändert von MACH formsolutions am 05.09.2025
Zeige letzte Bearbeiter
| author | version | line-number | content |
|---|---|---|---|
| 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. | ||
| 2 | |||
| 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 30 Minuten für einen Ausfüllprozess reserviert. Wird der Assistent in diesem Zeitraum nicht eingereicht, steht der Wert nach Ablauf der 30 Minuten wieder zur Verfügung. | ||
| 6 | * Für ungültige Werte ist die Fehlermeldung konfigurierbar. | ||
| 7 | * Bei Einreichung des Assistenten wird die verfügbare Anzahl reduziert, sofern zutreffend. | ||
| 8 | |||
| 9 | |||
| 10 | |||
| 11 | (% class="box infomessage" %) | ||
| 12 | ((( | ||
| 13 | **Nicht unterstützte Funktionskombinationen** | ||
| 14 | |||
| 15 | * Multipanel mit dynamischer Liste | ||
| 16 | * mehrere dynamische Listen in einem Assistenten | ||
| 17 | * Zwischenspeichern von Assistenten mit dynamischer Liste | ||
| 18 | * das Ein-/Ausblenden von Komponenten mit einer dynamischen Liste wird nicht empfohlen | ||
| 19 | ))) | ||
| 20 | |||
| 21 | |||
| 22 | == Anlegen einer dynamischen Liste in der Listenverwaltung == | ||
| 23 | |||
| 24 | Um eine lokal gespeicherte Liste in Assistenten nutzen zu können, müssen die Daten als Textdatei im Format CSV vorbereitet und in der [[Listenverwaltung>>doc:Main.05_Assistenten.04_Assistentenbauoberfläche.08_Listen.01_Listenverwaltung.WebHome]] des Formularservers hochgeladen werden. | ||
| 25 | Informationen zum erforderlichen Format siehe Artikel: [[Erstellung einer CSV-Liste>>path:/wiki/docwiki/view/Main/05_Assistenten/04_Assistentenbauoberfl%C3%A4che/08_Listen/03_ErstellungeinerCSV-Datei/]] | ||
| 26 | |||
| 27 | Die erstellte Liste wird in der [[Listenverwaltung>>Main.05_Assistenten.04_Assistentenbauoberfläche.08_Listen.01_Listenverwaltung]] als dynamische Liste angelegt und konfiguriert. Nach dem ersten Hochladen der Datei ordnen Sie die Spalten der Quelldatei den Funktionen zu. Danach laden Sie die Datei erneut hoch und speichern. | ||
| 28 | |||
| 29 | |||
| 30 | === Hochladen der Liste === | ||
| 31 | |||
| 32 | [[image:@DynamischeListeKonfigListenverwaltung.jpg||alt="Konfigurationsdialog einer dynamischen Liste in der Listenverwaltung" data-xwiki-image-style-alignment="end" height="250" width="331"]] | ||
| 33 | |||
| 34 | 1. **Namen** eintragen | ||
| 35 | 1. **Datenquellentyp**: Lokaler CSV-Import | ||
| 36 | 1. Auswahl **Listentyp: Dynamisch** | ||
| 37 | 1. **CSV-Datei **auswählen | ||
| 38 | 1. Optional: Fehlertexte unter „Fehlertext keinen/eindeutigen Wert“ und „Fehlertext für ungültigen Wert“ angeben. | ||
| 39 | 1. **Speichern** | ||
| 40 | Die Meldung erscheint: "Die Listenkonfiguration wurde gespeichert" | ||
| 41 | Es werden **weitere Konfigurationsfelder** eingeblendet. | ||
| 42 | 1. Zuordnung der Spaltenüberschriften zu den Funktionen „Schlüssel“, „Gültigkeit von“, „Gültigkeit bis“ und „Anzahl“, soweit zutreffend | ||
| 43 | 1. **CSV-Datei nochmal hochladen** | ||
| 44 | 1. **Speichern** | ||
| 45 | 1. Die dynamische Liste ist jetzt angelegt. | ||
| 46 | |||
| 47 | |||
| 48 | |||
| 49 | === Mögliche Funktionen der Spalten === | ||
| 50 | |||
| 51 | |=Bezeichnung|=Funktion | ||
| 52 | |=Schlüssel|((( | ||
| 53 | * **Eingabefeld-Validierung:** zu prüfende Werte (z. B. Zugangscode, Gutscheincode, ..) | ||
| 54 | * **Dropdown / Optionsfeld: **Bezeichnung der Auswahlmöglichkeit (z.B. Wochentag, Sportart, ..) | ||
| 55 | ))) | ||
| 56 | |=Gültigkeit von|Gültigkeitsbeginn des Schlüssels | ||
| 57 | am angegebenen Datum ist der Wert gültig | ||
| 58 | |=Gültigkeit bis|Gültigkeitsende des Schlüssels | ||
| 59 | am angegebenen Datum ist der Wert nicht mehr gültig | ||
| 60 | |=Anzahl|Startwert, der mit jeder Einreichung heruntergezählt wird | ||
| 61 | z. B. maximale Teilnehmeranzahl der Gruppe, die die Zeile betrifft | ||
| 62 | |||
| 63 | |||
| 64 | |||
| 65 | == Anwendungsfall Validierung einer Eingabe, z. B. Gutscheincode == | ||
| 66 | |||
| 67 | **Benötigte Komponenten:**[[image:DynamischeListenKonfigKomponente.jpg||alt="Konfiguration der Komponente Autovervollständigung für Validierung einer Eingabe, z. B. Gutscheincode" data-xwiki-image-style-alignment="end" data-xwiki-image-style-border="true" height="173" width="300"]] | ||
| 68 | |||
| 69 | * [[Autovervollständigung>>Main.05_Assistenten.04_Assistentenbauoberfläche.08_Listen.02_Listennutzung.03_BeispieleListennutzung]] | ||
| 70 | * ein Textfeld, der Autovervollständigung untergeordnet | ||
| 71 | |||
| 72 | **Konfiguration:** | ||
| 73 | |||
| 74 | 1. Konfiguration der **Autovervollständigung**s-Komponente > Spezielle Einstellungen | ||
| 75 | 1. im Feld **Liste auswählen** den Listennamen auswählen | ||
| 76 | 1. bei **Art der Validierung: Nur Validierung** auswählen | ||
| 77 | 1. in der Tabellenzeile, in der **Bezeichnung technisch** dem **Textfeld **entspricht, in der Spalte **Listenfeld **die **Schlüsselspalte **auswählen | ||
| 78 | |||
| 79 | {{html}} | ||
| 80 | <div style="clear:both;"/> | ||
| 81 | {{/html}} | ||
| 82 | |||
| 83 | == Anwendungsfall verfügbare Anzahl herunterzählen, z.B. Terminvergabe == | ||
| 84 | |||
| 85 | Eine Anzeige der noch verfügbaren Listeneinträge ist nicht möglich.[[image:@DynamischeListenKonfigKomponenteDropdown.jpg||alt="Konfiguration der Komponente Autovervollständigung für einen Termin" data-xwiki-image-style-alignment="end" data-xwiki-image-style-border="true" height="351" width="300"]] | ||
| 86 | Ungültige Werte werden weiterhin angezeigt. Bei Auswahl eines ungültigen Wertes erscheint eine Fehlermeldung beim Verlassen des Panels. | ||
| 87 | |||
| 88 | **Benötigte Komponenten:** | ||
| 89 | |||
| 90 | * [[Autovervollständigung>>Main.05_Assistenten.04_Assistentenbauoberfläche.08_Listen.02_Listennutzung.03_BeispieleListennutzung]] | ||
| 91 | * ein Dropdown/Optionsfeld, der Autovervollständigung untergeordnet | ||
| 92 | * eine Liste, die eine numerisch befüllte Spalte enthält. Diese Spalte ist in der Listenkonfiguration der Funktion **Anzahl** zugeordnet. | ||
| 93 | |||
| 94 | **Konfiguration:** | ||
| 95 | |||
| 96 | 1. Konfiguration der **Dropdown/Optionsfeld**-Komponente > Spezielle Einstellungen | ||
| 97 | 11. Feld **Einträge aus Liste** auf **Ja** einstellen | ||
| 98 | 11. im Feld **Liste auswählen: Einträge aus umgebender Autovervollständigung** auswählen | ||
| 99 | 1. Konfiguration der **Autovervollständigung**s-Komponente > Spezielle Einstellungen | ||
| 100 | 11. im Feld **Liste auswählen** den Listennamen auswählen | ||
| 101 | 11. bei **Art der Validierung: Auto-Vervollständigung und Validierung** auswählen | ||
| 102 | 11. in der Tabellenzeile, in der **Bezeichnung technisch** dem **Dropdown/Optionsfeld **entspricht, in der Spalte **Listenfeld **die **Schlüsselspalte **auswählen | ||
| 103 | |||
| 104 | |||
| 105 | |||
| 106 |