TreeView

Mit dem Element TreeView können Elemente einer anderen Tabelle mithilfe eines Baumes dem aktuellen Element zugewiesen werden. Durch die Darstellung der zu verbindenden Tabelle im Baum kann das jeweilige Element über die vorangestellten Kontrollkästchen dem aktuellen Element zugewiesen werden. Das Element TreeView ist von Vorteil, wenn einem Element mehrere andere Elemente zugeordnet werden sollen und die Zuordnung über ein Kombinationsfeld, das nur eine Verbindung erlaubt, nicht ausreichend ist. Zur Erstellung eines TreeView sind folgende Felder auszufüllen:

Spezifische Eigenschaften eines TreeView
MappingForeignKeyFieldAngabe des Fremdschlüsselfeldes der Tabelle, welche die Beziehung zu der verbindenden Tabellen darstellt.
MappingReferenceFieldGibt an, in welches Feld in der Beziehungstabelle die ausgewählten Einträge der Referenztabelle gespeichert werden sollen.
MappingTableAngabe des Tabellennamens der Tabelle, welche die Verbindung zwischen den beiden zu verbindenden Feldern darstellt.
ReferencePrimaryFieldAngabe des Primärschlüssels der Referenztabelle.
ReferenceRecursionFieldAngabe eines eventuell vorhandenen Rekursionsfeldes, falls die Referenztabelle eine rekursive Tabelle ist.
ReferenceSQLAngabe des SQL-Statements um die benötigten Daten aus der Referenztabelle zu erhalten.
ReferenceTextFieldAngabe des Textfeldes, das als Knotennamen im Baum aufgeführt werden soll.
SortedIst diese Eigenschaft aktiviert, werden die Einträge alphabetisch nach der ersten Spalte sortiert. Wenn diese Option nicht aktiv ist, wird bei Sichten die Sortierung verwendet, die beim Statement angegeben wurde, und bei Tabellen werden die Daten in der Reihenfolge ausgegeben, in der sie in die Tabelle eingefügt wurden.

Anwendungsbeispiel:

Jedem eingetragenen Kontakt soll mithilfe des TreeView die Domäne zugewiesen werden, zu der er gehört.

Zu Beginn muss eine Tabelle erstellt werden, welche die Beziehung zwischen der Kontakte- und der Domänentabelle herstellen soll. Hierzu muss, wie im Bereich Erweiterung der Struktur erläutert, verfahren werden.

Nach Erstellung der Tabelle xtContactDomain, welche die Spalten xDomainID, xContactID und xContactDomainID besitzt, besteht folgende Tabellenstruktur:

Docusnap-Designer-Toolbox-Tree-Tabellenstruktur

Nun können alle Daten im Eigenschaftsfenster für den jeweiligen TreeView angegeben werden.

Docusnap-Editor-Toolbox-Tree-Eigenschaften

Als referenzierendes SQL-Statement wird ein einfaches Select Statement auf die Tabelle tDomains ausgeführt. Um alle Domänen der jeweiligen Firma zu erhalten, kann die Variable {AccountID} verwendet werden. Die Variable wird mit der AccountID der Firma befüllt, unter der die Eingabemaske ausgegeben wird.

Nach Eingabe aller notwendigen Daten kann das Element gespeichert und verwendet werden.

Docusnap-Editor-Kontakte-Zuordnen