SWS getTenantLetterListV2 Method
Retrieves tenant letter document information for an entire site, account and/or rental item. Receipts are excluded if they were centrally mailed. Includes additional return fields not found in the original version GetTenantLetterList.
Parameters
Name | DataType | Is Required |
---|---|---|
AcctID | Long | Optional* |
Description | The account’s ID number. This is returned when you use the CreateNewAccount method or can be retrieved with the SearchBy method. * AcctID, RentalID or SiteID is required. |
|
EndDate | DateTime | Optional |
Description | The end of the date range for which you are requesting the letters. Defaults to the StartDate if left undefined. | |
RentalID | Long | Optional* |
Description | The rental item’s ID number. This is returned when using the MakeReservation method or can be searched for using the SearchBy method. * AcctID, RentalID or SiteID is required. |
|
SiteID | Long | Optional* |
Description | The site’s ID number. This can be found using the GetSiteList method. * AcctID, RentalID or SiteID is required. |
|
StartDate | DateTime | Optional |
Description | The start of the date range for which you are requesting the letters. Defaults to today if left undefined. |
Returned Parameters
Name | DataType |
---|---|
ACCT_ID | Long |
Description | The account’s ID number. |
CERTIFIED | String |
Description | Indicates that the letter is flagged to be sent as certified mail (“Y”) or as regular mail (“N”). |
CREATED | DateTime |
Description | The created date and time of the record. |
EXPORT_DATE | String |
Description | The date the letter was exported to a .pdf for printing. |
EXPORT_ID | Long |
Description | The export ID number in which the letter was sent. |
GROUP_MEANING | String |
Description | The textual value of the LTR_TYPE_GROUP. |
LTR_NAME | String |
Description | The textual value of the LTR_TYPE_ID |
LTR_NUM | Long |
Description | The letter number. This is system generated when the letter is generated and is primarily used for tracking. |
LTR_TYPE_GROUP | Integer |
Description | The group number assigned to the letter template type. Common values:
|
LTR_TYPE_ID | Long |
Description | The ID to the specific letter template used to generate the letter. |
MAIL_LOCAL | String |
Description | Indicates if the letter will be printed and mailed by the site (“Y”) or sent through centralized mail (“N”). |
PRINT_MEANING | String |
Description | The textual value of the PRINT_SPECIAL parameter. |
PRINT_SPECIAL | Integer |
Description | The type of special printing required for the letter. The default is “0” for “Plain Letter”. |
RENTAL_ID | Long |
Description | The rental item’s ID number. |
SITE_ID | Long |
Description | The site’s ID number. |
UNIT_NUMBER | String |
Description | The unit’s number as assigned by the organization. This is not the UnitID. |
VERSION | Integer |
Description | The version number of the letter template that was used to create the letter. Defaults to 1 if there have been no updates. |
WHO_CREATED | String |
Description | The name of the user that created the letter. |
SCHEDULED | DateTime |
Description | The date and time the letter was scheduled to be created. |
MAILED_DATE | DateTime |
Description | The date and time the letter was mailed, if done through centralized mailing. |
ERROR_CODE | Integer |
Description | The error codes numeric value. While this is called an error code, it does not necessarily indicate an error has occured. |
ERROR_CODE_MEANING | String |
Description | The textual value of the ERROR_CODE. While this is called an error code, it does not necessarily indicate an error has occured. |
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’ll need the standard service object, a GetTenantDocList request object, and a GetTenantLetterListV2 response object. We can define and create those like this:
// Create a request and response objects
SWS.WSSoapClient service = new SWS.WSSoapClient();
SWS.getTenantDocList_Request request = new SWS.getTenantDocList_Request();
SWS.getTenantLetterListV2_Response response;
Here is a sample code of the request object:
// GetTenantDocList Request
request.SiteID = 123456;
request.AcctID = 123456;
request.RentalID = 123456;
request.StartDate = DateTime.Today.AddDays(-30);
request.EndDate = DateTime.Today;
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.getTenantLetterListV2(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.
-
October 10, 2012 at 1:51 pmSWS Methods Table of Contents « Centershift Developer eXchange