FKT ALLCHILDRENTREE: Unterschied zwischen den Versionen

Aus CoPlanner 11
Zur Navigation springenZur Suche springen
Keine Bearbeitungszusammenfassung
Keine Bearbeitungszusammenfassung
 
(22 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.
 
==Beispiele==
Der folgende Beispielausdruck führt je nach Einstellung der Boolfelder in der Dimension zu den angezeigten Ergebnissen in der Eingabemaske.


==Anwendungsmöglichkeiten==
<code>FKT_AllChildrenTree('anzeigeJaNein = true')</code> (gleichbedeutend mit <code>FKT_AllChildrenTree('anzeigeJaNein me true)</code>')
-- to be added --


==Beispiele==
'''Ausgangssituation'''
-- to be added --


====Verwandte Funktionen====
Dimension
-- to be added --[[Datei:FktsetGenerischesBeispielDim1.png|ohne|mini|dim1 enthält dim2 als Lookup]]


==== FKT_SET auf Knotenelementen erklärt am vorliegenden Beispiel ====
[[Datei:FKT AllChildrentreedim1 1.png]]
{{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".
Ergebnis Eingabemaske


[[Datei:FKT AllChildrentreeEingabemaske 1.png]]




Sprich bei gleichem Beispielaufbau ergibt die folgende Konstellation in der Dimension:
'''Beispielverwendung 1'''
[[Datei:FktsetGenerischesBeispielKnotenelementDim1.png|ohne|mini|311x311px]]


das folgende Ergebnis in der Maske:
Dimension
[[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>===
[[Datei:FKT AllChildrentreedim1 2.png]]
-- to be added --


==== Generisches Beispiel mit einem bool-Dimensionsattribut (True/False ) ====
Ergebnis Eingabemaske
Es gibt eine Dimension und eine Tabelle. Auf der Tabelle baut später eine Matrixmaske auf.


'''Dimension'''
[[Datei:FKT AllChildrentreeEingabemaske 2.png]]


* dim1: Enthält die Elemente auf die später die Daten aufgebaut werden sollen und eine Attributspalte/ein Attributmeasure vom Typ bool ("AttributeBool")
[[Datei:FktsetGenerischesBeispielBoolOhneLookupDim1.png|ohne|mini]]


'''Beispielverwendung 2'''


'''Tabelle:'''
Dimension


* tbl1: Enthält ein dezimalmeasure "value"
[[Datei:FKT AllChildrentreedim1 3.png]]
dim1 ist eine Attribut/Lookupdimension in tbl1.


Ergebnis Eingabemaske


[[Datei:FKT AllChildrentreeEingabemaske 3.png]]


=== Weitere einfache Beispiele ===
weitere Beispiele:
-- to be added --
* siehe Verwendung von [[FKT Set|FKT_Set]]
:* ltert wird
:: <code>FKT_SET('Attributmeasure = true')</code>


=== Beispiele bei Verwendung zur Einschränkung von Lookupdimensionen/Attributdimensionen in einer anderen Dimension ===
====Verwandte Funktionen====
-- to be added --
:* [[FKT_Set|FKT_Set]]: Liefert alle Elemente, auf welche die Bedingung zutrifft
:* [[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
:* 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)


__NOEDITSECTION__


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


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

Aktuelle Version vom 2. April 2026, 14:48 Uhr

Funktion

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:

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

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)