Share via


Registration Web Part

The Registration Web Part lets shoppers create a profile to use on your e-commerce site. This Web Part gathers the appropriate personal information necessary to create an account and set up the site login information, and lets shoppers set passwords for their accounts.

You can configure the Registration Web Part to use a shopper's e-mail address as the unique identifier, or you can configure it to let the shopper specify a unique user name. At a minimum, the Registration Web Part collects the first and last name of the shopper. You can configure this Web Part to gather additional information if needed.

You can configure the Registration Web Part to employ a challenge-response system if the shopper forgets the password, or you can employ a password recovery process. For the challenge-response system, shoppers specify a question and an answer during creation of their accounts. If the shopper forgets the password and the shopper correctly answers the challenge question, the system grants access to the Web site.

Architecture

You can use the Registration Web Part in two possible deployment environments: Windows SharePoint Services (WSS) and Microsoft Office SharePoint Server (MOSS). The Web Part has two implementations:

  • RegistrationWizardWebPart: Dynamically loads the RegistrationWizard user control

  • RegistrationWizard.ascx: Lets an unregistered shopper create a profile for the shopping site. The control uses the Membership provider to create a new profile by using the API UserProfile service. The RegistrationWizard.ascx file contains a CreateUserWizard Web control.

Properties

The following table lists the mapping of the properties for the Registration Web Part.

Property

Maps to

"Security question's answer" label text

AnswerLabelText

"Security question's answer is required" message

AnswerRequiredErrorMessage

"Cancel" button text

CancelButtonText

"Allow additional communications" check box text

CommunicationText

"Success" message

CompleteLabelText

"Confirm email does not match" message

ConfirmEmailErrorMessage

"Passwords don't match" message

ConfirmPasswordErrorMessage

"Confirm password" label text

ConfirmPasswordLabelText

"Confirm password is required" message

ConfirmPasswordRequiredErrorMessage

ContinueButtonText

ContinueButtonText

On completion, go to URL

ContinueDestinationPageUrl

"Create" button text

CreateButtonText

"User name already exists" message

DuplicateUserNameErrorMessage

"Email" label text

EmailLabelText

"Email is required" message

EmailRequiredErrorMessage

"Email" validation pattern

EmailValidationExpression

"Email is invalid" error message

EmailValidatorErrorMessage

"First name" label text

FirstNameLabelText

"First name is required" message

FirstNameRequiredErrorMessage

"Registration" section title text

HeaderLabelText

Instructional text

InstructionText

"Last name" label text

LastNameLabelText

"Last name is required" message

LastNameRequiredErrorMessage

"Password creation tip" link text

PasswordCreationTipLink

"Password creation tip" text

PasswordCreationTipText

"Password" label text

PasswordLabelText

Password strength validation pattern

PasswordRegularExpression

"Password is required" message

PasswordRequiredErrorMessage

"Password fails strength validation" message

PasswordStrengthNotMetErrorMessage

"Personal Information" section title text

PersonalInformationLabelText

On completion, go to URL

PostActionPageUrl

"Security question" label text

QuestionLabelText

"Security question is required" message

QuestionRequiredErrorMessage

"User name already exists" message

RegistrationWizardMainDuplicateUserNameErrorMessage

"* are required fields" label text

RequiredFields

"Security question tip" link text

SecurityQuestionTipLink

"Security question tip" text

SecurityQuestionTipText

"Use Live Id" check box text

UseLiveIDText

"User name" label text

UserNameLabelText

"User name is required" message

UserNameRequiredErrorMessage

"User name" validation pattern

UserNameValidationExpression

"User name is invalid" message

UserNameValidatorErrorMessage

You can configure the Registration Web Part to let the shopper to enter a personal question and answer to facilitate a Challenge-Response question and answer password recovery system. The default value of the Enable Challenge Response property is False. Shoppers can specify their own personal question and answer, which is stored with their profiles.

The following table lists the field and length limits imposed in the Registration Web Part.

Field

Maximum length

User Name/Email Address

64

Password/Confirm Password

50

First Name

50

Last Name

50

Security Question

255

Security Answer

50

The following table lists the default regular expressions that the fields in the Registration Web Part use.

Field

Pattern

Regular Expression

Username/Email Address

E-mail address

\w+([-+.']\w+)*@\w+([-.]\w+)*\.\w+([-.]\w+)*

Password/Confirm Password

Alphanumeric characters

[0-9a-zA-Z]*

Customization

You can customize the Registration Web Part by modifying the .ascx file or the properties sheet.

Error Handling

There is no design-time error handing required for this Web Part.

API Dependencies

The Registration Web Part relies on the API and a Membership Provider that encapsulates calls to the API service. Because the Registration Web Part implements a CreateUserWizard Web control, a Membership provider can support its functionality.

See Also

Other Resources

Working With the Registration Web Part

Developing with SharePoint Commerce Services

Profile Administration System Web Parts