Baum-Elemente

Baum-Elemente dienen zur Anzeige von hierarchischen Daten auf Basis von Datensätzen.

Eigenschaften Baum-Element

Bereich	Eigenschaft	Wert
Allgemeines	Name (Name)	Name des Elementes (für Anwender nicht sichtbar)
	Titel (Title)	Titel des Elementes (für Anwender sichtbar)
	Beschreibung (Description)	Kurze Dokumentation des Baum-Elementes
	Kommentar (Comment)	Beliebiger Kommentar zur Dokumentation. Der Kommentar wird nicht zum Client übertragen und dient nur zur Dokumentation von Besonderheiten, Hinweisen, etc. Bei Auslieferung/Weitergabe der Lösung wird der Kommentar eingeschlossen, so dass der Empfänger ihn im AppDesigner sieht.
Daten	Datenquelle (DataSourcePartnerId , DataSourcePackageId , DataSourceName )	Partner-Kennung, Lösungs-Kennung und Name für die verwendete Datenquelle
	Feldname Schlüssel Datensatz (IdFieldName)	Name des Feldes, das den eindeutigen Schlüssel des Satzes im Baum definiert
	Feldname Schlüssel Elternknoten (ParentIdFieldName)	Name des Feldes, das den Schlüssel des Elternsatzes im Baum festlegt.
	Feldname Festlegung Selektierbarkeit (IsSelectableDefinedByField)	Name des Feldes, das die Selektierbarkeit der Einträge steuert. Wenn das Feld den Wert -1 enthält, ist der Eintrag selektierbar Beim Feld selbst muss die Eigenschaft "Sichtbarkeit" mit dem Wert "Versteckt" definiert werden. Wird kein Feldname angegeben, sind alle Einträge selektierbar.
	Feldname Anzahl Unterelemente (ChildCountDefinedByField)	Name des Feldes, das angibt, wie viele Kind-Elemente vorhanden sind. Wenn das Feld den Wert -1 enthält, hat der Eintrag eine unbekannte Anzahl Kind-Elemente. Bei Werten > 0 die exakte Anzahl, bei 0 keine. Wird kein Feldname angegeben, wird zur Laufzeit bei Öffnen ermittelt, ob Kind-Elemente vorhanden sind.
	Wert Hauptknoten (RootLevelValue)	Datenbankwert, der für die Kennzeichnung des Hauptknotens verwendet wird (z.B. "EMPTY" bei den Artikelgruppen).
	Max. Anzahl Baum-Ebenen (MaxLevelCount)	Festlegung, wie viele Ebenen der Baum maximal haben darf (0 bedeutet unbegrenzt). Die Angabe eines Ausdrucks (muss mit „=“ beginnen) ist zulässig.
	Feste Reihenfolge der Knoten einer Ebene (IsFixedOrder)	Durch den Wert "Ja" wird verhindert, dass der Baum vom Anwender sortiert werden kann.
Darstellung	Feldname Festlegung des Icons (IconFieldName)	Name der Feldes, das den Dateinamen des Icon enthält. Falls kein Feld angegeben wird, wird kein Icon dargestellt.
	Name Hauptknoten (RootLevelName)	Bezeichnung für den Hauptknoten; Falls kein Name eingetragen wird, wird der Baum ohne Hauptknoten dargestellt.
Kontextmenü	Kontextmenü (FunctionSetPartnerId, FunctionSetPackageId, FunctionSetName)	Partner-Kennung, Lösungskennung und Name für das Kontextmenü.
	Freizuschaltende Funktionen (FunctionSetActivationList)	Liste explizit freizuschaltender Kontextmenü-Funktionen (siehe auch die Eigenschaft "Explizite Freischaltung?" der Kontextmenüeinträge)
Drag&Drop	Service für Drag&Drop-Funktionalität in DLL (Name) (DragDropAssemblyName)	Dienst der Server-seitig die Drag&Drop-Funktionalität umsetzt (Interface "Sagede.Shared.RealTimeData.Core.ITreeDragDrop"); Hier wird der Name der aufzurufenden DLL (ohne Verzeichnisname, aber mit Dateinamenerweiterung „.dll“) angegeben. Die DLL wird immer im OL-Shared-Verzeichnis gesucht.
	Service für Drag&Drop-Funktionalität in DLL (Klassenname) (DragDropClassName)	Name der aufzurufenden Klasse inklusive Namespace. Hinweis für Developer Partner WDB-Eintrag 203334: Dokument "Zusatzdokumentation zum Wiki für Developer Partner", ITreeDragDrop
