About advisories and alarms
If the Alarm Enable property of the AdvisoryContainer is true (default setting), each advisory results in an alarm routed to the specified AlarmClass, containing weather provider data.
See the following sections.
Current Weather view (Px) effects
During an alarm condition for a WeatherReport (locale), the iconic Px widget for its CurrentConditions (Current Weather view) reflects the weather advisory, including changed text color.
Figure 18. Example Current Weather view during weather advisory
The default alarm text color is red, configurable in the Px editor (property AlarmStateBrush).
When the alarm condition clears (all provider-issued watches, warnings, and advisories have been canceled or expired), the Current Weather view returns to its normal state.
Figure 19. Example Current Weather view returned to normal
In this case, there are no Advisory components under the AdvisoryContainer of the CurrentConditions component.
Weather provider data in Advisory and alarm
A weather advisory results in an Advisory component created under the AdvisoryContainer. Typical access is from the Advisory Manger view of the AdvisoryContainer, where a double-click provides a popup dialog as given below.
Figure 20. Example Advisory details (popup) from double-click in Advisory Manager view
If the AdvisoryContainer’s Alarm Enable property is true, a corresponding
Figure 21. Example alarm details popup (alarm record) of
Among the entries in the Alarm Data portion of the alarm record are the following:
- certainty — the enumerated value of the “Certainty” property received from the provider, for example “Possible”, “Likely”, and so on.
- description — text string from the provider that provides a complete description of the advisory.
- expires — date/timestamp of when the weather advisory expires.
- instructions — text instructions from the provider on what to do because of this advisory.
- msgText — the enumerated value of the CurrentConditions “state” property.
- severity — the enumerated value of the “Severity” property received from the provider, for example “Moderate”, “Minor”, and so on.
- sourceName — typically the name of the parent WeatherReport (locale), such as “Richmond”, etc. (unless “Source Name” under the “Alarm Properties” container has been edited from defaults).
- state — the alarm state and status of the CurrentConditions component.
- urgency — the enumerated value of the “Urgency” property received from the provider, for example “Immediate”, “Expected”, “Future”, and so on.
Once all weather watches, warnings, and advisories have been canceled or expired, the AdvisoryContainer alarm source returns the offnormal alarm to a normal condition.