*genericEvent

Open

Configuration Article | CA-20220907-TP-26 VDG Sense | API | Functions | Events Open

Open

Note: This function requires an API license.

The genericEvent signal with the supplied value parameter is used in the macro mechanism to trigger macros.

This signal is also stored in the database. It can be obtained with the command getEvents. Special care must be taken when including xml specific characters. These are ‘&’, ‘<' en '>‘. The ampersand (‘&’) character can not be sent by this command because it will be part of the URL. See next paragraph. The less-then (‘<') and greater-then ('>‘) character cannot be part of the return xml message in getEvents. These characters are converted to ‘<' and '>‘ before they are stored in the database.

As the value of this event is in the query part of an URL, the ampersand character (‘&’) cannot be part of it. It must be URL Encoded. See i.e. http://www.w3schools.com/TAGS/ref_urlencode.asp. The best practive is to URL Encode the complete value.

This command is only available if the option XML is available.

Request

Response

Changelog

• 2.2.1   – Handling of xml and html specific characters.

• 1.12.1 – Added serverid and deviceid.

• 1.11.1 – Added.