2 * Copyright (C) 2008 Equinox Software, Inc.
3 * Bill Erickson <erickson@esilibrary.com>
5 * This program is free software; you can redistribute it and/or
6 * modify it under the terms of the GNU General Public License
7 * as published by the Free Software Foundation; either version 2
8 * of the License, or (at your option) any later version.
10 * This program is distributed in the hope that it will be useful,
11 * but WITHOUT ANY WARRANTY; without even the implied warranty of
12 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
13 * GNU General Public License for more details.
17 CREATE OR REPLACE FUNCTION actor.usr_merge_rows( table_name TEXT, col_name TEXT, src_usr INT, dest_usr INT ) RETURNS VOID AS $$
24 sel := 'SELECT id::BIGINT FROM ' || table_name || ' WHERE ' || quote_ident(col_name) || ' = ' || quote_literal(src_usr);
25 upd := 'UPDATE ' || table_name || ' SET ' || quote_ident(col_name) || ' = ' || quote_literal(dest_usr) || ' WHERE id = ';
26 del := 'DELETE FROM ' || table_name || ' WHERE id = ';
27 FOR cur_row IN EXECUTE sel LOOP
29 --RAISE NOTICE 'Attempting to merge % %', table_name, cur_row.id;
30 EXECUTE upd || cur_row.id;
31 EXCEPTION WHEN unique_violation THEN
32 --RAISE NOTICE 'Deleting conflicting % %', table_name, cur_row.id;
33 EXECUTE del || cur_row.id;
39 COMMENT ON FUNCTION actor.usr_merge_rows(TEXT, TEXT, INT, INT) IS $$
40 Attempts to move each row of the specified table from src_user to dest_user.
41 Where conflicts exist, the conflicting "source" row is deleted.
45 CREATE OR REPLACE FUNCTION actor.usr_merge( src_usr INT, dest_usr INT, del_addrs BOOLEAN, del_cards BOOLEAN, deactivate_cards BOOLEAN ) RETURNS VOID AS $$
54 -- Bail if src_usr equals dest_usr because the result of merging a
55 -- user with itself is not what you want.
56 IF src_usr = dest_usr THEN
60 -- do some initial cleanup
61 UPDATE actor.usr SET card = NULL WHERE id = src_usr;
62 UPDATE actor.usr SET mailing_address = NULL WHERE id = src_usr;
63 UPDATE actor.usr SET billing_address = NULL WHERE id = src_usr;
67 DELETE FROM actor.card where usr = src_usr;
69 IF deactivate_cards THEN
70 UPDATE actor.card SET active = 'f' WHERE usr = src_usr;
72 UPDATE actor.card SET usr = dest_usr WHERE usr = src_usr;
77 DELETE FROM actor.usr_address WHERE usr = src_usr;
79 UPDATE actor.usr_address SET usr = dest_usr WHERE usr = src_usr;
82 UPDATE actor.usr_message SET usr = dest_usr WHERE usr = src_usr;
83 -- dupes are technically OK in actor.usr_standing_penalty, should manually delete them...
84 UPDATE actor.usr_standing_penalty SET usr = dest_usr WHERE usr = src_usr;
85 PERFORM actor.usr_merge_rows('actor.usr_org_unit_opt_in', 'usr', src_usr, dest_usr);
86 PERFORM actor.usr_merge_rows('actor.usr_setting', 'usr', src_usr, dest_usr);
89 PERFORM actor.usr_merge_rows('permission.usr_perm_map', 'usr', src_usr, dest_usr);
90 PERFORM actor.usr_merge_rows('permission.usr_object_perm_map', 'usr', src_usr, dest_usr);
91 PERFORM actor.usr_merge_rows('permission.usr_grp_map', 'usr', src_usr, dest_usr);
92 PERFORM actor.usr_merge_rows('permission.usr_work_ou_map', 'usr', src_usr, dest_usr);
97 -- For each *_bucket table: transfer every bucket belonging to src_usr
98 -- into the custody of dest_usr.
100 -- In order to avoid colliding with an existing bucket owned by
101 -- the destination user, append the source user's id (in parenthesese)
102 -- to the name. If you still get a collision, add successive
103 -- spaces to the name and keep trying until you succeed.
107 FROM container.biblio_record_entry_bucket
108 WHERE owner = src_usr
110 suffix := ' (' || src_usr || ')';
113 UPDATE container.biblio_record_entry_bucket
114 SET owner = dest_usr, name = name || suffix
115 WHERE id = bucket_row.id;
116 EXCEPTION WHEN unique_violation THEN
117 suffix := suffix || ' ';
126 FROM container.call_number_bucket
127 WHERE owner = src_usr
129 suffix := ' (' || src_usr || ')';
132 UPDATE container.call_number_bucket
133 SET owner = dest_usr, name = name || suffix
134 WHERE id = bucket_row.id;
135 EXCEPTION WHEN unique_violation THEN
136 suffix := suffix || ' ';
145 FROM container.copy_bucket
146 WHERE owner = src_usr
148 suffix := ' (' || src_usr || ')';
151 UPDATE container.copy_bucket
152 SET owner = dest_usr, name = name || suffix
153 WHERE id = bucket_row.id;
154 EXCEPTION WHEN unique_violation THEN
155 suffix := suffix || ' ';
164 FROM container.user_bucket
165 WHERE owner = src_usr
167 suffix := ' (' || src_usr || ')';
170 UPDATE container.user_bucket
171 SET owner = dest_usr, name = name || suffix
172 WHERE id = bucket_row.id;
173 EXCEPTION WHEN unique_violation THEN
174 suffix := suffix || ' ';
181 UPDATE container.user_bucket_item SET target_user = dest_usr WHERE target_user = src_usr;
184 -- transfer queues the same way we transfer buckets (see above)
188 WHERE owner = src_usr
190 suffix := ' (' || src_usr || ')';
193 UPDATE vandelay.queue
194 SET owner = dest_usr, name = name || suffix
195 WHERE id = queue_row.id;
196 EXCEPTION WHEN unique_violation THEN
197 suffix := suffix || ' ';
204 UPDATE vandelay.session_tracker SET usr = dest_usr WHERE usr = src_usr;
207 PERFORM actor.usr_merge_rows('money.collections_tracker', 'usr', src_usr, dest_usr);
208 PERFORM actor.usr_merge_rows('money.collections_tracker', 'collector', src_usr, dest_usr);
209 UPDATE money.billable_xact SET usr = dest_usr WHERE usr = src_usr;
210 UPDATE money.billing SET voider = dest_usr WHERE voider = src_usr;
211 UPDATE money.bnm_payment SET accepting_usr = dest_usr WHERE accepting_usr = src_usr;
214 UPDATE action.circulation SET usr = dest_usr WHERE usr = src_usr;
215 UPDATE action.circulation SET circ_staff = dest_usr WHERE circ_staff = src_usr;
216 UPDATE action.circulation SET checkin_staff = dest_usr WHERE checkin_staff = src_usr;
217 UPDATE action.usr_circ_history SET usr = dest_usr WHERE usr = src_usr;
219 UPDATE action.hold_request SET usr = dest_usr WHERE usr = src_usr;
220 UPDATE action.hold_request SET fulfillment_staff = dest_usr WHERE fulfillment_staff = src_usr;
221 UPDATE action.hold_request SET requestor = dest_usr WHERE requestor = src_usr;
222 UPDATE action.hold_notification SET notify_staff = dest_usr WHERE notify_staff = src_usr;
224 UPDATE action.in_house_use SET staff = dest_usr WHERE staff = src_usr;
225 UPDATE action.non_cataloged_circulation SET staff = dest_usr WHERE staff = src_usr;
226 UPDATE action.non_cataloged_circulation SET patron = dest_usr WHERE patron = src_usr;
227 UPDATE action.non_cat_in_house_use SET staff = dest_usr WHERE staff = src_usr;
228 UPDATE action.survey_response SET usr = dest_usr WHERE usr = src_usr;
231 UPDATE acq.fund_allocation SET allocator = dest_usr WHERE allocator = src_usr;
232 UPDATE acq.fund_transfer SET transfer_user = dest_usr WHERE transfer_user = src_usr;
233 UPDATE acq.invoice SET closed_by = dest_usr WHERE closed_by = src_usr;
235 -- transfer picklists the same way we transfer buckets (see above)
239 WHERE owner = src_usr
241 suffix := ' (' || src_usr || ')';
245 SET owner = dest_usr, name = name || suffix
246 WHERE id = picklist_row.id;
247 EXCEPTION WHEN unique_violation THEN
248 suffix := suffix || ' ';
255 UPDATE acq.purchase_order SET owner = dest_usr WHERE owner = src_usr;
256 UPDATE acq.po_note SET creator = dest_usr WHERE creator = src_usr;
257 UPDATE acq.po_note SET editor = dest_usr WHERE editor = src_usr;
258 UPDATE acq.provider_note SET creator = dest_usr WHERE creator = src_usr;
259 UPDATE acq.provider_note SET editor = dest_usr WHERE editor = src_usr;
260 UPDATE acq.lineitem_note SET creator = dest_usr WHERE creator = src_usr;
261 UPDATE acq.lineitem_note SET editor = dest_usr WHERE editor = src_usr;
262 UPDATE acq.lineitem_usr_attr_definition SET usr = dest_usr WHERE usr = src_usr;
265 UPDATE asset.copy SET creator = dest_usr WHERE creator = src_usr;
266 UPDATE asset.copy SET editor = dest_usr WHERE editor = src_usr;
267 UPDATE asset.copy_note SET creator = dest_usr WHERE creator = src_usr;
268 UPDATE asset.call_number SET creator = dest_usr WHERE creator = src_usr;
269 UPDATE asset.call_number SET editor = dest_usr WHERE editor = src_usr;
270 UPDATE asset.call_number_note SET creator = dest_usr WHERE creator = src_usr;
273 UPDATE serial.record_entry SET creator = dest_usr WHERE creator = src_usr;
274 UPDATE serial.record_entry SET editor = dest_usr WHERE editor = src_usr;
277 -- It's not uncommon to define the reporter schema in a replica
278 -- DB only, so don't assume these tables exist in the write DB.
280 UPDATE reporter.template SET owner = dest_usr WHERE owner = src_usr;
281 EXCEPTION WHEN undefined_table THEN
285 UPDATE reporter.report SET owner = dest_usr WHERE owner = src_usr;
286 EXCEPTION WHEN undefined_table THEN
290 UPDATE reporter.schedule SET runner = dest_usr WHERE runner = src_usr;
291 EXCEPTION WHEN undefined_table THEN
295 -- transfer folders the same way we transfer buckets (see above)
298 FROM reporter.template_folder
299 WHERE owner = src_usr
301 suffix := ' (' || src_usr || ')';
304 UPDATE reporter.template_folder
305 SET owner = dest_usr, name = name || suffix
306 WHERE id = folder_row.id;
307 EXCEPTION WHEN unique_violation THEN
308 suffix := suffix || ' ';
314 EXCEPTION WHEN undefined_table THEN
318 -- transfer folders the same way we transfer buckets (see above)
321 FROM reporter.report_folder
322 WHERE owner = src_usr
324 suffix := ' (' || src_usr || ')';
327 UPDATE reporter.report_folder
328 SET owner = dest_usr, name = name || suffix
329 WHERE id = folder_row.id;
330 EXCEPTION WHEN unique_violation THEN
331 suffix := suffix || ' ';
337 EXCEPTION WHEN undefined_table THEN
341 -- transfer folders the same way we transfer buckets (see above)
344 FROM reporter.output_folder
345 WHERE owner = src_usr
347 suffix := ' (' || src_usr || ')';
350 UPDATE reporter.output_folder
351 SET owner = dest_usr, name = name || suffix
352 WHERE id = folder_row.id;
353 EXCEPTION WHEN unique_violation THEN
354 suffix := suffix || ' ';
360 EXCEPTION WHEN undefined_table THEN
364 -- propagate preferred name values from the source user to the
365 -- destination user, but only when values are not being replaced.
366 WITH susr AS (SELECT * FROM actor.usr WHERE id = src_usr)
369 COALESCE(pref_prefix, (SELECT pref_prefix FROM susr)),
370 pref_first_given_name =
371 COALESCE(pref_first_given_name, (SELECT pref_first_given_name FROM susr)),
372 pref_second_given_name =
373 COALESCE(pref_second_given_name, (SELECT pref_second_given_name FROM susr)),
375 COALESCE(pref_family_name, (SELECT pref_family_name FROM susr)),
377 COALESCE(pref_suffix, (SELECT pref_suffix FROM susr))
380 -- Copy and deduplicate name keywords
381 -- String -> array -> rows -> DISTINCT -> array -> string
382 WITH susr AS (SELECT * FROM actor.usr WHERE id = src_usr),
383 dusr AS (SELECT * FROM actor.usr WHERE id = dest_usr)
384 UPDATE actor.usr SET name_keywords = (
386 SELECT DISTINCT UNNEST(
387 REGEXP_SPLIT_TO_ARRAY(
388 COALESCE((SELECT name_keywords FROM susr), '') || ' ' ||
389 COALESCE((SELECT name_keywords FROM dusr), ''), E'\\s+'
392 ) SELECT ARRAY_TO_STRING(ARRAY_AGG(kw.parts), ' ') FROM keywords kw
393 ) WHERE id = dest_usr;
395 -- Finally, delete the source user
396 PERFORM actor.usr_delete(src_usr,dest_usr);
403 COMMENT ON FUNCTION actor.usr_merge(INT, INT, BOOLEAN, BOOLEAN, BOOLEAN) IS $$
404 Merges all user date from src_usr to dest_usr. When collisions occur,
405 keep dest_usr's data and delete src_usr's data.
409 CREATE OR REPLACE FUNCTION actor.usr_purge_data(
411 specified_dest_usr IN INTEGER
415 renamable_row RECORD;
419 IF specified_dest_usr IS NULL THEN
420 dest_usr := 1; -- Admin user on stock installs
422 dest_usr := specified_dest_usr;
425 -- action_trigger.event (even doing this, event_output may--and probably does--contain PII and should have a retention/removal policy)
426 UPDATE action_trigger.event SET context_user = dest_usr WHERE context_user = src_usr;
429 UPDATE acq.fund_allocation SET allocator = dest_usr WHERE allocator = src_usr;
430 UPDATE acq.lineitem SET creator = dest_usr WHERE creator = src_usr;
431 UPDATE acq.lineitem SET editor = dest_usr WHERE editor = src_usr;
432 UPDATE acq.lineitem SET selector = dest_usr WHERE selector = src_usr;
433 UPDATE acq.lineitem_note SET creator = dest_usr WHERE creator = src_usr;
434 UPDATE acq.lineitem_note SET editor = dest_usr WHERE editor = src_usr;
435 UPDATE acq.invoice SET closed_by = dest_usr WHERE closed_by = src_usr;
436 DELETE FROM acq.lineitem_usr_attr_definition WHERE usr = src_usr;
438 -- Update with a rename to avoid collisions
442 WHERE owner = src_usr
444 suffix := ' (' || src_usr || ')';
448 SET owner = dest_usr, name = name || suffix
449 WHERE id = renamable_row.id;
450 EXCEPTION WHEN unique_violation THEN
451 suffix := suffix || ' ';
458 UPDATE acq.picklist SET creator = dest_usr WHERE creator = src_usr;
459 UPDATE acq.picklist SET editor = dest_usr WHERE editor = src_usr;
460 UPDATE acq.po_note SET creator = dest_usr WHERE creator = src_usr;
461 UPDATE acq.po_note SET editor = dest_usr WHERE editor = src_usr;
462 UPDATE acq.purchase_order SET owner = dest_usr WHERE owner = src_usr;
463 UPDATE acq.purchase_order SET creator = dest_usr WHERE creator = src_usr;
464 UPDATE acq.purchase_order SET editor = dest_usr WHERE editor = src_usr;
465 UPDATE acq.claim_event SET creator = dest_usr WHERE creator = src_usr;
468 DELETE FROM action.circulation WHERE usr = src_usr;
469 UPDATE action.circulation SET circ_staff = dest_usr WHERE circ_staff = src_usr;
470 UPDATE action.circulation SET checkin_staff = dest_usr WHERE checkin_staff = src_usr;
471 UPDATE action.hold_notification SET notify_staff = dest_usr WHERE notify_staff = src_usr;
472 UPDATE action.hold_request SET fulfillment_staff = dest_usr WHERE fulfillment_staff = src_usr;
473 UPDATE action.hold_request SET requestor = dest_usr WHERE requestor = src_usr;
474 DELETE FROM action.hold_request WHERE usr = src_usr;
475 UPDATE action.in_house_use SET staff = dest_usr WHERE staff = src_usr;
476 UPDATE action.non_cat_in_house_use SET staff = dest_usr WHERE staff = src_usr;
477 DELETE FROM action.non_cataloged_circulation WHERE patron = src_usr;
478 UPDATE action.non_cataloged_circulation SET staff = dest_usr WHERE staff = src_usr;
479 DELETE FROM action.survey_response WHERE usr = src_usr;
480 UPDATE action.fieldset SET owner = dest_usr WHERE owner = src_usr;
481 DELETE FROM action.usr_circ_history WHERE usr = src_usr;
482 UPDATE action.curbside SET notes = NULL WHERE patron = src_usr;
485 DELETE FROM actor.card WHERE usr = src_usr;
486 DELETE FROM actor.stat_cat_entry_usr_map WHERE target_usr = src_usr;
487 DELETE FROM actor.usr_privacy_waiver WHERE usr = src_usr;
488 DELETE FROM actor.usr_message WHERE usr = src_usr;
490 -- The following update is intended to avoid transient violations of a foreign
491 -- key constraint, whereby actor.usr_address references itself. It may not be
492 -- necessary, but it does no harm.
493 UPDATE actor.usr_address SET replaces = NULL
494 WHERE usr = src_usr AND replaces IS NOT NULL;
495 DELETE FROM actor.usr_address WHERE usr = src_usr;
496 DELETE FROM actor.usr_org_unit_opt_in WHERE usr = src_usr;
497 UPDATE actor.usr_org_unit_opt_in SET staff = dest_usr WHERE staff = src_usr;
498 DELETE FROM actor.usr_setting WHERE usr = src_usr;
499 DELETE FROM actor.usr_standing_penalty WHERE usr = src_usr;
500 UPDATE actor.usr_message SET title = 'purged', message = 'purged', read_date = NOW() WHERE usr = src_usr;
501 DELETE FROM actor.usr_message WHERE usr = src_usr;
502 UPDATE actor.usr_standing_penalty SET staff = dest_usr WHERE staff = src_usr;
503 UPDATE actor.usr_message SET editor = dest_usr WHERE editor = src_usr;
506 UPDATE asset.call_number SET creator = dest_usr WHERE creator = src_usr;
507 UPDATE asset.call_number SET editor = dest_usr WHERE editor = src_usr;
508 UPDATE asset.call_number_note SET creator = dest_usr WHERE creator = src_usr;
509 UPDATE asset.copy SET creator = dest_usr WHERE creator = src_usr;
510 UPDATE asset.copy SET editor = dest_usr WHERE editor = src_usr;
511 UPDATE asset.copy_note SET creator = dest_usr WHERE creator = src_usr;
514 DELETE FROM auditor.actor_usr_address_history WHERE id = src_usr;
515 DELETE FROM auditor.actor_usr_history WHERE id = src_usr;
516 UPDATE auditor.asset_call_number_history SET creator = dest_usr WHERE creator = src_usr;
517 UPDATE auditor.asset_call_number_history SET editor = dest_usr WHERE editor = src_usr;
518 UPDATE auditor.asset_copy_history SET creator = dest_usr WHERE creator = src_usr;
519 UPDATE auditor.asset_copy_history SET editor = dest_usr WHERE editor = src_usr;
520 UPDATE auditor.biblio_record_entry_history SET creator = dest_usr WHERE creator = src_usr;
521 UPDATE auditor.biblio_record_entry_history SET editor = dest_usr WHERE editor = src_usr;
524 UPDATE biblio.record_entry SET creator = dest_usr WHERE creator = src_usr;
525 UPDATE biblio.record_entry SET editor = dest_usr WHERE editor = src_usr;
526 UPDATE biblio.record_note SET creator = dest_usr WHERE creator = src_usr;
527 UPDATE biblio.record_note SET editor = dest_usr WHERE editor = src_usr;
530 -- Update buckets with a rename to avoid collisions
533 FROM container.biblio_record_entry_bucket
534 WHERE owner = src_usr
536 suffix := ' (' || src_usr || ')';
539 UPDATE container.biblio_record_entry_bucket
540 SET owner = dest_usr, name = name || suffix
541 WHERE id = renamable_row.id;
542 EXCEPTION WHEN unique_violation THEN
543 suffix := suffix || ' ';
552 FROM container.call_number_bucket
553 WHERE owner = src_usr
555 suffix := ' (' || src_usr || ')';
558 UPDATE container.call_number_bucket
559 SET owner = dest_usr, name = name || suffix
560 WHERE id = renamable_row.id;
561 EXCEPTION WHEN unique_violation THEN
562 suffix := suffix || ' ';
571 FROM container.copy_bucket
572 WHERE owner = src_usr
574 suffix := ' (' || src_usr || ')';
577 UPDATE container.copy_bucket
578 SET owner = dest_usr, name = name || suffix
579 WHERE id = renamable_row.id;
580 EXCEPTION WHEN unique_violation THEN
581 suffix := suffix || ' ';
590 FROM container.user_bucket
591 WHERE owner = src_usr
593 suffix := ' (' || src_usr || ')';
596 UPDATE container.user_bucket
597 SET owner = dest_usr, name = name || suffix
598 WHERE id = renamable_row.id;
599 EXCEPTION WHEN unique_violation THEN
600 suffix := suffix || ' ';
607 DELETE FROM container.user_bucket_item WHERE target_user = src_usr;
610 DELETE FROM money.billable_xact WHERE usr = src_usr;
611 DELETE FROM money.collections_tracker WHERE usr = src_usr;
612 UPDATE money.collections_tracker SET collector = dest_usr WHERE collector = src_usr;
615 DELETE FROM permission.usr_grp_map WHERE usr = src_usr;
616 DELETE FROM permission.usr_object_perm_map WHERE usr = src_usr;
617 DELETE FROM permission.usr_perm_map WHERE usr = src_usr;
618 DELETE FROM permission.usr_work_ou_map WHERE usr = src_usr;
621 -- Update with a rename to avoid collisions
625 FROM reporter.output_folder
626 WHERE owner = src_usr
628 suffix := ' (' || src_usr || ')';
631 UPDATE reporter.output_folder
632 SET owner = dest_usr, name = name || suffix
633 WHERE id = renamable_row.id;
634 EXCEPTION WHEN unique_violation THEN
635 suffix := suffix || ' ';
641 EXCEPTION WHEN undefined_table THEN
646 UPDATE reporter.report SET owner = dest_usr WHERE owner = src_usr;
647 EXCEPTION WHEN undefined_table THEN
651 -- Update with a rename to avoid collisions
655 FROM reporter.report_folder
656 WHERE owner = src_usr
658 suffix := ' (' || src_usr || ')';
661 UPDATE reporter.report_folder
662 SET owner = dest_usr, name = name || suffix
663 WHERE id = renamable_row.id;
664 EXCEPTION WHEN unique_violation THEN
665 suffix := suffix || ' ';
671 EXCEPTION WHEN undefined_table THEN
676 UPDATE reporter.schedule SET runner = dest_usr WHERE runner = src_usr;
677 EXCEPTION WHEN undefined_table THEN
682 UPDATE reporter.template SET owner = dest_usr WHERE owner = src_usr;
683 EXCEPTION WHEN undefined_table THEN
687 -- Update with a rename to avoid collisions
691 FROM reporter.template_folder
692 WHERE owner = src_usr
694 suffix := ' (' || src_usr || ')';
697 UPDATE reporter.template_folder
698 SET owner = dest_usr, name = name || suffix
699 WHERE id = renamable_row.id;
700 EXCEPTION WHEN unique_violation THEN
701 suffix := suffix || ' ';
707 EXCEPTION WHEN undefined_table THEN
712 -- Update with a rename to avoid collisions
716 WHERE owner = src_usr
718 suffix := ' (' || src_usr || ')';
721 UPDATE vandelay.queue
722 SET owner = dest_usr, name = name || suffix
723 WHERE id = renamable_row.id;
724 EXCEPTION WHEN unique_violation THEN
725 suffix := suffix || ' ';
732 UPDATE vandelay.session_tracker SET usr = dest_usr WHERE usr = src_usr;
734 -- NULL-ify addresses last so other cleanup (e.g. circ anonymization)
735 -- can access the information before deletion.
739 mailing_address = NULL,
740 billing_address = NULL
746 COMMENT ON FUNCTION actor.usr_purge_data(INT, INT) IS $$
747 Finds rows dependent on a given row in actor.usr and either deletes them
748 or reassigns them to a different user.
753 CREATE OR REPLACE FUNCTION actor.usr_delete(
758 old_profile actor.usr.profile%type;
759 old_home_ou actor.usr.home_ou%type;
760 new_profile actor.usr.profile%type;
761 new_home_ou actor.usr.home_ou%type;
763 new_dob actor.usr.dob%type;
766 id || '-PURGED-' || now(),
780 -- Quit if no such user
782 IF old_profile IS NULL THEN
786 perform actor.usr_purge_data( src_usr, dest_usr );
788 -- Find the root grp_tree and the root org_unit. This would be simpler if we
789 -- could assume that there is only one root. Theoretically, someday, maybe,
790 -- there could be multiple roots, so we take extra trouble to get the right ones.
797 permission.grp_ancestors( old_profile )
806 actor.org_unit_ancestors( old_home_ou )
810 -- Truncate date of birth
812 IF new_dob IS NOT NULL THEN
813 new_dob := date_trunc( 'year', new_dob );
820 profile = new_profile,
823 passwd = random()::text,
828 FROM config.identification_type
833 net_access_level = DEFAULT,
836 first_given_name = new_name,
837 second_given_name = NULL,
838 family_name = new_name,
843 evening_phone = NULL,
845 mailing_address = NULL,
846 billing_address = NULL,
847 home_ou = new_home_ou,
850 master_account = DEFAULT,
851 super_user = DEFAULT,
856 claims_returned_count = DEFAULT,
857 credit_forward_balance = DEFAULT,
858 last_xact_id = DEFAULT,
860 pref_first_given_name = NULL,
861 pref_second_given_name = NULL,
862 pref_family_name = NULL,
864 name_keywords = NULL,
872 COMMENT ON FUNCTION actor.usr_delete(INT, INT) IS $$
873 Logically deletes a user. Removes personally identifiable information,
874 and purges associated data in other tables.
879 CREATE OR REPLACE FUNCTION actor.approve_pending_address(pending_id INT) RETURNS BIGINT AS $$
883 SELECT INTO old_id replaces FROM actor.usr_address where id = pending_id;
884 IF old_id IS NULL THEN
885 UPDATE actor.usr_address SET pending = 'f' WHERE id = pending_id;
888 -- address replaces an existing address
889 DELETE FROM actor.usr_address WHERE id = -old_id;
890 UPDATE actor.usr_address SET id = -id WHERE id = old_id;
891 UPDATE actor.usr_address SET replaces = NULL, id = old_id, pending = 'f' WHERE id = pending_id;
896 COMMENT ON FUNCTION actor.approve_pending_address(INT) IS $$
897 Replaces an address with a pending address. This is done by giving the pending
898 address the ID of the old address. The replaced address is retained with -id.
901 CREATE OR REPLACE FUNCTION actor.change_password (user_id INT, new_pw TEXT, pw_type TEXT DEFAULT 'main')
906 SELECT actor.create_salt(pw_type) INTO new_salt;
908 IF pw_type = 'main' THEN
909 -- Only 'main' passwords are required to have
910 -- the extra layer of MD5 hashing.
911 PERFORM actor.set_passwd(
912 user_id, pw_type, md5(new_salt || md5(new_pw)), new_salt
916 PERFORM actor.set_passwd(user_id, pw_type, new_pw, new_salt);
919 $$ LANGUAGE 'plpgsql';
921 COMMENT ON FUNCTION actor.change_password(INT,TEXT,TEXT) IS $$
922 Allows setting a salted password for a user by passing actor.usr id and the text of the password.
925 CREATE OR REPLACE FUNCTION container.clear_expired_circ_history_items(
929 -- Delete old circulation bucket items for a specified user.
930 -- "Old" means older than the interval specified by a
931 -- user-level setting, if it is so specified.
934 threshold TIMESTAMP WITH TIME ZONE;
937 IF ac_usr IS NULL THEN
940 -- Determine the threshold date that defines "old". Subtract the
941 -- interval from the system date, then truncate to midnight.
945 now() - CAST( translate( value, '"', '' ) AS INTERVAL )
953 AND name = 'patron.max_reading_list_interval';
955 IF threshold is null THEN
956 -- No interval defined; don't delete anything
957 -- RAISE NOTICE 'No interval defined for user %', ac_usr;
961 -- RAISE NOTICE 'Date threshold: %', threshold;
963 -- Threshold found; do the delete
964 delete from container.copy_bucket_item
971 container.copy_bucket
974 and btype = 'circ_history'
976 and create_time < threshold;
982 COMMENT ON FUNCTION container.clear_expired_circ_history_items( INTEGER ) IS $$
983 Delete old circulation bucket items for a specified user.
984 "Old" means older than the interval specified by a
985 user-level setting, if it is so specified.
988 CREATE OR REPLACE FUNCTION container.clear_all_expired_circ_history_items( )
991 -- Delete expired circulation bucket items for all users that have
992 -- a setting for patron.max_reading_list_interval.
995 today TIMESTAMP WITH TIME ZONE;
996 threshold TIMESTAMP WITH TIME ZONE;
999 SELECT date_trunc( 'day', now() ) INTO today;
1008 name = 'patron.max_reading_list_interval'
1011 -- Make sure the setting is a valid interval
1014 threshold := today - CAST( translate( usr_setting.value, '"', '' ) AS INTERVAL );
1017 RAISE NOTICE 'Invalid setting patron.max_reading_list_interval for user %: ''%''',
1018 usr_setting.usr, usr_setting.value;
1022 --RAISE NOTICE 'User % threshold %', usr_setting.usr, threshold;
1024 DELETE FROM container.copy_bucket_item
1031 container.copy_bucket
1033 owner = usr_setting.usr
1034 AND btype = 'circ_history'
1036 AND create_time < threshold;
1040 $$ LANGUAGE plpgsql;
1042 COMMENT ON FUNCTION container.clear_all_expired_circ_history_items( ) IS $$
1043 Delete expired circulation bucket items for all users that have
1044 a setting for patron.max_reading_list_interval.
1047 CREATE OR REPLACE FUNCTION asset.merge_record_assets( target_record BIGINT, source_record BIGINT ) RETURNS INT AS $func$
1049 moved_objects INT := 0;
1050 source_cn asset.call_number%ROWTYPE;
1051 target_cn asset.call_number%ROWTYPE;
1052 metarec metabib.metarecord%ROWTYPE;
1053 hold action.hold_request%ROWTYPE;
1054 ser_rec serial.record_entry%ROWTYPE;
1055 ser_sub serial.subscription%ROWTYPE;
1056 acq_lineitem acq.lineitem%ROWTYPE;
1057 acq_request acq.user_request%ROWTYPE;
1058 booking booking.resource_type%ROWTYPE;
1059 source_part biblio.monograph_part%ROWTYPE;
1060 target_part biblio.monograph_part%ROWTYPE;
1061 multi_home biblio.peer_bib_copy_map%ROWTYPE;
1065 uri_text TEXT := '';
1068 -- we don't merge bib -1
1069 IF target_record = -1 OR source_record = -1 THEN
1073 -- move any 856 entries on records that have at least one MARC-mapped URI entry
1074 SELECT INTO uri_count COUNT(*)
1075 FROM asset.uri_call_number_map m
1076 JOIN asset.call_number cn ON (m.call_number = cn.id)
1077 WHERE cn.record = source_record;
1079 IF uri_count > 0 THEN
1081 -- This returns more nodes than you might expect:
1082 -- 7 instead of 1 for an 856 with $u $y $9
1083 SELECT COUNT(*) INTO counter
1084 FROM oils_xpath_table(
1087 'biblio.record_entry',
1089 'id=' || source_record
1090 ) as t(i int,c text);
1092 FOR i IN 1 .. counter LOOP
1093 SELECT '<datafield xmlns="http://www.loc.gov/MARC21/slim"' ||
1095 ' ind1="' || FIRST(ind1) || '"' ||
1096 ' ind2="' || FIRST(ind2) || '">' ||
1098 '<subfield code="' || subfield || '">' ||
1101 regexp_replace(data,'&','&','g'),
1105 ) || '</subfield>', ''
1106 ) || '</datafield>' INTO uri_datafield
1107 FROM oils_xpath_table(
1110 'biblio.record_entry',
1111 '//*[@tag="856"][position()=' || i || ']/@ind1|' ||
1112 '//*[@tag="856"][position()=' || i || ']/@ind2|' ||
1113 '//*[@tag="856"][position()=' || i || ']/*/@code|' ||
1114 '//*[@tag="856"][position()=' || i || ']/*[@code]',
1115 'id=' || source_record
1116 ) as t(id int,ind1 text, ind2 text,subfield text,data text);
1118 -- As most of the results will be NULL, protect against NULLifying
1119 -- the valid content that we do generate
1120 uri_text := uri_text || COALESCE(uri_datafield, '');
1123 IF uri_text <> '' THEN
1124 UPDATE biblio.record_entry
1125 SET marc = regexp_replace(marc,'(</[^>]*record>)', uri_text || E'\\1')
1126 WHERE id = target_record;
1131 -- Find and move metarecords to the target record
1132 SELECT INTO metarec *
1133 FROM metabib.metarecord
1134 WHERE master_record = source_record;
1137 UPDATE metabib.metarecord
1138 SET master_record = target_record,
1140 WHERE id = metarec.id;
1142 moved_objects := moved_objects + 1;
1145 -- Find call numbers attached to the source ...
1146 FOR source_cn IN SELECT * FROM asset.call_number WHERE record = source_record LOOP
1148 SELECT INTO target_cn *
1149 FROM asset.call_number
1150 WHERE label = source_cn.label
1151 AND prefix = source_cn.prefix
1152 AND suffix = source_cn.suffix
1153 AND owning_lib = source_cn.owning_lib
1154 AND record = target_record
1157 -- ... and if there's a conflicting one on the target ...
1160 -- ... move the copies to that, and ...
1162 SET call_number = target_cn.id
1163 WHERE call_number = source_cn.id;
1165 -- ... move V holds to the move-target call number
1166 FOR hold IN SELECT * FROM action.hold_request WHERE target = source_cn.id AND hold_type = 'V' LOOP
1168 UPDATE action.hold_request
1169 SET target = target_cn.id
1172 moved_objects := moved_objects + 1;
1175 UPDATE asset.call_number SET deleted = TRUE WHERE id = source_cn.id;
1179 -- ... just move the call number to the target record
1180 UPDATE asset.call_number
1181 SET record = target_record
1182 WHERE id = source_cn.id;
1185 moved_objects := moved_objects + 1;
1188 -- Find T holds targeting the source record ...
1189 FOR hold IN SELECT * FROM action.hold_request WHERE target = source_record AND hold_type = 'T' LOOP
1191 -- ... and move them to the target record
1192 UPDATE action.hold_request
1193 SET target = target_record
1196 moved_objects := moved_objects + 1;
1199 -- Find serial records targeting the source record ...
1200 FOR ser_rec IN SELECT * FROM serial.record_entry WHERE record = source_record LOOP
1201 -- ... and move them to the target record
1202 UPDATE serial.record_entry
1203 SET record = target_record
1204 WHERE id = ser_rec.id;
1206 moved_objects := moved_objects + 1;
1209 -- Find serial subscriptions targeting the source record ...
1210 FOR ser_sub IN SELECT * FROM serial.subscription WHERE record_entry = source_record LOOP
1211 -- ... and move them to the target record
1212 UPDATE serial.subscription
1213 SET record_entry = target_record
1214 WHERE id = ser_sub.id;
1216 moved_objects := moved_objects + 1;
1219 -- Find booking resource types targeting the source record ...
1220 FOR booking IN SELECT * FROM booking.resource_type WHERE record = source_record LOOP
1221 -- ... and move them to the target record
1222 UPDATE booking.resource_type
1223 SET record = target_record
1224 WHERE id = booking.id;
1226 moved_objects := moved_objects + 1;
1229 -- Find acq lineitems targeting the source record ...
1230 FOR acq_lineitem IN SELECT * FROM acq.lineitem WHERE eg_bib_id = source_record LOOP
1231 -- ... and move them to the target record
1233 SET eg_bib_id = target_record
1234 WHERE id = acq_lineitem.id;
1236 moved_objects := moved_objects + 1;
1239 -- Find acq user purchase requests targeting the source record ...
1240 FOR acq_request IN SELECT * FROM acq.user_request WHERE eg_bib = source_record LOOP
1241 -- ... and move them to the target record
1242 UPDATE acq.user_request
1243 SET eg_bib = target_record
1244 WHERE id = acq_request.id;
1246 moved_objects := moved_objects + 1;
1249 -- Find parts attached to the source ...
1250 FOR source_part IN SELECT * FROM biblio.monograph_part WHERE record = source_record LOOP
1252 SELECT INTO target_part *
1253 FROM biblio.monograph_part
1254 WHERE label = source_part.label
1255 AND record = target_record;
1257 -- ... and if there's a conflicting one on the target ...
1260 -- ... move the copy-part maps to that, and ...
1261 UPDATE asset.copy_part_map
1262 SET part = target_part.id
1263 WHERE part = source_part.id;
1265 -- ... move P holds to the move-target part
1266 FOR hold IN SELECT * FROM action.hold_request WHERE target = source_part.id AND hold_type = 'P' LOOP
1268 UPDATE action.hold_request
1269 SET target = target_part.id
1272 moved_objects := moved_objects + 1;
1277 -- ... just move the part to the target record
1278 UPDATE biblio.monograph_part
1279 SET record = target_record
1280 WHERE id = source_part.id;
1283 moved_objects := moved_objects + 1;
1286 -- Find multi_home items attached to the source ...
1287 FOR multi_home IN SELECT * FROM biblio.peer_bib_copy_map WHERE peer_record = source_record LOOP
1288 -- ... and move them to the target record
1289 UPDATE biblio.peer_bib_copy_map
1290 SET peer_record = target_record
1291 WHERE id = multi_home.id;
1293 moved_objects := moved_objects + 1;
1296 -- And delete mappings where the item's home bib was merged with the peer bib
1297 DELETE FROM biblio.peer_bib_copy_map WHERE peer_record = (
1298 SELECT (SELECT record FROM asset.call_number WHERE id = call_number)
1299 FROM asset.copy WHERE id = target_copy
1302 -- Apply merge tracking
1303 UPDATE biblio.record_entry
1304 SET merge_date = NOW() WHERE id = target_record;
1306 UPDATE biblio.record_entry
1307 SET merge_date = NOW(), merged_to = target_record
1308 WHERE id = source_record;
1310 -- replace book bag entries of source_record with target_record
1311 UPDATE container.biblio_record_entry_bucket_item
1312 SET target_biblio_record_entry = target_record
1313 WHERE bucket IN (SELECT id FROM container.biblio_record_entry_bucket WHERE btype = 'bookbag')
1314 AND target_biblio_record_entry = source_record;
1316 -- Finally, "delete" the source record
1317 UPDATE biblio.record_entry SET active = FALSE WHERE id = source_record;
1318 DELETE FROM biblio.record_entry WHERE id = source_record;
1320 -- That's all, folks!
1321 RETURN moved_objects;
1323 $func$ LANGUAGE plpgsql;
1325 -- Authority ingest routines
1326 CREATE OR REPLACE FUNCTION authority.propagate_changes
1327 (aid BIGINT, bid BIGINT) RETURNS BIGINT AS $func$
1329 bib_rec biblio.record_entry%ROWTYPE;
1333 SELECT INTO bib_rec * FROM biblio.record_entry WHERE id = bid;
1335 new_marc := vandelay.merge_record_xml(
1336 bib_rec.marc, authority.generate_overlay_template(aid));
1338 IF new_marc = bib_rec.marc THEN
1339 -- Authority record change had no impact on this bib record.
1340 -- Nothing left to do.
1344 PERFORM 1 FROM config.global_flag
1345 WHERE name = 'ingest.disable_authority_auto_update_bib_meta'
1349 -- update the bib record editor and edit_date
1351 SELECT editor FROM authority.record_entry WHERE id = aid);
1352 bib_rec.edit_date = NOW();
1355 UPDATE biblio.record_entry SET
1357 editor = bib_rec.editor,
1358 edit_date = bib_rec.edit_date
1364 $func$ LANGUAGE PLPGSQL;
1366 CREATE OR REPLACE FUNCTION authority.propagate_changes (aid BIGINT) RETURNS SETOF BIGINT AS $func$
1367 SELECT authority.propagate_changes( authority, bib ) FROM authority.bib_linking WHERE authority = $1;
1368 $func$ LANGUAGE SQL;
1370 CREATE OR REPLACE FUNCTION authority.map_thesaurus_to_control_set () RETURNS TRIGGER AS $func$
1372 IF NEW.control_set IS NULL THEN
1373 SELECT control_set INTO NEW.control_set
1374 FROM authority.thesaurus
1375 WHERE authority.extract_thesaurus(NEW.marc) = code;
1380 $func$ LANGUAGE PLPGSQL;
1382 CREATE OR REPLACE FUNCTION authority.reingest_authority_rec_descriptor( auth_id BIGINT ) RETURNS VOID AS $func$
1384 DELETE FROM authority.rec_descriptor WHERE record = auth_id;
1385 INSERT INTO authority.rec_descriptor (record, record_status, encoding_level, thesaurus)
1387 vandelay.marc21_extract_fixed_field(marc,'RecStat'),
1388 vandelay.marc21_extract_fixed_field(marc,'ELvl'),
1389 authority.extract_thesaurus(marc)
1390 FROM authority.record_entry
1394 $func$ LANGUAGE PLPGSQL;
1396 CREATE OR REPLACE FUNCTION authority.reingest_authority_full_rec( auth_id BIGINT ) RETURNS VOID AS $func$
1398 DELETE FROM authority.full_rec WHERE record = auth_id;
1399 INSERT INTO authority.full_rec (record, tag, ind1, ind2, subfield, value)
1400 SELECT record, tag, ind1, ind2, subfield, value FROM authority.flatten_marc( auth_id );
1404 $func$ LANGUAGE PLPGSQL;
1406 -- Given an authority record's ID, control set ID (if known), and marc::XML,
1407 -- return all links to other authority records in the form of rows that
1408 -- can be inserted into authority.authority_linking.
1409 CREATE OR REPLACE FUNCTION authority.calculate_authority_linking(
1410 rec_id BIGINT, rec_control_set INT, rec_marc_xml XML
1411 ) RETURNS SETOF authority.authority_linking AS $func$
1413 acsaf authority.control_set_authority_field%ROWTYPE;
1415 aal authority.authority_linking%ROWTYPE;
1417 IF rec_control_set IS NULL THEN
1418 -- No control_set on record? Guess at one
1419 SELECT control_set INTO rec_control_set
1420 FROM authority.control_set_authority_field
1423 XPATH('//*[starts-with(@tag,"1")]/@tag',rec_marc_xml)::TEXT[]
1428 RAISE WARNING 'Could not even guess at control set for authority record %', rec_id;
1433 aal.source := rec_id;
1436 SELECT * FROM authority.control_set_authority_field
1437 WHERE control_set = rec_control_set
1438 AND linking_subfield IS NOT NULL
1439 AND main_entry IS NOT NULL
1441 -- Loop over the trailing-number contents of all linking subfields
1443 SELECT SUBSTRING( x::TEXT, '\d+$' )
1449 || acsaf.linking_subfield
1456 -- Ignore links that are null, malformed, circular, or point to
1457 -- non-existent authority records.
1458 IF link IS NOT NULL AND link::BIGINT <> rec_id THEN
1459 PERFORM * FROM authority.record_entry WHERE id = link::BIGINT;
1461 aal.target := link::BIGINT;
1462 aal.field := acsaf.id;
1469 $func$ LANGUAGE PLPGSQL;
1471 -- AFTER UPDATE OR INSERT trigger for authority.record_entry
1472 CREATE OR REPLACE FUNCTION authority.indexing_ingest_or_delete () RETURNS TRIGGER AS $func$
1474 ashs authority.simple_heading%ROWTYPE;
1475 mbe_row metabib.browse_entry%ROWTYPE;
1480 IF NEW.deleted IS TRUE THEN -- If this authority is deleted
1481 DELETE FROM authority.bib_linking WHERE authority = NEW.id; -- Avoid updating fields in bibs that are no longer visible
1482 DELETE FROM authority.full_rec WHERE record = NEW.id; -- Avoid validating fields against deleted authority records
1483 DELETE FROM authority.simple_heading WHERE record = NEW.id;
1484 -- Should remove matching $0 from controlled fields at the same time?
1486 -- XXX What do we about the actual linking subfields present in
1487 -- authority records that target this one when this happens?
1488 DELETE FROM authority.authority_linking
1489 WHERE source = NEW.id OR target = NEW.id;
1491 RETURN NEW; -- and we're done
1494 IF TG_OP = 'UPDATE' THEN -- re-ingest?
1495 PERFORM * FROM config.internal_flag WHERE name = 'ingest.reingest.force_on_same_marc' AND enabled;
1497 IF NOT FOUND AND OLD.marc = NEW.marc THEN -- don't do anything if the MARC didn't change
1501 -- Unless there's a setting stopping us, propagate these updates to any linked bib records when the heading changes
1502 PERFORM * FROM config.internal_flag WHERE name = 'ingest.disable_authority_auto_update' AND enabled;
1504 IF NOT FOUND AND NEW.heading <> OLD.heading THEN
1505 PERFORM authority.propagate_changes(NEW.id);
1508 DELETE FROM authority.simple_heading WHERE record = NEW.id;
1509 DELETE FROM authority.authority_linking WHERE source = NEW.id;
1512 INSERT INTO authority.authority_linking (source, target, field)
1513 SELECT source, target, field FROM authority.calculate_authority_linking(
1514 NEW.id, NEW.control_set, NEW.marc::XML
1517 FOR ashs IN SELECT * FROM authority.simple_heading_set(NEW.marc) LOOP
1519 INSERT INTO authority.simple_heading (record,atag,value,sort_value,thesaurus)
1520 VALUES (ashs.record, ashs.atag, ashs.value, ashs.sort_value, ashs.thesaurus);
1521 ash_id := CURRVAL('authority.simple_heading_id_seq'::REGCLASS);
1523 SELECT INTO mbe_row * FROM metabib.browse_entry
1524 WHERE value = ashs.value AND sort_value = ashs.sort_value;
1527 mbe_id := mbe_row.id;
1529 INSERT INTO metabib.browse_entry
1530 ( value, sort_value ) VALUES
1531 ( ashs.value, ashs.sort_value );
1533 mbe_id := CURRVAL('metabib.browse_entry_id_seq'::REGCLASS);
1536 INSERT INTO metabib.browse_entry_simple_heading_map (entry,simple_heading) VALUES (mbe_id,ash_id);
1540 -- Flatten and insert the afr data
1541 PERFORM * FROM config.internal_flag WHERE name = 'ingest.disable_authority_full_rec' AND enabled;
1543 PERFORM authority.reingest_authority_full_rec(NEW.id);
1544 PERFORM * FROM config.internal_flag WHERE name = 'ingest.disable_authority_rec_descriptor' AND enabled;
1546 PERFORM authority.reingest_authority_rec_descriptor(NEW.id);
1552 $func$ LANGUAGE PLPGSQL;
1555 CREATE TRIGGER fingerprint_tgr BEFORE INSERT OR UPDATE ON biblio.record_entry FOR EACH ROW EXECUTE PROCEDURE biblio.fingerprint_trigger ('eng','BKS');
1556 CREATE TRIGGER aaa_indexing_ingest_or_delete AFTER INSERT OR UPDATE ON biblio.record_entry FOR EACH ROW EXECUTE PROCEDURE biblio.indexing_ingest_or_delete ();
1557 CREATE TRIGGER bbb_simple_rec_trigger AFTER INSERT OR UPDATE OR DELETE ON biblio.record_entry FOR EACH ROW EXECUTE PROCEDURE reporter.simple_rec_trigger ();
1559 CREATE TRIGGER map_thesaurus_to_control_set BEFORE INSERT OR UPDATE ON authority.record_entry FOR EACH ROW EXECUTE PROCEDURE authority.map_thesaurus_to_control_set ();
1560 CREATE TRIGGER aaa_auth_ingest_or_delete AFTER INSERT OR UPDATE ON authority.record_entry FOR EACH ROW EXECUTE PROCEDURE authority.indexing_ingest_or_delete ();
1562 -- Utility routines, callable via cstore
1564 CREATE OR REPLACE FUNCTION config.interval_to_seconds( interval_val INTERVAL )
1565 RETURNS INTEGER AS $$
1567 RETURN EXTRACT( EPOCH FROM interval_val );
1569 $$ LANGUAGE plpgsql;
1571 CREATE OR REPLACE FUNCTION config.interval_to_seconds( interval_string TEXT )
1572 RETURNS INTEGER AS $$
1574 RETURN config.interval_to_seconds( interval_string::INTERVAL );
1576 $$ LANGUAGE plpgsql;
1578 CREATE OR REPLACE FUNCTION vandelay.ingest_items ( import_id BIGINT, attr_def_id BIGINT ) RETURNS SETOF vandelay.import_item AS $$
1589 deposit_amount TEXT;
1605 tmp_attr_set RECORD;
1606 attr_set vandelay.import_item%ROWTYPE;
1613 SELECT * INTO attr_def FROM vandelay.import_item_attr_definition WHERE id = attr_def_id;
1617 attr_set.definition := attr_def.id;
1619 -- Build the combined XPath
1623 WHEN attr_def.owning_lib IS NULL THEN 'null()'
1624 WHEN LENGTH( attr_def.owning_lib ) = 1 THEN '//*[@code="' || attr_def.owning_lib || '"]'
1625 ELSE '//*' || attr_def.owning_lib
1630 WHEN attr_def.circ_lib IS NULL THEN 'null()'
1631 WHEN LENGTH( attr_def.circ_lib ) = 1 THEN '//*[@code="' || attr_def.circ_lib || '"]'
1632 ELSE '//*' || attr_def.circ_lib
1637 WHEN attr_def.call_number IS NULL THEN 'null()'
1638 WHEN LENGTH( attr_def.call_number ) = 1 THEN '//*[@code="' || attr_def.call_number || '"]'
1639 ELSE '//*' || attr_def.call_number
1644 WHEN attr_def.copy_number IS NULL THEN 'null()'
1645 WHEN LENGTH( attr_def.copy_number ) = 1 THEN '//*[@code="' || attr_def.copy_number || '"]'
1646 ELSE '//*' || attr_def.copy_number
1651 WHEN attr_def.status IS NULL THEN 'null()'
1652 WHEN LENGTH( attr_def.status ) = 1 THEN '//*[@code="' || attr_def.status || '"]'
1653 ELSE '//*' || attr_def.status
1658 WHEN attr_def.location IS NULL THEN 'null()'
1659 WHEN LENGTH( attr_def.location ) = 1 THEN '//*[@code="' || attr_def.location || '"]'
1660 ELSE '//*' || attr_def.location
1665 WHEN attr_def.circulate IS NULL THEN 'null()'
1666 WHEN LENGTH( attr_def.circulate ) = 1 THEN '//*[@code="' || attr_def.circulate || '"]'
1667 ELSE '//*' || attr_def.circulate
1672 WHEN attr_def.deposit IS NULL THEN 'null()'
1673 WHEN LENGTH( attr_def.deposit ) = 1 THEN '//*[@code="' || attr_def.deposit || '"]'
1674 ELSE '//*' || attr_def.deposit
1679 WHEN attr_def.deposit_amount IS NULL THEN 'null()'
1680 WHEN LENGTH( attr_def.deposit_amount ) = 1 THEN '//*[@code="' || attr_def.deposit_amount || '"]'
1681 ELSE '//*' || attr_def.deposit_amount
1686 WHEN attr_def.ref IS NULL THEN 'null()'
1687 WHEN LENGTH( attr_def.ref ) = 1 THEN '//*[@code="' || attr_def.ref || '"]'
1688 ELSE '//*' || attr_def.ref
1693 WHEN attr_def.holdable IS NULL THEN 'null()'
1694 WHEN LENGTH( attr_def.holdable ) = 1 THEN '//*[@code="' || attr_def.holdable || '"]'
1695 ELSE '//*' || attr_def.holdable
1700 WHEN attr_def.price IS NULL THEN 'null()'
1701 WHEN LENGTH( attr_def.price ) = 1 THEN '//*[@code="' || attr_def.price || '"]'
1702 ELSE '//*' || attr_def.price
1707 WHEN attr_def.barcode IS NULL THEN 'null()'
1708 WHEN LENGTH( attr_def.barcode ) = 1 THEN '//*[@code="' || attr_def.barcode || '"]'
1709 ELSE '//*' || attr_def.barcode
1714 WHEN attr_def.circ_modifier IS NULL THEN 'null()'
1715 WHEN LENGTH( attr_def.circ_modifier ) = 1 THEN '//*[@code="' || attr_def.circ_modifier || '"]'
1716 ELSE '//*' || attr_def.circ_modifier
1721 WHEN attr_def.circ_as_type IS NULL THEN 'null()'
1722 WHEN LENGTH( attr_def.circ_as_type ) = 1 THEN '//*[@code="' || attr_def.circ_as_type || '"]'
1723 ELSE '//*' || attr_def.circ_as_type
1728 WHEN attr_def.alert_message IS NULL THEN 'null()'
1729 WHEN LENGTH( attr_def.alert_message ) = 1 THEN '//*[@code="' || attr_def.alert_message || '"]'
1730 ELSE '//*' || attr_def.alert_message
1735 WHEN attr_def.opac_visible IS NULL THEN 'null()'
1736 WHEN LENGTH( attr_def.opac_visible ) = 1 THEN '//*[@code="' || attr_def.opac_visible || '"]'
1737 ELSE '//*' || attr_def.opac_visible
1742 WHEN attr_def.pub_note IS NULL THEN 'null()'
1743 WHEN LENGTH( attr_def.pub_note ) = 1 THEN '//*[@code="' || attr_def.pub_note || '"]'
1744 ELSE '//*' || attr_def.pub_note
1748 WHEN attr_def.priv_note IS NULL THEN 'null()'
1749 WHEN LENGTH( attr_def.priv_note ) = 1 THEN '//*[@code="' || attr_def.priv_note || '"]'
1750 ELSE '//*' || attr_def.priv_note
1755 WHEN attr_def.internal_id IS NULL THEN 'null()'
1756 WHEN LENGTH( attr_def.internal_id ) = 1 THEN '//*[@code="' || attr_def.internal_id || '"]'
1757 ELSE '//*' || attr_def.internal_id
1762 WHEN attr_def.stat_cat_data IS NULL THEN 'null()'
1763 WHEN LENGTH( attr_def.stat_cat_data ) = 1 THEN '//*[@code="' || attr_def.stat_cat_data || '"]'
1764 ELSE '//*' || attr_def.stat_cat_data
1769 WHEN attr_def.parts_data IS NULL THEN 'null()'
1770 WHEN LENGTH( attr_def.parts_data ) = 1 THEN '//*[@code="' || attr_def.parts_data || '"]'
1771 ELSE '//*' || attr_def.parts_data
1776 xpaths := ARRAY[owning_lib, circ_lib, call_number, copy_number, status, location, circulate,
1777 deposit, deposit_amount, ref, holdable, price, barcode, circ_modifier, circ_as_type,
1778 alert_message, pub_note, priv_note, internal_id, stat_cat_data, parts_data, opac_visible];
1782 FROM oils_xpath_tag_to_table( (SELECT marc FROM vandelay.queued_bib_record WHERE id = import_id), attr_def.tag, xpaths)
1783 AS t( ol TEXT, clib TEXT, cn TEXT, cnum TEXT, cs TEXT, cl TEXT, circ TEXT,
1784 dep TEXT, dep_amount TEXT, r TEXT, hold TEXT, pr TEXT, bc TEXT, circ_mod TEXT,
1785 circ_as TEXT, amessage TEXT, note TEXT, pnote TEXT, internal_id TEXT,
1786 stat_cat_data TEXT, parts_data TEXT, opac_vis TEXT )
1789 attr_set.import_error := NULL;
1790 attr_set.error_detail := NULL;
1791 attr_set.deposit_amount := NULL;
1792 attr_set.copy_number := NULL;
1793 attr_set.price := NULL;
1794 attr_set.circ_modifier := NULL;
1795 attr_set.location := NULL;
1796 attr_set.barcode := NULL;
1797 attr_set.call_number := NULL;
1799 IF tmp_attr_set.pr != '' THEN
1800 tmp_str = REGEXP_REPLACE(tmp_attr_set.pr, E'[^0-9\\.]', '', 'g');
1801 IF tmp_str = '' THEN
1802 attr_set.import_error := 'import.item.invalid.price';
1803 attr_set.error_detail := tmp_attr_set.pr; -- original value
1804 RETURN NEXT attr_set; CONTINUE;
1806 attr_set.price := tmp_str::NUMERIC(8,2);
1809 IF tmp_attr_set.dep_amount != '' THEN
1810 tmp_str = REGEXP_REPLACE(tmp_attr_set.dep_amount, E'[^0-9\\.]', '', 'g');
1811 IF tmp_str = '' THEN
1812 attr_set.import_error := 'import.item.invalid.deposit_amount';
1813 attr_set.error_detail := tmp_attr_set.dep_amount;
1814 RETURN NEXT attr_set; CONTINUE;
1816 attr_set.deposit_amount := tmp_str::NUMERIC(8,2);
1819 IF tmp_attr_set.cnum != '' THEN
1820 tmp_str = REGEXP_REPLACE(tmp_attr_set.cnum, E'[^0-9]', '', 'g');
1821 IF tmp_str = '' THEN
1822 attr_set.import_error := 'import.item.invalid.copy_number';
1823 attr_set.error_detail := tmp_attr_set.cnum;
1824 RETURN NEXT attr_set; CONTINUE;
1826 attr_set.copy_number := tmp_str::INT;
1829 IF tmp_attr_set.ol != '' THEN
1830 SELECT id INTO attr_set.owning_lib FROM actor.org_unit WHERE shortname = UPPER(tmp_attr_set.ol); -- INT
1832 attr_set.import_error := 'import.item.invalid.owning_lib';
1833 attr_set.error_detail := tmp_attr_set.ol;
1834 RETURN NEXT attr_set; CONTINUE;
1838 IF tmp_attr_set.clib != '' THEN
1839 SELECT id INTO attr_set.circ_lib FROM actor.org_unit WHERE shortname = UPPER(tmp_attr_set.clib); -- INT
1841 attr_set.import_error := 'import.item.invalid.circ_lib';
1842 attr_set.error_detail := tmp_attr_set.clib;
1843 RETURN NEXT attr_set; CONTINUE;
1847 IF tmp_attr_set.cs != '' THEN
1848 SELECT id INTO attr_set.status FROM config.copy_status WHERE LOWER(name) = LOWER(tmp_attr_set.cs); -- INT
1850 attr_set.import_error := 'import.item.invalid.status';
1851 attr_set.error_detail := tmp_attr_set.cs;
1852 RETURN NEXT attr_set; CONTINUE;
1856 IF COALESCE(tmp_attr_set.circ_mod, '') = '' THEN
1858 -- no circ mod defined, see if we should apply a default
1859 SELECT INTO attr_set.circ_modifier TRIM(BOTH '"' FROM value)
1860 FROM actor.org_unit_ancestor_setting(
1861 'vandelay.item.circ_modifier.default',
1865 -- make sure the value from the org setting is still valid
1866 PERFORM 1 FROM config.circ_modifier WHERE code = attr_set.circ_modifier;
1868 attr_set.import_error := 'import.item.invalid.circ_modifier';
1869 attr_set.error_detail := tmp_attr_set.circ_mod;
1870 RETURN NEXT attr_set; CONTINUE;
1875 SELECT code INTO attr_set.circ_modifier FROM config.circ_modifier WHERE code = tmp_attr_set.circ_mod;
1877 attr_set.import_error := 'import.item.invalid.circ_modifier';
1878 attr_set.error_detail := tmp_attr_set.circ_mod;
1879 RETURN NEXT attr_set; CONTINUE;
1883 IF tmp_attr_set.circ_as != '' THEN
1884 SELECT code INTO attr_set.circ_as_type FROM config.coded_value_map WHERE ctype = 'item_type' AND code = tmp_attr_set.circ_as;
1886 attr_set.import_error := 'import.item.invalid.circ_as_type';
1887 attr_set.error_detail := tmp_attr_set.circ_as;
1888 RETURN NEXT attr_set; CONTINUE;
1892 IF COALESCE(tmp_attr_set.cl, '') = '' THEN
1893 -- no location specified, see if we should apply a default
1895 SELECT INTO attr_set.location TRIM(BOTH '"' FROM value)
1896 FROM actor.org_unit_ancestor_setting(
1897 'vandelay.item.copy_location.default',
1901 -- make sure the value from the org setting is still valid
1902 PERFORM 1 FROM asset.copy_location
1903 WHERE id = attr_set.location AND NOT deleted;
1905 attr_set.import_error := 'import.item.invalid.location';
1906 attr_set.error_detail := tmp_attr_set.cs;
1907 RETURN NEXT attr_set; CONTINUE;
1911 -- search up the org unit tree for a matching copy location
1912 WITH RECURSIVE anscestor_depth AS (
1916 FROM actor.org_unit ou
1917 JOIN actor.org_unit_type out ON (out.id = ou.ou_type)
1918 WHERE ou.id = COALESCE(attr_set.owning_lib, attr_set.circ_lib)
1923 FROM actor.org_unit ou
1924 JOIN actor.org_unit_type out ON (out.id = ou.ou_type)
1925 JOIN anscestor_depth ot ON (ot.parent_ou = ou.id)
1926 ) SELECT cpl.id INTO attr_set.location
1927 FROM anscestor_depth a
1928 JOIN asset.copy_location cpl ON (cpl.owning_lib = a.id)
1929 WHERE LOWER(cpl.name) = LOWER(tmp_attr_set.cl)
1931 ORDER BY a.depth DESC
1935 attr_set.import_error := 'import.item.invalid.location';
1936 attr_set.error_detail := tmp_attr_set.cs;
1937 RETURN NEXT attr_set; CONTINUE;
1941 attr_set.circulate :=
1942 LOWER( SUBSTRING( tmp_attr_set.circ, 1, 1)) IN ('t','y','1')
1943 OR LOWER(tmp_attr_set.circ) = 'circulating'; -- BOOL
1946 LOWER( SUBSTRING( tmp_attr_set.dep, 1, 1 ) ) IN ('t','y','1')
1947 OR LOWER(tmp_attr_set.dep) = 'deposit'; -- BOOL
1949 attr_set.holdable :=
1950 LOWER( SUBSTRING( tmp_attr_set.hold, 1, 1 ) ) IN ('t','y','1')
1951 OR LOWER(tmp_attr_set.hold) = 'holdable'; -- BOOL
1953 attr_set.opac_visible :=
1954 LOWER( SUBSTRING( tmp_attr_set.opac_vis, 1, 1 ) ) IN ('t','y','1')
1955 OR LOWER(tmp_attr_set.opac_vis) = 'visible'; -- BOOL
1958 LOWER( SUBSTRING( tmp_attr_set.r, 1, 1 ) ) IN ('t','y','1')
1959 OR LOWER(tmp_attr_set.r) = 'reference'; -- BOOL
1961 attr_set.call_number := tmp_attr_set.cn; -- TEXT
1962 attr_set.barcode := tmp_attr_set.bc; -- TEXT,
1963 attr_set.alert_message := tmp_attr_set.amessage; -- TEXT,
1964 attr_set.pub_note := tmp_attr_set.note; -- TEXT,
1965 attr_set.priv_note := tmp_attr_set.pnote; -- TEXT,
1966 attr_set.alert_message := tmp_attr_set.amessage; -- TEXT,
1967 attr_set.internal_id := tmp_attr_set.internal_id::BIGINT;
1968 attr_set.stat_cat_data := tmp_attr_set.stat_cat_data; -- TEXT,
1969 attr_set.parts_data := tmp_attr_set.parts_data; -- TEXT,
1971 RETURN NEXT attr_set;
1980 $$ LANGUAGE PLPGSQL;
1984 CREATE OR REPLACE FUNCTION vandelay.ingest_bib_items ( ) RETURNS TRIGGER AS $func$
1987 item_data vandelay.import_item%ROWTYPE;
1990 IF TG_OP IN ('INSERT','UPDATE') AND NEW.imported_as IS NOT NULL THEN
1994 SELECT item_attr_def INTO attr_def FROM vandelay.bib_queue WHERE id = NEW.queue;
1996 FOR item_data IN SELECT * FROM vandelay.ingest_items( NEW.id::BIGINT, attr_def ) LOOP
1997 INSERT INTO vandelay.import_item (
2026 item_data.definition,
2027 item_data.owning_lib,
2029 item_data.call_number,
2030 item_data.copy_number,
2033 item_data.circulate,
2035 item_data.deposit_amount,
2040 item_data.circ_modifier,
2041 item_data.circ_as_type,
2042 item_data.alert_message,
2044 item_data.priv_note,
2045 item_data.internal_id,
2046 item_data.opac_visible,
2047 item_data.stat_cat_data,
2048 item_data.parts_data,
2049 item_data.import_error,
2050 item_data.error_detail
2056 $func$ LANGUAGE PLPGSQL;
2058 CREATE TRIGGER ingest_item_trigger
2059 AFTER INSERT OR UPDATE ON vandelay.queued_bib_record
2060 FOR EACH ROW EXECUTE PROCEDURE vandelay.ingest_bib_items();
2063 -- evergreen.generic_map_normalizer
2065 CREATE OR REPLACE FUNCTION evergreen.generic_map_normalizer ( TEXT, TEXT ) RETURNS TEXT AS $f$
2069 my $default = $string;
2072 while (/^\s*?(.*?)\s*?=>\s*?(\S+)\s*/) {
2076 $map{$2} = [split(/\s*,\s*/, $1)];
2081 for my $key ( keys %map ) {
2082 return $key if (grep { $_ eq $string } @{ $map{$key} });
2087 $f$ LANGUAGE PLPERLU;
2089 CREATE OR REPLACE FUNCTION actor.address_alert_matches (
2098 mailing_address BOOL DEFAULT FALSE,
2099 billing_address BOOL DEFAULT FALSE
2100 ) RETURNS SETOF actor.address_alert AS $$
2103 FROM actor.address_alert
2106 AND owner IN (SELECT id FROM actor.org_unit_ancestors($1))
2108 (NOT mailing_address AND NOT billing_address)
2109 OR (mailing_address AND $9)
2110 OR (billing_address AND $10)
2115 AND COALESCE($2, '') ~* COALESCE(street1, '.*')
2116 AND COALESCE($3, '') ~* COALESCE(street2, '.*')
2117 AND COALESCE($4, '') ~* COALESCE(city, '.*')
2118 AND COALESCE($5, '') ~* COALESCE(county, '.*')
2119 AND COALESCE($6, '') ~* COALESCE(state, '.*')
2120 AND COALESCE($7, '') ~* COALESCE(country, '.*')
2121 AND COALESCE($8, '') ~* COALESCE(post_code, '.*')
2135 ORDER BY actor.org_unit_proximity(owner, $1)
2138 CREATE OR REPLACE FUNCTION evergreen.coded_value_map_normalizer( input TEXT, ctype TEXT )
2140 SELECT COALESCE(value,$1)
2141 FROM config.coded_value_map
2142 WHERE ctype = $2 AND code = $1;
2145 -- user activity functions --
2147 -- remove transient activity entries on insert of new entries
2148 CREATE OR REPLACE FUNCTION actor.usr_activity_transient_trg () RETURNS TRIGGER AS $$
2150 DELETE FROM actor.usr_activity act USING config.usr_activity_type atype
2151 WHERE atype.transient AND
2152 NEW.etype = atype.id AND
2153 act.etype = atype.id AND
2157 $$ LANGUAGE PLPGSQL;
2159 CREATE TRIGGER remove_transient_usr_activity
2160 BEFORE INSERT ON actor.usr_activity
2161 FOR EACH ROW EXECUTE PROCEDURE actor.usr_activity_transient_trg();
2163 -- given a set of activity criteria, find the most approprate activity type
2164 CREATE OR REPLACE FUNCTION actor.usr_activity_get_type (
2168 ) RETURNS SETOF config.usr_activity_type AS $$
2169 SELECT * FROM config.usr_activity_type
2172 (ewho IS NULL OR ewho = $1) AND
2173 (ewhat IS NULL OR ewhat = $2) AND
2174 (ehow IS NULL OR ehow = $3)
2176 -- BOOL comparisons sort false to true
2177 COALESCE(ewho, '') != COALESCE($1, ''),
2178 COALESCE(ewhat,'') != COALESCE($2, ''),
2179 COALESCE(ehow, '') != COALESCE($3, '')
2183 -- given a set of activity criteria, finds the best
2184 -- activity type and inserts the activity entry
2185 CREATE OR REPLACE FUNCTION actor.insert_usr_activity (
2190 ) RETURNS SETOF actor.usr_activity AS $$
2192 new_row actor.usr_activity%ROWTYPE;
2194 SELECT id INTO new_row.etype FROM actor.usr_activity_get_type(ewho, ewhat, ehow);
2197 INSERT INTO actor.usr_activity (usr, etype)
2198 VALUES (usr, new_row.etype)
2199 RETURNING * INTO new_row;
2200 RETURN NEXT new_row;
2203 $$ LANGUAGE plpgsql;
2205 CREATE OR REPLACE FUNCTION evergreen.rel_bump(terms TEXT[], value TEXT, bumps TEXT[], mults NUMERIC[]) RETURNS NUMERIC AS
2208 my ($terms,$value,$bumps,$mults) = @_;
2212 for (my $id = 0; $id < @$bumps; $id++) {
2213 if ($bumps->[$id] eq 'first_word') {
2214 $retval *= $mults->[$id] if ($value =~ /^$terms->[0]/);
2215 } elsif ($bumps->[$id] eq 'full_match') {
2216 my $fullmatch = join(' ', @$terms);
2217 $retval *= $mults->[$id] if ($value =~ /^$fullmatch$/);
2218 } elsif ($bumps->[$id] eq 'word_order') {
2219 my $wordorder = join('.*', @$terms);
2220 $retval *= $mults->[$id] if ($value =~ /$wordorder/);
2224 $BODY$ LANGUAGE plperlu IMMUTABLE STRICT COST 100;
2226 -- user activity functions --
2229 -- find the most relevant set of credentials for the Z source and org
2230 CREATE OR REPLACE FUNCTION config.z3950_source_credentials_lookup
2231 (source TEXT, owner INTEGER)
2232 RETURNS config.z3950_source_credentials AS $$
2235 FROM config.z3950_source_credentials creds
2236 JOIN actor.org_unit aou ON (aou.id = creds.owner)
2237 JOIN actor.org_unit_type aout ON (aout.id = aou.ou_type)
2238 WHERE creds.source = $1 AND creds.owner IN (
2239 SELECT id FROM actor.org_unit_ancestors($2)
2241 ORDER BY aout.depth DESC LIMIT 1;
2243 $$ LANGUAGE SQL STABLE;
2245 -- since we are not exposing config.z3950_source_credentials
2246 -- via the IDL, providing a stored proc gives us a way to
2247 -- set values in the table via cstore
2248 CREATE OR REPLACE FUNCTION config.z3950_source_credentials_apply
2249 (src TEXT, org INTEGER, uname TEXT, passwd TEXT)
2252 PERFORM 1 FROM config.z3950_source_credentials
2253 WHERE owner = org AND source = src;
2256 IF COALESCE(uname, '') = '' AND COALESCE(passwd, '') = '' THEN
2257 DELETE FROM config.z3950_source_credentials
2258 WHERE owner = org AND source = src;
2260 UPDATE config.z3950_source_credentials
2261 SET username = uname, password = passwd
2262 WHERE owner = org AND source = src;
2265 IF COALESCE(uname, '') <> '' OR COALESCE(passwd, '') <> '' THEN
2266 INSERT INTO config.z3950_source_credentials
2267 (source, owner, username, password)
2268 VALUES (src, org, uname, passwd);
2272 $$ LANGUAGE PLPGSQL;
2274 -- Handy function for transforming marc to a variant available on config.xml_transform
2275 CREATE OR REPLACE FUNCTION evergreen.marc_to (marc text, xfrm text) RETURNS TEXT AS $$
2276 SELECT evergreen.xml_pretty_print(xslt_process($1,xslt)::XML)::TEXT FROM config.xml_transform WHERE name = $2;