Polisy Developers:ISY:API:System Editors

From Universal Devices, Inc. Wiki
Revision as of 13:24, 21 March 2022 by Chris (talk | contribs)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to navigation Jump to search

Polisy_Developers : ISY : API : System Editors

System Editors

System editors are editors supplied by and maintained by the ISY.

(first available in Polisy 5.4.2)


  • In the GUI, system editors act the same as other editors
  • All system editors have an id with a prefix of _sys_
  • System editors are only allowed on command parameters (not status)


Unless otherwise specified, all REST commands use HTTP GET method.

See REST return codes


  • URL Prefix: /rest


Returns all System Editors, or just the single specified System Editor.

editorId The name of the system editor, or omit to return all system editors


  <editor id="_sys_notify_short">
      <range min="1" max="5" step="1" prec="0" uom="146">
            <e id="1">Kitchen lights</e>
            <e id="2">Back door is open</e>
            <e id="3">Motion in front yard</e>
            <e id="4">Car is charging</e>
            <e id="5">Alarm is on</e>
editor id The name of the system editor
range The set of values supported by this system editor
nls The list of name value pairs for this range
e id The id is the range value


Whenever the content for a system editor changes, the ISY will send out the following event indicating which system editor changed.

<Event SEQNUM="15" SID="uuid:33">
Content changes whenever the custom notifications change in the ISY.

Supported System Editors


The _sys_notify_short system editor provides the list of user created custom notifications.

When a command with a parameter using the _sys_notify_short system editor is submitted to the ISY, the custom notification it specifies is formatted by the ISY into a string as follows:

  • If there is a subject in the notification then only the subject is used
  • If there is no subject then the body is used
  • Maximum of 80 characters are returned

The resulting string is then used as the command parameter rather than the ID of the custom notification.


If ISY receives the following command with a parameter using _sys_notify_short.

  Note the UOM being used is the one reserved for this system editor.

Then the ISY finds notification id=2, formats it, and sends the resulting string as follows to the node server.

  Note the UOM changed to 145 (Text)

Could also be in this format (unnamed parameter)