X-Git-Url: http://git.indexdata.com/?a=blobdiff_plain;f=doc%2Fpazpar2_conf.xml;h=9782efbc759ff88792198a5bac4a4b46134f7313;hb=fb4ae0240d3f121281100e9a483c42e0f5577d15;hp=7777636881c67840cf13a2852fbbf85a309379fd;hpb=41ec1a1758b25c268c706caba8bcd08512643724;p=pazpar2-moved-to-github.git diff --git a/doc/pazpar2_conf.xml b/doc/pazpar2_conf.xml index 7777636..9782efb 100644 --- a/doc/pazpar2_conf.xml +++ b/doc/pazpar2_conf.xml @@ -157,9 +157,9 @@ One of these elements is required for every data element in the internal representation of the record (see . It governs - subsequent processing as pertains to sorting, relevance - ranking, merging, and display of data elements. It supports - the following attributes: + subsequent processing as pertains to sorting, relevance + ranking, merging, and display of data elements. It supports + the following attributes: @@ -257,7 +257,7 @@ longest element (strlen), 'range' (calculate a range of values across all matching records), 'all' (include all elements), or 'no' (don't merge; this is the - default); + default); @@ -265,9 +265,22 @@ mergekey - If set to yes, the value of this - metadata element is appended to the resulting mergekey. - By default metadata is not part of a mergekey. + If set to 'required', the value of this + metadata element is appended to the resulting mergekey if + the metadata is present in a record instance. + If the metadata element is not present, the a unique mergekey + will be generated instead. + + + If set to 'optional', the value of this + metadata element is appended to the resulting mergekey if the + the metadata is present in a record instance. If the metadata + is not present, it will be empty. + + + If set to 'no' or the mergekey attribute is + omitted, the metadata will not be used in the creation of a + mergekey. @@ -275,23 +288,23 @@ setting - This attribute allows you to make use of static database - settings in the processing of records. Three possible values - are allowed. 'no' is the default and doesn't do anything. - 'postproc' copies the value of a setting with the same name - into the output of the normalization stylesheet(s). 'parameter' - makes the value of a setting with the same name available - as a parameter to the normalization stylesheet, so you - can further process the value inside of the stylesheet, or use - the value to decide how to deal with other data values. + This attribute allows you to make use of static database + settings in the processing of records. Three possible values + are allowed. 'no' is the default and doesn't do anything. + 'postproc' copies the value of a setting with the same name + into the output of the normalization stylesheet(s). 'parameter' + makes the value of a setting with the same name available + as a parameter to the normalization stylesheet, so you + can further process the value inside of the stylesheet, or use + the value to decide how to deal with other data values. - The purpose of using settings in this way can either be to - control the behavior of normalization stylesheet in a database- - dependent way, or to easily make database-dependent values - available to display-logic in your user interface, without having - to implement complicated interactions between the user interface - and your configuration system. + The purpose of using settings in this way can either be to + control the behavior of normalization stylesheet in a database- + dependent way, or to easily make database-dependent values + available to display-logic in your user interface, without having + to implement complicated interactions between the user interface + and your configuration system. @@ -400,10 +413,19 @@ Specifies timeout parameters for this service. The timeout element supports the following attributes: - session, z3950_connect, + session, z3950_operation, z3950_session which specifies - 'session timeout', 'Z39.50 connect timeout', 'Z39.50 session timeout' - respectively. + 'session timeout', 'Z39.50 operation timeout', + 'Z39.50 session timeout' respectively. The Z39.50 operation + timeout is the time Pazpar2 will wait for an active Z39.50/SRU + operation before it gives up (times out). The Z39.50 session + time out is the time Pazpar2 will keep the session alive for + an idle session (no operation). + + + The following is recommended but not required: + z3950_operation (30) < session (60) < z3950_session (180) . + The default values are given in parantheses. @@ -891,7 +913,7 @@ - + pz:apdulog @@ -901,55 +923,88 @@ - + - pz:sru - - - This setting enables SRU/SRW support. It has three possible settings. - 'get', enables SRU access through GET requests. 'post' enables SRU/POST - support, less commonly supported, but useful if very large requests are - to be submitted. 'srw' enables the SRW variation of the protocol. - - + pz:sru + + + This setting enables SRU/SRW support. It has three possible settings. + 'get', enables SRU access through GET requests. 'post' enables SRU/POST + support, less commonly supported, but useful if very large requests are + to be submitted. 'srw' enables the SRW variation of the protocol. + + - + - pz:sru_version - - - This allows SRU version to be specified. If unset Pazpar2 - will the default of YAZ (currently 1.2). Should be set - to 1.1 or 1.2. - - + pz:sru_version + + + This allows SRU version to be specified. If unset Pazpar2 + will the default of YAZ (currently 1.2). Should be set + to 1.1 or 1.2. + + - + - pz:pqf_prefix - - - Allows you to specify an arbitrary PQF query language substring. The provided - string is prefixed the user's query after it has been normalized to PQF - internally in pazpar2. This allows you to attach complex 'filters' to - queries for a gien target, sometimes necessary to select sub-catalogs - in union catalog systems, etc. - - + pz:pqf_prefix + + + Allows you to specify an arbitrary PQF query language substring. + The provided string is prefixed the user's query after it has been + normalized to PQF internally in pazpar2. + This allows you to attach complex 'filters' to queries for a given + target, sometimes necessary to select sub-catalogs + in union catalog systems, etc. + + + + + + pz:pqf_strftime + + + Allows you to extend a query with dates and operators. + The provided string allows certain substitutions and serves as a + format string. + The special two character sequence '%%' gets converted to the + original query. Other characters leading with the percent sign are + conversions supported by strftime. + All other characters are copied verbatim. For example, the string + @and @attr 1=30 @attr 2=3 %Y %% + would search for current year combined with the original PQF (%%). + + + + + + pz:sort + + + Specifies sort criteria to be applied to the result set. + Only works for targets which support the sort service. + + - pz:sort - - - Specifies sort criteria to be applied to the result set. Only works for targets - which support the sort service. - - + pz:recordfilter + + + Specifies a filter which allows Pazpar2 to only include + records that meet a certain criteria in a result. Unmatched records + will be ignored. The filter takes the form name[~value] , which + will include only records with metadata element (name) that has the + substring (value) given. If value is omitted all records with the + metadata present will be included. + + - + + SEE ALSO