Archive

Archive for the ‘Rules’ Category

siteRuleData Reference

December 5, 2016 Leave a comment

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

November 11, 2016 Leave a comment

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.
Categories: API General, Lookups, Rules

SWS GetPartialPayRules Method

May 23, 2011 Leave a comment

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.

Categories: API General, Payments, Rules Tags: ,

SWS GetEndRentalRules Method

May 16, 2011 Leave a comment

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.