1 Reply by Jonathan Cooper (edited by Jonathan Cooper 17-08-2009 10:35:15)

  • Jonathan Cooper
  • Veteran
  • Offline
  • Registered: 12-05-2006
  • Posts: 64

Re: New version (3.3) of web services published

Hi,

this is to let you know we've published a new release (3.3) of the web services.

Please see http://data.nbn.org.uk/library/webservices/versions.jsp and http://data.nbn.org.uk/library/webservi … tTools.jsp for details and downloads.

One important point to mention is that we now have a release strategy where we will support deprecated web service versions for 12 months.

Here are the features we've managed to fit into this release:

- a multiple taxon version key filter to restrict the response from the one site (species lists and species data) and the species list requests

- flexible species designation filtering and a new species designation discovery web service

- no more Exceptions when no records are found, now its part of the response

- the DatasetSummaryQuery now has a date stamp so you can find out when a dataset was last updated

- a Map Only option is available in one site data queries if you don't need the data - but the list of data providers is still returned.

(see #4 below for info. about how this might affect existing apps)

Cheers, Jon

2 Reply by Jonathan Cooper

  • Jonathan Cooper
  • Veteran
  • Offline
  • Registered: 12-05-2006
  • Posts: 64

Re: New version (3.3) of web services published

Hi,

I've had to disable the new web services until Thursday 4th August at the latest.  This is because we need to re-configure the web-app that supports them to prevent any chance of it conflicting with the old web services.  This was hard to test before publication, and because of other commitments we've just disabled them until Thursday.

Once up and running on Thursday all will be fine.

Sorry about that, Jon

3 Reply by Jonathan Cooper

  • Jonathan Cooper
  • Veteran
  • Offline
  • Registered: 12-05-2006
  • Posts: 64

Re: New version (3.3) of web services published

Latest version of the web services are now available.  There will be an announcement on the main nbn website soon too.

Cheers, Jon

4 Reply by Jonathan Cooper

  • Jonathan Cooper
  • Veteran
  • Offline
  • Registered: 12-05-2006
  • Posts: 64

Re: New version (3.3) of web services published

Hi,

there are 3 changes to the web services that may affect you as you upgrade your existing application.  Obviously, the changes you need to make depend on what web services functionality you use.  Here are those changes that may affect you:

•    No records found is no longer a SOAPRequestException: if you make use of this you will now have to check the RecordsFound boolean in the response.  This affects the species group, species list and species data requests, as shown in the library (eg see how the the RecordsFound attribute appears in the GatewayData element shown here http://data.nbn.org.uk/library/webservi … eData3.jsp
•    The single species key filter is now a multiple species key filter: if you use a single species key filter in a one site data or a species list request you can still filter by just one key.  However the filter’s name has changed to TaxonVersionKeys rather than TaxonVersionKey (eg here's how it looks in OneSiteDataRequest http://data.nbn.org.uk/library/webservi … eData2.jsp
•    Species designations are no longer hard coded into the schema as an enumeration:  it has been replaced with a new web service to supply the designation filters you can use in requests.  It is documented here: http://data.nbn.org.uk/library/webservi … ations.jsp.  This will be a reasonably significant change if you were previously using the hard coded designations, since you now need to use this web service to present your user with designation choices.

Cheers, Jon