Category:Cumulus MX: Difference between revisions

2,107 bytes added ,  10:21, 26 May 2020
m
Line 685: Line 685:


== The Data Log Viewing and Editing interface ==
== The Data Log Viewing and Editing interface ==
[[File:Data Logs Options.png|right|800px]]
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'''.


The '''Data logs''' tab in the admin interface gives access to screens that can display the contents of [[Monthly log files|Detailed log files for any month]],  the [[Extra Sensor Files|Extra Sensor Log Files]], and the [[Dayfile.txt|daily summary log (dayfile.txt)]].
All screens use datatables, and the schema used is based on that defined in the version of MX you are running.


=== Data Log screen ===
<big>WARNING: In any of these editors, when you save a row that was shorter because it was created by an earlier version, datatables will store the row with the length defined in the MX version you are using, so extra commas (and any values you set) will be added to end of just any line that has been edited, leaving other lines unchanged in length.</big>


This 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, including those those for dates before when MX believes is earliest date (StartDate= xxxx, in Cumulus.ini).


Highlight any one row and the datatables software used here will offer '''Edit''' and '''Delete''' buttons that operate on that row.
=== 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 is how the file is at time of loading, more lines may be appended to the file while the screen is open, but as far as I can tell the file is not refreshed, so you can only edit those available at time of load.
 
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 screen 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''' button and hopefully you will see a ''Success'' message.
 
 
=== Extra Data Logs ===
 
As I am typing this, a new release has just been announced with a new version of this screen, so I'm not going to talk about this moving target.
 
=== Dayfile ===
 
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 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, and its use by the datatables software ''could'' cause a conflict.


== Changing Settings ==
== Changing Settings ==
5,838

edits