FKT PRODUCT: Unterschied zwischen den Versionen

Aus CoPlanner 11
Zur Navigation springenZur Suche springen
T.auer (Diskussion | Beiträge)
Die Seite wurde neu angelegt: „==Funktion== <code>FKT_PRODUCT(<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|Tabellendes…“
 
Keine Bearbeitungszusammenfassung
 
(15 dazwischenliegende Versionen von 3 Benutzern werden nicht angezeigt)
Zeile 12: Zeile 12:
|-
|-
|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>Mehrungen_PLAN.Faktor</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>Mehrungen_PLAN.Faktor</code>
 
Falsch:
 
<code>[Mehrungen_PLAN.Faktor]</code>
|-
|-
|Einschränkung 1 bis n
|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@.
|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.


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@
Beispiel: <code>Unternehmen_1 me @Session_Unternehmen_ID@</code>


Der Operator ist mit 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
:*<> (''ab CoPlanner 11 Release 4 2023)''
:*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 <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.  
|}
|}


Zeile 47: Zeile 94:
Als Beispiel kann die Formel „Umsatzerloese_GuV_IST“ herangezogen werden:
Als Beispiel kann die Formel „Umsatzerloese_GuV_IST“ herangezogen werden:


'''Hinweis'''
* Das Handling von leeren Zeilen und Zeilen mit NULL/0 unterscheidet sich fundamental von FKT_SUM:
** Aufgrund der Tatsache, dass NULL/0 das [https://de.wikipedia.org/wiki/Neutrales_Element neutrale Element/Einheitselement] in einer Addition ist, hat das Vorhandensein von leeren/Nullzeilen keine Auswirkung auf das Ergebnis
** Bei der Multiplikation wird dadurch jedoch das Ergebnis 0 (da 1 das Einheitselement der Multiplikation ist und nicht 0).
* Im Gegensatz zur Addition spielt es bei der Multiplikation eine Rolle, wie Werte auf Zeilen verteilt sind:
** Hat man bei FKT_SUM einmal 2 Zeilen mit 1 und einmal 1 Zeile mit 2, so ist das Ergebnis in beiden Fällen 2.
** Bei der Multiplikation erhält man jedoch einmal 1 und einmal 2 als Ergebnis
* Zeilen mit dem Wert "NULL" werden gleich wie Zeilen mit dem Wert 0 behandelt.
* Workaround, um leere Zeilen zu ignorieren:
** Anlegen einer neuen Spalte, die man mit Hilfe von IsNull mit 1 befüllt, wenn der Wert NULL ist und ansonsten mit dem Wert, Berechnung von FKT_Product auf der Hilfsspalte


'''Beispiele für Formel mit typed calculations:'''
'''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>
<code>FKT_PRODUCT("Mehrungen_PLAN.Faktor",<br>"Zeit me " + [Planung.Zeit_1.COPSYS_ID], <br>  "Produkt = " + [Planung.Produkt_1.COPSYS_ID])</code>
 
 
 
 


__NOEDITSECTION__  
__NOEDITSECTION__  


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

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

Funktion

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

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:

Mehrungen_PLAN.Faktor 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:

Mehrungen_PLAN.Faktor

Falsch:

[Mehrungen_PLAN.Faktor]

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 auch typed calculations aktiviert haben oder in Berechnungen in Power Cubes.

Als Beispiel kann die Formel „Umsatzerloese_GuV_IST“ herangezogen werden:

Hinweis

  • Das Handling von leeren Zeilen und Zeilen mit NULL/0 unterscheidet sich fundamental von FKT_SUM:
    • Aufgrund der Tatsache, dass NULL/0 das neutrale Element/Einheitselement in einer Addition ist, hat das Vorhandensein von leeren/Nullzeilen keine Auswirkung auf das Ergebnis
    • Bei der Multiplikation wird dadurch jedoch das Ergebnis 0 (da 1 das Einheitselement der Multiplikation ist und nicht 0).
  • Im Gegensatz zur Addition spielt es bei der Multiplikation eine Rolle, wie Werte auf Zeilen verteilt sind:
    • Hat man bei FKT_SUM einmal 2 Zeilen mit 1 und einmal 1 Zeile mit 2, so ist das Ergebnis in beiden Fällen 2.
    • Bei der Multiplikation erhält man jedoch einmal 1 und einmal 2 als Ergebnis
  • Zeilen mit dem Wert "NULL" werden gleich wie Zeilen mit dem Wert 0 behandelt.
  • Workaround, um leere Zeilen zu ignorieren:
    • Anlegen einer neuen Spalte, die man mit Hilfe von IsNull mit 1 befüllt, wenn der Wert NULL ist und ansonsten mit dem Wert, Berechnung von FKT_Product auf der Hilfsspalte

Beispiele für Formel mit typed calculations:

FKT_PRODUCT("Mehrungen_PLAN.Faktor",
"Zeit me " + [Planung.Zeit_1.COPSYS_ID],
"Produkt = " + [Planung.Produkt_1.COPSYS_ID])