SWS RetrievePassword Method
Retrieves the password/eCommerce code along with contact details for an email within the specified organization. This will retrieve contact information for all accounts with the specified email address if no password/eCommerce code is included. If a password/eCommerce code is included, it will filter for only accounts that are registered with eStore/eCommerce with that password.
Parameters
Description
Name | DataType | Is Required |
---|---|---|
EmailAddress | String | Required |
Description | The email address for which you wish to retrieve the password/eCommerce code. | |
OrgID | Long | Required |
Description | The organization’s ID number. | |
Password | String | Optional |
Description | The password/eCommerce code of the contact. |
Returned Parameters
Name | DataType |
---|---|
ACCT_ID | Long |
Description | The account’s ID number. |
ACTIVE | String |
Description | Indicates if the account is active (“Y”) or not (“N”). |
CFLEX01 | String |
Description | A custom field, set up by the organization, designed to hold additional contact information. This is not displayed in the Store application. |
CFLEX02 | String |
Description | A custom field, set up by the organization, designed to hold additional contact information. This is not displayed in the Store application. |
CFLEX03 | String |
Description | A custom field, set up by the organization, designed to hold additional contact information. This is not displayed in the Store application. |
CFLEX04 | String |
Description | A custom field, set up by the organization, designed to hold additional contact information. This is not displayed in the Store application. |
CFLEX05 | String |
Description | A custom field, set up by the organization, designed to hold additional contact information. This is not displayed in the Store application. |
CONTACT_ID | Long |
Description | The rental contact’s ID number. |
CONTACT_TYPE | Integer |
Description | The numeric value for the contact type. Available values:
|
ECOMM_CODE | String |
Description | No longer returned. |
String | |
Description | The email address for the primary contact. |
FIRST_NAME | String |
Description | The given name for the account/rental contact. |
KNOWN_AS | String |
Description | The alternate or nick name for the rental contact. |
LAST_NAME | String |
Description | The family name for the rental contact. |
ORG_ID | Long |
Description | The organization’s ID number. |
Example
As with every method we need to pass in credentials. We do this with the LookupUser request object.
We will assume you have a web reference, let us name it SWS, in your Visual Studio project. At this point we need to define our objects. We will need the standard service object, a Password request object, and a Password response object. We can define and create those like this:
// Create a request and response objects
SWS.WSSoapClient service = new SWS.WSSoapClient();
SWS.Password_Request request = new SWS.Password_Request();
SWS.Password_Response response;
Here is a sample code of the request object (including optional parameter):
// RetrievePassword Request
request.OrgID = 123456;
request.EmailAddress = "test@b.c";
request.Password = "testpass";
Finally we can call the method and pass across the login object and the request object to retrieve our requested information. It’s a good idea to do this in a Try Catch block.
// Call the method that will load the response object
try
{
response = service.RetrievePassword(user_request, request);
}
catch (Exception ex)
{
MessageBox.Show(ex.Message);
}
Note that if something goes wrong the service will respond with an exception. You will want to capture the message in the exception so it can be debugged.
For a full list of methods see SWS Methods.
Updated July 28, 2014: Updated the method to return “No record found” error instead of “Invalid object” error.
Updated July 17, 2014: Recent updates were made to the data access in the RetrievePassword method. Response times should be shorter, data and the logic by which it is retrieved, remains the same.