Get Roles

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

4. Select an element (e.g. a button) on the page where you want to list the roles.
5. 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.).

‍

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.

• 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.