[open-ils-commits] [GIT] Evergreen ILS branch rel_3_1 updated. ca8ae4410a69ab68ca4e704da7982d7457f50955

[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, rel_3_1 has been updated
       via  ca8ae4410a69ab68ca4e704da7982d7457f50955 (commit)
      from  a65b26f4e29a2d1273fde69421625b1a2bff7794 (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 ca8ae4410a69ab68ca4e704da7982d7457f50955
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