[open-ils-commits] [GIT] Evergreen ILS branch master updated. 5b3923e834e464a5571f194ccc54797212828541

[Evergreen Git]

This is an automated email from the git hooks/post-receive script. It was
generated because a ref change was pushed to the repository containing
the project "Evergreen ILS".

The branch, master has been updated
       via  5b3923e834e464a5571f194ccc54797212828541 (commit)
      from  1bbf52d978ed9faa595a5391a020ce888bfffe6f (commit)

Those revisions listed above that are new to this repository have
not appeared on any other notification email; so we list those
revisions in full, below.

- Log -----------------------------------------------------------------
commit 5b3923e834e464a5571f194ccc54797212828541
Author: kilsdonka <43423795+kilsdonka at users.noreply.github.com>
Date:   Wed Sep 19 15:59:59 2018 -0700

    Docs: Infrastructure changes to authority browse
    
    Signed-off-by: Jane Sandberg <sandbej at linnbenton.edu>

diff --git a/docs/admin/infrastructure_auth_browse.adoc b/docs/admin/infrastructure_auth_browse.adoc
new file mode 100644
index 0000000..d938a45
--- /dev/null
+++ b/docs/admin/infrastructure_auth_browse.adoc
@@ -0,0 +1,39 @@
+Infrastructure Changes to Authority Browse
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+As part of a larger development and consulting project to improve how authority records are used in public catalog browse, improvements have been made to how authority records are indexed in Evergreen.  This will not result in any direct changes to the public catalog, but will create infrastructure for improvements to the browse list.  Specifically, a configuration table will be used to specify how browse entries from authority records should be generated.  This new tables will supplement the existing authority control set configuration tables but will not replace them.
+
+Backend functionality
+^^^^^^^^^^^^^^^^^^^^^
+
+The new configuration table, authority.heading_field, specifies how headings can be extracted from MARC21 authority records. The general mechanism is similar to how config.metabib_field specifies how bibliographic records should be indexed: the XML representation of the MARC21 authority record is first passed through a stylesheet specified by the authority.heading_field definition, then XPath expressions are used to extract the heading for generating browse entries for the authority.simple_heading and metabib.browse_entry tables.
+
+The initial set of definitions supplied for authority.heading_field use the MARCXML to MADS 2.1 stylesheet; this helps ensure that heading strings extracted from authority records will match headings extracted from bibliographic records using the MODS stylesheet.
+
+Staff User Interface
+^^^^^^^^^^^^^^^^^^^^
+
+An interface for configuring authority headings is available in Server Administration in the web-based staff client, under the name "Authority Headings Fields".
+
+When navigated to, the interface looks like this:
+
+images::media/auth_browse_infra1.png[]
+
+Individual heading field definitions can be edited like this:
+
+images::media/auth_browse_infra2.png[]
+
+The available fields are:
+
+* Heading type: this can be personal_name, corporate_name, meeting_name, uniform_title, named_event, chronology_term, topical_term, geographic_name, genre_form_term, or medium_of_performance_term.
+* Heading purpose: this can be main, related, or variant, corresponding to authority record 1XX, 5XX, or 4XX fields respectively.
+* Heading field label: Label for use by administrators
+* Heading XSLT Format: This core
+* Heading XPath: Main XPath expression for selecting a part of the authority record to extract a heading from.
+* Heading Component XPath: XPath express for selecting parts of a heading string from the elements selected by Heading XPath.
+* Related/Variant Type XPath: Expression used, for variant and related headings, for identifying the specific purpose of the heading (e.g., broader term, narrower term, etc.).
+* Thesaurus XPath: Expression used for extracting the thesaurus that controls the heading
+* Thesaurus Override XPath: Expression used for identifying the thesaurus that controls a related heading.
+* Joiner string: String used to stitch together components of the heading into a single display string. If not set, " -- " is used.
+
+It should be noted that unless one has non-standard authority records, it is recommended that changes to the authority heading field definitions be minimized.
diff --git a/docs/media/auth_browse_infra1.png b/docs/media/auth_browse_infra1.png
new file mode 100644
index 0000000..a68f8af
Binary files /dev/null and b/docs/media/auth_browse_infra1.png differ
diff --git a/docs/media/auth_browse_infra2.png b/docs/media/auth_browse_infra2.png
new file mode 100644
index 0000000..e08b9c5
Binary files /dev/null and b/docs/media/auth_browse_infra2.png differ
diff --git a/docs/root.adoc b/docs/root.adoc
index 9c5644a..20d6ae6 100644
--- a/docs/root.adoc
+++ b/docs/root.adoc
@@ -232,6 +232,8 @@ include::admin/age_hold_protection.adoc[]
 
 include::admin/authorities.adoc[]
 
+include::admin/infrastructure_auth_browse.adoc
+
 include::admin/Best_Hold_Selection_Sort_Order.adoc[]
 
 include::admin/booking-admin.adoc[]
@@ -260,6 +262,8 @@ include::admin/MARC_RAD_MVF_CRA.adoc[]
 
 include::admin/multilingual_search.adoc[]
 
+include::admin/infrastructure_auth_browse.adoc[]
+
 include::admin/Org_Unit_Proximity_Adjustments.adoc[]
 
 :leveloffset: -1
diff --git a/docs/root_staff_client_admin.adoc b/docs/root_staff_client_admin.adoc
index 3fc4335..93ae165 100644
--- a/docs/root_staff_client_admin.adoc
+++ b/docs/root_staff_client_admin.adoc
@@ -212,6 +212,8 @@ include::admin/popularity_badges_web_client.adoc[]
 
 include::admin/multilingual_search.adoc[]
 
+include::admin/infrastructure_auth_browse.adoc[]
+
 :leveloffset: 0
 
 

-----------------------------------------------------------------------

Summary of changes:
 docs/admin/infrastructure_auth_browse.adoc |   39 ++++++++++++++++++++++++++++
 docs/media/auth_browse_infra1.png          |  Bin 0 -> 76521 bytes
 docs/media/auth_browse_infra2.png          |  Bin 0 -> 72192 bytes
 docs/root.adoc                             |    4 +++
 docs/root_staff_client_admin.adoc          |    2 +
 5 files changed, 45 insertions(+), 0 deletions(-)
 create mode 100644 docs/admin/infrastructure_auth_browse.adoc
 create mode 100644 docs/media/auth_browse_infra1.png
 create mode 100644 docs/media/auth_browse_infra2.png


hooks/post-receive
-- 
Evergreen ILS