Versionen im Vergleich

Schlüssel

  • Diese Zeile wurde hinzugefügt.
  • Diese Zeile wurde entfernt.
  • Formatierung wurde geändert.

Inhalt
maxLevel3

Definition

Die Multiselektions-Combobox erlaubt es eine 1:N Beziehung zwischen dem Hauptdatensatz und mehreren, referenzierenden Nebendatensätzen herzustellen. Im Gegensatz zum Subform ist nur ein Attribut für die Darstellung relevant, weshalb eine einzeilige Darstellung der zugeordneten Referenzen möglich ist.

Folgende Anforderungen sind an das BO gestellt, welches für die Multiselektionskomponente gewählt wird:

  • es muss ein Referenzfeld auf das Layout BO besitzen
  • es muss ein Referenzfeld auf ein Vorschlag BO besitzen
  • es dürfen keine weiteren Pflichtfelder existieren, da die Komponente sonst keine Einträge erstellen kann

Vorschau, wie diese Komponente im Webclient aussehen könnte:

 

Konfiguration

Die Multiselektions-Combobox befindet sich in der Kategorie "Datenkomponenten" der Palette im Layout Editor.

Die Komponente ist standardmäßig unbeschriftet, da sie sich nicht auf ein Attribut des Layout-BOs bezieht - vergleichbar mit einem Subform. Ist eine Beschriftung gewünscht, muss diese also manuell mit einem statischen Label erzeugt werden.


Multiselektionskomponente in der Palette des LayoutEditors

Wie bei der Subform Komponente werden unter "Businessobjekt" diejenigen Entitäten aufgezählt, welche sich aufgrund einer Referenz zum Layout BO für die Komponente qualifizieren.

Wird ein Businessobjekt ausgewählt, so sollte - falls richtig konfiguriert - automatisch der Fremdschlüssel und die Anzeige Referenz ausgewählt werden.

"Anzeige Referenz" bezeichnet das Feld, welches das BO mit den möglichen Vorschlägen referenziert. Es wird die Darstellung, welche im BO Attribut Wizard für dieses, unter "Verknüpfung zu anderen Businessobjekten" konfiguriert wurde, als Anzeigetext verwendet.

Konfiguration einer Multiselektionskomponente 

Der genaue Anzeigetext kann konfiguriert werden. Hierzu bearbeitet man das Referenzattribut im BO-Wizard. Unter "Verknüpfung zu anderen Businessobjekten" kann der Anzeigetext aus Attributen des Businessobjekts und statischen Zeichenketten zusammengesetzt werden.

Falls für die Multiselektionskomponente ein ValuelistProvider ausgewählt wurde, so wird nicht mehr das Referenzattribut für den Anzeigetext verwendet, sondern es wird die Beschriftung aus dem ValuelistProvider ermittelt.

Beispiel

Wir möchten einem Artikel mehrere Schlagwörter - nachfolgend als Tags bezeichnet - zuordnen.

Zuerst legen wir ein Businessobjekt "Tags" an, welches alle Schlagwörter enthält, die vorgeschlagen werden sollen.

In diesem Beispiel benötigt das Tag-BO ausschließlich ein Attribut "name", welches später für die Anzeige verwendet wird.



Dann erstellen wir ein Businessobjekt "ArticleTags", welches genau 2 Referenzfelder enthält:

  • Referenzfeld auf Article
  • Referenzfeld auf Tag

Dieses BO können wir dann im LayoutEditor auswählen und es sollte automatisch die benötigten Felder ermitteln.


Vorschau im Webclient