FKT TIMESERIES
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:
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 LOWERBOUND FROMTIMESERIES
FKT TREND UPPERBOUND FROMTIMESERIES
FKT LINEARREGRESSION FROMTIMESERIES
FKT LINEARREGRESSION LOWERBOUND FROMTIMESERIES
