Docs: making support scripts adoc formatting more consistent, adding marc stream...
authorJane Sandberg <sandbej@linnbenton.edu>
Thu, 7 Sep 2017 16:54:46 +0000 (09:54 -0700)
committerJane Sandberg <sandbej@linnbenton.edu>
Thu, 7 Sep 2017 16:55:12 +0000 (09:55 -0700)
Signed-off-by: Jane Sandberg <sandbej@linnbenton.edu>
docs/development/support_scripts.adoc

index 982f839..fe5fbaf 100644 (file)
@@ -1,4 +1,5 @@
-== Support Scripts
+Support Scripts
+---------------
 
 Various scripts are included with Evergreen in the `/openils/bin/` directory
 (and in the source code in `Open-ILS/src/support-scripts` and
@@ -56,7 +57,8 @@ to more thorough documentation, if available.
 
 anchor:_marc_export[]
 
-=== marc_export: Exporting Bibliographic Records into MARC files
+marc_export: Exporting Bibliographic Records into MARC files
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 indexterm:[marc_export]
 
@@ -126,7 +128,8 @@ For more information, run marc_export with the -h option:
 
 
 
-=== Importing Authority Records from Command Line
+Importing Authority Records from Command Line
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 indexterm:[marc2are.pl]
 indexterm:[pg_loader.pl]
@@ -176,4 +179,28 @@ that command looks like:
 psql -U evergreen -h localhost -d evergreen -f pg_loader-output.sql
 ----
 
+MARC Stream Importer
+~~~~~~~~~~~~~~~~~~~~
+
+The MARC Stream Importer can import authority records or bibliographic records.
+A single running instance of the script can import either type of record, based
+on the record leader.
+
+This support script has its own configuration file, _marc_stream_importer.conf_, 
+which includes settings related to logs, ports, uses, and access control.
+
+The importer is even more flexible than the staff client import, including the
+following options:
+
+ * _--bib-auto-overlay-exact_ and _--auth-auto-overlay-exact_: overlay/merge on
+exact 901c matches
+ * _--bib-auto-overlay-1match_ and _--auth-auto-overlay-1match_: overlay/merge
+when exactly one match is found
+ * _--bib-auto-overlay-best-match_ and _--auth-auto-overlay-best-match_:
+overlay/merge on best match
+ * _--bib-import-no-match_ and _--auth-import-no-match_: import when no match
+is found
+
+One advantage to using this tool instead of the staff client Import interface
+is that the MARC Stream Importer can load a group of files at once.