Ein viel verwendeter Anwendungsfall ist, dass eine nicht vorher bekannte Anzahl an Dateien hochgeladen werden sollten. Statt einfach 10 Uploadfelder im Formular einzufügen, können vom User weitere Felder eingefügt oder vorhandene gelöscht werden. Beispiele sind unter Punkt 6 Editiermodus zu finden.
Alternative > Alternative Wiederholung / Zusätzliche Felder dynamisch anzeigen
Konfiguration
1. Minimale Anzahl Einträge
Anzahl der Wiederholungen, die erstellt werden. Bedeutet, dass die Anzahl Wiederholungen (wenn ein Feld obligatorisch ist) zwingend vom User erfasst werden müssen. Macht in Kombination mit Punkt 2 Sinn.
2. Minimale Einträge automatisch anlegen
Wird diese Option gewählt, wird die unter 1 erfasste Anzahl Wiederholungen direkt angezeigt / angelegt.
3. Maximale Anzahl Einträge
Anzahl der für den User verfügbaren Wiederholungen. Es empfiehlt sich genau zu überlegen, was im Anwendungsfall sinnvoll ist. Uneingeschränkte Anzahl Wiederholungen ist selten nötig und kann die Performance einschränken. Achtung, bei Dateiuploads kann eine Beschränkung der Anzahl Wiederholungen im Zusammenspiel mit der maximalen Dateigrösse zu Problemen führen, wenn die Dateien per E-Mail übermittelt werden - maximale Grösse der Beilagen!
4. Maximale Einträge automatisch anlegen
Es werden alle Wiederholungen direkt angelegt. Wird in der Tabellenansicht verwendet und macht in der "serial" Konfiguration unter Punkt 6 keinen Sinn.
5. Kontrollschaltflächen anzeigen?
Wird diese Option gewählt (empfohlen), zeigen sich die "weiteren Eintrag hinzufügen" oder "Eintrag löschen". Wenn unter Punkt 4 die maximale Anzahl schon erstellt wurde, macht diese Option weniger Sinn.
5.1 Kontrollschaltflächen konfigurieren
Standardmässig sind die Aktionen "Eintrag hinzufügen" und "Eintrag löschen" für die Liste aktiv. Mit der JEP-Funktion 'setListControlAccess()' lassen sich die Aktionen konfigurieren und entsprechend ein- und ausblenden.
Dazu muss eine Regel auf der Liste erstellt werden:
Folgende Konfigurationsparameter sind verfügbar:
| JEP-Funktion | Aktion | Werte | JEP Beschreibung |
|---|---|---|---|
| setListControlAccess() | delete |
|
|
| add |
| ||
| copy |
| ||
| copyContent |
| ||
| edit |
| ||
| moveUp |
| ||
| moveDown |
| ||
| paste |
|
6. Editiermodus
Definiert, wie sich die Wiederholung beim User zeigt. Siehe dazu auch die Beispiele oben.
| serial | tabelle | masterDetail | masterDialog |
|---|---|---|---|
| Die Wiederholungen werden vollständig dargestellt. | Die Wiederholungen werden direkt in der Tabelle dargestellt und auch dort bearbeitet. | Der Master zeigt die Wiederholung als Werte in einer Tabelle. Die gewählte Wiederholung kann unter der Master- Tabelle erfasst oder bearbeitet werden. | Der Master zeigt die Wiederholung |
Beispiele
|
|
Beispiel
|
als Dialogfenster |
Wichtig, je nach Custom Design können die Darstellungen abweichen, respektive müssen jeweils entsprechend als Styles (CSS) definiert sein.
7. Pluginklasse
Java Klasse, welche Spezialprogrammierungen erfasst werden.
8. Tabellenhöhe dynamisch?
Die Tabelle ist so hoch, dass alle Zeilen dargestellt werden. Diese Höhe passt sich automatisch an die Anzahl Zeilen an.
9. Layout
Nur bei Editiermodus "serial" verfügbar. Je nach Custom Design, kann die Darstellung der erwarteten Spalten-Logik angepasst werden.
10. Spaltendefinition (zu verwendende Elemente)
Je zu wiederholendes Formular-Element muss ein Eintrag erfasst werden. Die Konfiguration des einzelnen Eintrages erfolgt unterhalb und verhält sich dem gewählten Formular-/Feldtyp entsprechend.
| Funktionsmenu | Zeilenüberschrift | Beschriftungen | ||
|---|---|---|---|---|
|
|
|
|
|
Es werden die bekannten Funktionen angeboten. Referenz oder Kopie einer (globalen) Komponente.  | Wird bei der Tabellenansicht in "linken Spalte" angezeigt. | Wird bei der Schaltfläche "hinzufügen" angezeigt oder als ToolTipp hinterlegt. Hinweis *) | Wird bei der Schaltfläche "kopieren" angezeigt oder als ToolTipp hinterlegt. Hinweis *) | Wird bei der Schaltfläche "löschen" angezeigt oder als ToolTipp hinterlegt. Hinweis *) |
*) Je nach Custom Design werden die Schaltflächen ausgeblendet oder anders dargestellt.
11. Name
Entspricht dem Feldnamen (technisch). Muss eindeutig sein und den Kriterien einer Variable entsprechen.
12. Breite
Definiert die Anzeigebreite. Die effektiven Breiten (% oder Wert) der angebotenen Auswahl werden im Style-Sheet (CSS) definiert. Siehe Beispiel am Anfang der Seite.
13. Wert nicht serialisieren?
Nur Anzeige, nicht übermitteln / ins XML schreiben.
14. In Tabelle anzeigen?
Um eine Tabelle übersichtlich zu halten, kann es sinnvoll sein, bestimmte Feldwerte in der Tabellenansicht auszublenden.
15. Horizontale Ausrichtung?
Ausrichtung in der Tabellenansicht. Kann sinnvoll sein, wenn ein Betrag oder Zahlenwert rechts ausgerichtet werden soll.
16. Konfiguration des unter Punkt 10 ausgewählten Elementes?
Unterhalb zeigt sich die eigentliche Konfiguration des Formular-Elementes. Es kann sein, dass sich diese Konfigurationsmöglichkeiten eingeschränkt sind, da sich nicht bei jedem Typ jede Konfigurationsmöglichkeit in der Wiederholung umsetzen lässt.
Konfigurationsanleitung je Formular-Element ist der entsprechenden Beschreibung zu entnehmen.
ACHTUNG: Aktuell sind nicht alle Elemente in der Tabelle verfügbar.
Tipps und Tricks zur Anwendung einer Tabelle
Insbesondere Formeln / Sichtbarkeiten und Regeln müssen bei der Verwendung innerhalb einer Tabelle anders (dynamisch) funktionieren. Entsprechend benötigt die Anwendung mehr Vorkenntnisse zum Thema.