FKT SETFROMDATA

Funktion

Hinweis  Ein ausführliches Beispiel und genauere Erkärung zur analogen Verwendung dieser Funktion finden sich bei FKT_Set

FKT_SETFROMDATA('<Tabelle>.<Dimension>', '<Einschränkung>', ...)

Parameter	Beschreibung
<Tabelle>.<Dimension>	Hier ist der Datenpfad zum Feld anzugeben, dessen Set ermittelt werden soll. Tabellen und Spaltennamen sind nicht in eckigen Klammern zu schreiben. (Falsch: [Umsatzerloese_PLAN.Umsatz])
Einschränkung 1 bis n	Dies sind Filtereinschränkungen auf LookUp-Dimensionen, Filter auf LookUp-Tabellen werden ab CoPlanner 11 Release 4 2023 unterstützt. Jede Einschränkung besteht aus 3 Teilen, der einzuschränkenden Dimension, einem Operator und der Einschränkung selbst. Beispiel: Unternehmen me @Session_Unternehmen_ID@. Die einzuschränkende Dimension bezieht sich immer auf die Tabelle, die im Wert-Feld angegeben wurde. Daher ist diese nur mit dem Namen anzugeben. Falls eine Dimension mehrfach in der Tabelle vorkommt (bspw. Die Kostenstellen-Dimension in der Umlagen-Tabelle), 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 <> (ab CoPlanner 11 Release 4 2023) > >= < <= 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

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.

Beispiel

FKT_SETFROMDATA('ReferenzTable.Zeit1', 'Unternehmen <> 2') -> Liefert alle eindeutigen Zeitelemente aus der ReferenzTable zum Unternehmen mit der ID 2

Anwendung der Funktion erfolgt z.B. bei Matrixmasken in der ReadOnlyElementsExpression oder AvailableElementsExpression.

Es kann auf Session-Variablen und Anwendungseigenschaften zugegriffen werden, nicht jedoch auf Elemente der Maske/des Würfels.

weitere Beispiele:

• siehe Verwendung von FKT_Set

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_ALLCHILDRENTREE Liefert alle Elemente, auf welche die Bedingung zutrifft und zusätzlich alle Child-Elemente inkl. der jeweiligen Verzweigungen.