Changes between Version 41 and Version 42 of Discovery/DiscoveryWebServiceMEDIN


Ignore:
Timestamp:
03/12/09 16:52:52 (10 years ago)
Author:
mpritcha
Comment:

typos & corrected doPresentRequest / Return examples

Legend:

Unmodified
Added
Removed
Modified
  • Discovery/DiscoveryWebServiceMEDIN

    v41 v42  
    9494 
    9595==== Choice of search criteria: <termSearch>, <spatialSearch> and <temporalSearch> ==== 
    96 The <searchCriteria> element acts as a container enabling the selection of one or more of <termSearch>, <spatialSearch> and <temporalSearch>. Only one of each of <termSearch>, <spatialSearch> and <temporalSearch> may be included, but at least one of these three types of search must be supplied. If more than one is specified, the resulting search combines the components in "AND" combination (i.e. metadata records should match the term search AND the spatial search AND the temporal search criteria). 
     96The <searchCriteria> element acts as a container enabling the selection of one or more of <termSearch>, <spatialSearch> and <temporalSearch>. Multiple <termSearch> elements, but only one of each of <spatialSearch> and <temporalSearch> may be included, so that the search has at least one component. If more than one of these three main types is specified, the resulting search combines the components in "AND" combination (i.e. metadata records should match the term search AND the spatial search AND the temporal search criteria). 
    9797 
    9898===== termSearch ===== 
     
    228228Ordering of the result set can optionally be requested by providing an <orderBy> element containing one or more <orderByField>s, each with an optional associated <orderByDirection> (default : descending). Available fields for use as an <orderByField> are listed in the [#orderByFieldsList orderByFieldList]. 
    229229 
    230 In addition, the direction of ordering (ascending or descending) can be specified. If omitted, the default direction is descending. 
    231  
    232230==== Scope of search: <scope> ==== 
    233231The optional <scope> element can be used to restrict the search to onr or more of the supported NDG Data Provider Groups, defined in NDG controlled vocabulary http://vocab.ndg.nerc.ac.uk/list/N010/0. Currently supported values from this vocabulary are these are given in the the [#scopeList scopeList] list accessible via the getList operation. 
     
    238236 
    239237==== !RecordDetail ==== 
    240 The optional <recordDetail> element enables selection of the level of detail included in each result returned in the search result. Values must be one of those available from the [#recordDetailList recordList]. Default is documentId, which simply returns the id of the document corresponding to the result. See [#SearchResults Search Results] section for further explanation of the structures returned in each of these cases. 
     238The optional <recordDetail> element enables selection of the level of detail included in each result returned in the search result. Values must be one of those available from the [#recordDetailList recordDetailList]. Default is documentId, which simply returns the id of the document corresponding to the result. See [#SearchResults Search Results] section for further explanation of the structures returned in each of these cases. 
    241239 
    242240 
     
    320318<m:doPresent xmlns:m="urn:DiscoveryServiceAPI"> 
    321319    <m:documents> 
    322         <m:document>badc.nerc.ac.uk__DIF__dataent_claus.xml</m:document> 
    323         <m:document>ndg.noc.soton.ac.uk__DIF__NOCSDAT160.xml</m:document> 
    324         <m:document>ndg.noc.soton.ac.uk__DIF__NOCSDAT162.xml</m:document> 
    325         <m:document>ndg.noc.soton.ac.uk__DIF__NOCSDAT163.xml</m:document> 
     320        <m:documentId>badc.nerc.ac.uk__DIF__dataent_claus.xml</m:documentId> 
    326321    </m:documents> 
    327322    <m:format>DIF_v9.4</m:format> 
     
    335330    <statusMessage>Success</statusMessage> 
    336331    <documents> 
    337         <document>&lt;DIF xmlns="http://gcmd.gsfc.nasa.gov/Aboutus/xml/dif/"  
     332        <documentFull> 
     333           <documentId>badc.nerc.ac.uk__DIF__dataent_claus.xml</documentId> 
     334           <title>Cloud Archive User Service data (CLAUS)</title> 
     335           <abstract>Global Brightness Temperature imagery from the  
     336Cloud Archive User Service project. This project produced a long  
     337time-series of global thermal infra-red imagery of the Earth using  
     338data from operational meteorological satellites, which was used in  
     339validating atmospheric General Circulation Models</abstract> 
     340           <document>&lt;DIF xmlns="http://gcmd.gsfc.nasa.gov/Aboutus/xml/dif/"  
    338341xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"> 
    339342&lt;Entry_ID>badc.nerc.ac.uk:DIF:dataent_claus&lt;/Entry_ID> 
    340  (...) &lt;/DIF></document> 
    341         <document>&lt;DIF xmlns="http://gcmd.gsfc.nasa.gov/Aboutus/xml/dif/" 
    342  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"> 
    343 &lt;Entry_ID>ndg.noc.soton.ac.uk__DIF__NOCSDAT160&lt;/Entry_ID>  
    344 (...) &lt;/DIF></document> 
    345         <document>&lt;DIF xmlns="http://gcmd.gsfc.nasa.gov/Aboutus/xml/dif/"  
    346 xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"> 
    347 &lt;Entry_ID>ndg.noc.soton.ac.uk__DIF__NOCSDAT162&lt;/Entry_ID> 
    348  (...) &lt;/DIF></document> 
    349         <document>&lt;DIF xmlns="http://gcmd.gsfc.nasa.gov/Aboutus/xml/dif/" 
    350  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"> 
    351 &lt;Entry_ID>ndg.noc.soton.ac.uk__DIF__NOCSDAT163&lt;/EntryID>  
    352 (...) &lt;/DIF></document> 
     343 (.. truncated! ..) &lt;/DIF></document> 
     344        </documentFull> 
    353345    </documents> 
    354346</doPresentReturn> 
     
    426418   Return metadata records having one or more spatial coverages that are entirely within the search bounding box. 
    427419 
    428 > Should we restrict this to ("...having '''all''' spatial coverages that entirely within the..." ?) 
     420> Should we restrict this to ("...having '''all''' spatial coverages that entirely within the..." ?). No : above definition is more intuitive. 
    429421 
    430422=== spatialReferenceSystemList ===