User Manual

Update User Name

18/4/25
Update User Name

The Update User Name action on the Kuika platform allows users to update their existing username. Update User Name allows users to manage their account information and change their username when needed. Once the update process is complete, the user will be recognized by their new name within the application and will continue all their transactions under this new username. Update User Name action is only supported in mobile applications.

Technical Specifications

  • Username Update: Dynamically updates the user's existing username.
  • Mobile Compatible: This action only works on mobile applications. The username update process can be done on the mobile platform.
  • Email Notification Management: It can be controlled whether email notifications will be sent during the username update process.
  • Language Preferences: The user's preferred language can be updated so that the language option within the application can be customized according to the user.
  • No Web Application Support: This action is only available in mobile apps and is not supported on the web platform.

Update User Name Action Implementation Steps

Adding Update User Name Action to the Project

  1. Log in to the Kuika platform and open the project you are working on.
  2. Open the Properties panel on the right panel in the UI Design module.
  1. From the+ ADD ACTION drop-down menu, select an appropriate trigger action (event) such as Initial Actions, OnClick, OnBlur respectively → Authorization → Update User Name.

Configuring Update User Name Parameters

In the fields below you can configure the parameters required for the username update process:

User Name

  • Tip: String
  • Necessity Yes
  • Description: Enter the current username (e-mail address) of the user to be updated.
  • Input: Enter the e-mail address of the user. For example, the user@example.com.Bu field can be imported primarily from data sources such as Action Result. Other sources such as Method Input, Current, Screen Input, Fixed or Component can also be used. These categories can be defined by selecting them via Symbol Picker .

New User Name

  • Tip: String
  • Necessity Yes
  • Description: Enter the user's new username (e-mail address).
  • Input: Enter the new e-mail address of the user. For example, newuser@example.com. Data can be imported into this field primarily from data sources such as Action Result. Other sources such as Method Input, Current, Screen Input, Fixed or Component can also be used. These categories can be defined by selecting them via Symbol Picker.

Optional Parameters

You can further customize the username update process with the following optional parameters:

Don't Send Email

  • Tip: Boolean
  • Requirement: Optional
  • Description: Determines whether email notifications are sent when updating the username.
  • Input: true or false can be entered. For example, true means no e-mail is sent, false means it is sent. Data can be transferred to this field primarily from data sources such as Action Result. Other sources such as Method Input, Current, Screen Input, Fixed or Component can also be used. These categories can be defined by selecting them via Symbol Picker.

Language

  • Tip: String
  • Requirement: Optional
  • Description: Specifies the user's preferred language.
  • Input: Specify the user's language preference. For example, en (English), en (Turkish).This field can primarily import data from data sources such as Action Result. Other sources such as Method Input, Current, Screen Input, Fixed or Component can also be used. These categories can be defined by selecting them via Symbol Picker.

Completing the Registration Process

After configuring your parameters, click the SAVE button to save your changes. This step ensures that the Update User Name action is successfully added.

Usage Scenario: User Updates Email (Username) Information

The user may want to change the username (e-mail address) of their account after logging in with their existing account. This is done from the user profile and once the update is complete, the user can log in to the system with the new email address. This scenario specifically allows users to keep their personal information up to date.

Add Update User Name Action to Email Update Form

  1. Log in to the Kuika platform.
  2. Open the project you are working on from the Apps screen.
  1. Switch to the UI Design module.
  2. Drag and drop a Form and two Text Input elements (Current Email and New Email) from the Elements panel on the left side.
  3. Add a Button under the Form and type “Update Email” in the Label.
  4. Select the Button and click the + ADD ACTION menu from the Properties panel on the right.
  5. Select the OnClick → Authorization → Update User Name action.

Configuring the Update User Name Action

In the action configuration window that opens, define the following fields:

  • User Name: formData.currentEmail
  • New User Name: formData.newEmail

Configure Optional Parameters

Click+ ADD OPTIONAL PARAMETER and add the needed settings:

  • Don't Send Email: false → (Send notification email after update)
  • Language: “en” → (Turkish language can be selected by default)

Click SAVE to complete the configuration.

User Experience After Update

When the user fills in the form and clicks the “Update Email” button:

  • The system verifies the existing username information.
  • Account information is updated with the new e-mail address.
  • If the update is successful, the user will receive a Notify action with the message “Your e-mail address has been successfully updated”.
  • The user can log in with the new email address in the next session.

Update User Name Advanced Customizations

  • Email Notification Control: With the “Don't Send Email” parameter, you can control whether or not email notifications are sent during username change. If you do not want notifications to be sent, you can set this parameter to true. This way, no email will be sent to the user about the change. For example, if you do not want to send notifications, you can set this parameter to true.
  • Language Preference Update: With the “Language” parameter, you can dynamically change the language of the application in the user's preferred language. With the username update, you can direct the user to the app with language settings according to their preferences. This provides a more personalized user experience. For example, after updating the username, you can also update the language preference.
  • Advanced User Guidance: After updating the username, you can redirect the user to another page. For example, after the username is successfully updated, you can redirect the user to the profile page. This type of redirection can make the user experience more efficient. For example, after a username change, you can redirect the user to the profile page.

Technical Risks and Control

  • Incorrect User Name Update: Make sure that the User Name and New User Name parameters are entered correctly. Invalid user names can lead to incorrect results.
  • Notification Sending Problems: The Don't Send Email parameter must be configured correctly. Otherwise, notifications may not be sent or unwanted notifications may be sent.
  • User Name Conflict: When changing the username, it is necessary to check whether the new username is available. Multiple registrations should not be made with the same username.

The Update User Name action provides an effective solution for users to update their accounts and change their usernames within the application. In particular, this action allows users to manage their profile information and personalize their in-app experience. It also provides secure and flexible user management in mobile apps and seamlessly handles username changes.

Other Related Content

No items found.

Glossary

No items found.

Alt Başlıklar