Webtag Applicability (preserving history)

Full information about Web tags can be seen on the linked page. The list of web tags there attempts to identify which web tags can be used whatever release of Cumulus you are running.

The following text used to be on that page, but to simplify that page has now been moved here.

A note of caution

Given how often a new release alters either what web tags are available or what parameters can be used with particular web tags, it is possible the tables on the linked page do not list all web tags at any version, and the tables can't say which modifiers are available at your version.

Cumulus MX

This badge is used to highlight text that applies to Cumulus 3 (MX) for any release with version numbers 3.0.0 to 3.9.7 ONLY.

• In many cases, it highlights web tags that are not available in Cumulus 1
• Use of this badge does not mean that all builds of MX are able to use this web tag
  • Web tags can only be used with template files (Steve Loft names these files in format "xxxxxxT.htm") and none are provided in MX release 3.10.1 or later.
  • Some attempt has been made to indicate either which MX build introduced individual tags, or from which build the web tag started giving the correct response (where earlier builds reported incorrect values for that web tag in some cases).
• You can, even with latest MX release, create a template file using web tags, as mentioned elsewhere on this page, and fully described on the Customised templates page.
• MX will raise an error:
  • for any web tag it does not recognise at the version you are running
  • for any input parameter that the token parser is unable to recognise
• MX treats output parameters differently:
  • any output parameter that it does not recognise at all, is ignored
  • any output parameter in a web tag that does not accept output parameters is also ignored
  • any output parameter in a web tag that does accept output parameters, where the supplied parameter is inconsistent with the content of the web tag, is reported as an error by the token parser
  • an output parameter that specifies only part of the standard output may be reported as an error because of single character rules (for example a tag that reports a time cannot understand format=H, amongst the acceptable formats are format=%H for just hour and format=H:mm for hour and minutes but not seconds.
  • any output parameter that contains incorrectly formatted characters in that output parameter will be treated as an error by the token parser (a common mistake is forgetting spaces are expected to be included with other literal characters by the MX token parser)
  • if you use valid parameters but the wrong parameters, you are likely to be confused by the output (the most common cases result in seeing minutes where a month is wanted, or there is a misunderstanding of the concept where the same character has different meanings when on its own and when with other characters).

Cumulus MX provides many, but not all web tags that were available in Cumulus 1.

MX adds many more web tags, mostly in support of new weather stations or new sensors.

When MX is processing web tags and finds one it cannot understand, a "*** web tag error - see MXdiags file ***" message will appear in the engine console, and the diagnostic file will include something like this, be aware a "token" parser is used to evaluate web tags:

Web tag error
Exception: i=8998 len=106297
inputText.Length=106297
token=<#daylightlength format=H>

This particular error is that when you use a single output format character it does not have same meaning as when there are multiple characters, correct this particular web tag to:

<#daylightlength format=%H>

Please note that where this article makes reference to other pages in the Wiki, the information shown there might be specific to Cumulus 1, as there are differences between the user interface for Cumulus 1 and MX flavours of this software, and the Wiki was originally written before MX existed, so not all pages have been updated.

Cumulus 2

Cumulus 2 is no longer available, it never did any web page generation, so even if you happen to have installed Cumulus 2 from when it was available, there are no web tags it supports.

Original (legacy) Cumulus software

This badge is used to highlight text that applies to Cumulus 1.

• Use of this badge does NOT mean that all builds of Cumulus 1 are able to use the web tag.
• There are gaps in the Cumulus 1 documentation, and so it is not usual for the table entry to indicate when a particular web tags started to be available
• If you are using the final version of Cumulus 1, then the text highlighted by that badge does apply to you.
• In general, Cumulus 1 will silently ignore any web tag it does not recognise. This means that you might see the raw

web tag remaining after processing, or you might see nothing where the web tag was prior to processing. It also means that if you try to do a numeric calculation on a web tag that Cumulus 1 does not recognise, the calculation will fail, but you might not see an error message.

When Cumulus 1 is processing web tags, it tends to ignore any it cannot understand, so look for gaps in your web pages to find errors.