|
|
| (23 dazwischenliegende Versionen desselben Benutzers werden nicht angezeigt) |
| Zeile 1: |
Zeile 1: |
| -- to be added --
| |
| ==[[Framework:Formeln#Funktionen|Funktion]]== | | ==[[Framework:Formeln#Funktionen|Funktion]]== |
|
| |
|
| <code>FKT ALLCHILDRENTREE('<Bedingung 1>', ..., '<Bedingung n>')</code>
| | ''Diese Funktion ist ab CoPlanner 11 Release 1 2026 verfügbar'' |
|
| |
|
| FKT ALLCHILDRENTREE | | {{Hinweis|Text=Ein ausführliches Beispiel und genauere Erkärung zur analogen Verwendung dieser Funktion finden sich bei [[FKT Set|FKT_Set]]}} |
|
| |
|
| -- to be added --
| | <code>FKT ALLCHILDRENTREE('<Bedingung 1>', ..., '<Bedingung n>')</code> |
|
| |
|
| {| class="wikitable" width="{{{breite|100%}}}" | | {| class="wikitable" width="{{{breite|100%}}}" |
| Zeile 40: |
Zeile 39: |
|
| |
|
| Diese Funktion gehört zu den [[:Kategorie:Funktionen_-_serverseitig|serverseitigen Funktionen]]. | | Diese Funktion gehört zu den [[:Kategorie:Funktionen_-_serverseitig|serverseitigen Funktionen]]. |
| | |
| | {{Hinweis|Text=Diese Funktion funktioniert nicht für Subsetelemente, bei denen die Funktion "Dynamische Unterlemente synchronisieren" aktiv ist.}} |
|
| |
|
| ==Ergebnis== | | ==Ergebnis== |
| -- to be added -- | | Liefert alle Elemente, auf welche die Bedingung zutrifft und zusätzlich alle Child-Elemente inkl. der jeweiligen Verzweigungen. |
| | |
| ==Anwendungsmöglichkeiten==
| |
| -- to be added --
| |
|
| |
|
| ==Beispiele== | | ==Beispiele== |
| -- to be added --
| | Der folgende Beispielausdruck führt je nach Einstellung der Boolfelder in der Dimension zu den angezeigten Ergebnissen in der Eingabemaske. |
| | |
| ====Verwandte Funktionen====
| |
| -- to be added --[[Datei:FktsetGenerischesBeispielDim1.png|ohne|mini|dim1 enthält dim2 als Lookup]]
| |
|
| |
|
| ==== FKT_SET auf Knotenelementen erklärt am vorliegenden Beispiel ==== | | <code>FKT_AllChildrenTree('anzeigeJaNein = true')</code> (gleichbedeutend mit <code>FKT_AllChildrenTree('anzeigeJaNein me true)</code>') |
| {{Hinweis|Text=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".
| | '''Ausgangssituation''' |
|
| |
|
| | Dimension |
|
| |
|
| | [[Datei:FKT AllChildrentreedim1 1.png]] |
|
| |
|
| Sprich bei gleichem Beispielaufbau ergibt die folgende Konstellation in der Dimension:
| | Ergebnis Eingabemaske |
| [[Datei:FktsetGenerischesBeispielKnotenelementDim1.png|ohne|mini|311x311px]]
| |
|
| |
|
| das folgende Ergebnis in der Maske:
| | [[Datei:FKT AllChildrentreeEingabemaske 1.png]] |
| [[Datei:FktsetGenerischesBeispielKnotenelementEM1.png|ohne|mini|407x407px]] | |
|
| |
|
| === 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:
| |
|
| |
|
| <code>FKT_SET('NameDesAttributmeasures OPERATOR Wert')</code>
| | '''Beispielverwendung 1''' |
|
| |
|
| * Beispiel: <code>FKT_SET('Attributmeasure < 5')</code>
| | Dimension |
|
| |
|
| <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>
| | [[Datei:FKT AllChildrentreedim1 2.png]] |
|
| |
|
| Siehe dazu die zwei folgenden Beispiele''
| | Ergebnis Eingabemaske |
|
| |
|
| ==== Generisches Beispiel mit einem bool-Dimensionsattribut (True/False ) ====
| | [[Datei:FKT AllChildrentreeEingabemaske 2.png]] |
| 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")
| | '''Beispielverwendung 2''' |
| [[Datei:FktsetGenerischesBeispielBoolOhneLookupDim1.png|ohne|mini]]
| |
|
| |
|
| | Dimension |
|
| |
|
| '''Tabelle:'''
| | [[Datei:FKT AllChildrentreedim1 3.png]] |
|
| |
|
| * tbl1: Enthält ein dezimalmeasure "value"
| | Ergebnis Eingabemaske |
| dim1 ist eine Attribut/Lookupdimension in tbl1.
| |
|
| |
|
| | [[Datei:FKT AllChildrentreeEingabemaske 3.png]] |
|
| |
|
| | weitere Beispiele: |
| | * siehe Verwendung von [[FKT Set|FKT_Set]] |
|
| |
|
| '''Matrixmaske''':
| | ====Verwandte Funktionen==== |
| | | :* [[FKT_Set|FKT_Set]]: Liefert alle Elemente, auf welche die Bedingung zutrifft |
| Darauf wird nun (ein Würfel und dann) eine Matrixmaske aufgebaut in der dim1 auf der Achse liegt.
| | :* [[FKT_FULLSUBTREE|FKT_FULLSUBTREE]]: wie FKT_SET, liefert aber zusätzlich alle Parentelemente bis zum Wurzelknoten |
| | | :* [[FKT_SPARSESUBTREE|FKT_SPARSESUBTREE]]: wie FKT_SET, liefert aber zusätzlich den kleinsten Teilbaum, der die ausgewählten Elemente enthält |
| '''Mögliche Expression:'''
| | :* FKT_COMMONPARENTSUBTREE: wie FKT_SET, liefert aber zusätzlich ein gemeinsames Element als Wurzelknoten (damit dieses z.B. im Filter ausgewählt werden kann um alle zu wählen) |
| | | :* [[FKT_SETFROMDATA|FKT_SETFROMDATA]]: Liefert die gruppierten Elemente der angegebenen Spalte in der angegebenen Tabelle. Um auch diese Daten als Sparsetree bzw. Fulltree aufzubauen, ist eine Verschachtelung der Expressions möglich. (siehe Beispiele) |
| 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 ===
| |
| ==== Verwendung von FKT_SET nur direkt auf Dimensionselemente ====
| |
| :* Root-Element und "keine Zuordnung" in der Dimension unterdrücken
| |
| :: <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>
| |
| | |
| === 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. | |
| [[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__
| |
| | |
| [[Category:Funktionen|Set]]
| |
| [[Category:Funktionen - serverseitig|Set]]
| |
| [[en:Framework:FKT_Set]]
| |
| | |
|
| |
|
|
| |
|
Diese Funktion ist ab CoPlanner 11 Release 1 2026 verfügbar
| Hinweis Ein ausführliches Beispiel und genauere Erkärung zur analogen Verwendung dieser Funktion finden sich bei FKT_Set
|
FKT ALLCHILDRENTREE('<Bedingung 1>', ..., '<Bedingung n>')
| 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:
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.
| Hinweis Diese Funktion funktioniert nicht für Subsetelemente, bei denen die Funktion "Dynamische Unterlemente synchronisieren" aktiv ist.
|
Ergebnis
Liefert alle Elemente, auf welche die Bedingung zutrifft und zusätzlich alle Child-Elemente inkl. der jeweiligen Verzweigungen.
Beispiele
Der folgende Beispielausdruck führt je nach Einstellung der Boolfelder in der Dimension zu den angezeigten Ergebnissen in der Eingabemaske.
FKT_AllChildrenTree('anzeigeJaNein = true') (gleichbedeutend mit FKT_AllChildrenTree('anzeigeJaNein me true)')
Ausgangssituation
Dimension
Ergebnis Eingabemaske
Beispielverwendung 1
Dimension
Ergebnis Eingabemaske
Beispielverwendung 2
Dimension
Ergebnis Eingabemaske
weitere Beispiele:
Verwandte Funktionen
- FKT_Set: Liefert alle Elemente, auf welche die Bedingung zutrifft
- FKT_FULLSUBTREE: wie FKT_SET, liefert aber zusätzlich alle Parentelemente bis zum Wurzelknoten
- FKT_SPARSESUBTREE: wie FKT_SET, liefert aber zusätzlich den kleinsten Teilbaum, der die ausgewählten Elemente enthält
- FKT_COMMONPARENTSUBTREE: wie FKT_SET, liefert aber zusätzlich ein gemeinsames Element als Wurzelknoten (damit dieses z.B. im Filter ausgewählt werden kann um alle zu wählen)
- FKT_SETFROMDATA: Liefert die gruppierten Elemente der angegebenen Spalte in der angegebenen Tabelle. Um auch diese Daten als Sparsetree bzw. Fulltree aufzubauen, ist eine Verschachtelung der Expressions möglich. (siehe Beispiele)