MarLIN Example NBN Web Services

Get Taxonomy

Enter all or part of a scientific name in the box below to return a list of matching species.

Click here to view the request to the server.

Click here to view the returned XML file.

timeout = 500; $client->response_timeout = 500; $err = $client->getError(); if ($err) { echo '

Constructor error

' . $err . '

'; } $query1=' '.$_POST["spp"].' '; $result = $client->call("GetTaxonReportingCategoryName", $query1); $debug = $client->getDebug(); print '

Results

'; //print $result; //the xml returned from the gateway appears to be missing the xml header which upsets PHP - so fix it first $fle=$client->response; $fle=str_replace("nbntq:","",$fle); //$obj = simplexml_load_string(fixupxml($client->response)); $obj = simplexml_load_string(fixupxml($fle)); print ("

"); echo ""; echo ""; //$txn="nbntq:Taxon"; foreach ($obj->Taxon as $Taxon) { echo ""; } echo "

Category	Scientific name	Taxon Version Key	Authority
". ucfirst($Taxon->TaxonReportingCategory) ."	". $Taxon->TaxonName. "	". $Taxon['taxonVersionKey'] ."	". $Taxon->Authority. "

"; print ("

"); print '

Request to Server

'; echo ''.$client->request.''; print "

Back to the top

"; //Debugging code if(isset($_GET["debug"])){ print '

Fixed up XML

'; echo ''.fixupxml($client->response).''; print '

Response

'; echo ''.$client->response.''; echo '

Debug

' . $debug . '

'; } echo "

The Returned XML File

";
		print htmlspecialchars(fixupxml($client->response));
		echo "

"; } ?>

Back to the top

Source code for this page

/*
 *    NBN Gateway SOAP Client Sample: 
 *    Author: James Perrins, 
 *    exeGesIS SDM
 *    3rd March 2006
 */
//pass in details of any proxy server
$proxyhost = isset($_POST['proxyhost']) ? $_POST['proxyhost'] : '';
$proxyport = isset($_POST['proxyport']) ? $_POST['proxyport'] : '';
$proxyusername = isset($_POST['proxyusername']) ? $_POST['proxyusername'] : '';
$proxypassword = isset($_POST['proxypassword']) ? $_POST['proxypassword'] : '';

$client = new soapclient("http://212.219.37.104/NBNWebServices/ws/webservice", 'true', $proxyhost, $proxyport, $proxyusername, $proxypassword);
// Set timeouts, nusoap default is 30 
$client->timeout = 500; 
$client->response_timeout = 500; 
$err = $client->getError();
if ($err) {
	echo '<h2>Constructor error</h2><pre>' . $err . '</pre>';
}
$query1 = '<TaxonomySearchRequest xmlns="http://webservices.searchnbn.net/taxonomyQuery">
		<SpeciesName xsi:type="q1:TaxonName">Mytilus</SpeciesName>
	   </TaxonomySearchRequest>';

$result = $client->call("GetTaxonomySearch", $query1);
$debug = $client->getDebug();

print '<h2>Results</h2>';

print $result;

print '<h2>Request</h2>';
echo '<xmp>'.$client->request.'</xmp>';
print ("<hr>");
print '<h2>Response</h2>';
echo '<xmp>'.$client->response.'</xmp>';
echo '<hr><h2>Debug</h2><pre>' . $debug . '</pre><hr>';

echo "<h2>The Returned XML File</h2><pre>";
print htmlspecialchars(fixupxml($client->response));
echo "</pre>";