FKT PRODUCT: Unterschied zwischen den Versionen
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 | |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: | |||
<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. | |||
Richtig: | |||
<code>Mehrungen_PLAN.Faktor</code> | |||
Falsch: | |||
<code>[Mehrungen_PLAN.Faktor]</code> | |||
|- | |- | ||
|Einschränkung 1 bis n | |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: | |||
# der einzuschränkenden Spalte, | |||
# einem Vergleichsoperator und | |||
# dem Vergleichswert. | |||
Beispiel: <code>Unternehmen_1 me @Session_Unternehmen_ID@</code> | |||
'''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)'' | ||
:*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. | |||
|} | |} | ||
| 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> | <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| | [[Category:Funktionen|PRODUCT]] | ||
[[Category:Funktionen - serverseitig| | [[Category:Funktionen - serverseitig|PRODUCT]] | ||
[[en:Framework: | [[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:
Richtig:
Falsch:
|
| Einschränkung 1 bis n | Filtereinschränkungen dienen dazu, die Daten der Tabelle/Dimension einzuschränken.
Eine Filtereinschränkung besteht immer aus drei Bestandteilen:
Beispiel:
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 ( 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.
Hinweis: Der Operator
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])