The user registration form, which is also known as the sign up form, is generated using claims and is primarily used to gather user information which is used by ES. The information required by business entities will differ based on their strategies. Therefore, WSO2 ES facilitates the option for the administrator to customize the registration form to suite the entities business requirements.
ES is built on top of WSO2 Carbon. The user registration form is populated by claims which are mapped through WSO2 Carbon. There are several claims configurations in Carbon and for self signup ES uses the following claim which is the default dialect for WSO2 Carbon: http://wso2.org/claims
The following screenshot depicts the fields in the default ES user registration form.
Customizing the user registration form
The user registration form can be customized in any of the following methods:
- Adding a new claim mapping
This allows you to add a new field in the user registration form. When adding the claim mapping for the new claim, you need to select therequired
checkbox for the claim to appear as a field in the user registration form. - Editing a claim mapping
If you wish to edit the fields in the user registration form (such as, change the order or a field, hide a field etc.), then you can edit the claims that correspond to those fields in the user registration form. - Deleting a claim mapping
If you do not want a certain field to permanently appear in the user registration form, then can delete the claim that corresponds to that field.
Adding a new claim mapping
Follow the instructions below to add a new claim mapping:
Log into the ES Management Console.
- On the Main menu, click Claim Management.
Click http://wso2.org/claims under AVAILABLE CLAIM DIALECTS.
The available claims under the claim dialect that you selected appears.
- Click Add New Claim Mapping to add a new claim that does not already exist.
Fill in the fields of the NEW CLAIM DETAILS form.
- Click Add to add the new claim.
Editing a claim mapping
Follow the instructions below to update a claim mapping:
Log into the ES Management Console.
- On the Main menu, click Claim Management.
Click http://wso2.org/claims under AVAILABLE CLAIM DIALECTS. The available claims under the claim dialect that you selected appears.
Click Edit corresponding to the claim that you want to edit.
- Edit the required fields of the UPDATE CLAIM DETAILS form. Note that the claim Uri can not be updated.Error rendering macro 'excerpt-include' : No location was provided.
- Click Update to save the changes made.
Navigate to the ES Store or Back Office (Publisher) registration page and refresh the page to view the customized registration form.
Deleting a claim mapping
Follow the instructions below to delete a claim mapping:
Log into the ES Management Console.
- On the Main menu, click Claim Management.
Click http://wso2.org/claims under AVAILABLE CLAIM DIALECTS. The available claims under the claim dialect that you selected appears.
Click Remove claim mapping corresponding to the claim that you want to delete.
- Click yes to delete the selected claim mapping.