1. Adding the Update User Starting Screen Action

• Log in to the Kuika platform.
• Open the project you want to work on from the Apps screen.
• Go to the UI Design module.
• Create a button on the relevant screen (e.g. ‘Set as Home Page’).

• Select the button and add the Authorisation > Update User Starting Screen action from the + ADD ACTION menu according to the desired trigger event (Initial Actions, OnClick, OnBlur, etc.).

2. Configuring Action Parameters

• User Name (Required): The email address of the user whose start screen will be updated. Example: user@kuika.com or currentUser.email. 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 tool.
• Starting Screen ID (Required):The ID number of the screen to which the user will be directed upon login. Example: ‘homeScreen’, ‘adminDashboard’. 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.

When a user gains a specific role in the application (e.g., when promoted to administrator), they should be directed to the ‘Administrator Panel’ screen by default when logging into the application.

Scenario Steps

• Element: Update Home button
• Trigger: OnClick
• Action: Authorisation → Update User Starting Screen
• Parameters:
  
  • User Name
  • Starting Screen

With this configuration, the user will be directed to the ‘adminDashboard’ screen directly upon their next login.

• Role-Based Dynamic Assignment: You can determine the start screen based on the user's role.
• Update After Registration or Role Assignment: When a new role is assigned to a user or immediately after registration, this action is triggered and the start screen can be assigned.
• Use After Login: Triggered after the Sign In action, the appropriate screen settings can be made for the user.

Technical Risks and Controls

• Invalid Screen ID: If the Starting Screen ID value displays a screen that is not defined in the system, the redirection may fail. It should be verified in advance.
• Incorrect User Name: If the User Name parameter is entered incorrectly, the action will not be effective on any user.
• Unauthorised Action: Make sure that the user who will execute the action is authorised to do so.

Update User Starting Screen is a powerful action for personalising the user experience and making role-based redirections dynamic. It allows you to determine the screen that users will see when they first log in to the application and customise system behaviour according to user profiles. It creates a secure and user-friendly start experience.