FKT TIMESERIES

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.

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])