The Remove User From Role action removes a user from a role defined in the system. As a result of this action, the user loses all permissions and access rights associated with the role. However, the user record in the system is not deleted; only role-based access is terminated.

Technical Features

Remove from Role: The user is removed from the role they are assigned to, thereby revoking all permissions associated with that role.
User Existence is Preserved: Only the role is removed; the user remains in the system.
Authorisation Panel Compatibility: Roles and permissions work in harmony with the Authorisation settings.
Web and Mobile Support: The action can be used in both web and mobile applications.

Remove User From Role Action Application Steps

Log in to the Kuika platform.
Open your project from the Apps screen.
Go to the UI Design module.

Open the Properties panel from the right panel.

From the + ADD ACTION menu, add the Authorisation > Remove User From Role action according to the desired trigger event (Initial Actions, OnClick, OnBlur, etc.).

Parameter Configuration

User Name (String – Required): The username or email address of the user to be removed from the role. Example: txtEmail.value
Role Name (String – Required): The name of the role from which the user will be removed in the system. Example: ‘editor’

Parameters can be entered directly or retrieved from sources such as Action Result, Screen Input, Fixed, Component using the Symbol Picker.

Use Case: Removing a User from the Editor Role

In a content management system, administrators may want to remove users who have changed roles from the ‘Editor’ role in the system. This way, the user will no longer have content editing permissions.

Application Steps:

Element: Remove Role button
Trigger: OnClick
Action: Authorisation → Remove User From Role

Parameter Assignments:

User Name → txtEmail.value
Role Name → ‘editor’

The user is removed from the ‘editor’ role and cannot access content editing screens or functions. However, the user account remains active in the system.

Remove User From Role Action Advanced Customisations

Dynamic Role Removal: The role name can be specified for each user, allowing users from different user groups to be removed from the same component.
Visual Feedback: A notification action can be sent to the user or administrators after the process is completed.
Conditional Role Control: Before removal, control can be provided with an If Then Else structure based on the user's current roles.

Technical Risks and Controls

Incorrect User: The User Name field must be linked correctly. Otherwise, another user may be accidentally removed from the role.
Unauthorised Access: This action should only be used by authorised persons such as administrators.
Deletion of System Roles: Removing certain system roles may disrupt the user experience. Role dependencies should be checked first.

The Remove User From Role action allows you to update access permissions in the system by removing users from specific roles. While the user's presence in the system is preserved, only role-based permissions are removed. Thanks to its dynamic structure, it can be applied flexibly to different user groups.