Docs: documenting new 3.2 features based on release notes
authorJane Sandberg <sandbej@linnbenton.edu>
Fri, 7 Sep 2018 04:01:17 +0000 (21:01 -0700)
committerJane Sandberg <sandbej@linnbenton.edu>
Fri, 7 Sep 2018 04:01:17 +0000 (21:01 -0700)
Signed-off-by: Jane Sandberg <sandbej@linnbenton.edu>

docs/RELEASE_NOTES_3_2.adoc
docs/acquisitions/selection_lists_po.adoc
docs/cataloging/authorities.adoc
docs/development/support_scripts.adoc

index acc8042..4c5fce7 100644 (file)
@@ -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 <osname>-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
index bcdbe19..54af0eb 100644 (file)
@@ -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
 ++++++++++++++++++
 
index 6722f4e..7b31689 100644 (file)
@@ -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
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
index 7f4fdb7..52b7270 100644 (file)
@@ -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
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~