editor, translation-admin, translator
4,754
edits
Changes
Elements access privilege (view source)
Revision as of 12:48, 26 January 2022
, 12:48, 26 January 2022Marked this version for translation
<languages/>
<languages/>
<translate>
<translate>
<!--T:1-->
Permissions can be created for all users groups, nesting is supported either,
Permissions can be created for all users groups, nesting is supported either,
for example, "item" which is not editable or which is not visible for some users can be created in "area".
for example, "item" which is not editable or which is not visible for some users can be created in "area".
===The following construction is used for creating the users groups===
===The following construction is used for creating the users groups=== <!--T:2-->
<!--T:3-->
<syntaxhighlight lang="xml" line>
<syntaxhighlight lang="xml" line>
<user-groups groups="GROUP_NAME"/>
<user-groups groups="GROUP_NAME"/>
</syntaxhighlight>
</syntaxhighlight>
===For adding users to the users group the following construction is used===
===For adding users to the users group the following construction is used=== <!--T:4-->
<!--T:5-->
<syntaxhighlight lang="xml" line>
<syntaxhighlight lang="xml" line>
<users>
<users>
</syntaxhighlight>
</syntaxhighlight>
<!--T:6-->
Within the tag all the users, their groups are entered, name and password attributes are specified for each concrete user. single-action="true" – the rules are applied only for one action (e.g. script activating)
Within the tag all the users, their groups are entered, name and password attributes are specified for each concrete user. single-action="true" – the rules are applied only for one action (e.g. script activating)
<!--T:7-->
User attribute "permissions" is responsible for accessing the "Advanced" tab in settings, Edit mode and "Setup" room
User attribute "permissions" is responsible for accessing the "Advanced" tab in settings, Edit mode and "Setup" room
<!--T:8-->
{|class="wikitable"
{|class="wikitable"
|-
|-
|}
|}
===Permissions parameter is used for restricting the access to the concrete element, for example===
===Permissions parameter is used for restricting the access to the concrete element, for example=== <!--T:9-->
<!--T:10-->
<syntaxhighlight lang="xml" line>
<syntaxhighlight lang="xml" line>
<area name="AREA_NAME" permissions="*:ve-;USER1:ve+">
<area name="AREA_NAME" permissions="*:ve-;USER1:ve+">
</syntaxhighlight>
</syntaxhighlight>
<!--T:11-->
In this part of code is specified that AREA_NAME area is visible and editable for USER1,
In this part of code is specified that AREA_NAME area is visible and editable for USER1,
<!--T:12-->
for all other users (in our case only USER2) it is invisible.
for all other users (in our case only USER2) it is invisible.
<!--T:13-->
"item" of lamp type with LAMP31112 name which is located in "area" with AREA_NAME name has its own authorisation for a concrete user,
"item" of lamp type with LAMP31112 name which is located in "area" with AREA_NAME name has its own authorisation for a concrete user,
<!--T:14-->
it is specified in the code that "item" of lamp type with LAMP31112 name is visible for USER1 but USER1 cannot edit this "item".
it is specified in the code that "item" of lamp type with LAMP31112 name is visible for USER1 but USER1 cannot edit this "item".
<!--T:15-->
All other users (in our case only for user USER2) can both see and edit this item.
All other users (in our case only for user USER2) can both see and edit this item.
===Permissions parameters and their description===
===Permissions parameters and their description=== <!--T:16-->
*"ve+" – is visible and can be edited
*"ve+" – is visible and can be edited
*"ve-" – is invisible and can’t be edited
*"ve-" – is invisible and can’t be edited
*"e-" – can’t be edited
*"e-" – can’t be edited
<!--T:17-->
edit-mode-users="User1;User2" is to be added to "smarthouse" tag for setting mode password (interface 3).
edit-mode-users="User1;User2" is to be added to "smarthouse" tag for setting mode password (interface 3).
===Also you can use the password for the items to protect them from accidental clicking===
===Also you can use the password for the items to protect them from accidental clicking=== <!--T:18-->
<!--T:19-->
Example:
Example:
<!--T:20-->
<syntaxhighlight lang="xml" line>
<syntaxhighlight lang="xml" line>
<item addr="311:12" name="LAMP31112" type="lamp" password="1234"/>
<item addr="311:12" name="LAMP31112" type="lamp" password="1234"/>