Aktualisierung	Unterknoten beim Aufklappen nachladen? (LoadSubNodesOnExpand)	Durch den Wert "Ja" wird bewirkt, dass immer nur eine Ebene des Baums geladen wird und beim Aufklappen eine Knotens die Unterebene vom Server angefordert wird.
	Aktualisierungsbenachrichtigungen (RefreshNotifications)	Liste der behandelten Aktualisierungsbenachrichtigungen ("Aktualisierungsbenachrichtigung“: sendet die Applikation eine Aktualisierungsbenachrichtigung, werden die Listen-elemente und Links, die diese Aktualisierungsbenachrichtigung enthalten, aktualisiert). Die spezielle Aktualisierungsbenachrichtigung "$[PartGuid]“ dient dazu, dass genau die Listen-Element-Instanz mit der entsprechenden Guid aktualisiert wird. Die Aktualisierung erfolgt aus VBA. Für die Aktualisierung einer Bildschirmauskunft ist der Funktionsaufruf gbSendAuskunftNotification.Sage.System zu verwenden. Der Name der Aktualisierungsbenachrichtigung wird in Parameter 1 des Kontextmenüeintrags eingetragen. Sollen Baum-Elemente aktualisiert werden, so ist die Funktion gbSendControlCenterNotification zu verwenden. Der Funktionsaufruf muss in der eigenen Lösung angelegt werden. Der Name der Aktualisierungsbenachrichtigung (z.B. $[PartGuid]) wird in Parameter 1 des Kontextmenüeintrags eingetragen. Die Aktualisierung ist identisch mit dem Aktualisieren durch den entsprechenden Button im Element. Eine eventuell vorhandene Selektion wird entfernt.
Lizenzierung	Lizenz-Kürzel (LicenseTokens)	Applikationskürzel der zu prüfenden Lizenz (nur in Nicht-Sage-Lösungen verwendbar und änderbar)
	Lizenz-Kürzel für Sage (SageLicenseTokens)	Applikationskürzel der zu prüfenden Lizenz (nur in Sage-Lösungen verwendbar und änderbar)

Eigenschaften Baum-Element-Felder

Bereich

Eigenschaft

Wert

Allgemeines

Feldname

(Name)

Eindeutiger Feldname (referenziert Datenquellenfeld)

Darstellung

Spaltennummer

(Position)

Standard Spaltennummer

Sichtbarkeit

(Visibility)

Sichtbarkeit der Spalte:

0 = Eingeblendet
1 = Ausgeblendet
2 = Versteckt

Breite (Pixel)

(Width)

Standardbreite in Pixel (Wertebereich 10 bis 600)

Ausrichtung

(Alignment)

Ausrichtung:

0 = linksbündig
1 = rechtsbündig
2 = mittig

Bei Sage werden immer die Standard-Werte verwendet, abhängig vom „Datentyp“ in der Datenquellen-Definition:

1 bei Integer, Decimal
sonst 0

Ampelfunktion

Ampeltyp

(TrafficLight)

Ampeltyp:

-1 = nicht möglich
0 = keine Ampelfunktion
1 = Ampel vor dem Wert
2 = Ampel hinter dem Wert
3 = Ampel anstelle des Wertes
4 = Einfärbung des Wertes
5 = Einfärbung der Zeile (wird von Sage nicht verwendet)

Die Definition darf nur einmal pro Listen-Element vorkommen und wird für die Datentypen Boolean, indizierter String und indiziertes Bild nicht berücksichtigt.

Tendenz Ampel

(TrafficLightValuation)

Tendenz Ampel:

1 = Grenzwerte, große Werte entsprechen Rot
2 = Grenzwerte, kleine Werte entsprechen Rot
3 = SQL-Ermittlung (nur verfügbar, wenn für dieses Feld die Eigenschaft "SQL-Ampelermittlung" in der Datenquelle definiert ist)

Grenzwert Ampel-Grün

(TrafficLightLimitGreen)

Standard für Grenzwert für Ampel-Grün

Eingabe nur, wenn "Tendenz Ampel" "Grenzwerte, große Werte entsprechen Rot" oder 2 "Grenzwerte, kleine Werte entsprechen Rot" ist, Eingabe ist dann erforderlich.

Grenzwert Ampel-Grün inklusive?

(IsTrafficLightLimitGreenInclusive)

Ist der Grenzwert noch grün, d.h. inklusive?

Eingabe nur, wenn "Tendenz Ampel" "Grenzwerte, große Werte entsprechen Rot" oder 2 "Grenzwerte, kleine Werte entsprechen Rot" ist, Eingabe ist dann erforderlich.

Grenzwert Ampel-Gelb

(TrafficLightLimitYellow)

Standard für Grenzwert für Ampel-Gelb

Eingabe nur, wenn "Tendenz Ampel" "Grenzwerte, große Werte entsprechen Rot" oder 2 "Grenzwerte, kleine Werte entsprechen Rot" ist, Eingabe ist dann erforderlich.

Grenzwert Ampel-Gelb inklusive?

(IsTrafficLightLimitYellowInclusive)

Ist der Grenzwert noch gelb, d.h. inklusive?

Eingabe nur, wenn "Tendenz Ampel" "Grenzwerte, große Werte entsprechen Rot" oder 2 "Grenzwerte, kleine Werte entsprechen Rot" ist, Eingabe ist dann erforderlich.