TitleSCAN Web Arb Definitions provide information about the Arbitrary Numbers that have been specified in the plant. Of course, some TitleSCAN Web sites may not use arbitrary numbers or, if they do, they may elect not to enter Arb Definitions due to the amount of data involved.
The parameters listed below will be used by both DAO Web Services and DAO Page Requests. For Web Services the Parameters will be submitted as part of the function call and will need to be passed in the sequence shown in this Parameters table. Note that in the Visual Studio development environment the function call arguments will show in a pop-up help window as the programmer types in the software code. For a Page Request the Parameter's name will be part of the submitted query followed by an equal sign and the desired value (see the example later in this section).
When you search for a specific arbitrary number, this is considered an exact match search. Only one arbitrary definition can be returned, since all numbers on file must be unique. You can also perform a partial match search for all arbitrary numbers that begin with a specified character string. You do this by appending an asterisk character ("*") to the string, which indicates to TitleSCAN Web that you want to perform a partial match search or what is referred to in TitleSCAN Web as a wildcard arb search.
Obviously, the partial match search is useful only in cases in which the arbitrary number is generally a left to right number with segments that translate into map units in some fashion. Fortunately, most of the arb number schemes in use are structured in this manner with many that directly translate into section, township, and range terms with the rightmost portions specifying quarters or smaller followed by a unique parcel number within that area specified.
NOTE:
Partial
match searches are specified by the appearance of an asterisk character
in the last position of the arbitrary number specified. For
example, a search for 2N6E0210*
will return all arbitrary number definitions beginning with the characters
2N6E0210.
|
Parameter |
Value(s) |
|
CountyCode |
County code |
|
ArbNumber |
Arb number for which definitions are to be returned.
If the
last character of the arbitrary number is an asterisk character ("*"),
this specifies a wildcard search, and the definitions for all arb numbers
beginning with the characters specified (prior to the asterisk) are returned.
|
The searches below specify a county code of L for Livingston County and an arbitrary number of 2N6E021001. Since the search was for a specific arb number, only one is returned.
If you perform the same search and request a partial match search using 2N6E0210*, you will retrieve 35 arbitrary numbers, all of which begin with the characters 2N6E0210. Those search results are not shown below due to their length, although you can see them by performing a manual search on the TitleSCAN Web Demonstration Site.
Referring back to our list of functions in the section titled Primary DAO Functions, the web service call is 'GetArbDefinitions' and that is shown in the first example below. In the second example, the DAO Page request has 'QueryName=ArbDefinition' immediately following the question mark in the query statement.
NOTE:
'DAODataService' in the above example
is the name given to a web reference. Please
refer to the section Using DAO Web
Services which describes creating the web reference. Also
note that the Token parameter above will need to be obtained via a call
to the 'DAOLoginService' (see
the User Authentication Parameters
section).
http://tsweb.titlescan.com/Query.aspx?QueryName=ArbDefinition&UserName=tsweb&UserCompany=tss&UserPassword=anywhere&CountyCode=L&ArbNumber=2N6E021001
IMPORTANT:
The UserName,
UserCompany, and UserPassword parameters shown in the sample query above
are example values only and will not work. If
you are developing software that uses the TitleSCAN Direct Access Option
and wish to test that software using the TitleSCAN Web demonstration site
at http://tsweb.titlescan.com, contact TitleSCAN Systems to obtain an
account on that system. When
you obtain the account, you will be given UserName, UserCompany, and UserPassword
values. Substitute
those values in the Query string above.
The following is the XML result set. The DAO Web Service request or the DAO Page Request will return this same result set.
