FKT PLAN MIN: Unterschied zwischen den Versionen

Aus CoPlanner 11
Zur Navigation springenZur Suche springen
Die Seite wurde neu angelegt: „==Funktion== <span {{CoPFormel}}>FKT_PLAN_MIN(<Wert-Feld>,<Einschränkung 1 bis n>)</span> {| class="wikitable" width={{{breite|100%}}} |- | width="150pt" |…“
 
Keine Bearbeitungszusammenfassung
 
(9 dazwischenliegende Versionen von 2 Benutzern werden nicht angezeigt)
Zeile 1: Zeile 1:
==Funktion==
==Funktion==


<span {{CoPFormel}}>FKT_PLAN_MIN(<Wert-Feld>,<Einschränkung 1 bis n>)</span>
<code>FKT_PLAN_MIN(<Wert-Feld>,<Einschränkung 1 bis n>)</code>


{| class="wikitable" width={{{breite|100%}}}
{| class="wikitable" width={{{breite|100%}}}
|-  
|-  
| width="150pt" |Parameter
! width="150pt" |Parameter
| Beschreibung
! Beschreibung
|-
|-
|Wert-Feld
|Wert-Feld
|Hier ist der Datenpfad zum Feld anzugeben, dessen Minimalwert ermittelt werden soll. 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 Minimalwert ermittelt werden soll.  
Soll beispielsweise das Feld Umsatz aus der Tabelle Umsatzerloese_PLAN verwendet werden, ist folgender Datenpfad anzugeben:


Umsatzerloese_PLAN.Umsatz
<code>Umsatzerloese_PLAN.Umsatz</code>


Hier kann jede Tabelle, nicht nur die Quell- oder Zieltabelle wie bei den anderen Funktionen, verwendet werden.
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 sind nicht in eckigen Klammern zu schreiben. (Falsch: [Umsatzerloese_PLAN.Umsatz])
Tabellen- und Spaltennamen werden ohne eckige Klammern angegeben.
 
Richtig:
 
<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 nicht 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.


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@
* 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.


Der Operator ist mit einem ! und einem Vergleichstyp anzugeben, wobei folgende erlaubt sind:
Eine Filtereinschränkung besteht immer aus drei Bestandteilen:


:*!me+under
# der einzuschränkenden Spalte,
:*!me
# 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 (''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.  
|}
|}


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


Die Funktion kann nur in Formeln verwendet werden, welche vorzugsweise auch typed calculations aktiviert haben.
Der Ausdruck ist [[Framework:Formeln:WarumTyped|typed]] zu schreiben. Die Funktion kann nur in Formeln verwendet werden, welche typed calculations aktiviert haben und im CoPlanner Power Cube in berechneten Measures.
 


''<small>(Ab CoPlanner 11 Release 4 2023):</small>'' Die Funktion kann auch mit Dimensionen und Datumsfeldern verwendet werden.


== Ergebnis ==
== Ergebnis ==
Zeile 48: Zeile 96:
==Beispiele==
==Beispiele==


<span {{CoPFormel}}>FKT_PLAN_MIN("Umsatzerloese_PLAN.Umsatz")</span>
<code>FKT_PLAN_MIN("Umsatzerloese_PLAN.Umsatz")</code>


Liefert den kleinsten Umsatz der Umsatzerloese_PLAN Tabelle vom Plan an dem man gerade angemeldet ist.
Liefert den kleinsten Umsatz der Umsatzerloese_PLAN Tabelle vom Plan an dem man gerade angemeldet ist.

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

Funktion

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

Parameter Beschreibung
Wert-Feld Hier ist der Datenpfad zu dem Feld anzugeben, dessen Minimalwert ermittelt werden soll.

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.

(Ab CoPlanner 11 Release 4 2023): Die Funktion kann auch mit Dimensionen und Datumsfeldern verwendet werden.

Ergebnis

Liefert den minimalen Wert des Feldes der Tabelle vom aktuellen Sessionplan.

Beispiele

FKT_PLAN_MIN("Umsatzerloese_PLAN.Umsatz")

Liefert den kleinsten Umsatz der Umsatzerloese_PLAN Tabelle vom Plan an dem man gerade angemeldet ist.