FKT AGG: Unterschied zwischen den Versionen

Aus CoPlanner 11
Zur Navigation springenZur Suche springen
Anpassungen für Rel 1 2026
Keine Bearbeitungszusammenfassung
 
Zeile 14: Zeile 14:
|-
|-
|Wert-Feld
|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:  
|Hier ist der Datenpfad zu dem Feld anzugeben, dessen Wert ermittelt werden soll. Verwendet werden können alle numerischen Felder sowie berechnete Felder einer Tabelle, für die im Tabellendesigner eine Aggregation (SUM oder AVG) definiert wurde.
Soll beispielsweise das Feld Umsatz aus der Tabelle Umsatzerloese_PLAN verwendet werden, ist folgender Datenpfad anzugeben:


Umsatzerloese_PLAN.Umsatz
<code>Umsatzerloese_PLAN.Umsatz</code>
Im Gegensatz zu den meisten anderen Funktionen kann hier auf jede beliebige Tabelle zugegriffen werden. Die Angabe ist daher nicht auf die Quell- oder Zieltabelle beschränkt.
Tabellen- und Spaltennamen werden ohne eckige Klammern angegeben.


Hier kann jede Tabelle, nicht nur die Quell- oder Zieltabelle wie bei den anderen Funktionen, verwendet werden.
Richtig:
Tabellen und Spaltennamen sind nicht in eckigen Klammern zu schreiben. (Falsch: [Umsatzerloese_PLAN.Umsatz])
 
<code>Umsatzerloese_PLAN.Umsatz</code>
 
Falsch:
 
<code>[Umsatzerloese_PLAN.Umsatz]</code>
|-
|-
|Einschränkung 1 bis n
|Einschränkung 1 bis n
|Dies sind Filtereinschränkungen auf LookUp-Dimensionen, Filter auf LookUp-Tabellen sind ab CoPlanner 11 Release 4 2023 verfügbar. Jede Einschränkung besteht aus 3 Teilen, der einzuschränkenden Dimension, einem Operator und der Einschränkung selbst. Beispiel: Unternehmen me @Session_Unternehmen_ID@.
|Filtereinschränkungen dienen dazu, die Daten der Tabelle/Dimension einzuschränken.
 
* Filter auf LookUp-Dimensionen werden grundsätzlich unterstützt.
* Filter auf LookUp-Tabellen werden ab CoPlanner 11 Release 4 2023 unterstützt.
* Filter auf Measures werden ab CoPlanner 11 Release 2 2026 unterstützt.
 
Eine Filtereinschränkung besteht immer aus drei Bestandteilen:
 
# der einzuschränkenden Spalte,
# einem Vergleichsoperator und
# dem Vergleichswert.
 
Beispiel: <code>Unternehmen_1 me @Session_Unternehmen_ID@</code>


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 einem Vergleichstyp anzugeben, wobei folgende erlaubt sind:
'''Einzuschränkende Spalte'''


Die angegebene Spalte bezieht sich immer auf die Tabelle oder Dimension, die im Wert-Feld ausgewählt wurde. Deshalb genügt in der Regel die Angabe des Spaltennamens.
Existiert eine Spalte mehrfach innerhalb der Tabelle (z. B. die Dimension Kostenstelle in einer Umlagentabelle), kann die gewünschte Spalte über den Alias oder den LookUp-Appendix angegeben werden.
Wird weder ein Alias noch ein Appendix verwendet, wird standardmäßig die erste LookUp-Dimension (<code>_1</code>) verwendet.
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')
'''Vergleichsoperatoren'''
Je nach Datentyp stehen unterschiedliche Operatoren zur Verfügung.
* Dimensionen:
:*me+under
:*me+under
:*me
:*me
:*under ''(ab CoPlanner 11 Release 1 2026)''
:*under (''ab CoPlanner 11 Release 1 2026)''
:*first_under ''(ab CoPlanner 11 Release 1 2026)''
:*first_under (''ab CoPlanner 11 Release 1 2026)''
:*me_first_under ''(ab CoPlanner 11 Release 1 2026)''
:*me_first_under (''ab CoPlanner 11 Release 1 2026)''
:*<>
:*<>
:* >  
:* >  
Zeile 38: Zeile 69:
:* <  
:* <  
:* <=  
:* <=  
Hinweis: Der Operator <code>=</code> wird bei Dimensionen immer als <code>me</code> interpretiert. Er ist ausschließlich aus Kompatibilitätsgründen weiterhin verfügbar.
* Zahlen- und Datumsfelder:
** =
** <>
** >
** >=
** <
** <=
* Text, Formatted Text und Link:
** =
** <>
** like
* Boolean:
** =
** <>
'''Vergleichswert'''


 
Als Vergleichswert kann jeder Datenpfad, jede Variable oder jede Funktion verwendet werden, die eine gültige COPSYS_ID liefert.
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.  
 
