[open-ils-commits] [GIT] Evergreen ILS branch rel_3_1 updated. 2a4f24ea20e3044f4902d97817792120dff46236

[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, rel_3_1 has been updated
       via  2a4f24ea20e3044f4902d97817792120dff46236 (commit)
      from  d2d6cb7d625d4e1ebfc5782206d5220ba798af24 (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 2a4f24ea20e3044f4902d97817792120dff46236
Author: kilsdonka <43423795+kilsdonka at users.noreply.github.com>
Date:   Tue Nov 20 09:50:54 2018 -0800

    Docs: Multilingual search documentation
    
    Signed-off-by: Jane Sandberg <sandbej at linnbenton.edu>

diff --git a/docs/admin/multilingual_search.adoc b/docs/admin/multilingual_search.adoc
new file mode 100644
index 0000000..1e69ccb
--- /dev/null
+++ b/docs/admin/multilingual_search.adoc
@@ -0,0 +1,70 @@
+Multilingual Search in Evergreen
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+It is now possible to search for items that contain multiple languages in the Evergreen catalog.  This will help facilitate searching for bilingual and multilingual materials, including specific translations, alternative languages, and to exclude specific translations from a search.  
+
+To identify the language of materials, Evergreen looks at two different fields in the MARC bibliographic record:
+  
+*  008/35-37: the language code located in characters 35-37 of the 008 tag 
+*  041$abdefgm: the 041 tag, subfields $abdefgm, which contain additional language codes   
+
+Multilingual searches can be conducted by constructing searches using specific language codes as a filter.  To search using specific language codes, use the Record Attribute Definition name _item_lang_ followed by the appropriate MARC Code for Languages.  For example, _item_lang(spa)_ will search only for Spanish language materials.
+
+The language filter can be appended to any search.  For example, a title search for _pippi longstocking item_lang(eng,swe)_ will search for English or Swedish language publications of the title.
+
+image::media/multilingual_search1.png[]
+
+Search Syntax
+^^^^^^^^^^^^^
+
+To search for materials that contain multiple languages (Boolean AND), the search filters can be constructed in the following ways:
+
+. Implicit Boolean filtering: _item_lang(eng) item_lang(spa)_
+.. Evergreen assumes a Boolean AND between the search filters
+. Explicit Boolean filtering: _item_lang(eng) && item_lang(spa)_
+.. The double ampersands (&&) explicitly tell Evergreen to apply a Boolean AND to the search filters
+
+To search for materials that contain at least one of the searched languages (Boolean OR), the search filters can be constructed in the following ways:
+
+. List filtering: _item_lang(eng,spa)_
+.. Listing the language codes, separated by a comma, within the search filter, tells Evergreen to apply a Boolean OR to the search filters
+. Explicit Boolean filtering: _item_lang(eng) || item_lang(spa)_
+.. The double pipes (||) explicitly tell Evergreen to apply a Boolean OR to the search filters
+
+To search for materials that contain a specific language and exclude another language from the search results (Boolean NOT), the search filters can be constructed as follows:
+
+. Boolean filtering: _item_lang(spa) -item_lang(eng)_
+.. The dash (-) explicitly tells Evergreen to apply a Boolean NOT to the english language search filter.  Evergreen assumes a Boolean AND between the search filters.
+
+To exclude multiple languages from search results (Boolean NOT), the search filters can be constructed as follows:
+
+. Boolean filtering: _-item_lang(eng) -item_lang(spa)_
+.. The dash (-) explicitly tells Evergreen to apply a Boolean NOT to both search filters.  Evergreen assumes a Boolean AND between the search filters.
+
+To conduct a search for materials that do not contain at least of the of the languages searched (Boolean “NOT” and “OR”), the search filters can be constructed in the following ways:
+
+. List filtering: _-item_lang(eng,spa)_
+.. Explicit Boolean filtering: _-item_lang(eng) || -item_lang(spa)_
+
+
+Advanced Search
+^^^^^^^^^^^^^^^
+
+Within the Advanced Search interface, multiple languages can be selected from the Language filter by holding down the Ctrl key on the keyboard and selecting the desired languages.  This will apply a Boolean OR operator to the language filters.
+
+image::media/multilingual_search2.PNG[]
+
+
+Adding Subfields to the Index
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+Additional subfields for the 041 tag, such as h, j, k, and n, can be added to the index through the Record Attribute Definitions interface.  Any records containing the additional subfields will need to be reingested into the database after making changes to the Record Attribute Definition.
+
+. Go to *Administration>Server Administration>Record Attribute Definitions*.
+. Click *Next* to locate the _item_lang_ record attribute definition.
+. To edit the definition, double click on the item_lang row and the configuration window will appear.
+. In the _MARC Subfields_ field, add the subfields you want included in the index.
+. Click *Save*.
+
+image::media/multilingual_search3.PNG[]
+
diff --git a/docs/media/multilingual_search1.png b/docs/media/multilingual_search1.png
new file mode 100644
index 0000000..b88ca9e
Binary files /dev/null and b/docs/media/multilingual_search1.png differ
diff --git a/docs/media/multilingual_search2.PNG b/docs/media/multilingual_search2.PNG
new file mode 100644
index 0000000..90f3dd4
Binary files /dev/null and b/docs/media/multilingual_search2.PNG differ
diff --git a/docs/media/multilingual_search3.PNG b/docs/media/multilingual_search3.PNG
new file mode 100644
index 0000000..f90c4ac
Binary files /dev/null and b/docs/media/multilingual_search3.PNG differ
diff --git a/docs/root.adoc b/docs/root.adoc
index 25744ed..bf69989 100644
--- a/docs/root.adoc
+++ b/docs/root.adoc
@@ -256,6 +256,8 @@ include::admin/copy_tags_admin.adoc[]
 
 include::admin/MARC_RAD_MVF_CRA.adoc[]
 
+include::admin/multilingual_search.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 f8e02f8..45fb8d6 100644
--- a/docs/root_staff_client_admin.adoc
+++ b/docs/root_staff_client_admin.adoc
@@ -199,6 +199,12 @@ include::admin/search_settings_web_client.adoc[]
 
 include::admin/popularity_badges_web_client.adoc[]
 
+:leveloffset: -1
+
+include::admin/multilingual_search.adoc[]
+
+:leveloffset: 0
+
 
 // Patron UX
 Patron User Experience Administration

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

Summary of changes:
 docs/admin/multilingual_search.adoc |   70 +++++++++++++++++++++++++++++++++++
 docs/media/multilingual_search1.png |  Bin 0 -> 13947 bytes
 docs/media/multilingual_search2.PNG |  Bin 0 -> 31198 bytes
 docs/media/multilingual_search3.PNG |  Bin 0 -> 52789 bytes
 docs/root.adoc                      |    2 +
 docs/root_staff_client_admin.adoc   |    6 +++
 6 files changed, 78 insertions(+), 0 deletions(-)
 create mode 100644 docs/admin/multilingual_search.adoc
 create mode 100644 docs/media/multilingual_search1.png
 create mode 100644 docs/media/multilingual_search2.PNG
 create mode 100644 docs/media/multilingual_search3.PNG


hooks/post-receive
-- 
Evergreen ILS