The Get Roles action is used to retrieve a list of all user roles defined in the system on the Kuika platform. This action allows administrators and developers to analyse the role structure within the application, simplify user management processes, and control the authorisation system in a more transparent manner.

Technical Features

Get Role List : Returns all user roles defined in the system.
Authority Analysis: Access control can be provided through roles.
Web & Mobile Compatibility: The action can be used in both web and mobile applications.
Easy Integration: Works with other Authorisation actions to enable dynamic role assignments.

Get Roles Action Application Steps

Log in to the Kuika platform.
Select the project you want to work on from the Apps screen.
Go to the UI Design module.

Select an element (e.g. a button) on the page where you want to list the roles.
Select the button and add the Authorisation > Get Roles action from the + ADD ACTION menu according to the trigger event you want (Initial Actions, OnClick, OnBlur, etc.).

‍

Usage Scenario: Dynamic Authorisation with Role Selection

When creating or editing a user in an administrator panel, it is necessary to dynamically retrieve a list of available system roles to select one. The Get Roles action is used for this.

Application Flow

Element: ‘Get Roles’ button or page load event
Trigger: OnClick
Action: Authorisation → Get Roles
Displaying Results: The roles received are listed in a Select Box element.
After Selection: The selected role is transferred to another action, such as Add User To Role or Create User, as a parameter.

Get Roles Action Advanced Customization

Automatic Dropdown Filling: By linking the output of the Get Roles action to a dropdown component, a list can be presented to the user for selection.
Role-Based Visibility: The fields to be displayed in the application can be dynamically determined with the role information received.
Role-Based Authorisation: The roles received with this action can be used in an integrated manner with other access control mechanisms in the system.
Linking to the Data Source: The incoming role data can be viewed and edited by the administrator on a Data Grid.

Technical Risks and Precautions

Unauthorised Access: Only authorised users should be able to access role information.
List Length: In systems with many defined roles, loading incoming data into UI components may be slow; filtering should be implemented.
Asynchronous Update: When roles are changed, the list should be updated.
Empty Return Check: When the system is first set up, a check for empty returns should be performed to prevent incorrect behaviour in components if no roles are defined.

The Get Roles action allows you to systematically view all user roles on the Kuika platform. It forms the basic data source for role management and authorization processes. When used in conjunction with other actions, it provides a dynamic, secure and user-centric authorization infrastructure.