FKT TIMESERIES: Unterschied zwischen den Versionen

Aus CoPlanner 11
Zur Navigation springenZur Suche springen
← Zum vorherigen Versionsunterschied
VisuellWikitext
Keine Bearbeitungszusammenfassung
Markierung: Manuelle Zurücksetzung
Verfügbar ab
 
(29 dazwischenliegende Versionen von 2 Benutzern werden nicht angezeigt)
Zeile 1: Zeile 1:
''Verfügbar ab CoPlanner 11 Release 2 2025''
==[[Framework:Formeln#Funktionen|Funktion]]==
==[[Framework:Formeln#Funktionen|Funktion]]==


<code>FKT_TIMESERIES(<Wert-Feld>, <Einschränkung 1 bis n></code>
<code>FKT_TIMESERIES(<Wert-Feld>, <Name der Zeitdimension>*, <timeDimTyp>*, <actualsFrom>*, <actualsTo>*, <interpretMissingAsZero>*, <Einschränkung 1 bis n>)</code>
 
Diese Funktion ermöglicht das Lesen einer einfachen Time Series (Datenbasis), die für eine Predicition verwendet wird. Die Datenbasis kann intern durch die Vorhersage Funktionen (zB FKT_TREND) ermittelt werden oder explizit abgefragt werden und an eine Vorhersage Funktion übergeben werden. 


{| class="wikitable" width={{{breite|80%}}}
{| class="wikitable" width={{{breite|80%}}}
Zeile 12: Zeile 16:
|fullFieldName
|fullFieldName
|Wertfeld
|Wertfeld
|Y (Jahr), D (Tag), M (Monat), Q (Quartal)
|Tabelle und Spaltenname, darf nur vom Datentyp "double" sein
|-
|filterParams
|Einschränkungen 1 bis n
|z.B.. +1, -10
|-
|-
|timeColumnName*
|timeColumnName*
|Name der Zeitdimension
|Name der Zeitdimension
|COPSYS_ID der Zeitdimension
|Optional: Name der Zeitdimension in der Tabelle
|-
|-
|timeTyp*
|timeTyp*
|timeDimTyp
|timeDimTyp
|Optional das Format der Ausgabe. Alle gängigen Zeitformate werden unterstützt. Wird kein Zeitformat angegeben wird die ID lt. CoPlanner Konvention retourniert
|Optional: Typ für die Ermittlung der Zeitwerte, "M" oder "Y" (für Monat oder Jahr)
|-
|-
|actualsFrom*
|actualsFrom*
|actualsFrom
|actualsFrom
|
|Optional: Start des Zeitraumes, aus dem Werte gelesen werden sollen
|-
|-
|actualsTo*
|actualsTo*
|actualsTo
|actualsTo
|
|Optional: Ende des Zeitraumes, aus dem Werte gelesen werden sollen
|-
|-
|interpretMissingAsZero*
|interpretMissingAsZero*
|interpretMissingAsZero
|interpretMissingAsZero
|
|gibt an ob fehlende Werte zwischen actualsFrom und actualsTo mit "0" aufgefüllt werden sollen
|-
|filterParams
|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
:*<> (''ab CoPlanner 11 Release 4 2023)''
:*>
:*>=
:*<
:*<=
 
 
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.
|}
|}


<small>*Optionaler Überladungsparameter. Wenn klar ist um welche Dimension es sich handeln muss, muss diese nicht angegeben werden.</small> 
TimeSeries beinhalten einen Zeitwert (als COPSYS_ID der jeweiligen Zeit) und zB einem Wert. Jeder Zeitwert kommt dabei nur einmal vor.
{| class="wikitable" width="{{{breite|80%}}}"
|-
! width="150pt" |Zeit
!Wert
|-
|2025010103
|12,7
|-
|2025020103
|37,5
|}
Verwendet man die Funktion FKT_TIMESERIES ohne optionale Parameter, gelten folgende Einstellungen:
* Level  für die Vorhersage: "Monate"
* als Zeitdimension wird die Plan Zeitdimension der Tabelle verwendet, ansonsten die erste Zeitdimension, die in der Tabelle gefunden wird
* Leere Werte werden NICHT aufgefüllt
{{Hinweis|Text=TimeSeries können nur für Vorhersage Funktionen verwendet werden.}}




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


==Ergebnis==


==Beispiele==
<code>FKT_TIMESERIES('[TBL_7982.Wert]',  'DIM_7982 me ' + [TBL_7982.DIM_7982])</code>
<code>FKT_TIMESERIES('[TBL_7982.Wert]','Zeit', 'M',2018010103, 2019120103,false, 'DIM_7982 me ' + [TBL_7982.DIM_7982])</code>
==[[Framework:Formeln#Funktionen|Weitere Funktionen]]==
Für eine genauere Steuerung von berechneten Vorhersagen und/oder wenn man Daten aus mehreren Tabellen kombinieren möchte, kann man, alternativ zu direkten Berechnungen von Vorhersagen, folgende Funktionen verwenden:
[[FKT TREND FROMTIMESERIES]]
[[FKT TREND LOWERBOUND FROMTIMESERIES]]
[[FKT TREND UPPERBOUND FROMTIMESERIES]]
[[FKT LINEARREGRESSION FROMTIMESERIES]]
[[FKT LINEARREGRESSION LOWERBOUND FROMTIMESERIES]]
[[FKT LINEARREGRESSION UPPERBOUND FROMTIMESERIES]]


'''''Beispiel '''''
[[FKT MERGE TIMESERIES]]


==Beispiele==


__NOEDITSECTION__  
__NOEDITSECTION__  

Aktuelle Version vom 3. Juli 2025, 16:21 Uhr

Verfügbar ab CoPlanner 11 Release 2 2025

Funktion

FKT_TIMESERIES(<Wert-Feld>, <Name der Zeitdimension>*, <timeDimTyp>*, <actualsFrom>*, <actualsTo>*, <interpretMissingAsZero>*, <Einschränkung 1 bis n>)

Diese Funktion ermöglicht das Lesen einer einfachen Time Series (Datenbasis), die für eine Predicition verwendet wird. Die Datenbasis kann intern durch die Vorhersage Funktionen (zB FKT_TREND) ermittelt werden oder explizit abgefragt werden und an eine Vorhersage Funktion übergeben werden.

Parameter Kurzbeschreibung

Parameter

Beschreibung
fullFieldName Wertfeld Tabelle und Spaltenname, darf nur vom Datentyp "double" sein
timeColumnName* Name der Zeitdimension Optional: Name der Zeitdimension in der Tabelle
timeTyp* timeDimTyp Optional: Typ für die Ermittlung der Zeitwerte, "M" oder "Y" (für Monat oder Jahr)
actualsFrom* actualsFrom Optional: Start des Zeitraumes, aus dem Werte gelesen werden sollen
actualsTo* actualsTo Optional: Ende des Zeitraumes, aus dem Werte gelesen werden sollen
interpretMissingAsZero* interpretMissingAsZero gibt an ob fehlende Werte zwischen actualsFrom und actualsTo mit "0" aufgefüllt werden sollen
filterParams 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
  • <> (ab CoPlanner 11 Release 4 2023)
  • >
  • >=
  • <
  • <=


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.


*Optionaler Überladungsparameter. Wenn klar ist um welche Dimension es sich handeln muss, muss diese nicht angegeben werden.


TimeSeries beinhalten einen Zeitwert (als COPSYS_ID der jeweiligen Zeit) und zB einem Wert. Jeder Zeitwert kommt dabei nur einmal vor.

Zeit Wert
2025010103 12,7
2025020103 37,5

Verwendet man die Funktion FKT_TIMESERIES ohne optionale Parameter, gelten folgende Einstellungen:

  • Level für die Vorhersage: "Monate"
  • als Zeitdimension wird die Plan Zeitdimension der Tabelle verwendet, ansonsten die erste Zeitdimension, die in der Tabelle gefunden wird
  • Leere Werte werden NICHT aufgefüllt


Hinweis  TimeSeries können nur für Vorhersage Funktionen verwendet werden.


Diese Funktion gehört zu den serverseitigen Funktionen.


Beispiele

FKT_TIMESERIES('[TBL_7982.Wert]',  'DIM_7982 me ' + [TBL_7982.DIM_7982])

FKT_TIMESERIES('[TBL_7982.Wert]','Zeit', 'M',2018010103, 2019120103,false, 'DIM_7982 me ' + [TBL_7982.DIM_7982])


Weitere Funktionen

Für eine genauere Steuerung von berechneten Vorhersagen und/oder wenn man Daten aus mehreren Tabellen kombinieren möchte, kann man, alternativ zu direkten Berechnungen von Vorhersagen, folgende Funktionen verwenden:

FKT TREND FROMTIMESERIES

FKT TREND LOWERBOUND FROMTIMESERIES

FKT TREND UPPERBOUND FROMTIMESERIES

FKT LINEARREGRESSION FROMTIMESERIES

FKT LINEARREGRESSION LOWERBOUND FROMTIMESERIES

FKT LINEARREGRESSION UPPERBOUND FROMTIMESERIES

FKT MERGE TIMESERIES

Abgerufen von „https://copsupport.coplanner.com/help11/index.php?title=FKT_TIMESERIES&oldid=22620“