1. Log in to the Kuika platform.
2. Select your project from the Apps screen.
3. Go to the UI Design module.
4. Select the component that will trigger the action (e.g., a button).

5. Select the button and add the Authorisation > Get Device Management Access List By Role ID action from the + ADD ACTION menu according to the desired trigger event (Initial Actions, OnClick, OnBlur, etc.).

Parameter Configuration

• Role ID (String-Required): The ID of the user role for which the access list will be retrieved.

• It is usually defined using data sources such as Action Result, Current, Form Component, Screen Input or Fixed, and can be linked via the Symbol Picker.

‍

A system administrator wants to view which permissions are defined for which devices based on user roles via a screen titled ‘Device Management’. When a user selects a role, the device access information for that role is listed in detail.

Application Flow:

• Element: ‘View Device Permissions’ button
• Trigger: OnClick
• Action: Authorisation → Get Device Management Access List By Role ID
• Parameter:
  
  • Role ID → ddlRoles.selectedItem.roleId

• Filtering and Search: Searches can be performed by device name. Role-based filters can be added.
• Colour Coding: Devices with permissions are displayed with green icons, and those without permissions are displayed with red icons.
• Comparison Between Related Roles: Device access permissions belonging to multiple roles can be listed side by side on the same screen.
• Notify Action with Warning: If no device has permissions in the selected role, a warning notification can be displayed to the user.

Technical Risks and Controls

• Empty or Invalid Role ID: If an undefined Role ID is entered, the list will not be returned or an error may occur.
• Unauthorised Use Risk: This action should only be used by high-level users (e.g. admin).
• Failure to Update Access Information: If authorisation information is not updated in the system, the displayed data may be incorrect.
• Testing Deficiency: After adding a new role, it is important to test that device permissions are working correctly.

Get Device Management Access List By Role ID is used to analyse the access permissions that roles have for device management on the Kuika platform. It plays a critical role in security, auditing, and IT management scenarios. Thanks to the listing outputs, access controls to devices can be planned in a healthy manner and role-based security policies can be implemented.

‍