FKT ALLCHILDRENTREE
-- to be added --
Funktion
FKT ALLCHILDRENTREE('<Bedingung 1>', ..., '<Bedingung n>')
FKT ALLCHILDRENTREE
-- to be added --
| Parameter | Beschreibung |
|---|---|
| Bedingung 1 bis n | Jede Bedingung besteht aus 3 Teilen
Beispiel: Das einzuschränkende Attribut bezieht sich immer auf die Dimension auf der das FKT_SET gesetzt wird. Daher sind diese nur mit dem Namen anzugeben. Falls eine Dimension als Attribut mehrfach in der Dimension vorkommt, dann kann durch Angabe des Alias oder des LookUp-Appendix die gewünschte Dimension angegeben werden. Wird kein Appendix angegeben und kein Alias verwendet, wird immer die LookUp-Dimension _1 genommen. Anzugeben wäre dies z.B.: Unternehmen_1 me @Session_Unternehmen_ID@ Der Operator ist mit einem Vergleichstyp anzugeben, wobei folgende erlaubt sind:
Die Einschränkung = wird bei Dimensionen immer als me interpretiert und ist nur aus Kompatibilitätsgründen enthalten. Die Einschränkung selbst kann jeder Datenpfad, Variable oder Funktion sein, die eine gültige COPSYS_ID liefert. |
Diese Funktion gehört zu den serverseitigen Funktionen.
Ergebnis
-- to be added --
Anwendungsmöglichkeiten
-- to be added --
Beispiele
-- to be added --
Verwandte Funktionen
-- to be added --

FKT_SET auf Knotenelementen erklärt am vorliegenden Beispiel
| Hinweis Für den Gebrauch von FKT_SET auf Knotenelemente gilt: FKT_SET filtert das jeweilige Element wirklich "komplett" weg.Das bedeutet: Nicht mehr vorhandene Ebenen werden pro Element eingerückt. |
Im Beispiel bedeutet das: Wenn das "Element 11" über dim2 auf "False" gesetzt wird, bleiben Element 13 und Element 14 bestehen und werden aber eine Ebene nach links "eingerückt".
Sprich bei gleichem Beispielaufbau ergibt die folgende Konstellation in der Dimension:

das folgende Ergebnis in der Maske:

Verwendung von Wertfeldern als Dimensionsattribut (ohne Verwendung von Lookupdimensionen) (ab CoPlanner 11 Release 2 2025)
Es ist möglich, direkt über Attributmeasures zu filtern, die keine Lookupdimensionen sind sondern Wertmeasures (Dezimal, Ganzzahl etc.). Die Synthax lautet dann:
FKT_SET('NameDesAttributmeasures OPERATOR Wert')
- Beispiel:
FKT_SET('Attributmeasure < 5')
Hinweis: Der Umweg über die Verwendung von Lookupdimensionen für einfache Abfragen, bei denen es z. B. nur um eine True/False Abfrage oder die Unterscheidung von Wertebereichen geht, bei der geprüft wird ob z. B. ein bestimmtes Attribut größer oder kleiner einem bestimmten Wert ist, war nur bis einschließlich Version CoPlanner CoPlanner 11 Release 2 2025 notwendig. Ab CoPlanner 11 Release 2 2025 kann hierfür - wie eben beschrieben - auch direkt ein Wertefeld verwendet werden.
Siehe dazu die zwei folgenden Beispiele
Generisches Beispiel mit einem bool-Dimensionsattribut (True/False )
Es gibt eine Dimension und eine Tabelle. Auf der Tabelle baut später eine Matrixmaske auf.
Dimension
- dim1: Enthält die Elemente auf die später die Daten aufgebaut werden sollen und eine Attributspalte/ein Attributmeasure vom Typ bool ("AttributeBool")

Tabelle:
- tbl1: Enthält ein dezimalmeasure "value"
dim1 ist eine Attribut/Lookupdimension in tbl1.
Matrixmaske:
Darauf wird nun (ein Würfel und dann) eine Matrixmaske aufgebaut in der dim1 auf der Achse liegt.
Mögliche Expression:
Nun kann man auf die Dimension in der Matrixmaske z. B. folgenden Ausdruck definieren:
FKT_SET('AttributeBool = true')
Dieser schränkt die Anzeige der Dimensionselemente auf alle Elemente ein, bei denen der Boolwert im Dimensionsattribut von dim1 true ist.
Ergebnis in der Matrixmaske

Erklärung: In dieser Konstellation werden alle Elemente angezeigt bei denen in "dim1" der Wert im Attributmeasure "AttributeBool" true ist. (siehe Screenshot weiter oben von dim1)
Generisches Beispiel mit einem Wertebereich in einem Dezimal-Dimensionsattribut
Es gibt eine Dimension und eine Tabelle. Auf der Tabelle baut später eine Matrixmaske auf.
Dimension
- dim1: Enthält die Elemente auf die später die Daten aufgebaut werden sollen und eine Attributspalte/ein Attributmeasure vom Typ Dezimal ("AttributeValue")

Tabelle:
- tbl1: Enthält ein dezimalmeasure "value"
dim1 ist eine Attribut/Lookupdimension in tbl1.
Matrixmaske:
Darauf wird nun (ein Würfel und dann) eine Matrixmaske aufgebaut in der dim1 auf der Achse liegt.
Mögliche Expression:
Nun kann man auf die Dimension in der Matrixmaske z. B. folgenden Ausdruck definieren:
FKT_SET('AttributeValue <= 5')
Dieser schränkt die Anzeige der Dimensionselemente auf alle Elemente ein, bei denen der Wert im Dimensionsattribut von dim1 kleiner oder gleich 5 ist.
Ergebnis in der Matrixmaske

