Sprache: Deutsch · English
Valuelist Provider
Abhängige Auswahllisten in Comboboxen – z.B. nur die Ansprechpartner des gewählten Kunden.
HOW-TO ANWENDUNGSENTWICKLER STAND: JUL 2026 GILT FUER NUCLOS 4.2026.X
Auf dieser Seite
Was ist ein Valuelist Provider?
Ein Valuelist Provider (VLP) schränkt die Auswahl in einer Combobox/List-of-Values dynamisch ein – abhängig von einem anderen ausgewählten Wert. Typische Fälle: nur die Ansprechpartner eines gewählten Kunden anzeigen oder nur die Räume eines gewählten Gebäudes.
Fallbeispiel: Ansprechpartner je Kunde.
Schritt 1: Datenquelle anlegen
Menüaufruf: Administration → Datenquellen → Valuelist Provider. Definiere einen Übergabeparameter (z.B. intid_kunde), der die interne ID des auslösenden Datensatzes übermittelt.
Praktisch
Heißt der Parameter intid, übernimmt Nuclos automatisch die INTID des Hauptdatensatzes.
Datenquelle des Valuelist Providers.
Schritt 2: VLP im Layout einfügen
Im Layouteditor hängst du den Valuelist Provider über die Palette an das Zielfeld (hier: Ansprechpartner). Optional lässt sich ein Default-Flag nutzen, um beim Durchlaufen automatisch einen Standardwert (z.B. die Standardadresse) vorzuwählen.
Valuelist Provider im Layout.
Schritt 3: Layoutregel anlegen
Definiere auf dem Ausgangsfeld (hier Kunde) eine Layoutregel:
| Feld | Wert |
|---|---|
| Ereignis | Wenn Wert sich ändert |
| Aktionstyp | Werteliste aktualisieren |
| Businessobjekt | BO der Zielkomponente (nur bei Unterformular; sonst leer) |
| Zielkomponente | Combobox, deren Werte aktualisiert werden |
| Parameter | Parametername aus der Datenquelle |
Layoutregel „Werteliste aktualisieren“.
Vordefinierte Valuelist Provider
- Status: grenzt die Werteliste des Statusfeldes auf bestimmte Businessobjekte ein (Parameter Businessobjekte = interner BO-Name).
- Process: grenzt die Werteliste des Aktionsfeldes ein (nur auf dem Feld
NuclosProcess). - Parameters: hinterlegt Wertelisten in Spaltendefinitionen von Unterformulardaten (Parameter
showValue).
Systemseitige Parameter
Systemparameter in Bedingung/SQL: $username, $mandator, $locale, $searchmode (in Hochkommata). Sie müssen im VLP zuvor unter Parameter deklariert werden.
VLP für Text-Attribute
Um für ein Text-Attribut eine feste Werteliste anzubieten (ohne Referenz, z.B. für „Anrede“), wähle im Layouteditor eine Combobox mit Haken Zeige alle Attribute, hinterlege einen VLP (ID-Feld leer lassen). Mit Werteliste editierbar dürfen Nutzer auch eigene Werte eintragen.
Combobox mit Valuelist Provider für ein Text-Attribut.
Verwandte Seiten
Überblick
Inhalte