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 -->
|