docs/RELEASE_NOTES_NEXT/Cataloging/z39_batch_search_queue.txt

   1 Z39.50 Batch Search and Queue
   2 =============================
   3
   4 Staff Work Flow
   5 ---------------
   6
   7  * Staff add records to bib record buckets
   8  * Staff select the new "Locate Z39.50 Matches" action for a selected bucket.
   9  * Staff choose which Z39.50 sources and indexes to search and the destination
  10    queue.
  11  * Submitting the search fires a series of parallel Z39.50 searches across
  12    all selected Z39.50 sources.
  13  * Matches are added to the selected (Vandelay) queue.
  14  * Matched records may be manually or automatically overlaid to existing
  15    catalog records using the existing Vandelay import/merge/overlay features.
  16
  17 Vandelay Limit to Bucket
  18 ------------------------
  19
  20 As a side effect of this feature, Vandelay now has a new option in the
  21 interface which allows staff to limit which catalog records to which an
  22 inbound record matches to bib records within a record bucket.  When a record
  23 bucket and match set are chosen, only the records in the bucket can act as
  24 merge/overlay targets for the inbound Vandelay records.
  25
  26 Configuration
  27 -------------
  28
  29 Z39.50 Index Field Maps
  30 ~~~~~~~~~~~~~~~~~~~~~~~
  31
  32 These map bib record indexes (Metabib Fields and Record Attributes) to Z39.50
  33 search attributes.  The purpose of the mapping is to allow the server to
  34 determine which values to use for the automated Z39.50 searches.  For example,
  35 if the Z39.50 "title" attribute is mapped to the "Uniform Title" Metabib Field,
  36 the extracted value for "Uniform Title" for each record in the bucket will be
  37 used as the "title" value in the Z39.50 search.
  38
  39 Mappings can be applied to specific Z39.50 attributes, which define an attribute
  40 type and a Z39.50 source, or to generic attribute types (e.g. "title").  When
  41 a specific attribute is used, the mapping will only be applied to searches
  42 directed at the Z39.50 source linked to the attribute.
  43
  44 The management interface can be found in the staff client under
  45
  46 Admin => Server Administration => Z39.50 Index Field Maps
  47
  48 Metabib Field Additions
  49 ^^^^^^^^^^^^^^^^^^^^^^^
  50
  51 Stock config.metabib_field entries for author include additional author-
  52 related data, like dates.  For example, a value for Personal Author might
  53 look like this:
  54
  55 'girdlestone cuthbert morton 1895 1975 creator'
  56
  57 In the context of searching Z39.50 servers, the extraneous data can be
  58 detrimental.  Creating a separate field definition without the extra data
  59 is recommended.
  60
  61 [source,sql]
  62 --------------------------------------------
  63 INSERT INTO config.metabib_field
  64     (field_class, name, label, format, xpath, search_field)
  65     VALUES (
  66         'author',
  67         'personal - trimmed',
  68         'Personal Author (trimmed)',
  69         'mods32',
  70         '//mods32:mods/mods32:name[@type=''personal'' and mods32:role/mods32:roleTerm[text()=''creator'']]/mods32:namePart[not (@type)]',
  71         FALSE
  72     );
  73
  74 -- FULL BIB (OR INDEX-TARGETED) RE-INGEST REQUIRED
  75 --------------------------------------------
  76
  77
  78 Org Unit Settings
  79 ~~~~~~~~~~~~~~~~~
  80
  81  * cat.z3950.batch.max_parallel
  82   ** Maximum Parallel Z39.50 Batch Searches
  83   ** The maximum number of Z39.50 searches that can be in-flight at any given
  84      time when performing batch Z39.50 searches
  85  * cat.z3950.batch.max_results
  86   ** Maximum Z39.50 Batch Search Results
  87   ** The maximum number of search results to retrieve and queue for each
  88      record + Z39 source during batch Z39.50 searches
  89