Project

General

Profile

1 153 jones
<!--
2
  * pathquery.dtd
3
  *
4
  *      Authors: Matt Jones
5
  * Organization: National Center for Ecological Analysis and Synthesis
6
  *    Copyright: 2000 Regents of the University of California and the
7
  *               National Center for Ecological Analysis and Synthesis
8
  *  For Details: http://www.nceas.ucsb.edu/
9
  *      Created: 13 June 2000
10
  *    File Info: '$Id$'
11
  *
12
  * This DTD describes the structure and content of XML documents used
13
  * to represent, store, and exchange a simple path-based query expression.
14
  * This syntax represents a small subset of the capabilities of the XPath
15
  * language (http://www.w3.org/TR/xpath), and is intended as a simple
16
  * query language for the metadata catalog database (mcdb).  It is
17
  * intended that all expressions in this language can be mapped directly
18
  * into XPath syntax, but not all Xpath expressions can be mapped into this
19
  * syntax.
20
  *
21
  * Although ideally we would implement the query language as either the full
22
  * XPath language or as one of the emerging XML query languages (like
23
  * XML-QL or XQL), in practice this would be an involved undertaking that
24
  * doesn't necessarily have high payoffs.  But we will revisit this issue and
25
  * determine later whether these full-featured technologies are warranted
26
  * after we have some experience with a simpler implementation such as this.
27
-->
28
29
<!-- Overall query container -->
30 756 jones
<!ELEMENT pathquery (meta_file_id*, querytitle*, returndoctype*,
31
                     filterdoctype*, returnfield*,
32 535 jones
                     owner*, site*, querygroup)>
33 153 jones
34
<!-- The version of this query specification -->
35 756 jones
<!ATTLIST pathquery version CDATA #FIXED "1.2">
36 153 jones
37
<!-- a unique identifier for this query document -->
38
<!ELEMENT meta_file_id (#PCDATA)>
39
40
<!-- a descriptive title for this query document -->
41
<!ELEMENT querytitle (#PCDATA)>
42
43 756 jones
<!-- optional doctype returned spec - only documents with this type returned -->
44
<!-- hits are looked up using package links to this doctype -->
45 173 jones
<!ELEMENT returndoctype (#PCDATA)>
46
47 756 jones
<!-- optional doctype filter - only documents with this type are searched -->
48
<!ELEMENT filterdoctype (#PCDATA)>
49
50 535 jones
<!-- optional name of an xml node to be returned in the resultset -->
51 403 berkley
<!ELEMENT returnfield (#PCDATA)>
52
53 535 jones
<!-- optional name of the owner of the documents to be returned -->
54
<!-- multiple owner fields are ORed together in the query -->
55
<!ELEMENT owner (#PCDATA)>
56
57
<!-- optional name of the site/server of the documents to be returned -->
58
<!-- multiple site fields are ORed together in the query -->
59
<!ELEMENT site (#PCDATA)>
60
61 153 jones
<!-- A group of related query terms -->
62
<!ELEMENT querygroup ( (queryterm|querygroup)+ )>
63
64
<!-- the boolean expression used to combine the query terms in this group -->
65 179 jones
<!ATTLIST querygroup operator (INTERSECT|UNION) #REQUIRED>
66 153 jones
67
<!-- a query term is the atomic unit of a query that can be translated
68
     to a single SELECT statement -->
69
<!ELEMENT queryterm (value, pathexpr?)>
70
71
<!-- a boolean flag indicating whether matches should be case-sensitive or
72 156 jones
     case-independent for this queryterm, one of: true|false
73
     and searchmode is the type of match to perform against the text value -->
74
<!ATTLIST queryterm casesensitive (true|false) #REQUIRED
75
                    searchmode
76
        (contains|starts-with|ends-with|matches-exactly) #REQUIRED>
77 153 jones
78
<!-- the text value for which we are searching -->
79
<!ELEMENT value (#PCDATA)>
80
81
<!-- the path to the TEXT node used to constrain the query -->
82
<!ELEMENT pathexpr (#PCDATA)>
83
84
<!-- End of file -->