Search Service

lexi.hafften Mon, 11/25/2019 - 14:51

field_block:node:guide:title

Search Service

field_block:node:guide:body

The eCRV Web Services application offers the Search service to return data related to your local government organization. The request returns a list of eCRV IDs that match the search criteria provided in the request.

A unique Search Service is available for all four versions (types of data) available in eCRV:

Original
County
Muni (Municipal, or City)
State

A user is only able to modify eCRVs for their local government agency.

field_block:node:guide:field_paragraph

URLs [+]

The URLs needed for this service are:

Production Region

WSDL: https://www.mndor.state.mn.us/ecrv_ws_c5/services/SearchService.wsdl
End Point: https://www.mndor.state.mn.us/ecrv_ws_c5/services/SearchService

Test Region

WSDL: https://www.dortest.mdor.state.mn.us/ecrv_ws_c5/services/SearchService.wsdl
End Point: https://www.dortest.mdor.state.mn.us/ecrv_ws_c5/services/SearchService

Input [+]

The inputs required for each request type vary based on the information available for each version.

County and Muni (City)

In addition to other search criteria below, the request type must be specified as:

CountySearchRequest type CountySearchRequest
MuniSearchRequest type MuniSearchRequest

Field	Type	Notes
CurrentWorkflowStepID	Int
CurrentWorkflowStepString	String
TagId	Int
TagString	String
PropertyTypeGroup	String	See schema ecrvBaseTypes
PropertyType	String	See schema ecrvBaseTypes
StudyYear	gYear
ParcelId	String
AuditorId	String

Original

In addition to other search criteria below, the request type must be specified as:

OriginalSearchRequest type OriginalSearchRequest

Field	Required	Type	Notes
ParcelId		String
CountyCode	Yes	String	Enum (two-digit County code)
PropertyUseCodeCodeLevel1		String	See schema ecrvBaseTypes
PropertyUseCodeCodeLevel2		String	See schema ecrvBaseTypes
PropertyUseCodeCodeLevel3		String	See schema ecrvBaseTypes
AcceptedDate		Date	gYearMonth
SaleDate		Date	gYearMonth

State

In addition to other search criteria below, the request type must be specified as:

StateSearchRequest type StateSearchRequest

Field	Required	Type	Notes
PropertyTypeGroup		String	See schema ecrvBaseTypes
PropertyType		String	See schema ecrvBaseTypes
StudyYear		gYear
ParcelId		String
CountyCode	Required	String	Enum (two-digit County code)

Output [+]

The output from the Search Service returns the list of eCRV IDs with matching data on the version requested. The responses are specified as:

CountySearchResponse type CountySearchResponse
MuniSearchResponse type MuniSearchResponse
StateSearchResponse type StateSearchResponse
OriginalSearchResponse type OriginalSearchResponse

For all request types, the response includes:

Field	Return Values	Type	Parent
resultCount	Yes	Int
CrvIds	Optional
CrvId	Unbounded	Int	CrvIds
RequestErrors	Optional
RequestError	Unbounded		RequestErrors
ErrorString	Optional	String	RequestErrors

Sample Requests and Responses [+]

Sample Requests

County version search based on Workflow Step and Property Type Group:

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:sear="http://schemas.ecrv.mdor.state.mn.us/searchService">
<soapenv:Header/>
<soapenv:Body>
<sear:CountySearchRequest>

<sear:CurrentWorkflowStepId>2978</sear:CurrentWorkflowStepId>

<sear:PropertyTypeGroup>03</sear:PropertyTypeGroup>
</sear:CountySearchRequest>
</soapenv:Body>
</soapenv:Envelope>

Original version search based on Property Use:

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:sear="http://schemas.ecrv.mdor.state.mn.us/searchService">
<soapenv:Header/>
<soapenv:Body>
<sear:OriginalSearchRequest>
<sear:CountyCode>62</sear:CountyCode>

<sear:PropertyUseCodeCodeLevel1>RESID</sear:PropertyUseCodeCodeLevel1>

<sear:PropertyUseCodeCodeLevel2>STUDENTHSG</sear:PropertyUseCodeCodeLevel2>

<sear:PropertyUseCodeCodeLevel3>STUDENTAPT</sear:PropertyUseCodeCodeLevel3>

</sear:OriginalSearchRequest>
</soapenv:Body>
</soapenv:Envelope>

Sample Responses

Partial successful response returning results:

<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/">
<SOAP-ENV:Header>
<wsse:Security SOAP-ENV:mustUnderstand="1" xmlns:wsse="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd">
<wsu:Timestamp wsu:Id="XWSSGID-15763414901991185817290" xmlns:wsu="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd">
<wsu:Created>2019-12-31T14:43:50.284Z</wsu:Created>
<wsu:Expires>2019-12-31T14:48:50.284Z</wsu:Expires>
</wsu:Timestamp>
</wsse:Security>
</SOAP-ENV:Header> <SOAP-ENV:Body>
<ns2:CountySearchResponse xmlns:ns2="http://schemas.ecrv.mdor.state.mn.us/searchService">
<ns2:resultCount>314</ns2:resultCount>
<ns2:CrvIds>
<ns2:CrvId>123456</ns2:CrvId>
<ns2:CrvId>234567</ns2:CrvId>
<ns2:CrvId>345678</ns2:CrvId>
<ns2:CrvId>456789</ns2:CrvId>
       .
       .
       .
</ns2:CrvIds>
<ns2:RequestErrors/>
</ns2:CountySearchResponse>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>

Failed response caused by an incorrect search parameter:

<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/">
<SOAP-ENV:Header>
<wsse:Security SOAP-ENV:mustUnderstand="1" xmlns:wsse="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd">
<wsu:Timestamp wsu:Id="XWSSGID-15763414901991185817290" xmlns:wsu="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd">
<wsu:Created>2019-12-31T14:43:50.284Z</wsu:Created>
<wsu:Expires>2019-12-31T14:48:50.284Z</wsu:Expires>
</wsu:Timestamp>
</wsse:Security>
</SOAP-ENV:Header>
<SOAP-ENV:Body>
<SOAP-ENV:Fault>
<faultcode>SOAP-ENV:Client</faultcode>
<faultstring xml:lang="en">Validation error</faultstring>
<detail>
<spring-ws:ValidationError xmlns:spring-ws="http://springframework.org/spring-ws">cvc-enumeration-valid: Value 'o3' is not facet-valid with respect to enumeration '[01, 02, 03, 04, 05, 06, 07, 08, 09, 10, 11, 12, 13, 14, 15]'. It must be a value from the enumeration.</spring-ws:ValidationError>
<spring-ws:ValidationError xmlns:spring-ws="http://springframework.org/spring-ws">cvc-type.3.1.3: The value 'o3' of element 'sear:PropertyTypeGroup' is not valid.</spring-ws:ValidationError>
</detail>
</SOAP-ENV:Fault>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>

Search Service

Guide Menu

Search Service