Erklärung: In dieser Konstellation werden alle Elemente angezeigt bei der in "dim1" im Attributmeasure "AttributeValue" Werte stehen, die kleiner oder gleich 5 sind. (siehe Screenshot weiter oben von dim1)
Weitere einfache Beispiele
Verwendung von FKT_SET nur direkt auf Dimensionselemente
- Root-Element und "keine Zuordnung" in der Dimension unterdrücken
FKT_SET('COPSYS_ID > 2')
- Bestimmte einzelne Elemente über deren COPSYS_ID aus einer Dimension wegfiltern
FKT_SET('COPSYS_ID <> 938797822888410908','COPSYS_ID <> 637797822088410900')
- Nur auf ein bestimmtes Element und dessen Children filtern
FKT_SET('COPSYS_ID me+under 638797822088410875')
Verwendung von FKT_SET auf andere Felder (z. B. Attributmeasures in einer Dimension)
- Eine Dimension hat ein Attributmeasure vom Typ Dezimal auf das gefiltert wird
FKT_SET('Attributmeasure < 5')FKT_SET('Attributmeasure <> 0')FKT_SET('Attributmeasure >= 100000')
- Eine Dimension hat ein Attributmeasure vom Typ bool auf das gefiltert wird
FKT_SET('Attributmeasure = true')
Beispiele bei Verwendung zur Einschränkung von Lookupdimensionen/Attributdimensionen in einer anderen Dimension
FKT_Set kann auch verwendet werden, um auswählbare Dimensionen einzuschränken, wenn eine Dimension als Attributdimension in einer anderen Dimension verwendet wird. Dadurch können z. b. "Einschränkungsbereiche" definiert werden. Hierzu zwei Beispiele
Generelles Beispiel
Im Beispiel ist das Ziel, dass auf Elementebene in "dim1" eingeschränkt werden kann, welche Elemente der Attributdimension "dim2" als Attribut ausgewählt werden können.
Aufbau:
Dimensionen:
- dim1: Enthält Elemente und "dim2" zweimal als Lookupdimension mit unterschiedlichem Alias.

- dim2: Enthält nur Elemente

Konkret soll für Element 5 in dim1 im Attribut "dim2" nur Elemente ausgewählt werden können die Element 2 sind oder sich unterhalb von Element 2 befinden.
Dazu kann in "dim1" auf der Attributdimension "dim2" bei den verfügbaren Elementen folgende Expression definiert werden:
Mögliche Expression: FKT_SET('[COPSYS_ID] !me_under ' + [dim2_Einschraenkungsbereich])

Ergebnis:
Nun kann über die Auswahl der Elemente in "dim2_Einschränkungsbereich" die Auswahlmöglichkeit der Elemente in "dim2" eingeschränkt werden.Im Beispiel nun bei Element 5 in der Attributdimension "dim2_Einschränkungsbereich" das Element 2 auswählen.

Nun kann für das Attribut "dim2" auf Element 5, nur noch Element 2 und diesem untergeordnete Elemente aus dim2 ausgewählt werden.
| Hinweis Dies kann damit pro Element ausgewählt werden, jedoch nur nach den Kriterien der Expression für die Verfügbaren Elemente. Diese wird - wie eben dargestellt - für die ganze "Attributspalte" dim2 definiert. |
Ergebnis, wenn für alle Elemente eine gültige Einschränkung erfolgt ist:

möglicher Anwendungsfall
Dies ist z. B. bei Zuordnungen hilfreich wenn für den User sinnvolle Attribute vorausgewählt werden sollen.
Beispiel bei Verwendung von Wertfeldern als Dimensionsattribut (ab CoPlanner 11 Release 2 2025)
Wenn man die Auswahlmöglichkeit nicht anhand der gleichen Dimension wie im vorhergehenden Beispiel beschrieben einschränken möchte, sondern anhand z. B. eine Bool- Oder Wertfeldes ist dies auch möglich. Dies ist dann analog zum generischen Beispiel mit einem bool-Dimensionsattribut (True/False ). Jedoch wird dann die FKT_SET Expression nicht in einer Matrixmaske sondern wie im vorhergehenden Beispiel auf die Verfügbaren Elemente der Attributdimension definiert.
Möglicher Aufbau:
- dim1 enthält Elemente und dim2 als Attributdimension

- dim2 enthält Element und ein Attributmeasure vom Typ bool.

Mögliche Expression:
Nun auf definiert in "dim1" auf der Attributdimension "dim2" in der verfügbaren Elemente Einstellung den folgenden Ausdruck:
FKT_SET('bool_AuswahlInDim1Moeglich = true')
Ergebnis:
Es werden bei der Auswahl der Elemente für dim2 nun nur noch diese angezeigt, bei denen das bool feld "bool_AuswahlInDim1Moeglich" auf true steht.

Komplexere Abfragen (FKT_SetByExpression)
- FKT_SetByExpression
Für komplexere Abfragen gibt es noch die Funktion FKT_SetByExpression, die es ermöglicht, eine Menge mit boolschen Ausdrücken abzufragen.
Anhand eines einfachen Beispiels: wenn man in der Dimension "Regionen" nur das Root-Element und alle Blattelemente als Ergebnis haben möchte, so geht dies mit folgender Abfrage:
FKT_SetByExpression('([COPSYS_ID] = 1) OR (FKT_DimHasChildren("Regionen", [COPSYS_ID]) = false)')
| Hinweis Damit dies funktioniert, muss man im Ausdruck 2 unterschiedliche Hochkomma verwenden. |