Log.xml: Difference between revisions

From Cumulus Wiki
Jump to navigationJump to search
2,040 bytes added ,  08:22, 1 July 2021
m
no edit summary
mNo edit summary
 
(6 intermediate revisions by the same user not shown)
Line 1: Line 1:
File holding entries created in [[Weather_Diary|'Weather Diary']] assessed from Cumulus 1 View menu.
File holding entries created in [[Weather_Diary|'Weather Diary']] assessed from Cumulus 1 View menu.


== Editing this log ===
The file name is because Steve Loft originally had a screen "Station Log" to edit this file.  As he wrote "It's (snow is) in the 'Log', which is an over-used term in Cumulus, I know. Select 'Log' from the 'View' menu.
The file can be edited within Cumulus 1 (Weather Diary on Edit menu), and can be viewed (but not edited) using a XML viewer.
It is actually documented in the Help, under 'The Displays' - 'The Station Log Window'" in the forum  "Wed 26 Nov 2008 10:08 am".  Later it was renamed to "Weather diary" to overcome the confusion, it is not recorded which version implemented that change.
 
== Content of file ==
 
The structure Steve Loft created (and I think he regretted this later) is a bit more complicated than that shown below. Each <ROWDATA/> actually has another field not shown that is set by a somewhat complicated algorithm that I eventually worked out but will not fully describe here. Putting it as simply as I can, there is an extra code field, so that when an extra record is created for the same date, the code records how many times each individual field has been changed (since it is tracking several fields, each of these has a different multiplier, so just a single number represents everything). Since any external XML editor does not understand this extra field, it cannot edit it, and without that field being correct the weather diary feature in Cumulus 1 cannot read it, and consequently will either not start or will crash out (depending on whether it is stopped or running at time of external edit).
 
Here is the incomplete structure as detected by "XML Notepad 2007":
<pre><DATAPACKET Version="2.0">
<METADATA>
<FIELDS>
<FIELD attrname="EntryDate" fieldtype="date"/>
<FIELD attrname="Entry" fieldtype="string" WIDTH="1024"/>
<FIELD attrname="SnowLying" fieldtype="boolean"/>
<FIELD attrname="SnowFalling" fieldtype="boolean"/>
<FIELD attrname="SnowDepth" fieldtype="i4"/>
</FIELDS>
<PARAMS/>
</METADATA>
<ROWDATA/>
</DATAPACKET></pre>
 
== Editing this log ==
The file can be edited within Cumulus 1 (Weather Diary on Edit menu), and can be viewed (but not edited for reason explained earlier) using any XML viewer. However, most viewers (including your browser will struggle without a template telling them the complete format (not just what is shown above).


== Using in your own scripts ==
== Using in your own scripts ==
Line 58: Line 81:




[[Category:Log Files]]
[[Category:Cumulus Files]]
[[Category:User Contributions]]
[[Category:User Contributions]]
5,838

edits

Navigation menu