Difference between revisions of "Redirect variables"
(→Syntax) |
|||
Line 28: | Line 28: | ||
In a project we place a [[TempMini]] and three [[User]] buttons. | In a project we place a [[TempMini]] and three [[User]] buttons. | ||
On the TempMini parameters, we use two variables: mysid and myzone. | On the TempMini parameters, we use two variables: mysid and myzone. | ||
+ | |||
[[File:redirect_vars_01.png]] | [[File:redirect_vars_01.png]] | ||
− | Each [[User]] button will have "changetemp" as name and 1,2 or 3 respectively as param. | + | Each [[User]] button will have "changetemp" as name and "1", "2" or "3" respectively as param. |
+ | |||
In [[JavaScript_Callback_Functions_API#userCommand|events]] we declare: | In [[JavaScript_Callback_Functions_API#userCommand|events]] we declare: | ||
Line 39: | Line 41: | ||
} | } | ||
} | } | ||
+ | |||
+ | Clicking on a button in the interface will execute the above callback, which sets the redirect variables' values and changes the source of the TempMini object accordingly. | ||
+ | |||
+ | == Example: Button object == | ||
+ | Similarly to the previous example, in a project we place a [[Button]] object with a variable called myaddr. | ||
+ | We also place two User buttons with name "changeaddr" and param "light.1" and "autom.1" | ||
+ | |||
+ | [[File:redirect_vars_02.png]] | ||
+ | |||
+ | function userCommand(session, userid, name, param) : { | ||
+ | if (name == "change") { | ||
+ | uiSet("redirect", "myaddr", "dummy."+param); // dummy.light.1 | ||
+ | } | ||
+ | } | ||
+ | |||
+ | Once again clicking on a User button will cause the Button object to change its source, from a light to an autom. |
Revision as of 13:07, 26 September 2019
Redirect variables allow UI Objects to be linked dynamically to a source.
Variables can be used in: - any object's id - I/O Server Objects, in server id and address parameters - Button objects, in the address parameter
Syntax
Variables are defined with the following syntax:
[<variable name>]
E.g.
[myaddr]
Setting Values
Server UISets (from events or java) are used to set a redirect variable value. Each variable is a property of the "redirect" object. For example, a variable called "myaddr" can be set to "70" with a UISet command on events:
UISET redirect.myaddr=70
Example: Weather Object
In this example we will use a single TempMini object to display different sources. In hsyco.ini we have an ioServer with 3 zones.
ioServers = bmne500 ioServersType.bmne500 = MYHOME ioServersOptions.bmne500 = tempzones=1;2;3
In a project we place a TempMini and three User buttons. On the TempMini parameters, we use two variables: mysid and myzone.
Each User button will have "changetemp" as name and "1", "2" or "3" respectively as param.
In events we declare:
function userCommand(session, userid, name, param) : { if (name == "changetemp") { uiSet("redirect", "mysid", "bmne500"); uiSet("redirect", "myzone", param); // address: "temp."+ myzone } }
Clicking on a button in the interface will execute the above callback, which sets the redirect variables' values and changes the source of the TempMini object accordingly.
Example: Button object
Similarly to the previous example, in a project we place a Button object with a variable called myaddr. We also place two User buttons with name "changeaddr" and param "light.1" and "autom.1"
function userCommand(session, userid, name, param) : { if (name == "change") { uiSet("redirect", "myaddr", "dummy."+param); // dummy.light.1 } }
Once again clicking on a User button will cause the Button object to change its source, from a light to an autom.