From 43e0db09a9c784619b5adfb6caaf8af21197bfb9 Mon Sep 17 00:00:00 2001 From: Jane Sandberg Date: Thu, 6 Sep 2018 15:00:26 -0700 Subject: [PATCH] Docs: Adding two more entries to 3.2 release notes Signed-off-by: Jane Sandberg --- docs/RELEASE_NOTES_3_2.adoc | 88 +++++++++++++++++++++++++++++++++++++ 1 file changed, 88 insertions(+) diff --git a/docs/RELEASE_NOTES_3_2.adoc b/docs/RELEASE_NOTES_3_2.adoc index 578ca0ea8b..0560792bef 100644 --- a/docs/RELEASE_NOTES_3_2.adoc +++ b/docs/RELEASE_NOTES_3_2.adoc @@ -80,6 +80,79 @@ Patron Acquisitions Requests The existing interface for staff-mediated patron acquisition requests has been replaced in the web staff client with a re-implementation written in AngularJS, with some minor bug fixes (including access from the Patron interface) and other improvements. +Architecture +~~~~~~~~~~~~ + +Angular6 Base Application +^^^^^^^^^^^^^^^^^^^^^^^^^ +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. + +For this release, users will only be directed to the new Angular site +when navigating to Administration => Acquisitions Administration. Once +on this page, some of the admin interfaces will presented as Angular6 +interfaces, while others will direct users back to the AngularJS +application. The Angular6 interfaces are the simpler, grid-based +interfaces. + +Acquisitions Admin Angular6 Interfaces +++++++++++++++++++++++++++++++++++++++ + + * Cancel Reasons + * Claim Event Types + * Claim Policies + * Claim Policy Actions + * Claim Types + * Currency Types + * EDI Accounts + * EDI Messages + * Exchange Rates + * Fund Tags + * Invoice Item Types + * Invoice Payment Method + * Line Item Alerts + * Line Item MARC Attribute Definitions + +System Admin Upgrade Notes +++++++++++++++++++++++++++ + +Like the AngularJS application, Evergreen releases will come with all +web browser staff client code pre-compiled. Admins only need to add an +Apache configuration change. + +Add the following stanza to /etc/apache2/eg_vhost.conf. + +[source,conf] +-------------------------------------------------------------------------- +RewriteCond %{REQUEST_URI} ^/eg2/ +RewriteCond %{REQUEST_URI} !^/eg2/([a-z]{2}-[A-Z]{2})/ +RewriteRule ^/eg2/(.*) https://%{HTTP_HOST}/eg2/en-US/$1 [R=307,L] + + + FallbackResource /eg2/en-US/index.html + +-------------------------------------------------------------------------- + +For multi-locale sites, see the bottom section of +Open-ILS/examples/apache[_24]/eg_vhost.conf.in for a sample fr-CA +configuration. The section starts with "/eg2/ client setup and locale +configuration" + +Developer Upgrade Notes ++++++++++++++++++++++++ + +Developers building Angular code on existing installations need to update +their version of NodeJS by re-running the -developer prereqs installer. + +[source,sh] +-------------------------------------------------------------------------- +sudo make -f Open-ILS/src/extras/Makefile.install -developer +-------------------------------------------------------------------------- + + @@ -340,6 +413,21 @@ name keyword search. Client ~~~~~~ +Disabling of legacy XUL staff client +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ +The legacy XUL staff client is no longer supported in Evergreen +3.2.x and the server-side installation no longer supports a +direct connection by a version XUL client by default. All +users of Evergreen 3.2.x are strongly urged to complete their +switch to the web staff client as part of upgrading to 3.2.x. + +Evergreen administrators who for some reason continue to wish +to deploy the XUL staff client can do so at their risk by +supplying `STAFF_CLIENT_STAMP_ID` during the `make install` step +and using `make_release` to create installers for the staff client. +However, no community support will be provided for the XUL client. + + Permission Group Display Entries -- 2.43.2