A.6. permissions.xml
Files of this type are used in the Web Client and the Desktop Client blocks for registration of specific user permissions.
The file location is defined in the cuba.permissionConfig application property. When you create a new project in Studio, it creates the web-permissions.xml
file in the root package of the web module, for example modules/web/src/com/company/sample/web-permissions.xml
.
XML schema is available at http://schemas.haulmont.com/cuba/6.7/permissions.xsd.
The file has the following structure:
permission-config
- root element.
permission-config
elements:
-
specific
- specific permissions descriptor.specific
elements:-
category
- permissions category which is used for grouping permissions in the role edit screen.id
attribute is used as a key for retrieving a localized category name from the main message pack. -
permission
- named permission.id
attribute is used to obtain the permission value by theSecurity.isSpecificPermitted()
method, and as a key for retrieving a localized permission name form the main message pack to display the permission in the role edit screen.
-
For example:
<permission-config xmlns="http://schemas.haulmont.com/cuba/permissions.xsd">
<specific>
<category id="app">
<permission id="app.doSomething"/>
<permission id="app.doSomethingOther"/>
</category>
</specific>
</permission-config>