You use the search service to query the data contained in the Bank Wizard Database Table Files (DTF). You must supply the country you want to search and between 1 and 3 search parameters.
The search service always returns the standard branch data and the SWIFT and SEPA data, if you are licensed for this cross border data. You can limit the number of matches returned for each type of data to any number less than 100. If you leave the Result Limit blank, Bank Wizard returns 100 matches for each type of data, that is 100 branch data matches and 100 SWIFT and SEPA data matches.
The Bank Wizard web service response contains the number of matches (<matches>) and then includes a results section for each branch that matched the search (<resultSet>). The result set includes both the data and the metadata elements:
This example code searches the United Kingdom DTFs for Rugby, Nat and West, and returns a maximum of 10 matches for each type of data.
|
SearchRequest searchRequest = new SearchRequest(); /* Set information into the request */ GenericHeader client = new GenericHeader(); client.setUserID("BANKWIZARD_WEBCLIENT"); client.setWSDLVersion("1.0"); searchRequest.setClientInformation(client);
searchRequest.setISOCountryCode("GB"); searchRequest.setResultsLimit(new BigInteger("10")); searchRequest.setSearch1("Rugby"); searchRequest.setSearch2("Nat"); searchRequest.setSearch3("West"); /* Check for a response */ SearchResponse searchResponse = port.searchDataRequest(searchRequest); if (searchResponse != null) { /* If the call was successful, display data */ System.out.println("Number of matches = " +searchResponse.getMatches()); /* Get an array of ResultSets */ SearchResult[] results = searchResponse.getResultSet(); if (results != null) { for(int i=0;i<results.length;i++){ SearchResult result = results[i]; DataElement[] elements = result.getData(); for(int x=0;x<elements.length;x++){ /* Apply same principle for result.getMetaData()*/ DataElement element = elements[x]; System.out.println("Element ID = " +element.getID()); if(element.getDescription().length() >0){ System.out.println("Element Description = " +element.getDescription()); } System.out.println("Element Value = " +element.getValue()); } } } }else { /* If the call was NOT successful, display an error message */ System.out.println("No search data retrieved"); } |
Request
<soapenv:Body>
<SearchRequest xmlns="urn:experian/BANKWIZARD/soapservice/types">
<ClientInformation>
<UserID>BANKWIZARD_WEBCLIENT</UserID>
<WSDLVersion>1.0</WSDLVersion>
</ClientInformation>
<Search1>Rugby</Search1>
<Search2>Nat</Search2>
<Search3>West</Search3>
<ISOCountryCode>GB</ISOCountryCode>
<ResultsLimit>10</ResultsLimit>
</SearchRequest>
</soapenv:Body>
Response
<soapenv:Body>
<SearchResponse xmlns="urn:experian/BANKWIZARD/soapservice/types">
<matches>2</matches>
<resultSet>
<ID>1</ID>
<Data ID="1001">
<Description></Description>
<Value>050740</Value>
</Data>
<Data ID="1002">
<Description></Description>
<Value>YORKGB21</Value>
</Data>
<Data ID="1003">
<Description></Description>
<Value>740</Value>
</Data>
...
<Data ID="1">
<Description>Identifier1:1001</Description>
<Value>050740</Value>
</Data>
<MetaData ID="1006">
<Description>Bank name</Description>
<Value>YORKSHIRE BANK</Value>
</MetaData>
<MetaData ID="1005">
<Description>Branch name</Description>
<Value>RUGBY</Value>
</MetaData>
...
<MetaData ID="1017">
<Description>Redirection to</Description>
<Value></Value>
</MetaData>
</resultSet>
<conditions/>
</SearchResponse>
</soapenv:Body>
Response with no matches
<soapenv:Body>
<SearchResponse xmlns="urn:experian/BANKWIZARD/soapservice/types">
<matches>0</matches>
<conditions/>
</SearchResponse>
</soapenv:Body>
See also