From bb466cd966fa3a2677e886d0c12364856b66c46a Mon Sep 17 00:00:00 2001 From: Jane Sandberg Date: Thu, 6 Sep 2018 21:01:17 -0700 Subject: [PATCH] Docs: documenting new 3.2 features based on release notes Signed-off-by: Jane Sandberg --- docs/RELEASE_NOTES_3_2.adoc | 47 ++++------------- docs/acquisitions/selection_lists_po.adoc | 15 ++++++ docs/cataloging/authorities.adoc | 18 +++++++ docs/development/support_scripts.adoc | 61 +++++++++++++++++++++++ 4 files changed, 105 insertions(+), 36 deletions(-) diff --git a/docs/RELEASE_NOTES_3_2.adoc b/docs/RELEASE_NOTES_3_2.adoc index acc80428a9..4c5fce766e 100644 --- a/docs/RELEASE_NOTES_3_2.adoc +++ b/docs/RELEASE_NOTES_3_2.adoc @@ -12,27 +12,21 @@ New Features ------------ - Acquisitions ~~~~~~~~~~~~ - - -Auto-Cancel Lineitems When All Copies Are Canceled +Auto-Cancel Line items When All Copies Are Canceled ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ -When a copy (lineitem detail) is canceled through the Acquisitions interface, -the parent lineitem is also canceled if all copies for that lineitem are also +When a copy (line item detail) is canceled through the Acquisitions interface, +the parent line item is also canceled if all copies for that line item are also canceled. The cancel reason given will come from: -1. The cancel reason for the just-canceled copy if it's a Keep Debits true - cancel reason. -2. The cancel reason from any other copy on the lineitem that has a Keep - Debits true cancel reason. -3. The cancel reason for the just-canceled copy if no copies have a Keep - Debits true cancel reason. - - - +. The cancel reason for the just-canceled copy if it's a Keep Debits true +cancel reason. +. The cancel reason from any other copy on the lineitem that has a Keep +Debits true cancel reason. +. The cancel reason for the just-canceled copy if no copies have a Keep +Debits true cancel reason. Invoice Closed Date and Closed By Fields @@ -71,9 +65,6 @@ invoices. - - - Patron Acquisitions Requests ^^^^^^^^^^^^^^^^^^^^^^^^^^^^ @@ -89,7 +80,7 @@ With Evergreen 3.2, we introduce the initial infrastructure for migrating to a new version of Angular. The structure of the new code is quite different from the AngularJS code and it runs as a separate application which communicates with the AngularJS app via shared storage -and in-page URLs that link back and fort between the two. +and in-page URLs that link back and forth between the two. For this release, users will only be directed to the new Angular site when navigating to Administration => Acquisitions Administration. Once @@ -153,22 +144,15 @@ sudo make -f Open-ILS/src/extras/Makefile.install -developer -------------------------------------------------------------------------- - - - Cataloging ~~~~~~~~~~ - - Add UPC to z39.50 search for OCLC and LOC ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ Add UPC as a search attribute for both OCLC and LOC targets in z39.50 for cataloging. - - Asynchronous Vandelay Imports ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ @@ -216,11 +200,9 @@ inventory date was updated. - - Parallel Ingest with pingest.pl ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ -A program named pingest.pl is now installed to allow faster record +A program named pingest.pl is now installed to allow faster bibliographic record ingest. It performs ingest in parallel so that multiple batches can be done simultaneously. It operates by splitting the records to be ingested up into batches and running all of the ingest methods on each @@ -290,8 +272,6 @@ pingest.pl accepts the following command line options: - - View Authority Record by Database ID ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ @@ -311,8 +291,6 @@ number. - - Circulation ~~~~~~~~~~~ @@ -658,9 +636,6 @@ search bar appears (for example, offering a large, Google-style search bar on the homepage only). - - - Username Login Hint ^^^^^^^^^^^^^^^^^^^ To make customization easier, the username hint on the OPAC login page ("Please diff --git a/docs/acquisitions/selection_lists_po.adoc b/docs/acquisitions/selection_lists_po.adoc index bcdbe19106..54af0ebcad 100644 --- a/docs/acquisitions/selection_lists_po.adoc +++ b/docs/acquisitions/selection_lists_po.adoc @@ -207,6 +207,21 @@ A delayed line item can now be canceled. You can mark a line item as delayed, a Cancel/delay reasons now appear on the worksheet and the printable purchase order. +[NOTE] +======================== +When all the copies of a line item are canceled through the Acquisitions interface, +the parent lineitem is also canceled. The cancel reason will be calculated based +on the settings of the + +. The cancel reason for the last copy to be canceled copy if the cancel reason's +_Keep Debits_ setting is true. +. The cancel reason for any other copy on the line item if the cancel reason's +_Keep Debits_ setting is true. +. The cancel reason for the last copy to be canceled if no copies on the line +item have a cancel reason where _Keep Debits_ is true. +======================== + + Paid PO Line Items ++++++++++++++++++ diff --git a/docs/cataloging/authorities.adoc b/docs/cataloging/authorities.adoc index 6722f4e4c7..7b31689a55 100644 --- a/docs/cataloging/authorities.adoc +++ b/docs/cataloging/authorities.adoc @@ -75,6 +75,24 @@ Evergreen's database stores normalized authority headings in a format that inclu Evergreen's internal identifier is in the 901c field. If you have previously exported authority record -- perhaps for an external vendor to do authority cleanup work -- and you want to import them back into your catalog, you may wish to include the 901c field in your match set. ================= +Viewing and Editing Authority Records by Database ID +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +The authority record retriever allows catalogers to retrieve a specific +authority record using its database ID. Catalogers can +find those IDs in subfield $0 of matching fields in +bibliographic records. + +To use the authority record retriever: + +. Click *Cataloging -> Retrieve Authority Record by ID*. +. Type in the ID number of the authority record you are +interested in. Don't include any prefixes, just the ID +number. +. Click *Submit*. +. View or edit the authority record as needed. + + Manage Authorities Interface ~~~~~~~~~~~~~~~~~~~~~~~~~~~~ diff --git a/docs/development/support_scripts.adoc b/docs/development/support_scripts.adoc index 7f4fdb78eb..52b72703f8 100644 --- a/docs/development/support_scripts.adoc +++ b/docs/development/support_scripts.adoc @@ -219,6 +219,67 @@ best way to use this option is in combination with the `--items` and one of the `--library` or `--descendants` options to export *all* of a library's holdings both physical and electronic. +anchor:_pingest_pl[] + +Parallel Ingest with pingest.pl +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +indexterm:[pgingest.pl] +indexterm:[MARC records,importing,using the command line] + +A program named pingest.pl allows fast bibliographic record +ingest. It performs ingest in parallel so that multiple batches can +be done simultaneously. It operates by splitting the records to be +ingested up into batches and running all of the ingest methods on each +batch. You may pass in options to control how many batches are run at +the same time, how many records there are per batch, and which ingest +operations to skip. + +NOTE: The browse ingest is presently done in a single process over all +of the input records as it cannot run in parallel with itself. It +does, however, run in parallel with the other ingests. + +Command Line Options +^^^^^^^^^^^^^^^^^^^^ + +pingest.pl accepts the following command line options: + +--host:: + The server where PostgreSQL runs (either host name or IP address). + The default is read from the PGHOST environment variable or + "localhost." + +--port:: + The port that PostgreSQL listens to on host. The default is read + from the PGPORT environment variable or 5432. + +--db:: + The database to connect to on the host. The default is read from + the PGDATABASE environment variable or "evergreen." + +--user:: + The username for database connections. The default is read from + the PGUSER environment variable or "evergreen." + +--password:: + The password for database connections. The default is read from + the PGPASSWORD environment variable or "evergreen." + +--batch-size:: + Number of records to process per batch. The default is 10,000. + +--max-child:: + Max number of worker processes (i.e. the number of batches to + process simultaneously). The default is 8. + +--skip-browse:: +--skip-attrs:: +--skip-search:: +--skip-facets:: +--skip-display:: + Skip the selected reingest component. + + Importing Authority Records from Command Line ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -- 2.43.2