FKT ALLCHILDRENTREE: Unterschied zwischen den Versionen

Aus CoPlanner 11
Zur Navigation springenZur Suche springen
Keine Bearbeitungszusammenfassung
Keine Bearbeitungszusammenfassung
Zeile 67: Zeile 67:


=== Verwendung von Wertfeldern als Dimensionsattribut (ohne Verwendung von Lookupdimensionen) <small><small>''(ab CoPlanner 11 Release 2 2025)''</small></small>===
=== Verwendung von Wertfeldern als Dimensionsattribut (ohne Verwendung von Lookupdimensionen) <small><small>''(ab CoPlanner 11 Release 2 2025)''</small></small>===
Es ist möglich, direkt über Attributmeasures zu filtern, die keine Lookupdimensionen sind sondern Wertmeasures (Dezimal, Ganzzahl etc.). Die Synthax lautet dann:
-- to be added --
 
<code>FKT_SET('NameDesAttributmeasures OPERATOR Wert')</code>
 
* Beispiel: <code>FKT_SET('Attributmeasure < 5')</code>
 
<small>''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.''</small>
 
Siehe dazu die zwei folgenden Beispiele''


==== Generisches Beispiel mit einem bool-Dimensionsattribut (True/False ) ====
==== Generisches Beispiel mit einem bool-Dimensionsattribut (True/False ) ====
Zeile 90: Zeile 82:
* tbl1: Enthält ein dezimalmeasure "value"
* tbl1: Enthält ein dezimalmeasure "value"
dim1 ist eine Attribut/Lookupdimension in tbl1.
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:
<code>FKT_SET('AttributeBool = true')</code>
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'''
[[Datei:FktsetGenerischesBeispielBoolOhneLookupEM1.png|ohne|mini]]
'''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")
[[Datei:FktsetGenerischesBeispielWertebereichOhneLookupDim1.png|ohne|mini]]
'''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:
<code>FKT_SET('AttributeValue <= 5')</code>
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'''
[[Datei:FktsetGenerischesBeispielWertebereichOhneLookupEM1.png|ohne|mini]]
'''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 ===
=== Weitere einfache Beispiele ===
==== Verwendung von FKT_SET nur direkt auf Dimensionselemente ====
-- to be added --
:* Root-Element und "keine Zuordnung" in der Dimension unterdrücken
:* ltert wird
:: <code>FKT_SET('COPSYS_ID > 2')</code>
 
:* Bestimmte einzelne Elemente über deren COPSYS_ID aus einer Dimension wegfiltern
:: <code>FKT_SET('COPSYS_ID <> 938797822888410908','COPSYS_ID <> 637797822088410900')</code>
 
:* Nur auf ein bestimmtes Element und dessen Children filtern
:: <code>FKT_SET('COPSYS_ID me+under 638797822088410875')</code>
 
==== 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
:: <code>FKT_SET('Attributmeasure < 5')</code>
:: <code>FKT_SET('Attributmeasure <> 0')</code>
:: <code>FKT_SET('Attributmeasure >= 100000')</code>
 
:* Eine Dimension hat ein Attributmeasure vom Typ bool auf das gefiltert wird
:: <code>FKT_SET('Attributmeasure = true')</code>
:: <code>FKT_SET('Attributmeasure = true')</code>


=== Beispiele bei Verwendung zur Einschränkung von Lookupdimensionen/Attributdimensionen in einer anderen Dimension ===
=== 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
-- to be added --
 
==== 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.
[[Datei:FktsetBeispielEinschraenkungDimensionsbereichDim1.png|ohne|mini|dim1|516x516px]]
*dim2: Enthält nur Elemente
[[Datei:FktsetBeispielEinschraenkungDimensionsbereichDim2.png|ohne|mini|dim2]]
 
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 [[WebApps:Dimensionswartungseditor#Kontextmenü der Header|verfügbaren Elementen]] folgende Expression definiert werden: 
 
'''Mögliche Expression:''' <code>FKT_SET('[COPSYS_ID] !me_under ' + [dim2_Einschraenkungsbereich])</code> [[Datei:FktsetBeispielEinschraenkungDimensionsbereichAusdruck.png|ohne|mini|688x688px]]
 
 
'''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.
[[Datei:FktsetBeispielEinschraenkungDimensionsbereichDim1EingeschraenkteElemente.png|ohne|mini|685x685px]]
Nun kann für das Attribut "dim2" auf Element 5, nur noch Element 2 und diesem untergeordnete Elemente aus dim2 ausgewählt werden.
 
{{Hinweis|Text=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:'''
[[Datei:FktsetBeispielEinschraenkungDimensionsbereichDim1AlleElementeEingeschraenkt.png|ohne|mini|446x446px]]
 


'''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 <small><small>''(ab CoPlanner 11 Release 2 2025)''</small></small> ====
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 [[FKT_Set#Generisches Beispiel mit einem bool-Dimensionsattribut (True/False )|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
[[Datei:FktsetBeispiel2BoolEinschraenkungDimensionsbereichDim1.png|ohne|mini|347x347px|dim1]]
* dim2 enthält Element und ein Attributmeasure vom Typ bool.
[[Datei:FktsetBeispiel2BoolEinschraenkungDimensionsbereichDim2.png|ohne|mini|dim2]]
'''Mögliche Expression:'''
Nun auf definiert in "dim1" auf der Attributdimension "dim2" in der verfügbaren Elemente Einstellung den folgenden Ausdruck:
<code>FKT_SET('bool_AuswahlInDim1Moeglich = true')</code>
'''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.
[[Datei:FktsetBeispiel2BoolEinschraenkungDimensionsbereichDim1EingeschraenkteElemente.png|ohne|mini|684x684px|Auswahlmöglichkeit bei Klick auf Element 2 im Attribut "dim2"]]
== 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:
<code>FKT_SetByExpression('([COPSYS_ID] = 1) OR (FKT_DimHasChildren("Regionen", [COPSYS_ID]) = false)')</code>
{{Hinweis|Text=Damit dies funktioniert, muss man im Ausdruck 2 unterschiedliche Hochkomma verwenden.}}
__NOEDITSECTION__  
__NOEDITSECTION__  


Zeile 253: Zeile 98:
[[Category:Funktionen - serverseitig|Set]]
[[Category:Funktionen - serverseitig|Set]]
[[en:Framework:FKT_Set]]
[[en:Framework:FKT_Set]]
__NOEDITSECTION__  
__NOEDITSECTION__  


[[Category:Funktionen|ALLCHILDRENTREE]]
[[Category:Funktionen|ALLCHILDRENTREE]]
[[Category:Funktionen - serverseitig|ALLCHILDRENTREE]]
[[Category:Funktionen - serverseitig|ALLCHILDRENTREE]]

Version vom 24. März 2026, 15:11 Uhr

-- 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
  • dem einzuschränkenden Attribut
  • einem Operator
  • und der Einschränkung selbst

Beispiel: COPSYS_ID me @Session_Unternehmen_ID@.

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:

  • me+under
  • me
  • <>
  • >
  • >=
  • <
  • <=

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 --

dim1 enthält dim2 als Lookup

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)

-- to be added --

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.


Weitere einfache Beispiele

-- to be added --

  • ltert wird
FKT_SET('Attributmeasure = true')

Beispiele bei Verwendung zur Einschränkung von Lookupdimensionen/Attributdimensionen in einer anderen Dimension

-- to be added --