OASIS Mailing List ArchivesView the OASIS mailing list archive below
or browse/search using MarkMail.


Help: OASIS Mailing Lists Help | MarkMail Help

search-ws message

[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]

Subject: RE: [search-ws] Explain model

Here’s my cut at it.


Every SRU database has an associated Explain record.  The standard requires that this record be retrievable as the response of an HTTP GET at the base URL for the database as well as at the base URL with an “operation” parameter of “explain”.  Explain record may be gotten from other sources as well.  An SRU client may retrieve this record which …


The rest can stay the same.


Thanks, Ray!




From: Ray Denenberg, Library of Congress [mailto:rden@loc.gov]
Sent: Friday, January 22, 2010 2:15 PM
Subject: [search-ws] Explain model


As I mentioned at the call last week, the SRU document needs an "Explain Model" in the model section.   I had drafted one, and thought I had put it in the last draft but somehow it didn't get in and I've lost it. So I've re-drafted it.  It needs more work so all of you, feel free to add to it.  However, the only purpose I see for it is to provide context for the numerous places within the document where Explain is mentioned.  So something like the following should be fairly close to what we need, I think:




Explain Model

Every SRU server provides an Explain file, which contains information about the server’s capabilities. An SRU client may retrieve this file which can then be used to self-configure and provide an appopriate interface to the user.


The Explain file provides such details as  query types supported, CQL context sets - and for each context set indexes supported;  diagnostic sets, record schemas, sorting capabilities, specification of defaults  (need more here)……. . The explain file also includes sample queries, conditions of use (e.g. mandatory display of copyright, syndication rights) (need more here).



[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]