''Ab 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_AGG('[Dimension.Feld]','COPSYS_ID > 2')
|}
|}



Aktuelle Version vom 23. Juli 2026, 16:54 Uhr

Funktion

FKT_AGG(<Wert-Feld>,<Einschränkung 1 bis n>)


Funktioniert wie FKT_SUM, allerdings wird der Aggregationstyp berücksichtigt.


Parameter Beschreibung
Wert-Feld Hier ist der Datenpfad zu dem Feld anzugeben, dessen Wert ermittelt werden soll. Verwendet werden können alle numerischen Felder sowie berechnete Felder einer Tabelle, für die im Tabellendesigner eine Aggregation (SUM oder AVG) definiert wurde.

Soll beispielsweise das Feld Umsatz aus der Tabelle Umsatzerloese_PLAN verwendet werden, ist folgender Datenpfad anzugeben:

Umsatzerloese_PLAN.Umsatz Im Gegensatz zu den meisten anderen Funktionen kann hier auf jede beliebige Tabelle zugegriffen werden. Die Angabe ist daher nicht auf die Quell- oder Zieltabelle beschränkt. Tabellen- und Spaltennamen werden ohne eckige Klammern angegeben.

Richtig:

Umsatzerloese_PLAN.Umsatz

Falsch:

[Umsatzerloese_PLAN.Umsatz]

Einschränkung 1 bis n Filtereinschränkungen dienen dazu, die Daten der Tabelle/Dimension einzuschränken.
  • Filter auf LookUp-Dimensionen werden grundsätzlich unterstützt.
  • Filter auf LookUp-Tabellen werden ab CoPlanner 11 Release 4 2023 unterstützt.
  • Filter auf Measures werden ab CoPlanner 11 Release 2 2026 unterstützt.

Eine Filtereinschränkung besteht immer aus drei Bestandteilen:

  1. der einzuschränkenden Spalte,
  2. einem Vergleichsoperator und
  3. dem Vergleichswert.

Beispiel: Unternehmen_1 me @Session_Unternehmen_ID@


Einzuschränkende Spalte

Die angegebene Spalte bezieht sich immer auf die Tabelle oder Dimension, die im Wert-Feld ausgewählt wurde. Deshalb genügt in der Regel die Angabe des Spaltennamens.

Existiert eine Spalte mehrfach innerhalb der Tabelle (z. B. die Dimension Kostenstelle in einer Umlagentabelle), kann die gewünschte Spalte über den Alias oder den LookUp-Appendix angegeben werden.

Wird weder ein Alias noch ein Appendix verwendet, wird standardmäßig die erste LookUp-Dimension (_1) verwendet.

Ab 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')

Vergleichsoperatoren

Je nach Datentyp stehen unterschiedliche Operatoren zur Verfügung.

  • Dimensionen:
  • 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)
  • <>
  • >
  • >=
  • <
  • <=

Hinweis: Der Operator = wird bei Dimensionen immer als me interpretiert. Er ist ausschließlich aus Kompatibilitätsgründen weiterhin verfügbar.

  • Zahlen- und Datumsfelder:
    • =
    • <>
    • >
    • >=
    • <
    • <=
  • Text, Formatted Text und Link:
    • =
    • <>
    • like
  • Boolean:
    • =
    • <>

Vergleichswert

Als Vergleichswert kann jeder Datenpfad, jede Variable oder jede Funktion verwendet werden, die eine gültige COPSYS_ID liefert.


Diese Funktion gehört zu den serverseitigen Funktionen.

Der Ausdruck ist typed zu schreiben. Die Funktion kann nur in Formeln verwendet werden, welche typed calculations aktiviert haben und im CoPlanner Power Cube in berechneten Measures.

Als Beispiel kann die Formel „Umsatzerloese_GuV_IST“ herangezogen werden:


Beispiele für Formel mit typed calculations:

fkt_AGG("Umsatzerloese_IST.Umsatz","Zeit me " + [Umsatzerloese_IST.Zeit_1.COPSYS_ID] ,
"Umsatzerloesarten.GuV-Gesamtkostenverfahren-Struktur = " + [Umsatzerloese_IST.Umsatzerloesarten_1.COPSYS_ID],
"Unternehmen me " + [Umsatzerloese_IST.Unternehmen_1.COPSYS_ID],
"PC/KST me " + [Umsatzerloese_IST.PC/KST_1.COPSYS_ID])