[open-ils-commits] [GIT] Evergreen ILS branch master updated. e3a67f1a81b8e7ffd3a856c2addd2c0a3a8486a7

[Evergreen Git]

This is an automated email from the git hooks/post-receive script. It was
generated because a ref change was pushed to the repository containing
the project "Evergreen ILS".

The branch, master has been updated
       via  e3a67f1a81b8e7ffd3a856c2addd2c0a3a8486a7 (commit)
      from  6d98ced94170e96ae69a7c4baa3e80377b8de04f (commit)

Those revisions listed above that are new to this repository have
not appeared on any other notification email; so we list those
revisions in full, below.

- Log -----------------------------------------------------------------
commit e3a67f1a81b8e7ffd3a856c2addd2c0a3a8486a7
Author: Jane Sandberg <sandbej at linnbenton.edu>
Date:   Fri Aug 10 10:34:28 2018 -0700

    Docs: sample patron import script now also updates existing patron data
    
    With inspiration and help from Martha Driscoll
    
    Signed-off-by: Jane Sandberg <sandbej at linnbenton.edu>

diff --git a/docs/admin_initial_setup/migrating_patron_data.adoc b/docs/admin_initial_setup/migrating_patron_data.adoc
index dd531d4..346ea4a 100644
--- a/docs/admin_initial_setup/migrating_patron_data.adoc
+++ b/docs/admin_initial_setup/migrating_patron_data.adoc
@@ -152,12 +152,15 @@ steps to create an import script:
 ----------------------------------
     BEGIN;
 
+    -- Remove any old staging table.
+    DROP TABLE IF EXISTS students;
+
     -- Create staging table.
     CREATE TABLE students (
-    	student_id int, barcode text, last_name text, first_name text, email text, address_type text, 
+    	student_id text, barcode text, last_name text, first_name text, email text, address_type text, 
 		street1 text, street2 text, city text, province text, country text, postal_code text, phone 
 		text, profile int, ident_type int, home_ou int, claims_returned_count int DEFAULT 0, usrname text, 
-    	net_access_level int DEFAULT 2, password text
+    	net_access_level int DEFAULT 2, password text, already_exists boolean DEFAULT FALSE
     ); 
 
     --Copy records from your import text file
@@ -165,20 +168,51 @@ steps to create an import script:
 	country, postal_code, phone, password) 
     	FROM '/home/opensrf/patrons.csv' WITH CSV HEADER;  
 
+    --Determine which records are new, and which are merely updates of existing patrons
+    --You may with to also add a check on the home_ou column here, so that you don't
+    --accidentaly overwrite the data of another library in your consortium.
+    --You may also use a different matchpoint than actor.usr.ident_value.
+    UPDATE students
+        SET already_exists = TRUE
+        FROM actor.usr
+        WHERE students.student_id = actor.usr.ident_value;
+
+    --Update the names of existing patrons, in case they have changed their name
+    UPDATE actor.usr
+        SET first_given_name = students.first_name, family_name=students.last_name
+        FROM students
+        WHERE actor.usr.ident_value=students.student_id
+        AND (first_given_name != students.first_name OR family_name != students.last_name)
+        AND students.already_exists;
+        
+    --Update email addresses of existing patrons
+    --You may wish to update other fields as well, while preserving others
+    --actor.usr.passwd is an example of a field you may not wish to update,
+    --since patrons may have set the password to something other than the
+    --default.
+    UPDATE actor.usr
+        SET email=students.email
+        FROM students
+        WHERE actor.usr.ident_value=students.student_id
+        AND students.email != ''
+        AND actor.usr.email != students.email
+        AND students.already_exists;
 
     --Insert records from the staging table into the actor.usr table.
     INSERT INTO actor.usr (
     	profile, usrname, email, passwd, ident_type, ident_value, first_given_name, family_name, 
     	day_phone, home_ou, claims_returned_count, net_access_level) 
     	SELECT profile, students.usrname, email, password, ident_type, student_id, first_name, 
-    	last_name, phone, home_ou, claims_returned_count, net_access_level FROM students;
+    	last_name, phone, home_ou, claims_returned_count, net_access_level
+        FROM students WHERE NOT already_exists;
 
-    --Insert records from the staging table into the actor.usr table.
+    --Insert records from the staging table into the actor.card table.
     INSERT INTO actor.card (usr, barcode) 
     	SELECT actor.usr.id, students.barcode 
     	FROM students 
     		INNER JOIN actor.usr 
-    			ON students.usrname = actor.usr.usrname;
+    			ON students.usrname = actor.usr.usrname
+        WHERE NOT students.already_exists;
 
     --Update actor.usr.card field with actor.card.id to associate active card with the user:
     UPDATE actor.usr 
@@ -191,7 +225,8 @@ steps to create an import script:
     	SELECT actor.usr.id, students.street1, students.street2, students.city, students.province, 
     	students.country, students.postal_code 
     	FROM students 
-    	INNER JOIN actor.usr ON students.usrname = actor.usr.usrname;
+    	INNER JOIN actor.usr ON students.usrname = actor.usr.usrname
+        WHERE NOT students.already_exists;
 
 
    --Update actor.usr mailing address with id from actor.usr_address table.:

-----------------------------------------------------------------------

Summary of changes:
 .../admin_initial_setup/migrating_patron_data.adoc |   47 +++++++++++++++++---
 1 files changed, 41 insertions(+), 6 deletions(-)


hooks/post-receive
-- 
Evergreen ILS