Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

The user registration form, which is also known as the sign up form, is generated using claims and is primarily used to gather information of users who are using a given service or productuser 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.

Info

The ES is built on top of WSO2 Carbon. The user registration form is populated by claims which are mapped through WSO2 Carbon.

By default the ES user registration form include the following fields:

Image Removed

...

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 field in the default ES user registration form.

Image Added

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 the required checkbox for the claim to appear as a field in the user registration form.
  • Editing a claim
    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
    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:

  1. Log into the ES Management Console.

  2. Click Configure
  3. Click On the Main menu, click Claim Management.

  4. Click http://wso2.org/claims under AVAILABLE CLAIM DIALECTS.

    Info

    In WSO2 ES the http://wso2.org/claims is used to configure the registration form and it is the default dialect being used by WSO2 Carbon.

    Image RemovedImage Added

    Working with claims: 
    Image Removed
    Adding a new claim:

    The available claims under the claim dialect that you selected appears.
    Image Added

  5. Click Add New Claim Mapping to add a new claim that does not already exist.
  6. Fill in the fields of the NEW CLAIM DETAILS form.

    Excerpt

     

     

    Info
    iconfalse
    • Display Name: Name of the dialect.

    • Description: Describe the dialect, such as, what it is designed for, etc.

    • Claim Uri: Each dialect should have at least one claim when defining it.

    • Mapped Attribute: Corresponding attribute name from the underlying user store for this claim.

    • Regular Expression: Regular expression to validate inputs for this claim.

    • Display Order: Display order of the above claim among all the other claims defined under the same dialect.

    • Supported by Default: If unchecked, this claim will not be prompted at the time of user registration.

    • Required: Whether this claim is mandatory for user registration or not. Note that the claim will only appear in the user registration form if this field is checked.

    • Read-only

    Image Added

  7. Click Add to add the new claim. Image RemovedEditing

Editing a claim

Follow the instructions below to update a claim:

  1. Click  Edit, corresponding to the claim you wish

    Log into the ES Management Console.

  2. On the Main menu, click Claim Management.
  3. Click  http://wso2.org/claims  under AVAILABLE CLAIM DIALECTS.

    Info

    In WSO2 ES the http://wso2.org/claims is used to configure the registration form and it is the default dialect being used by WSO2 Carbon.

    The available claims under the claim dialect that you selected appears.

  4. Click Edit corresponding to the claim that you want to edit.

  5. Edit the required fields of the UPDATE CLAIM DETAILS form.
    Check Required to get the respective field on the registration form.
    Uncheck Required to remove the respective field from the registration form.
    Example:
    Currently the filed named country is not on the ES registration form, by checking Required it will be included on the registration form.
    Insert excerpt
    Customizing the User Registration Form
    Customizing the User Registration Form
    nopaneltrue
    Image Added
  6. Click Update to save the changes made.
    Image RemovedNavigate to the ES store front or back office (publisherStore or Back Office (Publisher) registration page and refresh the page to view the customized registration form.
    Image Removed