5,838
edits
Category:Cumulus MX: Difference between revisions
m
→The Data Log Viewing and Editing interface
|
The '''Data logs''' tab in the admin interface a shown right gives access to screens that can display the contents of [[Monthly log files|Detailed log files for any month]] with menu item '''Data logs''' (yes same name as tab), the [[Extra Sensor Files|Extra Sensor Log Files]] with menu item '''Extra Data Logs''', and the [[Dayfile.txt|daily summary log (dayfile.txt)]] with menu item '''Dayfile'''.
All screens use the datatables library to access the application programme interface (api) representing the selected log file, and the schema used is based on that defined in the version of MX you are running.
Version 3.6.1 changes the wording on the pop up dialogs showing a single row; Earlier versions used "Close", "Edit" buttons. Later versions use the more meaningful "Cancel" and "Save" buttons respectively. The new terminology takes precedence in the following sub-sections.
=== Data logs ===
This screen can be used to display any monthly log file in the '''CumulusMX/data''' folder. None are displayed until you select date (defaults to current month) and click '''Load'''. The selector will find any file in the folder, including those those for dates before when MX believes is earliest date (StartDate= xxxx, in Cumulus.ini). The only proviso is that the file naming must obey that currently defined in the current locale supplied to MONO (or defined in Control Panel for Windows operating system). Obviously, if you choose to load the default (the current) log file, what you see loaded from the api mentioned above is how the file
Highlight any one row and the ''datatables'' software used here will offer '''Edit''' and '''Delete''' buttons that operate on that row. The Edit button pops up a dialog showing all fields available in the version of MX you are using. If the log file has fewer fields because it was created by an earlier version of Cumulus, the excess fields will not show any value. Make any edits, click the '''Save'''(prior to MX version 3.6.1, it was "Edit") button and hopefully you will see a ''Success'' message.
For displaying and editing the dayfile.txt file. Like the others, highlight any one row and the ''datatables'' software used here will offer '''Edit''' and '''Delete''' buttons that operate on that row.
Please don't start to use this option either when MX has only just started, or within 10 minutes either side of your rollover time, because in both cases MX needs exclusive access to the file
Note, when you click the Edit (table) button, it pops up a window that shows all the fields (in the highlighted row) vertically with cancel (previously "close") and save (previously "edit" or "edit row") buttons visible when you scroll down. It does not show any values from any other files. MX does not provide within this screen any way to read the monthly data logs for a particular day and recalculate the value to place in any field of this dayfile log. In the future it is possible that there might be a separate executable, outside the admin interface that could do this (similar to separate executable mentioned for MySQL functionality, later on this page), but at the time of writing that is no more than a possible very low priority project with the developer.
== Changing Settings ==
| |||