From: Marc Cromme Date: Wed, 21 Jun 2006 13:32:33 +0000 (+0000) Subject: added section on idxpath query model X-Git-Tag: before.bug.529~15 X-Git-Url: http://jsfdemo.indexdata.com/cgi-bin?a=commitdiff_plain;h=8d4fd86574ab7de92b916c99073550348eb778f1;p=idzebra-moved-to-github.git added section on idxpath query model --- diff --git a/doc/querymodel.xml b/doc/querymodel.xml index f4d5c96..c7ebc17 100644 --- a/doc/querymodel.xml +++ b/doc/querymodel.xml @@ -1,5 +1,5 @@ - + Query Model @@ -198,7 +198,7 @@ - Explain attribute set + Explain exp-1 Special attribute set used on the special automagic IR-Explain-1 database to gain information on @@ -207,7 +207,7 @@ predefined - Bib1 attribute set + Bib1 bib-1 Standard PQF query language attribute set which defines the semantics of Z39.50 searching. In addition, all of the @@ -217,20 +217,18 @@ default - GILS attribute set + GILS gils Extention to the Bib1 attribute set. predefined - @@ -243,12 +241,12 @@ configuration path of the server. - - The Zebra internal query processing is modeled after - the Bib1 attribute set, and the non-use - attributes type 2-6 are hard-wired in. It is therefore essential - to be familiar with . - + + The Zebra internal query processing is modeled after + the Bib1 attribute set, and the non-use + attributes type 2-6 are hard-wired in. It is therefore essential + to be familiar with . + @@ -585,29 +583,6 @@ size is medium to large. - - @@ -1461,7 +1436,145 @@ - + + + + Zebra special IDXPATH Attribute Set for GRS indexing + + The attribute-set idxpath consists of a single + Use (type 1) attribute. All non-use attributes + behave as normal. + + + This feature is enabled when defining the + xpath enable option in the GRS filter + *.abs configuration files. If one wants to use + the special idxpath numeric attribute set, the + main Zebra configuraiton file zebra.cfg + directive attset: idxpath.att must be enabled. + + The idxpath is depreciated, may not be + supported in future Zebra versions, and should definitely + not be used in production code. + + + + IDXPATH Use Attributes (type = 1) + + This attribute set allows one to search GRS filter indexed + records by XPATH like structured index names. It is enabled by + specifying the + + + + The idxpath option defines hard-coded + index names, which might clash with your own index names. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
Zebra specific IDXPATH Use Attributes (type 1)
IDXPATHValueString IndexNotes
XPATH Begin1_XPATH_BEGINdepreciated
XPATH End2_XPATH_ENDdepreciated
XPATH CData1016_XPATH_CDATAdepreciated
XPATH Attribute Name3_XPATH_ATTR_NAMEdepreciated
XPATH Attribute CData1015_XPATH_ATTR_CDATAdepreciated
+ + + + See tab/idxpath.att for more information. + + + Search for all documents starting with root element + /root (either using the numeric or the string + use attributes): + + Z> find @attrset idxpath @attr 1=1 @attr 4=3 root/ + Z> find @attr idxpath 1=1 @attr 4=3 root/ + Z> find @attr 1=_XPATH_BEGIN @attr 4=3 root/ + + + + Search for all documents where specific nested XPATH + /c1/c2/../cn exists. Notice the very + counter-intuitive reverse notation! + + Z> find @attrset idxpath @attr 1=1 @attr 4=3 cn/cn-1/../c1/ + Z> find @attr 1=_XPATH_BEGIN @attr 4=3 cn/cn-1/../c1/ + + + + Search for CDATA string text in any element + + Z> find @attrset idxpath @attr 1=1016 text + Z> find @attr 1=_XPATH_CDATA text + + + + Search for CDATA string anothertext in any + attribute: + + Z> find @attrset idxpath @attr 1=1015 anothertext + Z> find @attr 1=_XPATH_ATTR_CDATA anothertext + + + + Search for all documents with have an XML element node + including an XML attribute named creator + + Z> find @attrset idxpath @attr 1=3 @attr 4=3 creator + Z> find @attr 1=_XPATH_ATTR_NAME @attr 4=3 creator + + + + Combining usual bib-1 attribut set searches + with idxpath attribute set searches: + + Z> find @and @attr idxpath 1=1 @attr 4=3 link/ @attr 1=4 mozart + Z> find @and @attr 1=_XPATH_BEGIN @attr 4=3 link/ @attr 1=_XPATH_CDATA mozart + + + + + + Mapping from Bib1 Attributes to Zebra internal