Archive
siteRuleData Reference
Reference for any method using the siteRuleData object.
Name | Data Type |
---|---|
ruleID | Long |
Description | The rule’s ID number |
ruleName | String |
Description | The name of the rule. |
desc | String |
Description | The description of the rule. |
currSiteValue | String |
Description | The numeric value of the current rule setting. |
siteValueMeaning | String |
Description | The textual value of the current rule setting. |
RULE_VALUES Reference
Reference for methods using the RULE_VALUES object.
Name | DataType |
---|---|
ABLE_INVOKED | String |
Description | “Y” if the invoked icon should show next to the rule in the Org rules form in Store, “N” if it should not. |
ACTIVE | String |
Description | “Y” if the rule is currently “Active”, “N” if it is not. |
CLASS_VALUE | String |
Description | The type of object the rule applies to. |
CONFIG_ID | Decimal |
Description | The rule value’s ID number. |
CREATED_BY | Long |
Description | The Store user’s ID that created the field. |
DEP_RULE_ID | Decimal |
Description | The dependent rule’s ID number. For example, if the Auto-Reconcile Cash rule is set to “True”, there are three child rules that are ignored. |
DEP_VALUE | String |
Description | The parent rule’s name, if applicable. |
DESCRIPTION | String |
Description | A brief description of the item type. |
DISP_ORDER | Integer |
Description | The numeric value of the display order for the end rental rules. |
DISPLAY | String |
Description | The rule’s display values. |
ENTITY_NAME | String |
Description | The org or site name, depending on whether the rule is an Org or Site level rule. |
LOOKUP_IS_VIRTUAL | Boolean |
Description | “True” if the lookup is a virtual lookup, “False” if not. |
LOOKUP_SET | Decimal |
Description | The lookup ID number. |
LOOKUP_USED | Boolean |
Description | “True” if the values are lookups from the cfg_lookups table, “False” if not. |
NEG_ONE_MEANING | String |
Description | The value to display in the default value field if no default value is set. |
PARENT_ID | Long |
Description | The parent ID number of the site or organization owning the rule. |
RULE_CLASS | Decimal |
Description | The numeric value for the category the rule belongs to. |
RULE_ID | Long |
Description | The rule’s ID number. |
RULE_LEVEL | String |
Description | “Org” or “Site” to indicate what level the rule originates. |
RULE_NAME | String |
Description | The rule’s name. |
RULE_TYPE | Integer |
Description | The rule type. |
SITE_VALUE | String |
Description | The numeric value assigned to the rule. |
SITE_VALUE_MEANING | String |
Description | The textual value, if different from the actual value. (I.E., A site has a penalty for vacating without notification. A SITE_VALUE of 4 would indicate that the customer would have a ‘percentage’ penalty of their rent for vacating without notice. The SITE_VALUE would be 4, the SITE_VALUE_MEANING would be ‘% of Refund Penalty’.) |
UPDATED_BY | Long |
Description | The Store user’s ID number that last updated the field. |
VALUE_DATATYPE | Integer |
Description | A numeric value for the data type of the rule. |
VALUE_DEFAULT | String |
Description | The default value of the rule. |
VALUE_DEFAULT_MEANING | String |
Description | A textual description of the default value rule. |
VALUE_IS_REFERENCE | Boolean |
Description | “True” if the value is a reference to another rental item, “False” if not. |
VALUE_LEN | Integer |
Description | The maximum number of characters allowed, if the is a string. |
VALUE_MAX | Decimal |
Description | The maximum amount of the value if the value is numeric. |
VALUE_MIN | Decimal |
Description | The minimum amount of the value if the value is numeric. |
RULE_VALUES | RULE_VALUES |
Description | The rule display. If there is a subset of a rule, this will populate the rule values of that subset. |
SWS GetPartialPayRules Method
Retrieves site rule values that determine if and how partial payments are applied.
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 |
---|---|
AllowsPartialPay | String |
Description | Indicates if the site allows partial payments (“True”) or not (“False”). |
AllowsPartialRentPay | String |
Description | Indicates if the site allows partial payment son delinquent rentals (“True”) or not (“False”). |
PriorityList | ArrayOfString1 |
Description | The order, highest to lowest priority, in which any payment will apply to assessments. |
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 our objects. We’ll need the standard service object, a GetPartialPayRules request object and a GetPartialPayRules response object. We can define and create those like this:
// Create a request and response objects
SWS.WSSoapClient service = new SWS.WSSoapClient();
SWS.GetPartialPayRules_Request request = new SWS.GetPartialPayRules_Request();
SWS.GetPartialPayRules_Response response;
Here’s my sample code of the Request object.
// GetPartialPayRules Request
request.SiteID = 123456;
Finally we can call the method and pass across the login object and the request object to get our partial pay rules. 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.GetPartialPayRules(user_request, request);
}
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 GetEndRentalRules Method
Retrieves site rules pertaining to terminating a rental.
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 |
---|---|
RULE_VALUES | RULE_VALUES |
Description | The object containing all returned information about the end rental rules. |
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 our objects. We’ll need the standard service object, a GetEndRentalRules request object and a RULE_VALUES collection object for the response. We can define and create those like this:
// Create a request and response objects
SWS.WSSoapClient service = new SWS.WSSoapClient();
SWS.GetEndRentalRules_Request request = new SWS.GetEndRentalRules_Request();
SWS.RULE_VALUES[] response;
Here’s my sample code of the Request object.
// GetEndRentalRules Request
request.SiteID = 123456;
Finally we can call the method and pass across the login object and the request object to get our end rental rules. 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.GetEndRentalRules(user_request,request);
}
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.