Für Eingaben, deren zulässige Werte aus einer Liste ausgewählt werden können, stehen sogenannte Kombinationsfelder zur Verfügung. Hierbei werden für die verknüpfte Spalte in einer Datenbank alle zulässigen Werte in einer Liste angezeigt, aus welcher der gewünschte Wert dann ausgewählt werden kann. Geeignet ist dieses Steuerelement daher für alle Anwendungsfälle, in denen eine beschränkte Anzahl gültiger Werte vorhanden ist, welche sich auch dynamisch verändern können. Als Datenquellen kommen dabei andere Datenbanktabellen oder Initialwerte von Docusnap in Frage. Sollen die Daten aus der Datenbank kommen, kann jede beliebige Datenbanktabelle angegeben werden, sofern diese über einen Primärschlüssel und ein Anzeigefeld verfügt. Gespeichert wird in der Datenbank dabei nicht der ausgewählte Text, sondern die zugehörige Zahl, die im Falle einer Tabelle als Datenquelle dem Primärschlüssel und im Falle von Initialwerten dem jeweiligen Wert entspricht.
In einigen Fällen kann es nötig sein, dass im Kombinationsfeld nur bestimmt Werte zur Auswahl stehen, z.B. nur Kontakte, die zum aktuellen Mandanten gehören. Um dies zu ermöglichen, wird eine Sicht verwendet, die über die Variable {FilterID} gefiltert wird. Die {FilterID} wird durch den Primärschlüssel des übergeordneten Knotens ersetzt.
Unten stehende Tabelle listet alle spezifischen Eigenschaften von Kombinationsfeldern auf.
Spezifische Eigenschaften von Kombinationsfeldern |
|
DropDownHeight |
Legt fest, wie groß in Pixel der aufklappende Bereich zur Auswahl vordefinierter Werte erscheinen soll. |
Fieldname |
Gibt die verknüpfte Spalte in der jeweiligen Tabelle der aktuellen Docusnap-Datenbank an. Die zugehörige Tabelle ergibt sich aus dem mit der Eingabemaske verknüpften Metaobjekt. Die entsprechende Zielspalte in der Datenbank muss bei einem Kombinationsfeld immer eine Zahl repräsentieren. |
Sorted |
Ist diese Eigenschaft aktiviert, so wird der Inhalt des Kombinationsfeldes alphabetisch sortiert dargestellt. Hierbei ist zu beachten, dass Initialwerte nicht explizit sortiert werden können, sondern die Auswahl in diesem Fall zu einem fehlerhaften Verhalten führen kann. |
SourceType |
Diese Eigenschaft ermöglicht festzulegen, welche Art von Datenquelle für das Kombinationsfeld verwendet werden soll. Zur Auswahl stehen dabei, wie bereits eingangs erwähnt, andere Datenbanktabellen sowie die Initialwerte von Docusnap. |
SourceValue |
Je nach ausgewähltem SourceType wird bei dieser Eigenschaft entweder der Name der entsprechenden Datenbanktabelle oder die Bezeichnung des gewünschten Initialwertes eingetragen. |
NoSelection |
Ist diese Eigenschaft aktiviert, wird im Kombinationsfeld zusätzlich zu den Einträgen auch noch die Möglichkeit <Keine Auswahl> angezeigt. Wenn <Keine Auswahl> ausgewählt wird, wird beim Speichern kein Wert in die Datenbank eingetragen. Wenn die Datenspalte nicht leer sein darf, kann diese Eigenschaft nicht verwendet werden. |
