Retrieve User ID (SCC_USERREG_GET_USERID) Service Operation

This service operation retrieves a user’s ID using the Forgot User ID utility. A user must provide the email address that is associated with his or her OPRID (stored inside the user’s profile) in order to retrieve the user ID. The user ID is retrieved only if one OPRID is associated with the email address. The New User Registration framework uses the Notifications framework to generate the email message that contains the user ID.

The Retrieve User ID service operation:

  1. Verifies whether the required input parameter (email address) has been passed to the Forgot my User ID page.

  2. Validates whether the email address entered is associated with only one user ID (OPRID) (from the PSOPRDEFN and PSUSEREMAIL records).

  3. Prepares the response message. The service operation either retrieves the user ID and uses the Notifications framework to send an email that contains the user ID, or returns an error. An error is returned when:

    • The email address is not found.

    • The email address is associated with multiple user IDs (OPRIDs), or to no user ID.

See Notifications Framework and New User Registration.

The Retrieve User ID service operation includes the following messages:

Input Message: SCC_USERREG_GET_USERID_REQ

The email address is a mandatory input parameter to pass to the service operation. The utility evaluates whether there is only one OPRID assigned to the email address. If so, the user ID is retrieved.

Output Message: SCC_USERREG_GET_USERID_RESP

When the user ID is retrieved, an email that contains the user ID is sent to the user as part of the response. The Notifications framework is triggered to send the email message.

If more than one user ID is assigned to an email address or no user ID is found, the user ID is not retrieved and an error message appears.

See: