An exceptional commandline parameter is UserAskedData. The purpose of this commandline parameter is to activate the data generator for data which are not supplied by CMX. CMX itself has many options to supply the data in JSON format for the charts available in CMX, but CumulusUtils provides possibilities for more charts and therefore may need other or more data. Those data are generated and uploaded by the command:
Note that CMX uploads its JSON's to its configured FTP directory. CumulusUtils uploads all its files to what it understands as being the webroot. Those two can be the same or they can deviate. In the last case CumulusUtils has to find the datafiles of CMX by setting the parameter CumulusRealTimeLocation.
CumulusUtils adheres to the JSON format as adopted by CumulusMX. It also takes the FTP frequency as configured in the Interval Settings of CumulusMX (Normal Interval Setting)
The following three modules depend on UserAskedData: ChartsCompiler, AirLink and ExtraSensors. If any of these modules are used, CumulusUtils needs to be executed in the scheduler with the parameter UserAskedData on the FTP frequency as set in CMX (Normal Interval Setting).
The data is read between a Start date and an End date. The start date is defined by the now minus the number of hours on a chart as defined in CMX. The End date is determined by the moment the UserAskedData procedure starts and is the last period End moment (so if started today at 13h04 with a 5 minute period, the end time is today at 13h00).