[open-ils-commits] [GIT] Evergreen ILS branch master updated. 24c896d8226e67af2d97f12a9ca636c16f111b64

[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  24c896d8226e67af2d97f12a9ca636c16f111b64 (commit)
      from  0823e056c6fbe81e1350bb1e987713d5357b447d (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 24c896d8226e67af2d97f12a9ca636c16f111b64
Author: Jane Sandberg <sandbej at linnbenton.edu>
Date:   Fri Sep 29 13:40:12 2017 -0700

    Docs: Adding some use cases to MARC Batch Edit
    
    Signed-off-by: Jane Sandberg <sandbej at linnbenton.edu>

diff --git a/docs/cataloging/MARC_batch_edit.adoc b/docs/cataloging/MARC_batch_edit.adoc
index 78d4e9b..6566410 100644
--- a/docs/cataloging/MARC_batch_edit.adoc
+++ b/docs/cataloging/MARC_batch_edit.adoc
@@ -6,6 +6,36 @@ Introduction
 
 This function is used to batch edit MARC records either adding a field, removing a field or changing the contents of a field. 
 
+.What MARC Batch Edit Can and Can't Do
+**************************************
+MARC Batch Edit is a powerful tool, but it also has some limitations.
+This tool can do the following tasks to a group of MARC records:
+
+* Remove all instances of a specific tag (e.g. remove all 992 tags)
+* Remove all instances of a specific tag _if_ a particular subfield
+has a particular value (e.g. remove all 650 fields in which the $2
+is _fast_)
+* Remove all instances of a specific subfield (e.g. remove all 245$h)
+* Remove all instances of a specific set of subfields
+* Add a field
+* Add a subfield to an existing field
+* Replace data in a specific field or subfield
+
+It cannot do more advanced tasks, such as:
+
+* Swapping data from one field to another
+* Deduplicating MARC records
+* Complex logic based on existing data
+
+For more advanced projects, you may wish to export your records and
+use a free tool such as http://marcedit.reeset.net/[MARCEdit] or
+https://github.com/edsu/pymarc[PyMarc].
+
+**************************************
+
+Setting Up a Batch Edit Session
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
 Record Source::
 This includes options to batch edit identifying MARC records in a record bucket, CSV file or by record id.
 
@@ -13,7 +43,7 @@ Go! (button)::
 This button runs the action defined by the rule template(s).
 
 Action (Rule Type)
-~~~~~~~~~~~~~~~~~~
+^^^^^^^^^^^^^^^^^^
 Replace::
 Replaces the value in a MARC field for a batch of records.
 Delete::
@@ -22,7 +52,7 @@ Add::
 Use this to add a field and its contents to a batch of records.
 
 Other Template Fields
-~~~~~~~~~~~~~~~~~~~~~
+^^^^^^^^^^^^^^^^^^^^^
 MARC Tag::
 This is used to identify the field for adding, replacing, or deleting.
 Subfield (optional)::
@@ -50,3 +80,25 @@ Using PERL syntax for a regular expression to identify the data to be removed or
 . Click *Go!*
 . Results page will display indicating the number of records successfully edited
 
+Examples
+~~~~~~~~
+
+Adding a new field to all records
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+. In the _action_ menu, choose _Add_.
+. In _MARC Tag_, type the MARC tag number.
+. Leave the _Subfields_ field blank.
+. In _MARC Data_, type the field you would like to add.
+
+Delete a field if it contains a particular string
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+. In the _action_ menu, choose _Delete_.
+. In _MARC Tag_, type the MARC tag number.
+. Leave the _Subfields_ field blank.
+. In _MARC Data_, type the field you would like to add.
+. In the _subfield_ field under _Advanced Matching Restriction_, type the subfield code where you expect to see the string.
+. In _Regular Expression_, type the string you expect to see.
+
+

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

Summary of changes:
 docs/cataloging/MARC_batch_edit.adoc |   56 ++++++++++++++++++++++++++++++++-
 1 files changed, 54 insertions(+), 2 deletions(-)


hooks/post-receive
-- 
Evergreen ILS