From 0e99828c61f48f1c5746fd2660e52f908ed431e1 Mon Sep 17 00:00:00 2001 From: Jane Sandberg Date: Thu, 7 Sep 2017 09:54:46 -0700 Subject: [PATCH] Docs: making support scripts adoc formatting more consistent, adding marc stream importer docs Signed-off-by: Jane Sandberg --- docs/development/support_scripts.adoc | 33 ++++++++++++++++++++++++--- 1 file changed, 30 insertions(+), 3 deletions(-) diff --git a/docs/development/support_scripts.adoc b/docs/development/support_scripts.adoc index 982f839407..fe5fbaf786 100644 --- a/docs/development/support_scripts.adoc +++ b/docs/development/support_scripts.adoc @@ -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. -- 2.43.2