Quelltext der Seite FKT SUM

==Funktion==

<code>FKT_SUM(<Wert-Feld>,<Einschränkung 1 bis n>)</code>

{| class="wikitable" width={{{breite|100%}}}
|- 
! width="150pt" |Parameter
! Beschreibung
|-
|Wert-Feld
|Hier ist der Datenpfad zum Feld anzugeben, dessen Wert ermittelt werden soll. Dies können alle Felder und berechneten Felder einer Tabelle sein, die eine Zahl sind und für ein Aggregat (SUM oder AVG) definiert ist (siehe [[Framework:Tabellen#Tabellendesigner|Tabellendesigner]]). Bspw. Möchte man das Feld Umsatz aus der Tabelle Umsatzerloese_PLAN ermitteln, so ist anzugeben: 

Umsatzerloese_PLAN.Umsatz

Hier kann jede Tabelle, nicht nur die Quell- oder Zieltabelle wie bei den anderen Funktionen, verwendet werden.
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
:*under (''ab CoPlanner 11 Release 1 2026)''
:*first_under (''ab CoPlanner 11 Release 1 2026)''
:*me_first_under (''ab CoPlanner 11 Release 1 2026)''
:*<>
:* > 
:* >= 
:* < 
:* <= 


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. 

A''b CoPlanner 11 Release 1 2026:'' Wendet man die Funktion auf eine Dimension an, kann man nun auch direkt auf die COPSYS_ID zugreifen. z.B. FKT_SUM('[Dimension.Feld]','COPSYS_ID > 2') 
|}


Diese Funktion gehört zu den [[:Kategorie:Funktionen_-_serverseitig|serverseitigen Funktionen]].

Der Ausdruck ist [[Framework:Formeln:WarumTyped|typed]] zu schreiben. Die Funktion kann nur in Formeln verwendet werden, welche auch typed calculations aktiviert haben oder in Berechnungen in Power Cubes.

Als Beispiel kann die Formel „Umsatzerloese_GuV_IST“ herangezogen werden:


'''Beispiele für Formel mit typed calculations:'''

<code>fkt_SUM("Umsatzerloese_IST.Umsatz","Zeit me " + [Umsatzerloese_IST.Zeit_1.COPSYS_ID], <br>   "Umsatzerloesarten = " + [Umsatzerloese_IST.Umsatzerloesarten_1.COPSYS_ID], <br>"Unternehmen me " + [Umsatzerloese_IST.Unternehmen_1.COPSYS_ID], <br>"PC/KST me " + [Umsatzerloese_IST.PC/KST_1.COPSYS_ID])</code>

__NOEDITSECTION__ 

[[Category:Funktionen|SUM]]
[[Category:Funktionen - serverseitig|SUM]]
[[en:Framework:FKT SUM]]