Archive
SWS GetSiteSMSFromAddr Method
This method is used to get the current “SMS From Address” being used for the specified site.
Parameters
Name | DataType | Is Required |
---|---|---|
SiteID | Long | Required |
Description | The site’s ID number. This can be found using the GetSiteList method. |
Returned Parameters
Name | DataType |
---|---|
Response | String |
Description | “SUCCESS” indicates that the query was successful, or “FAILURE” if not. |
ID | String |
Description | The site’s ID number. This echoes the requested site ID. |
STATUS | String |
Description | The current SMS From Address. |
Example
As with every method we need to pass in credentials. We do this with the LookupUser request object.
We’ll assume you’ve got a web reference, let’s name it SWS, in your Visual Studio project. At this point we only need to create our SiteID request object and a GetUpdateSMS response 2 object. We can define and create those objects like this:
// Create the request and response objects SWS.WSSoapClient service = new SWS.WSSoapClient(); SWS.SiteID_Request siteID_rqst = new SWS.SiteID_Request(); SWS.GetUpdateSMS_Response2 response = new SWS.GetUpdateSMS_Response2 ();
Now we set up the parameters for our request.
// SiteID Request- this is a required parameter siteID_rqst.SiteID = 123456;
We can then call the method and pass across the login object and the request objects to get our resultant dataset. 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.GetSiteSMSFromAddr (user_rqst, siteID_rqst);} catch (Exception ex){ MessageBox.Show(ex.Message);}
Note that if something goes wrong the service will respond with an exception. You’ll want to take a look at that message returned in that exception so it can be debugged.
For a full list of methods see SWS Methods.
SWS GetOrgSMSStatus Method
This method is used to get the current SMS Messaging Status for the organization.
Parameters
Name | DataType | Is Required |
---|---|---|
None | ||
Description | This is based on your credentials in LookUpUser_Request, so does not require any additional parameters. |
Returned Parameters
Name | DataType |
---|---|
Response | String |
Description | “SUCCESS” indicates that the query was successful, or “FAILURE” if not. |
ID | String |
Description | The organization’s ID number. This echoes the ID of the organization for which the credentials apply. |
STATUS | String |
Description | Indicates the current SMS messaging status. Available values:
|
Example
As with every method we need to pass in credentials. We do this with the LookupUser request object.
We’ll assume you’ve got a web reference, let’s name it SWS, in your Visual Studio project. At this point we only need to create a GetUpdateSMS response 2 object.
// Create the request and response objects SWS.WSSoapClient service = new SWS.WSSoapClient(); SWS.GetUpdateSMS_Response2 response = new SWS.GetUpdateSMS_Response2 ();
We can then call the method and pass across the login object and the request objects to get our resultant dataset. 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.GetOrgSMSStatus (user_rqst);} catch (Exception ex){ MessageBox.Show(ex.Message);}
Note that if something goes wrong the service will respond with an exception. You’ll want to take a look at that message returned in that exception so it can be debugged.
For a full list of methods see SWS Methods.
SWS PhoneSMSBlacklistStatus Method
This call may be used to GET or SET the SMS blacklist status for a PhoneID record for specified SiteID. This applies only to the phone number of the specified PhoneID. PhoneID must be supplied in the call. Only records having RENTAL_STATUS of “CURRENT_OCCUPIED”, “DELINQUENT”, “IN_PROCESS”, “RESERVED” or “SOFT_RESERVED” will be reported or affected.
Parameters
Name | DataType | Is Required |
---|---|---|
SiteID | Long | Required |
Description | The site’s ID number. This can be found using the GetSiteList method. | |
Get_Set | String | Optional |
Description | Accepted values are “GET” or “SET”, with “GET” being the default value. | |
RentalID | Long | Required* |
Description | The rental item’s ID number. This is returned when using the MakeReservation method or can be searched for using the SearchBy method. * Either the RentalID or PhoneID is required. |
|
PhoneID | Long | Required* |
Description | The ID number of the phone. This can be found using the GetContacts method. * Either the RentalID or PhoneID is required. |
|
Status | String | Required* |
Description | Indicates if you are enabling SMS on an account (“SET”) or just getting the current status (“GET”). * This value is required only for “SET”, otherwise it is ignored. |
Returned Parameters
Name | DataType |
---|---|
Response | String |
Description | “SUCCESS” indicates that the query was successful, or “FAILURE” if not. |
PHONE_ID | Long |
Description | The ID number of the rental. |
STATUS | String |
Description | The current SMS enabled status of the Rental/Phone combination. If using “GET”, this is the current status. If using “SET”, returns the status you just added. |
Example
As with every method we need to pass in credentials. We do this with the LookupUser request object.
We’ll assume you’ve got a web reference, let’s name it SWS, in your Visual Studio project. At this point we need to create our objects. We’ll need the standard service object, a SiteID request object, an GetUpdatePhoneID request object, and a GetUpdateSMS response 2 object. We can define and create those objects like this:
// Create the request and response objects SWS.WSSoapClient service = new SWS.WSSoapClient(); SWS.SiteID_Request siteID_rqst = new SWS.SiteID_Request(); SWS.GetUpdatePhoneID_Request SMSphone_rqst = new SWS.GetUpdatePhoneID_Request(); SWS.GetUpdateSMS_Response2 response = new SWS.GetUpdateSMS_Response2 ();
Now we set up the parameters for our request.
// SiteID Request- this is a required parameter siteID_rqst.SiteID = 123456; // Get_Set Request // this is an optional parameter, “GET” is the default value SMSphone.Get_Set = “GET” // PhoneID Request // this is a required parameter SMSphone_rqst.PhoneIDs(0).PhoneID = 345678;
Finally we can call the method and pass across the login object and the request objects to get our resultant dataset. 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.PhoneSMSBlacklistStatus(user_rqst, siteID_rqst, SMSphone_rqst);} catch (Exception ex){MessageBox.Show(ex.Message);}
Note that if something goes wrong the service will respond with an exception. You’ll want to take a look at that message returned in that exception so it can be debugged.
For a full list of methods see SWS Methods.
SWS PhoneSMSEnableStatus Method
This call may be used to GET or SET the SMS enabled status for RentalID/PhoneID record combinations for specified SiteID. This will update only one contact on the specified RentalID. A RentalID, PhoneID or both must be supplied in the parameters. Only records having RENTAL_STATUS of “CURRENT_OCCUPIED”, “DELINQUENT”, “IN_PROCESS”, “RESERVED” or “SOFT_RESERVED” will be reported or affected.
Parameters
Name | DataType | Is Required |
---|---|---|
SiteId | Long | Required |
Description | The site’s ID number. This can be found using the GetSiteList method. | |
Get_Set | String | Optional |
Description | Accepted values are “GET” or “SET”, with “GET” being the default value. | |
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. * Either the RentalID or PhoneID is required. |
|
PhoneID | Long | Optional* |
Description | The ID number of the phone. This can be found using the GetContacts method. * Either the RentalID or PhoneID is required. |
|
Status | String | Required* |
Description | Indicates if you are enabling SMS on an account (“SET”) or just getting the current status (“GET”). * This value is required only for “SET”, otherwise it is ignored. |
Returned Parameters
Name | DataType |
---|---|
Response | String |
Description | “SUCCESS” indicates that the query was successful, or “FAILURE” if not. |
RENTAL_ID | Long |
Description | The ID number of the rental. |
PHONE_ID | Long |
Description | The phone’s ID number. |
Status | String |
Description | The current SMS enabled status of the Rental/Phone combination. If using “GET”, this is the current status. If using “SET”, returns the status you just added. |
Example
As with every method we need to pass in credentials. We do this with the LookupUser request object.
We’ll assume you’ve got a web reference, let’s name it SWS, in your Visual Studio project. At this point we need to create our objects. We’ll need the standard service object, a SiteID request object, an GetUpdatePhoneID request object, and a GetUpdateSMS response object. We can define and create those objects like this:
// Create the request and response objects SWS.WSSoapClient service = new SWS.WSSoapClient(); SWS.SiteID_Request siteID_rqst = new SWS.SiteID_Request(); SWS.GetUpdatePhoneID_Request SMSphone_rqst = new SWS.GetUpdatePhoneID_Request(); SWS.GetUpdateSMS_Response response = new SWS.GetUpdateSMS_Response ();
Now we set up the parameters for our request.
// SiteID Request- this is a required parameter siteID_rqst.SiteID = 123456; // Get_Set Request // this is an optional parameter, “GET” is the default valueSMSphone.Get_Set = “GET” // PhoneID Request // these are required parameters, you must set one or both in each elementSMSphone_rqst.PhoneIDs(0).RentalID = 234567; SMSphone_rqst.PhoneIDs(0).PhoneID = 345678;
Finally we can call the method and pass across the login object and the request objects to get our resultant dataset. 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.PhoneSMSEnabledStatus(user_rqst, siteID_rqst, SMSphone_rqst);} catch (Exception ex){ MessageBox.Show(ex.Message);}
Note that if something goes wrong the service will respond with an exception. You’ll want to take a look at that message returned in that exception so it can be debugged.
For a full list of methods see SWS Methods.