Retrieve Password Hint (SCC_USERREG_GET_PSWD_HINT) Service Operation

This service operation retrieves the Forgot Password Hint set when a user forgets his or her password and triggers the PeopleTools Forgot Password utility. The PeopleTools Forgot Password utility requires that Forgot Password Hints should be defined. A user must provide his or her user ID in order to reset and receive a new password. When a user forgets his or her password and invokes the Forgot Password utility, the user ID that is provided is used to fetch the email address and Forgot Password hint set. The user’s response is compared with the information stored in the database.

The Retrieve Password Hint service operation:

1. Verifies whether the required input parameter, user ID (OPRID), has been passed in the Forgot my password page.

2. Evaluates whether the user ID is valid.

3. Prepares the response message. If the user ID is valid, the service operation retrieves the associated email address and displays the password hint set, or returns an error. An error is returned when:

   • The user ID is not found.

   • The user ID is not associated with a Forgot Password hint set.

   • The user ID is not associated with an email address, so an email cannot be sent.

See Using the Forgot Password Utility.

The Retrieve Password Hint service operation includes the following messages:

Input Message: SCC_USERREG_GET_PSWDHINT_REQ

The user ID (OPRID) is a mandatory parameter to pass to the service operation. The service operation evaluates whether the user ID is valid. If so, the associated email address and hint question are retrieved.

Output Message: SCC_USERREG_GET_PSWDHINT_RESP

If the user ID is valid, the associated email address and hint question are returned. If the user ID does not exist, is not associated with an email address or hint question, the service operation displays an error.

See Developer Reference to Deploy New User Registration, “Step 10: Configuring the Forgot Password Utility.”