1. Log in to the Kuika platform.
2. Select your project from the Apps screen.
3. Go to the UI Design module.
4. Go to the screen where you want to get the permission list.

5. Click the + ADD ACTION button in the Properties panel on the right.
6. Select the button and add the Authorisation > Add User To Role action from the + ADD ACTION menu according to the trigger event you want (Initial Actions, OnClick, OnBlur, etc.).

Parameter Configuration

• Role ID (String - Required): This is the ID of the role whose access permissions will be displayed.

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

‍

In a SaaS admin panel, the system administrator needs to see which subscription management permissions a selected role has. Based on these permissions, the user is granted or restricted access to the panel.

Application Flow

• Element: A button triggered after a role is selected with SelectBox (e.g. ‘Show Permissions’)
• Trigger: OnClick
• Action: Authorisation → Get Subscription Management Access List By Role ID
• Parameter: Role ID
• Display of Results: The obtained list is presented to the user with a Table element.

• Dynamic Role Selection: Subscription permissions can be obtained according to different Role IDs by allowing the user to select their role from a Select Box.
• Permission Visualisation: The incoming data can be used to graphically display access rights to the user via a checkbox list or icons.
• Conditional Actions: A warning can be displayed for roles that do not have a specific access permission (e.g. ‘This role cannot access subscription operations.’).
• Permission Comparison: The permission lists of two roles can be compared simultaneously, and differences can be highlighted.

Technical Risks and Precautions

• Use of empty Role ID: If the Role ID is empty or incorrect, the system cannot return a valid permission list.
• Access Restrictions: This action should only be performed by authorised users such as system administrators.
• Data Format Incompatibility: Ensure that the incoming data matches the UI components.
• Refresh After Permission Update: If roles have been updated in the system, the action should be retriggered to ensure that no old data remains in the cache.

The Get Subscription Management Access List By Role ID action is used to list subscription management permissions based on user roles. It facilitates role-based access analysis for system administrators and contributes to application security. It is a critical action, especially for SaaS platforms that require dynamic access control.