Category:Cumulus MX: Difference between revisions

Category:Cumulus MX (view source)

Revision as of 18:31, 9 June 2020

513 bytes added , 18:31, 9 June 2020

m

→‎Dayfile

Sfws

5,838

edits

@@ Line 964: / Line 964: @@
 === 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.
+For displaying and editing the dayfile.txt file. Like the others, highlight any one row and the ''datatables'' software used here will offer '''Edit a line''' and '''Delete a line''' 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.  Since the file being edited is provided via an api (see above) I don't believe its use by the datatables software ''could'' cause a conflict, but let us play safe.
+Since the dataTables format information is provided via an api (same process as for other log files above) you are not actually viewing the daily summary log directly; and therefore you do not need to worry about any locking conflicts.
-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.
+*Note, when you click the '''Edit a line''' button, it pops up a window that shows all the fields (in the highlighted row) vertically.
+*Having edited any fields, scroll down to the footer where there are two buttons:
+*#'''Save edit''' will send the edited line back to the MX engine where the log file is then read into an array, and the relevant array element is replaced by the line received. After that the log file is overwritten from the amended array. After that the log file as a whole is converted back to dataTables format and returned by the first api.
+*#'''Close dialog'''. You can close this dialog in 3 ways:
+*##clicking that Close dialog button
+*##Clicking the small '''x''' at the top right
+*## Clicking anywhere outside the dialog
+ 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 ==