Open-ILS/src/sql/Pg/999.functions.global.sql

   1 /*
   2  * Copyright (C) 2008 Equinox Software, Inc.
   3  * Bill Erickson <erickson@esilibrary.com>
   4  *
   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.
   9  *
  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.
  14  *
  15  */
  16
  17 CREATE OR REPLACE FUNCTION actor.usr_merge_rows( table_name TEXT, col_name TEXT, src_usr INT, dest_usr INT ) RETURNS VOID AS $$
  18 DECLARE
  19     sel TEXT;
  20     upd TEXT;
  21     del TEXT;
  22     cur_row RECORD;
  23 BEGIN
  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
  28         BEGIN
  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;
  34         END;
  35     END LOOP;
  36 END;
  37 $$ LANGUAGE plpgsql;
  38
  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.
  42 $$;
  43
  44
  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 $$
  46 DECLARE
  47         suffix TEXT;
  48         bucket_row RECORD;
  49         picklist_row RECORD;
  50         queue_row RECORD;
  51         folder_row RECORD;
  52 BEGIN
  53
  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
  57         RETURN;
  58     END IF;
  59
  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;
  64
  65     -- actor.*
  66     IF del_cards THEN
  67         DELETE FROM actor.card where usr = src_usr;
  68     ELSE
  69         IF deactivate_cards THEN
  70             UPDATE actor.card SET active = 'f' WHERE usr = src_usr;
  71         END IF;
  72         UPDATE actor.card SET usr = dest_usr WHERE usr = src_usr;
  73     END IF;
  74
  75
  76     IF del_addrs THEN
  77         DELETE FROM actor.usr_address WHERE usr = src_usr;
  78     ELSE
  79         UPDATE actor.usr_address SET usr = dest_usr WHERE usr = src_usr;
  80     END IF;
  81
  82     UPDATE actor.usr_note 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);
  87
  88     -- permission.*
  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);
  93
  94
  95     -- container.*
  96
  97         -- For each *_bucket table: transfer every bucket belonging to src_usr
  98         -- into the custody of dest_usr.
  99         --
 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.
 104         --
 105         FOR bucket_row in
 106                 SELECT id, name
 107                 FROM   container.biblio_record_entry_bucket
 108                 WHERE  owner = src_usr
 109         LOOP
 110                 suffix := ' (' || src_usr || ')';
 111                 LOOP
 112                         BEGIN
 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 || ' ';
 118                                 CONTINUE;
 119                         END;
 120                         EXIT;
 121                 END LOOP;
 122         END LOOP;
 123
 124         FOR bucket_row in
 125                 SELECT id, name
 126                 FROM   container.call_number_bucket
 127                 WHERE  owner = src_usr
 128         LOOP
 129                 suffix := ' (' || src_usr || ')';
 130                 LOOP
 131                         BEGIN
 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 || ' ';
 137                                 CONTINUE;
 138                         END;
 139                         EXIT;
 140                 END LOOP;
 141         END LOOP;
 142
 143         FOR bucket_row in
 144                 SELECT id, name
 145                 FROM   container.copy_bucket
 146                 WHERE  owner = src_usr
 147         LOOP
 148                 suffix := ' (' || src_usr || ')';
 149                 LOOP
 150                         BEGIN
 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 || ' ';
 156                                 CONTINUE;
 157                         END;
 158                         EXIT;
 159                 END LOOP;
 160         END LOOP;
 161
 162         FOR bucket_row in
 163                 SELECT id, name
 164                 FROM   container.user_bucket
 165                 WHERE  owner = src_usr
 166         LOOP
 167                 suffix := ' (' || src_usr || ')';
 168                 LOOP
 169                         BEGIN
 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 || ' ';
 175                                 CONTINUE;
 176                         END;
 177                         EXIT;
 178                 END LOOP;
 179         END LOOP;
 180
 181         UPDATE container.user_bucket_item SET target_user = dest_usr WHERE target_user = src_usr;
 182
 183     -- vandelay.*
 184         -- transfer queues the same way we transfer buckets (see above)
 185         FOR queue_row in
 186                 SELECT id, name
 187                 FROM   vandelay.queue
 188                 WHERE  owner = src_usr
 189         LOOP
 190                 suffix := ' (' || src_usr || ')';
 191                 LOOP
 192                         BEGIN
 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 || ' ';
 198                                 CONTINUE;
 199                         END;
 200                         EXIT;
 201                 END LOOP;
 202         END LOOP;
 203
 204     UPDATE vandelay.session_tracker SET usr = dest_usr WHERE usr = src_usr;
 205
 206     -- money.*
 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;
 212
 213     -- action.*
 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;
 218
 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;
 223
 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;
 229
 230     -- acq.*
 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;
 234
 235         -- transfer picklists the same way we transfer buckets (see above)
 236         FOR picklist_row in
 237                 SELECT id, name
 238                 FROM   acq.picklist
 239                 WHERE  owner = src_usr
 240         LOOP
 241                 suffix := ' (' || src_usr || ')';
 242                 LOOP
 243                         BEGIN
 244                                 UPDATE  acq.picklist
 245                                 SET     owner = dest_usr, name = name || suffix
 246                                 WHERE   id = picklist_row.id;
 247                         EXCEPTION WHEN unique_violation THEN
 248                                 suffix := suffix || ' ';
 249                                 CONTINUE;
 250                         END;
 251                         EXIT;
 252                 END LOOP;
 253         END LOOP;
 254
 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;
 263
 264     -- asset.*
 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;
 271
 272     -- serial.*
 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;
 275
 276     -- reporter.*
 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.
 279     BEGIN
 280         UPDATE reporter.template SET owner = dest_usr WHERE owner = src_usr;
 281     EXCEPTION WHEN undefined_table THEN
 282         -- do nothing
 283     END;
 284     BEGIN
 285         UPDATE reporter.report SET owner = dest_usr WHERE owner = src_usr;
 286     EXCEPTION WHEN undefined_table THEN
 287         -- do nothing
 288     END;
 289     BEGIN
 290         UPDATE reporter.schedule SET runner = dest_usr WHERE runner = src_usr;
 291     EXCEPTION WHEN undefined_table THEN
 292         -- do nothing
 293     END;
 294     BEGIN
 295                 -- transfer folders the same way we transfer buckets (see above)
 296                 FOR folder_row in
 297                         SELECT id, name
 298                         FROM   reporter.template_folder
 299                         WHERE  owner = src_usr
 300                 LOOP
 301                         suffix := ' (' || src_usr || ')';
 302                         LOOP
 303                                 BEGIN
 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 || ' ';
 309                                         CONTINUE;
 310                                 END;
 311                                 EXIT;
 312                         END LOOP;
 313                 END LOOP;
 314     EXCEPTION WHEN undefined_table THEN
 315         -- do nothing
 316     END;
 317     BEGIN
 318                 -- transfer folders the same way we transfer buckets (see above)
 319                 FOR folder_row in
 320                         SELECT id, name
 321                         FROM   reporter.report_folder
 322                         WHERE  owner = src_usr
 323                 LOOP
 324                         suffix := ' (' || src_usr || ')';
 325                         LOOP
 326                                 BEGIN
 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 || ' ';
 332                                         CONTINUE;
 333                                 END;
 334                                 EXIT;
 335                         END LOOP;
 336                 END LOOP;
 337     EXCEPTION WHEN undefined_table THEN
 338         -- do nothing
 339     END;
 340     BEGIN
 341                 -- transfer folders the same way we transfer buckets (see above)
 342                 FOR folder_row in
 343                         SELECT id, name
 344                         FROM   reporter.output_folder
 345                         WHERE  owner = src_usr
 346                 LOOP
 347                         suffix := ' (' || src_usr || ')';
 348                         LOOP
 349                                 BEGIN
 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 || ' ';
 355                                         CONTINUE;
 356                                 END;
 357                                 EXIT;
 358                         END LOOP;
 359                 END LOOP;
 360     EXCEPTION WHEN undefined_table THEN
 361         -- do nothing
 362     END;
 363
 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)
 367     UPDATE actor.usr SET
 368         pref_prefix =
 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)),
 374         pref_family_name =
 375             COALESCE(pref_family_name, (SELECT pref_family_name FROM susr)),
 376         pref_suffix =
 377             COALESCE(pref_suffix, (SELECT pref_suffix FROM susr))
 378     WHERE id = dest_usr;
 379
 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 = (
 385         WITH keywords AS (
 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+'
 390                 )
 391             ) AS parts
 392         ) SELECT ARRAY_TO_STRING(ARRAY_AGG(kw.parts), ' ') FROM keywords kw
 393     ) WHERE id = dest_usr;
 394
 395     -- Finally, delete the source user
 396     DELETE FROM actor.usr WHERE id = src_usr;
 397
 398 END;
 399 $$ LANGUAGE plpgsql;
 400
 401
 402
 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.
 406 $$;
 407
 408
 409 CREATE OR REPLACE FUNCTION actor.usr_purge_data(
 410         src_usr  IN INTEGER,
 411         specified_dest_usr IN INTEGER
 412 ) RETURNS VOID AS $$
 413 DECLARE
 414         suffix TEXT;
 415         renamable_row RECORD;
 416         dest_usr INTEGER;
 417 BEGIN
 418
 419         IF specified_dest_usr IS NULL THEN
 420                 dest_usr := 1; -- Admin user on stock installs
 421         ELSE
 422                 dest_usr := specified_dest_usr;
 423         END IF;
 424
 425         -- acq.*
 426         UPDATE acq.fund_allocation SET allocator = dest_usr WHERE allocator = src_usr;
 427         UPDATE acq.lineitem SET creator = dest_usr WHERE creator = src_usr;
 428         UPDATE acq.lineitem SET editor = dest_usr WHERE editor = src_usr;
 429         UPDATE acq.lineitem SET selector = dest_usr WHERE selector = src_usr;
 430         UPDATE acq.lineitem_note SET creator = dest_usr WHERE creator = src_usr;
 431         UPDATE acq.lineitem_note SET editor = dest_usr WHERE editor = src_usr;
 432     UPDATE acq.invoice SET closed_by = dest_usr WHERE closed_by = src_usr;
 433         DELETE FROM acq.lineitem_usr_attr_definition WHERE usr = src_usr;
 434
 435         -- Update with a rename to avoid collisions
 436         FOR renamable_row in
 437                 SELECT id, name
 438                 FROM   acq.picklist
 439                 WHERE  owner = src_usr
 440         LOOP
 441                 suffix := ' (' || src_usr || ')';
 442                 LOOP
 443                         BEGIN
 444                                 UPDATE  acq.picklist
 445                                 SET     owner = dest_usr, name = name || suffix
 446                                 WHERE   id = renamable_row.id;
 447                         EXCEPTION WHEN unique_violation THEN
 448                                 suffix := suffix || ' ';
 449                                 CONTINUE;
 450                         END;
 451                         EXIT;
 452                 END LOOP;
 453         END LOOP;
 454
 455         UPDATE acq.picklist SET creator = dest_usr WHERE creator = src_usr;
 456         UPDATE acq.picklist SET editor = dest_usr WHERE editor = src_usr;
 457         UPDATE acq.po_note SET creator = dest_usr WHERE creator = src_usr;
 458         UPDATE acq.po_note SET editor = dest_usr WHERE editor = src_usr;
 459         UPDATE acq.purchase_order SET owner = dest_usr WHERE owner = src_usr;
 460         UPDATE acq.purchase_order SET creator = dest_usr WHERE creator = src_usr;
 461         UPDATE acq.purchase_order SET editor = dest_usr WHERE editor = src_usr;
 462         UPDATE acq.claim_event SET creator = dest_usr WHERE creator = src_usr;
 463
 464         -- action.*
 465         DELETE FROM action.circulation WHERE usr = src_usr;
 466         UPDATE action.circulation SET circ_staff = dest_usr WHERE circ_staff = src_usr;
 467         UPDATE action.circulation SET checkin_staff = dest_usr WHERE checkin_staff = src_usr;
 468         UPDATE action.hold_notification SET notify_staff = dest_usr WHERE notify_staff = src_usr;
 469         UPDATE action.hold_request SET fulfillment_staff = dest_usr WHERE fulfillment_staff = src_usr;
 470         UPDATE action.hold_request SET requestor = dest_usr WHERE requestor = src_usr;
 471         DELETE FROM action.hold_request WHERE usr = src_usr;
 472         UPDATE action.in_house_use SET staff = dest_usr WHERE staff = src_usr;
 473         UPDATE action.non_cat_in_house_use SET staff = dest_usr WHERE staff = src_usr;
 474         DELETE FROM action.non_cataloged_circulation WHERE patron = src_usr;
 475         UPDATE action.non_cataloged_circulation SET staff = dest_usr WHERE staff = src_usr;
 476         DELETE FROM action.survey_response WHERE usr = src_usr;
 477         UPDATE action.fieldset SET owner = dest_usr WHERE owner = src_usr;
 478         DELETE FROM action.usr_circ_history WHERE usr = src_usr;
 479
 480         -- actor.*
 481         DELETE FROM actor.card WHERE usr = src_usr;
 482         DELETE FROM actor.stat_cat_entry_usr_map WHERE target_usr = src_usr;
 483
 484         -- The following update is intended to avoid transient violations of a foreign
 485         -- key constraint, whereby actor.usr_address references itself.  It may not be
 486         -- necessary, but it does no harm.
 487         UPDATE actor.usr_address SET replaces = NULL
 488                 WHERE usr = src_usr AND replaces IS NOT NULL;
 489         DELETE FROM actor.usr_address WHERE usr = src_usr;
 490         DELETE FROM actor.usr_note WHERE usr = src_usr;
 491         UPDATE actor.usr_note SET creator = dest_usr WHERE creator = src_usr;
 492         DELETE FROM actor.usr_org_unit_opt_in WHERE usr = src_usr;
 493         UPDATE actor.usr_org_unit_opt_in SET staff = dest_usr WHERE staff = src_usr;
 494         DELETE FROM actor.usr_setting WHERE usr = src_usr;
 495         DELETE FROM actor.usr_standing_penalty WHERE usr = src_usr;
 496         UPDATE actor.usr_standing_penalty SET staff = dest_usr WHERE staff = src_usr;
 497
 498         -- asset.*
 499         UPDATE asset.call_number SET creator = dest_usr WHERE creator = src_usr;
 500         UPDATE asset.call_number SET editor = dest_usr WHERE editor = src_usr;
 501         UPDATE asset.call_number_note SET creator = dest_usr WHERE creator = src_usr;
 502         UPDATE asset.copy SET creator = dest_usr WHERE creator = src_usr;
 503         UPDATE asset.copy SET editor = dest_usr WHERE editor = src_usr;
 504         UPDATE asset.copy_note SET creator = dest_usr WHERE creator = src_usr;
 505
 506         -- auditor.*
 507         DELETE FROM auditor.actor_usr_address_history WHERE id = src_usr;
 508         DELETE FROM auditor.actor_usr_history WHERE id = src_usr;
 509         UPDATE auditor.asset_call_number_history SET creator = dest_usr WHERE creator = src_usr;
 510         UPDATE auditor.asset_call_number_history SET editor  = dest_usr WHERE editor  = src_usr;
 511         UPDATE auditor.asset_copy_history SET creator = dest_usr WHERE creator = src_usr;
 512         UPDATE auditor.asset_copy_history SET editor  = dest_usr WHERE editor  = src_usr;
 513         UPDATE auditor.biblio_record_entry_history SET creator = dest_usr WHERE creator = src_usr;
 514         UPDATE auditor.biblio_record_entry_history SET editor  = dest_usr WHERE editor  = src_usr;
 515
 516         -- biblio.*
 517         UPDATE biblio.record_entry SET creator = dest_usr WHERE creator = src_usr;
 518         UPDATE biblio.record_entry SET editor = dest_usr WHERE editor = src_usr;
 519         UPDATE biblio.record_note SET creator = dest_usr WHERE creator = src_usr;
 520         UPDATE biblio.record_note SET editor = dest_usr WHERE editor = src_usr;
 521
 522         -- container.*
 523         -- Update buckets with a rename to avoid collisions
 524         FOR renamable_row in
 525                 SELECT id, name
 526                 FROM   container.biblio_record_entry_bucket
 527                 WHERE  owner = src_usr
 528         LOOP
 529                 suffix := ' (' || src_usr || ')';
 530                 LOOP
 531                         BEGIN
 532                                 UPDATE  container.biblio_record_entry_bucket
 533                                 SET     owner = dest_usr, name = name || suffix
 534                                 WHERE   id = renamable_row.id;
 535                         EXCEPTION WHEN unique_violation THEN
 536                                 suffix := suffix || ' ';
 537                                 CONTINUE;
 538                         END;
 539                         EXIT;
 540                 END LOOP;
 541         END LOOP;
 542
 543         FOR renamable_row in
 544                 SELECT id, name
 545                 FROM   container.call_number_bucket
 546                 WHERE  owner = src_usr
 547         LOOP
 548                 suffix := ' (' || src_usr || ')';
 549                 LOOP
 550                         BEGIN
 551                                 UPDATE  container.call_number_bucket
 552                                 SET     owner = dest_usr, name = name || suffix
 553                                 WHERE   id = renamable_row.id;
 554                         EXCEPTION WHEN unique_violation THEN
 555                                 suffix := suffix || ' ';
 556                                 CONTINUE;
 557                         END;
 558                         EXIT;
 559                 END LOOP;
 560         END LOOP;
 561
 562         FOR renamable_row in
 563                 SELECT id, name
 564                 FROM   container.copy_bucket
 565                 WHERE  owner = src_usr
 566         LOOP
 567                 suffix := ' (' || src_usr || ')';
 568                 LOOP
 569                         BEGIN
 570                                 UPDATE  container.copy_bucket
 571                                 SET     owner = dest_usr, name = name || suffix
 572                                 WHERE   id = renamable_row.id;
 573                         EXCEPTION WHEN unique_violation THEN
 574                                 suffix := suffix || ' ';
 575                                 CONTINUE;
 576                         END;
 577                         EXIT;
 578                 END LOOP;
 579         END LOOP;
 580
 581         FOR renamable_row in
 582                 SELECT id, name
 583                 FROM   container.user_bucket
 584                 WHERE  owner = src_usr
 585         LOOP
 586                 suffix := ' (' || src_usr || ')';
 587                 LOOP
 588                         BEGIN
 589                                 UPDATE  container.user_bucket
 590                                 SET     owner = dest_usr, name = name || suffix
 591                                 WHERE   id = renamable_row.id;
 592                         EXCEPTION WHEN unique_violation THEN
 593                                 suffix := suffix || ' ';
 594                                 CONTINUE;
 595                         END;
 596                         EXIT;
 597                 END LOOP;
 598         END LOOP;
 599
 600         DELETE FROM container.user_bucket_item WHERE target_user = src_usr;
 601
 602         -- money.*
 603         DELETE FROM money.billable_xact WHERE usr = src_usr;
 604         DELETE FROM money.collections_tracker WHERE usr = src_usr;
 605         UPDATE money.collections_tracker SET collector = dest_usr WHERE collector = src_usr;
 606
 607         -- permission.*
 608         DELETE FROM permission.usr_grp_map WHERE usr = src_usr;
 609         DELETE FROM permission.usr_object_perm_map WHERE usr = src_usr;
 610         DELETE FROM permission.usr_perm_map WHERE usr = src_usr;
 611         DELETE FROM permission.usr_work_ou_map WHERE usr = src_usr;
 612
 613         -- reporter.*
 614         -- Update with a rename to avoid collisions
 615         BEGIN
 616                 FOR renamable_row in
 617                         SELECT id, name
 618                         FROM   reporter.output_folder
 619                         WHERE  owner = src_usr
 620                 LOOP
 621                         suffix := ' (' || src_usr || ')';
 622                         LOOP
 623                                 BEGIN
 624                                         UPDATE  reporter.output_folder
 625                                         SET     owner = dest_usr, name = name || suffix
 626                                         WHERE   id = renamable_row.id;
 627                                 EXCEPTION WHEN unique_violation THEN
 628                                         suffix := suffix || ' ';
 629                                         CONTINUE;
 630                                 END;
 631                                 EXIT;
 632                         END LOOP;
 633                 END LOOP;
 634         EXCEPTION WHEN undefined_table THEN
 635                 -- do nothing
 636         END;
 637
 638         BEGIN
 639                 UPDATE reporter.report SET owner = dest_usr WHERE owner = src_usr;
 640         EXCEPTION WHEN undefined_table THEN
 641                 -- do nothing
 642         END;
 643
 644         -- Update with a rename to avoid collisions
 645         BEGIN
 646                 FOR renamable_row in
 647                         SELECT id, name
 648                         FROM   reporter.report_folder
 649                         WHERE  owner = src_usr
 650                 LOOP
 651                         suffix := ' (' || src_usr || ')';
 652                         LOOP
 653                                 BEGIN
 654                                         UPDATE  reporter.report_folder
 655                                         SET     owner = dest_usr, name = name || suffix
 656                                         WHERE   id = renamable_row.id;
 657                                 EXCEPTION WHEN unique_violation THEN
 658                                         suffix := suffix || ' ';
 659                                         CONTINUE;
 660                                 END;
 661                                 EXIT;
 662                         END LOOP;
 663                 END LOOP;
 664         EXCEPTION WHEN undefined_table THEN
 665                 -- do nothing
 666         END;
 667
 668         BEGIN
 669                 UPDATE reporter.schedule SET runner = dest_usr WHERE runner = src_usr;
 670         EXCEPTION WHEN undefined_table THEN
 671                 -- do nothing
 672         END;
 673
 674         BEGIN
 675                 UPDATE reporter.template SET owner = dest_usr WHERE owner = src_usr;
 676         EXCEPTION WHEN undefined_table THEN
 677                 -- do nothing
 678         END;
 679
 680         -- Update with a rename to avoid collisions
 681         BEGIN
 682                 FOR renamable_row in
 683                         SELECT id, name
 684                         FROM   reporter.template_folder
 685                         WHERE  owner = src_usr
 686                 LOOP
 687                         suffix := ' (' || src_usr || ')';
 688                         LOOP
 689                                 BEGIN
 690                                         UPDATE  reporter.template_folder
 691                                         SET     owner = dest_usr, name = name || suffix
 692                                         WHERE   id = renamable_row.id;
 693                                 EXCEPTION WHEN unique_violation THEN
 694                                         suffix := suffix || ' ';
 695                                         CONTINUE;
 696                                 END;
 697                                 EXIT;
 698                         END LOOP;
 699                 END LOOP;
 700         EXCEPTION WHEN undefined_table THEN
 701         -- do nothing
 702         END;
 703
 704         -- vandelay.*
 705         -- Update with a rename to avoid collisions
 706         FOR renamable_row in
 707                 SELECT id, name
 708                 FROM   vandelay.queue
 709                 WHERE  owner = src_usr
 710         LOOP
 711                 suffix := ' (' || src_usr || ')';
 712                 LOOP
 713                         BEGIN
 714                                 UPDATE  vandelay.queue
 715                                 SET     owner = dest_usr, name = name || suffix
 716                                 WHERE   id = renamable_row.id;
 717                         EXCEPTION WHEN unique_violation THEN
 718                                 suffix := suffix || ' ';
 719                                 CONTINUE;
 720                         END;
 721                         EXIT;
 722                 END LOOP;
 723         END LOOP;
 724
 725     UPDATE vandelay.session_tracker SET usr = dest_usr WHERE usr = src_usr;
 726
 727     -- NULL-ify addresses last so other cleanup (e.g. circ anonymization)
 728     -- can access the information before deletion.
 729         UPDATE actor.usr SET
 730                 active = FALSE,
 731                 card = NULL,
 732                 mailing_address = NULL,
 733                 billing_address = NULL
 734         WHERE id = src_usr;
 735
 736 END;
 737 $$ LANGUAGE plpgsql;
 738
 739 COMMENT ON FUNCTION actor.usr_purge_data(INT, INT) IS $$
 740 Finds rows dependent on a given row in actor.usr and either deletes them
 741 or reassigns them to a different user.
 742 $$;
 743
 744
 745
 746 CREATE OR REPLACE FUNCTION actor.usr_delete(
 747         src_usr  IN INTEGER,
 748         dest_usr IN INTEGER
 749 ) RETURNS VOID AS $$
 750 DECLARE
 751         old_profile actor.usr.profile%type;
 752         old_home_ou actor.usr.home_ou%type;
 753         new_profile actor.usr.profile%type;
 754         new_home_ou actor.usr.home_ou%type;
 755         new_name    text;
 756         new_dob     actor.usr.dob%type;
 757 BEGIN
 758         SELECT
 759                 id || '-PURGED-' || now(),
 760                 profile,
 761                 home_ou,
 762                 dob
 763         INTO
 764                 new_name,
 765                 old_profile,
 766                 old_home_ou,
 767                 new_dob
 768         FROM
 769                 actor.usr
 770         WHERE
 771                 id = src_usr;
 772         --
 773         -- Quit if no such user
 774         --
 775         IF old_profile IS NULL THEN
 776                 RETURN;
 777         END IF;
 778         --
 779         perform actor.usr_purge_data( src_usr, dest_usr );
 780         --
 781         -- Find the root grp_tree and the root org_unit.  This would be simpler if we
 782         -- could assume that there is only one root.  Theoretically, someday, maybe,
 783         -- there could be multiple roots, so we take extra trouble to get the right ones.
 784         --
 785         SELECT
 786                 id
 787         INTO
 788                 new_profile
 789         FROM
 790                 permission.grp_ancestors( old_profile )
 791         WHERE
 792                 parent is null;
 793         --
 794         SELECT
 795                 id
 796         INTO
 797                 new_home_ou
 798         FROM
 799                 actor.org_unit_ancestors( old_home_ou )
 800         WHERE
 801                 parent_ou is null;
 802         --
 803         -- Truncate date of birth
 804         --
 805         IF new_dob IS NOT NULL THEN
 806                 new_dob := date_trunc( 'year', new_dob );
 807         END IF;
 808         --
 809         UPDATE
 810                 actor.usr
 811                 SET
 812                         card = NULL,
 813                         profile = new_profile,
 814                         usrname = new_name,
 815                         email = NULL,
 816                         passwd = random()::text,
 817                         standing = DEFAULT,
 818                         ident_type =
 819                         (
 820                                 SELECT MIN( id )
 821                                 FROM config.identification_type
 822                         ),
 823                         ident_value = NULL,
 824                         ident_type2 = NULL,
 825                         ident_value2 = NULL,
 826                         net_access_level = DEFAULT,
 827                         photo_url = NULL,
 828                         prefix = NULL,
 829                         first_given_name = new_name,
 830                         second_given_name = NULL,
 831                         family_name = new_name,
 832                         suffix = NULL,
 833                         alias = NULL,
 834                         day_phone = NULL,
 835                         evening_phone = NULL,
 836                         other_phone = NULL,
 837                         mailing_address = NULL,
 838                         billing_address = NULL,
 839                         home_ou = new_home_ou,
 840                         dob = new_dob,
 841                         active = FALSE,
 842                         master_account = DEFAULT,
 843                         super_user = DEFAULT,
 844                         barred = FALSE,
 845                         deleted = TRUE,
 846                         juvenile = DEFAULT,
 847                         usrgroup = 0,
 848                         claims_returned_count = DEFAULT,
 849                         credit_forward_balance = DEFAULT,
 850                         last_xact_id = DEFAULT,
 851                         alert_message = NULL,
 852                         create_date = now(),
 853                         expire_date = now()
 854         WHERE
 855                 id = src_usr;
 856 END;
 857 $$ LANGUAGE plpgsql;
 858
 859 COMMENT ON FUNCTION actor.usr_delete(INT, INT) IS $$
 860 Logically deletes a user.  Removes personally identifiable information,
 861 and purges associated data in other tables.
 862 $$;
 863
 864
 865
 866 CREATE OR REPLACE FUNCTION actor.approve_pending_address(pending_id INT) RETURNS BIGINT AS $$
 867 DECLARE
 868     old_id INT;
 869 BEGIN
 870     SELECT INTO old_id replaces FROM actor.usr_address where id = pending_id;
 871     IF old_id IS NULL THEN
 872         UPDATE actor.usr_address SET pending = 'f' WHERE id = pending_id;
 873         RETURN pending_id;
 874     END IF;
 875     -- address replaces an existing address
 876     DELETE FROM actor.usr_address WHERE id = -old_id;
 877     UPDATE actor.usr_address SET id = -id WHERE id = old_id;
 878     UPDATE actor.usr_address SET replaces = NULL, id = old_id, pending = 'f' WHERE id = pending_id;
 879     RETURN old_id;
 880 END
 881 $$ LANGUAGE plpgsql;
 882
 883 COMMENT ON FUNCTION actor.approve_pending_address(INT) IS $$
 884 Replaces an address with a pending address.  This is done by giving the pending
 885 address the ID of the old address.  The replaced address is retained with -id.
 886 $$;
 887
 888 CREATE OR REPLACE FUNCTION container.clear_expired_circ_history_items(
 889          ac_usr IN INTEGER
 890 ) RETURNS VOID AS $$
 891 --
 892 -- Delete old circulation bucket items for a specified user.
 893 -- "Old" means older than the interval specified by a
 894 -- user-level setting, if it is so specified.
 895 --
 896 DECLARE
 897     threshold TIMESTAMP WITH TIME ZONE;
 898 BEGIN
 899         -- Sanity check
 900         IF ac_usr IS NULL THEN
 901                 RETURN;
 902         END IF;
 903         -- Determine the threshold date that defines "old".  Subtract the
 904         -- interval from the system date, then truncate to midnight.
 905         SELECT
 906                 date_trunc(
 907                         'day',
 908                         now() - CAST( translate( value, '"', '' ) AS INTERVAL )
 909                 )
 910         INTO
 911                 threshold
 912         FROM
 913                 actor.usr_setting
 914         WHERE
 915                 usr = ac_usr
 916                 AND name = 'patron.max_reading_list_interval';
 917         --
 918         IF threshold is null THEN
 919                 -- No interval defined; don't delete anything
 920                 -- RAISE NOTICE 'No interval defined for user %', ac_usr;
 921                 return;
 922         END IF;
 923         --
 924         -- RAISE NOTICE 'Date threshold: %', threshold;
 925         --
 926         -- Threshold found; do the delete
 927         delete from container.copy_bucket_item
 928         where
 929                 bucket in
 930                 (
 931                         select
 932                                 id
 933                         from
 934                                 container.copy_bucket
 935                         where
 936                                 owner = ac_usr
 937                                 and btype = 'circ_history'
 938                 )
 939                 and create_time < threshold;
 940         --
 941         RETURN;
 942 END;
 943 $$ LANGUAGE plpgsql;
 944
 945 COMMENT ON FUNCTION container.clear_expired_circ_history_items( INTEGER ) IS $$
 946 Delete old circulation bucket items for a specified user.
 947 "Old" means older than the interval specified by a
 948 user-level setting, if it is so specified.
 949 $$;
 950
 951 CREATE OR REPLACE FUNCTION container.clear_all_expired_circ_history_items( )
 952 RETURNS VOID AS $$
 953 --
 954 -- Delete expired circulation bucket items for all users that have
 955 -- a setting for patron.max_reading_list_interval.
 956 --
 957 DECLARE
 958     today        TIMESTAMP WITH TIME ZONE;
 959     threshold    TIMESTAMP WITH TIME ZONE;
 960         usr_setting  RECORD;
 961 BEGIN
 962         SELECT date_trunc( 'day', now() ) INTO today;
 963         --
 964         FOR usr_setting in
 965                 SELECT
 966                         usr,
 967                         value
 968                 FROM
 969                         actor.usr_setting
 970                 WHERE
 971                         name = 'patron.max_reading_list_interval'
 972         LOOP
 973                 --
 974                 -- Make sure the setting is a valid interval
 975                 --
 976                 BEGIN
 977                         threshold := today - CAST( translate( usr_setting.value, '"', '' ) AS INTERVAL );
 978                 EXCEPTION
 979                         WHEN OTHERS THEN
 980                                 RAISE NOTICE 'Invalid setting patron.max_reading_list_interval for user %: ''%''',
 981                                         usr_setting.usr, usr_setting.value;
 982                                 CONTINUE;
 983                 END;
 984                 --
 985                 --RAISE NOTICE 'User % threshold %', usr_setting.usr, threshold;
 986                 --
 987         DELETE FROM container.copy_bucket_item
 988         WHERE
 989                 bucket IN
 990                 (
 991                     SELECT
 992                         id
 993                     FROM
 994                         container.copy_bucket
 995                     WHERE
 996                         owner = usr_setting.usr
 997                         AND btype = 'circ_history'
 998                 )
 999                 AND create_time < threshold;
1000         END LOOP;
1001         --
1002 END;
1003 $$ LANGUAGE plpgsql;
1004
1005 COMMENT ON FUNCTION container.clear_all_expired_circ_history_items( ) IS $$
1006 Delete expired circulation bucket items for all users that have
1007 a setting for patron.max_reading_list_interval.
1008 $$;
1009
1010 CREATE OR REPLACE FUNCTION asset.merge_record_assets( target_record BIGINT, source_record BIGINT ) RETURNS INT AS $func$
1011 DECLARE
1012     moved_objects INT := 0;
1013     source_cn     asset.call_number%ROWTYPE;
1014     target_cn     asset.call_number%ROWTYPE;
1015     metarec       metabib.metarecord%ROWTYPE;
1016     hold          action.hold_request%ROWTYPE;
1017     ser_rec       serial.record_entry%ROWTYPE;
1018     ser_sub       serial.subscription%ROWTYPE;
1019     acq_lineitem  acq.lineitem%ROWTYPE;
1020     acq_request   acq.user_request%ROWTYPE;
1021     booking       booking.resource_type%ROWTYPE;
1022     source_part   biblio.monograph_part%ROWTYPE;
1023     target_part   biblio.monograph_part%ROWTYPE;
1024     multi_home    biblio.peer_bib_copy_map%ROWTYPE;
1025     uri_count     INT := 0;
1026     counter       INT := 0;
1027     uri_datafield TEXT;
1028     uri_text      TEXT := '';
1029 BEGIN
1030
1031     -- move any 856 entries on records that have at least one MARC-mapped URI entry
1032     SELECT  INTO uri_count COUNT(*)
1033       FROM  asset.uri_call_number_map m
1034             JOIN asset.call_number cn ON (m.call_number = cn.id)
1035       WHERE cn.record = source_record;
1036
1037     IF uri_count > 0 THEN
1038
1039         -- This returns more nodes than you might expect:
1040         -- 7 instead of 1 for an 856 with $u $y $9
1041         SELECT  COUNT(*) INTO counter
1042           FROM  oils_xpath_table(
1043                     'id',
1044                     'marc',
1045                     'biblio.record_entry',
1046                     '//*[@tag="856"]',
1047                     'id=' || source_record
1048                 ) as t(i int,c text);
1049
1050         FOR i IN 1 .. counter LOOP
1051             SELECT  '<datafield xmlns="http://www.loc.gov/MARC21/slim"' ||
1052                         ' tag="856"' ||
1053                         ' ind1="' || FIRST(ind1) || '"'  ||
1054                         ' ind2="' || FIRST(ind2) || '">' ||
1055                         STRING_AGG(
1056                             '<subfield code="' || subfield || '">' ||
1057                             regexp_replace(
1058                                 regexp_replace(
1059                                     regexp_replace(data,'&','&amp;','g'),
1060                                     '>', '&gt;', 'g'
1061                                 ),
1062                                 '<', '&lt;', 'g'
1063                             ) || '</subfield>', ''
1064                         ) || '</datafield>' INTO uri_datafield
1065               FROM  oils_xpath_table(
1066                         'id',
1067                         'marc',
1068                         'biblio.record_entry',
1069                         '//*[@tag="856"][position()=' || i || ']/@ind1|' ||
1070                         '//*[@tag="856"][position()=' || i || ']/@ind2|' ||
1071                         '//*[@tag="856"][position()=' || i || ']/*/@code|' ||
1072                         '//*[@tag="856"][position()=' || i || ']/*[@code]',
1073                         'id=' || source_record
1074                     ) as t(id int,ind1 text, ind2 text,subfield text,data text);
1075
1076             -- As most of the results will be NULL, protect against NULLifying
1077             -- the valid content that we do generate
1078             uri_text := uri_text || COALESCE(uri_datafield, '');
1079         END LOOP;
1080
1081         IF uri_text <> '' THEN
1082             UPDATE  biblio.record_entry
1083               SET   marc = regexp_replace(marc,'(</[^>]*record>)', uri_text || E'\\1')
1084               WHERE id = target_record;
1085         END IF;
1086
1087     END IF;
1088
1089         -- Find and move metarecords to the target record
1090         SELECT  INTO metarec *
1091           FROM  metabib.metarecord
1092           WHERE master_record = source_record;
1093
1094         IF FOUND THEN
1095                 UPDATE  metabib.metarecord
1096                   SET   master_record = target_record,
1097                         mods = NULL
1098                   WHERE id = metarec.id;
1099
1100                 moved_objects := moved_objects + 1;
1101         END IF;
1102
1103         -- Find call numbers attached to the source ...
1104         FOR source_cn IN SELECT * FROM asset.call_number WHERE record = source_record LOOP
1105
1106                 SELECT  INTO target_cn *
1107                   FROM  asset.call_number
1108                   WHERE label = source_cn.label
1109             AND prefix = source_cn.prefix
1110             AND suffix = source_cn.suffix
1111                         AND owning_lib = source_cn.owning_lib
1112                         AND record = target_record
1113                         AND NOT deleted;
1114
1115                 -- ... and if there's a conflicting one on the target ...
1116                 IF FOUND THEN
1117
1118                         -- ... move the copies to that, and ...
1119                         UPDATE  asset.copy
1120                           SET   call_number = target_cn.id
1121                           WHERE call_number = source_cn.id;
1122
1123                         -- ... move V holds to the move-target call number
1124                         FOR hold IN SELECT * FROM action.hold_request WHERE target = source_cn.id AND hold_type = 'V' LOOP
1125
1126                                 UPDATE  action.hold_request
1127                                   SET   target = target_cn.id
1128                                   WHERE id = hold.id;
1129
1130                                 moved_objects := moved_objects + 1;
1131                         END LOOP;
1132
1133             UPDATE asset.call_number SET deleted = TRUE WHERE id = source_cn.id;
1134
1135                 -- ... if not ...
1136                 ELSE
1137                         -- ... just move the call number to the target record
1138                         UPDATE  asset.call_number
1139                           SET   record = target_record
1140                           WHERE id = source_cn.id;
1141                 END IF;
1142
1143                 moved_objects := moved_objects + 1;
1144         END LOOP;
1145
1146         -- Find T holds targeting the source record ...
1147         FOR hold IN SELECT * FROM action.hold_request WHERE target = source_record AND hold_type = 'T' LOOP
1148
1149                 -- ... and move them to the target record
1150                 UPDATE  action.hold_request
1151                   SET   target = target_record
1152                   WHERE id = hold.id;
1153
1154                 moved_objects := moved_objects + 1;
1155         END LOOP;
1156
1157         -- Find serial records targeting the source record ...
1158         FOR ser_rec IN SELECT * FROM serial.record_entry WHERE record = source_record LOOP
1159                 -- ... and move them to the target record
1160                 UPDATE  serial.record_entry
1161                   SET   record = target_record
1162                   WHERE id = ser_rec.id;
1163
1164                 moved_objects := moved_objects + 1;
1165         END LOOP;
1166
1167         -- Find serial subscriptions targeting the source record ...
1168         FOR ser_sub IN SELECT * FROM serial.subscription WHERE record_entry = source_record LOOP
1169                 -- ... and move them to the target record
1170                 UPDATE  serial.subscription
1171                   SET   record_entry = target_record
1172                   WHERE id = ser_sub.id;
1173
1174                 moved_objects := moved_objects + 1;
1175         END LOOP;
1176
1177         -- Find booking resource types targeting the source record ...
1178         FOR booking IN SELECT * FROM booking.resource_type WHERE record = source_record LOOP
1179                 -- ... and move them to the target record
1180                 UPDATE  booking.resource_type
1181                   SET   record = target_record
1182                   WHERE id = booking.id;
1183
1184                 moved_objects := moved_objects + 1;
1185         END LOOP;
1186
1187         -- Find acq lineitems targeting the source record ...
1188         FOR acq_lineitem IN SELECT * FROM acq.lineitem WHERE eg_bib_id = source_record LOOP
1189                 -- ... and move them to the target record
1190                 UPDATE  acq.lineitem
1191                   SET   eg_bib_id = target_record
1192                   WHERE id = acq_lineitem.id;
1193
1194                 moved_objects := moved_objects + 1;
1195         END LOOP;
1196
1197         -- Find acq user purchase requests targeting the source record ...
1198         FOR acq_request IN SELECT * FROM acq.user_request WHERE eg_bib = source_record LOOP
1199                 -- ... and move them to the target record
1200                 UPDATE  acq.user_request
1201                   SET   eg_bib = target_record
1202                   WHERE id = acq_request.id;
1203
1204                 moved_objects := moved_objects + 1;
1205         END LOOP;
1206
1207         -- Find parts attached to the source ...
1208         FOR source_part IN SELECT * FROM biblio.monograph_part WHERE record = source_record LOOP
1209
1210                 SELECT  INTO target_part *
1211                   FROM  biblio.monograph_part
1212                   WHERE label = source_part.label
1213                         AND record = target_record;
1214
1215                 -- ... and if there's a conflicting one on the target ...
1216                 IF FOUND THEN
1217
1218                         -- ... move the copy-part maps to that, and ...
1219                         UPDATE  asset.copy_part_map
1220                           SET   part = target_part.id
1221                           WHERE part = source_part.id;
1222
1223                         -- ... move P holds to the move-target part
1224                         FOR hold IN SELECT * FROM action.hold_request WHERE target = source_part.id AND hold_type = 'P' LOOP
1225
1226                                 UPDATE  action.hold_request
1227                                   SET   target = target_part.id
1228                                   WHERE id = hold.id;
1229
1230                                 moved_objects := moved_objects + 1;
1231                         END LOOP;
1232
1233                 -- ... if not ...
1234                 ELSE
1235                         -- ... just move the part to the target record
1236                         UPDATE  biblio.monograph_part
1237                           SET   record = target_record
1238                           WHERE id = source_part.id;
1239                 END IF;
1240
1241                 moved_objects := moved_objects + 1;
1242         END LOOP;
1243
1244         -- Find multi_home items attached to the source ...
1245         FOR multi_home IN SELECT * FROM biblio.peer_bib_copy_map WHERE peer_record = source_record LOOP
1246                 -- ... and move them to the target record
1247                 UPDATE  biblio.peer_bib_copy_map
1248                   SET   peer_record = target_record
1249                   WHERE id = multi_home.id;
1250
1251                 moved_objects := moved_objects + 1;
1252         END LOOP;
1253
1254         -- And delete mappings where the item's home bib was merged with the peer bib
1255         DELETE FROM biblio.peer_bib_copy_map WHERE peer_record = (
1256                 SELECT (SELECT record FROM asset.call_number WHERE id = call_number)
1257                 FROM asset.copy WHERE id = target_copy
1258         );
1259
1260     -- Apply merge tracking
1261     UPDATE biblio.record_entry
1262         SET merge_date = NOW() WHERE id = target_record;
1263
1264     UPDATE biblio.record_entry
1265         SET merge_date = NOW(), merged_to = target_record
1266         WHERE id = source_record;
1267
1268     -- replace book bag entries of source_record with target_record
1269     UPDATE container.biblio_record_entry_bucket_item
1270         SET target_biblio_record_entry = target_record
1271         WHERE bucket IN (SELECT id FROM container.biblio_record_entry_bucket WHERE btype = 'bookbag')
1272         AND target_biblio_record_entry = source_record;
1273
1274     -- Finally, "delete" the source record
1275     DELETE FROM biblio.record_entry WHERE id = source_record;
1276
1277         -- That's all, folks!
1278         RETURN moved_objects;
1279 END;
1280 $func$ LANGUAGE plpgsql;
1281
1282 -- Authority ingest routines
1283 CREATE OR REPLACE FUNCTION authority.propagate_changes
1284     (aid BIGINT, bid BIGINT) RETURNS BIGINT AS $func$
1285 DECLARE
1286     bib_rec biblio.record_entry%ROWTYPE;
1287     new_marc TEXT;
1288 BEGIN
1289
1290     SELECT INTO bib_rec * FROM biblio.record_entry WHERE id = bid;
1291
1292     new_marc := vandelay.merge_record_xml(
1293         bib_rec.marc, authority.generate_overlay_template(aid));
1294
1295     IF new_marc = bib_rec.marc THEN
1296         -- Authority record change had no impact on this bib record.
1297         -- Nothing left to do.
1298         RETURN aid;
1299     END IF;
1300
1301     PERFORM 1 FROM config.global_flag
1302         WHERE name = 'ingest.disable_authority_auto_update_bib_meta'
1303             AND enabled;
1304
1305     IF NOT FOUND THEN
1306         -- update the bib record editor and edit_date
1307         bib_rec.editor := (
1308             SELECT editor FROM authority.record_entry WHERE id = aid);
1309         bib_rec.edit_date = NOW();
1310     END IF;
1311
1312     UPDATE biblio.record_entry SET
1313         marc = new_marc,
1314         editor = bib_rec.editor,
1315         edit_date = bib_rec.edit_date
1316     WHERE id = bid;
1317
1318     RETURN aid;
1319
1320 END;
1321 $func$ LANGUAGE PLPGSQL;
1322
1323 CREATE OR REPLACE FUNCTION authority.propagate_changes (aid BIGINT) RETURNS SETOF BIGINT AS $func$
1324     SELECT authority.propagate_changes( authority, bib ) FROM authority.bib_linking WHERE authority = $1;
1325 $func$ LANGUAGE SQL;
1326
1327 CREATE OR REPLACE FUNCTION authority.map_thesaurus_to_control_set () RETURNS TRIGGER AS $func$
1328 BEGIN
1329     IF NEW.control_set IS NULL THEN
1330         SELECT  control_set INTO NEW.control_set
1331           FROM  authority.thesaurus
1332           WHERE authority.extract_thesaurus(NEW.marc) = code;
1333     END IF;
1334
1335     RETURN NEW;
1336 END;
1337 $func$ LANGUAGE PLPGSQL;
1338
1339 CREATE OR REPLACE FUNCTION authority.reingest_authority_rec_descriptor( auth_id BIGINT ) RETURNS VOID AS $func$
1340 BEGIN
1341     DELETE FROM authority.rec_descriptor WHERE record = auth_id;
1342     INSERT INTO authority.rec_descriptor (record, record_status, encoding_level, thesaurus)
1343         SELECT  auth_id,
1344                 vandelay.marc21_extract_fixed_field(marc,'RecStat'),
1345                 vandelay.marc21_extract_fixed_field(marc,'ELvl'),
1346                 authority.extract_thesaurus(marc)
1347           FROM  authority.record_entry
1348           WHERE id = auth_id;
1349     RETURN;
1350 END;
1351 $func$ LANGUAGE PLPGSQL;
1352
1353 CREATE OR REPLACE FUNCTION authority.reingest_authority_full_rec( auth_id BIGINT ) RETURNS VOID AS $func$
1354 BEGIN
1355     DELETE FROM authority.full_rec WHERE record = auth_id;
1356     INSERT INTO authority.full_rec (record, tag, ind1, ind2, subfield, value)
1357         SELECT record, tag, ind1, ind2, subfield, value FROM authority.flatten_marc( auth_id );
1358
1359     RETURN;
1360 END;
1361 $func$ LANGUAGE PLPGSQL;
1362
1363 -- Given an authority record's ID, control set ID (if known), and marc::XML,
1364 -- return all links to other authority records in the form of rows that
1365 -- can be inserted into authority.authority_linking.
1366 CREATE OR REPLACE FUNCTION authority.calculate_authority_linking(
1367     rec_id BIGINT, rec_control_set INT, rec_marc_xml XML
1368 ) RETURNS SETOF authority.authority_linking AS $func$
1369 DECLARE
1370     acsaf       authority.control_set_authority_field%ROWTYPE;
1371     link        TEXT;
1372     aal         authority.authority_linking%ROWTYPE;
1373 BEGIN
1374     IF rec_control_set IS NULL THEN
1375         -- No control_set on record?  Guess at one
1376         SELECT control_set INTO rec_control_set
1377             FROM authority.control_set_authority_field
1378             WHERE tag IN (
1379                 SELECT UNNEST(
1380                     XPATH('//*[starts-with(@tag,"1")]/@tag',rec_marc_xml)::TEXT[]
1381                 )
1382             ) LIMIT 1;
1383
1384         IF NOT FOUND THEN
1385             RAISE WARNING 'Could not even guess at control set for authority record %', rec_id;
1386             RETURN;
1387         END IF;
1388     END IF;
1389
1390     aal.source := rec_id;
1391
1392     FOR acsaf IN
1393         SELECT * FROM authority.control_set_authority_field
1394         WHERE control_set = rec_control_set
1395             AND linking_subfield IS NOT NULL
1396             AND main_entry IS NOT NULL
1397     LOOP
1398         -- Loop over the trailing-number contents of all linking subfields
1399         FOR link IN
1400             SELECT  SUBSTRING( x::TEXT, '\d+$' )
1401               FROM  UNNEST(
1402                         XPATH(
1403                             '//*[@tag="'
1404                                 || acsaf.tag
1405                                 || '"]/*[@code="'
1406                                 || acsaf.linking_subfield
1407                                 || '"]/text()',
1408                             rec_marc_xml
1409                         )
1410                     ) x
1411         LOOP
1412
1413             -- Ignore links that are null, malformed, circular, or point to
1414             -- non-existent authority records.
1415             IF link IS NOT NULL AND link::BIGINT <> rec_id THEN
1416                 PERFORM * FROM authority.record_entry WHERE id = link::BIGINT;
1417                 IF FOUND THEN
1418                     aal.target := link::BIGINT;
1419                     aal.field := acsaf.id;
1420                     RETURN NEXT aal;
1421                 END IF;
1422             END IF;
1423         END LOOP;
1424     END LOOP;
1425 END;
1426 $func$ LANGUAGE PLPGSQL;
1427
1428 -- AFTER UPDATE OR INSERT trigger for authority.record_entry
1429 CREATE OR REPLACE FUNCTION authority.indexing_ingest_or_delete () RETURNS TRIGGER AS $func$
1430 DECLARE
1431     ashs    authority.simple_heading%ROWTYPE;
1432     mbe_row metabib.browse_entry%ROWTYPE;
1433     mbe_id  BIGINT;
1434     ash_id  BIGINT;
1435 BEGIN
1436
1437     IF NEW.deleted IS TRUE THEN -- If this authority is deleted
1438         DELETE FROM authority.bib_linking WHERE authority = NEW.id; -- Avoid updating fields in bibs that are no longer visible
1439         DELETE FROM authority.full_rec WHERE record = NEW.id; -- Avoid validating fields against deleted authority records
1440         DELETE FROM authority.simple_heading WHERE record = NEW.id;
1441           -- Should remove matching $0 from controlled fields at the same time?
1442
1443         -- XXX What do we about the actual linking subfields present in
1444         -- authority records that target this one when this happens?
1445         DELETE FROM authority.authority_linking
1446             WHERE source = NEW.id OR target = NEW.id;
1447
1448         RETURN NEW; -- and we're done
1449     END IF;
1450
1451     IF TG_OP = 'UPDATE' THEN -- re-ingest?
1452         PERFORM * FROM config.internal_flag WHERE name = 'ingest.reingest.force_on_same_marc' AND enabled;
1453
1454         IF NOT FOUND AND OLD.marc = NEW.marc THEN -- don't do anything if the MARC didn't change
1455             RETURN NEW;
1456         END IF;
1457
1458         -- Unless there's a setting stopping us, propagate these updates to any linked bib records when the heading changes
1459         PERFORM * FROM config.internal_flag WHERE name = 'ingest.disable_authority_auto_update' AND enabled;
1460
1461         IF NOT FOUND AND NEW.heading <> OLD.heading THEN
1462             PERFORM authority.propagate_changes(NEW.id);
1463         END IF;
1464
1465         DELETE FROM authority.simple_heading WHERE record = NEW.id;
1466         DELETE FROM authority.authority_linking WHERE source = NEW.id;
1467     END IF;
1468
1469     INSERT INTO authority.authority_linking (source, target, field)
1470         SELECT source, target, field FROM authority.calculate_authority_linking(
1471             NEW.id, NEW.control_set, NEW.marc::XML
1472         );
1473
1474     FOR ashs IN SELECT * FROM authority.simple_heading_set(NEW.marc) LOOP
1475
1476         INSERT INTO authority.simple_heading (record,atag,value,sort_value,thesaurus)
1477             VALUES (ashs.record, ashs.atag, ashs.value, ashs.sort_value, ashs.thesaurus);
1478             ash_id := CURRVAL('authority.simple_heading_id_seq'::REGCLASS);
1479
1480         SELECT INTO mbe_row * FROM metabib.browse_entry
1481             WHERE value = ashs.value AND sort_value = ashs.sort_value;
1482
1483         IF FOUND THEN
1484             mbe_id := mbe_row.id;
1485         ELSE
1486             INSERT INTO metabib.browse_entry
1487                 ( value, sort_value ) VALUES
1488                 ( ashs.value, ashs.sort_value );
1489
1490             mbe_id := CURRVAL('metabib.browse_entry_id_seq'::REGCLASS);
1491         END IF;
1492
1493         INSERT INTO metabib.browse_entry_simple_heading_map (entry,simple_heading) VALUES (mbe_id,ash_id);
1494
1495     END LOOP;
1496
1497     -- Flatten and insert the afr data
1498     PERFORM * FROM config.internal_flag WHERE name = 'ingest.disable_authority_full_rec' AND enabled;
1499     IF NOT FOUND THEN
1500         PERFORM authority.reingest_authority_full_rec(NEW.id);
1501         PERFORM * FROM config.internal_flag WHERE name = 'ingest.disable_authority_rec_descriptor' AND enabled;
1502         IF NOT FOUND THEN
1503             PERFORM authority.reingest_authority_rec_descriptor(NEW.id);
1504         END IF;
1505     END IF;
1506
1507     RETURN NEW;
1508 END;
1509 $func$ LANGUAGE PLPGSQL;
1510
1511 -- Ingest triggers
1512 CREATE TRIGGER fingerprint_tgr BEFORE INSERT OR UPDATE ON biblio.record_entry FOR EACH ROW EXECUTE PROCEDURE biblio.fingerprint_trigger ('eng','BKS');
1513 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 ();
1514 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 ();
1515
1516 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 ();
1517 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 ();
1518
1519 -- Utility routines, callable via cstore
1520
1521 CREATE OR REPLACE FUNCTION config.interval_to_seconds( interval_val INTERVAL )
1522 RETURNS INTEGER AS $$
1523 BEGIN
1524         RETURN EXTRACT( EPOCH FROM interval_val );
1525 END;
1526 $$ LANGUAGE plpgsql;
1527
1528 CREATE OR REPLACE FUNCTION config.interval_to_seconds( interval_string TEXT )
1529 RETURNS INTEGER AS $$
1530 BEGIN
1531         RETURN config.interval_to_seconds( interval_string::INTERVAL );
1532 END;
1533 $$ LANGUAGE plpgsql;
1534
1535 CREATE OR REPLACE FUNCTION vandelay.ingest_items ( import_id BIGINT, attr_def_id BIGINT ) RETURNS SETOF vandelay.import_item AS $$
1536 DECLARE
1537
1538     owning_lib      TEXT;
1539     circ_lib        TEXT;
1540     call_number     TEXT;
1541     copy_number     TEXT;
1542     status          TEXT;
1543     location        TEXT;
1544     circulate       TEXT;
1545     deposit         TEXT;
1546     deposit_amount  TEXT;
1547     ref             TEXT;
1548     holdable        TEXT;
1549     price           TEXT;
1550     barcode         TEXT;
1551     circ_modifier   TEXT;
1552     circ_as_type    TEXT;
1553     alert_message   TEXT;
1554     opac_visible    TEXT;
1555     pub_note        TEXT;
1556     priv_note       TEXT;
1557     internal_id     TEXT;
1558     stat_cat_data   TEXT;
1559     parts_data      TEXT;
1560
1561     attr_def        RECORD;
1562     tmp_attr_set    RECORD;
1563     attr_set        vandelay.import_item%ROWTYPE;
1564
1565     xpaths          TEXT[];
1566     tmp_str         TEXT;
1567
1568 BEGIN
1569
1570     SELECT * INTO attr_def FROM vandelay.import_item_attr_definition WHERE id = attr_def_id;
1571
1572     IF FOUND THEN
1573
1574         attr_set.definition := attr_def.id;
1575
1576         -- Build the combined XPath
1577
1578         owning_lib :=
1579             CASE
1580                 WHEN attr_def.owning_lib IS NULL THEN 'null()'
1581                 WHEN LENGTH( attr_def.owning_lib ) = 1 THEN '*[@code="' || attr_def.owning_lib || '"]'
1582                 ELSE '*' || attr_def.owning_lib
1583             END;
1584
1585         circ_lib :=
1586             CASE
1587                 WHEN attr_def.circ_lib IS NULL THEN 'null()'
1588                 WHEN LENGTH( attr_def.circ_lib ) = 1 THEN '*[@code="' || attr_def.circ_lib || '"]'
1589                 ELSE '*' || attr_def.circ_lib
1590             END;
1591
1592         call_number :=
1593             CASE
1594                 WHEN attr_def.call_number IS NULL THEN 'null()'
1595                 WHEN LENGTH( attr_def.call_number ) = 1 THEN '*[@code="' || attr_def.call_number || '"]'
1596                 ELSE '*' || attr_def.call_number
1597             END;
1598
1599         copy_number :=
1600             CASE
1601                 WHEN attr_def.copy_number IS NULL THEN 'null()'
1602                 WHEN LENGTH( attr_def.copy_number ) = 1 THEN '*[@code="' || attr_def.copy_number || '"]'
1603                 ELSE '*' || attr_def.copy_number
1604             END;
1605
1606         status :=
1607             CASE
1608                 WHEN attr_def.status IS NULL THEN 'null()'
1609                 WHEN LENGTH( attr_def.status ) = 1 THEN '*[@code="' || attr_def.status || '"]'
1610                 ELSE '*' || attr_def.status
1611             END;
1612
1613         location :=
1614             CASE
1615                 WHEN attr_def.location IS NULL THEN 'null()'
1616                 WHEN LENGTH( attr_def.location ) = 1 THEN '*[@code="' || attr_def.location || '"]'
1617                 ELSE '*' || attr_def.location
1618             END;
1619
1620         circulate :=
1621             CASE
1622                 WHEN attr_def.circulate IS NULL THEN 'null()'
1623                 WHEN LENGTH( attr_def.circulate ) = 1 THEN '*[@code="' || attr_def.circulate || '"]'
1624                 ELSE '*' || attr_def.circulate
1625             END;
1626
1627         deposit :=
1628             CASE
1629                 WHEN attr_def.deposit IS NULL THEN 'null()'
1630                 WHEN LENGTH( attr_def.deposit ) = 1 THEN '*[@code="' || attr_def.deposit || '"]'
1631                 ELSE '*' || attr_def.deposit
1632             END;
1633
1634         deposit_amount :=
1635             CASE
1636                 WHEN attr_def.deposit_amount IS NULL THEN 'null()'
1637                 WHEN LENGTH( attr_def.deposit_amount ) = 1 THEN '*[@code="' || attr_def.deposit_amount || '"]'
1638                 ELSE '*' || attr_def.deposit_amount
1639             END;
1640
1641         ref :=
1642             CASE
1643                 WHEN attr_def.ref IS NULL THEN 'null()'
1644                 WHEN LENGTH( attr_def.ref ) = 1 THEN '*[@code="' || attr_def.ref || '"]'
1645                 ELSE '*' || attr_def.ref
1646             END;
1647
1648         holdable :=
1649             CASE
1650                 WHEN attr_def.holdable IS NULL THEN 'null()'
1651                 WHEN LENGTH( attr_def.holdable ) = 1 THEN '*[@code="' || attr_def.holdable || '"]'
1652                 ELSE '*' || attr_def.holdable
1653             END;
1654
1655         price :=
1656             CASE
1657                 WHEN attr_def.price IS NULL THEN 'null()'
1658                 WHEN LENGTH( attr_def.price ) = 1 THEN '*[@code="' || attr_def.price || '"]'
1659                 ELSE '*' || attr_def.price
1660             END;
1661
1662         barcode :=
1663             CASE
1664                 WHEN attr_def.barcode IS NULL THEN 'null()'
1665                 WHEN LENGTH( attr_def.barcode ) = 1 THEN '*[@code="' || attr_def.barcode || '"]'
1666                 ELSE '*' || attr_def.barcode
1667             END;
1668
1669         circ_modifier :=
1670             CASE
1671                 WHEN attr_def.circ_modifier IS NULL THEN 'null()'
1672                 WHEN LENGTH( attr_def.circ_modifier ) = 1 THEN '*[@code="' || attr_def.circ_modifier || '"]'
1673                 ELSE '*' || attr_def.circ_modifier
1674             END;
1675
1676         circ_as_type :=
1677             CASE
1678                 WHEN attr_def.circ_as_type IS NULL THEN 'null()'
1679                 WHEN LENGTH( attr_def.circ_as_type ) = 1 THEN '*[@code="' || attr_def.circ_as_type || '"]'
1680                 ELSE '*' || attr_def.circ_as_type
1681             END;
1682
1683         alert_message :=
1684             CASE
1685                 WHEN attr_def.alert_message IS NULL THEN 'null()'
1686                 WHEN LENGTH( attr_def.alert_message ) = 1 THEN '*[@code="' || attr_def.alert_message || '"]'
1687                 ELSE '*' || attr_def.alert_message
1688             END;
1689
1690         opac_visible :=
1691             CASE
1692                 WHEN attr_def.opac_visible IS NULL THEN 'null()'
1693                 WHEN LENGTH( attr_def.opac_visible ) = 1 THEN '*[@code="' || attr_def.opac_visible || '"]'
1694                 ELSE '*' || attr_def.opac_visible
1695             END;
1696
1697         pub_note :=
1698             CASE
1699                 WHEN attr_def.pub_note IS NULL THEN 'null()'
1700                 WHEN LENGTH( attr_def.pub_note ) = 1 THEN '*[@code="' || attr_def.pub_note || '"]'
1701                 ELSE '*' || attr_def.pub_note
1702             END;
1703         priv_note :=
1704             CASE
1705                 WHEN attr_def.priv_note IS NULL THEN 'null()'
1706                 WHEN LENGTH( attr_def.priv_note ) = 1 THEN '*[@code="' || attr_def.priv_note || '"]'
1707                 ELSE '*' || attr_def.priv_note
1708             END;
1709
1710         internal_id :=
1711             CASE
1712                 WHEN attr_def.internal_id IS NULL THEN 'null()'
1713                 WHEN LENGTH( attr_def.internal_id ) = 1 THEN '*[@code="' || attr_def.internal_id || '"]'
1714                 ELSE '*' || attr_def.internal_id
1715             END;
1716
1717         stat_cat_data :=
1718             CASE
1719                 WHEN attr_def.stat_cat_data IS NULL THEN 'null()'
1720                 WHEN LENGTH( attr_def.stat_cat_data ) = 1 THEN '*[@code="' || attr_def.stat_cat_data || '"]'
1721                 ELSE '*' || attr_def.stat_cat_data
1722             END;
1723
1724         parts_data :=
1725             CASE
1726                 WHEN attr_def.parts_data IS NULL THEN 'null()'
1727                 WHEN LENGTH( attr_def.parts_data ) = 1 THEN '*[@code="' || attr_def.parts_data || '"]'
1728                 ELSE '*' || attr_def.parts_data
1729             END;
1730
1731
1732
1733         xpaths := ARRAY[owning_lib, circ_lib, call_number, copy_number, status, location, circulate,
1734                         deposit, deposit_amount, ref, holdable, price, barcode, circ_modifier, circ_as_type,
1735                         alert_message, pub_note, priv_note, internal_id, stat_cat_data, parts_data, opac_visible];
1736
1737         FOR tmp_attr_set IN
1738                 SELECT  *
1739                   FROM  oils_xpath_tag_to_table( (SELECT marc FROM vandelay.queued_bib_record WHERE id = import_id), attr_def.tag, xpaths)
1740                             AS t( ol TEXT, clib TEXT, cn TEXT, cnum TEXT, cs TEXT, cl TEXT, circ TEXT,
1741                                   dep TEXT, dep_amount TEXT, r TEXT, hold TEXT, pr TEXT, bc TEXT, circ_mod TEXT,
1742                                   circ_as TEXT, amessage TEXT, note TEXT, pnote TEXT, internal_id TEXT,
1743                                   stat_cat_data TEXT, parts_data TEXT, opac_vis TEXT )
1744         LOOP
1745
1746             attr_set.import_error := NULL;
1747             attr_set.error_detail := NULL;
1748             attr_set.deposit_amount := NULL;
1749             attr_set.copy_number := NULL;
1750             attr_set.price := NULL;
1751             attr_set.circ_modifier := NULL;
1752             attr_set.location := NULL;
1753             attr_set.barcode := NULL;
1754             attr_set.call_number := NULL;
1755
1756             IF tmp_attr_set.pr != '' THEN
1757                 tmp_str = REGEXP_REPLACE(tmp_attr_set.pr, E'[^0-9\\.]', '', 'g');
1758                 IF tmp_str = '' THEN
1759                     attr_set.import_error := 'import.item.invalid.price';
1760                     attr_set.error_detail := tmp_attr_set.pr; -- original value
1761                     RETURN NEXT attr_set; CONTINUE;
1762                 END IF;
1763                 attr_set.price := tmp_str::NUMERIC(8,2);
1764             END IF;
1765
1766             IF tmp_attr_set.dep_amount != '' THEN
1767                 tmp_str = REGEXP_REPLACE(tmp_attr_set.dep_amount, E'[^0-9\\.]', '', 'g');
1768                 IF tmp_str = '' THEN
1769                     attr_set.import_error := 'import.item.invalid.deposit_amount';
1770                     attr_set.error_detail := tmp_attr_set.dep_amount;
1771                     RETURN NEXT attr_set; CONTINUE;
1772                 END IF;
1773                 attr_set.deposit_amount := tmp_str::NUMERIC(8,2);
1774             END IF;
1775
1776             IF tmp_attr_set.cnum != '' THEN
1777                 tmp_str = REGEXP_REPLACE(tmp_attr_set.cnum, E'[^0-9]', '', 'g');
1778                 IF tmp_str = '' THEN
1779                     attr_set.import_error := 'import.item.invalid.copy_number';
1780                     attr_set.error_detail := tmp_attr_set.cnum;
1781                     RETURN NEXT attr_set; CONTINUE;
1782                 END IF;
1783                 attr_set.copy_number := tmp_str::INT;
1784             END IF;
1785
1786             IF tmp_attr_set.ol != '' THEN
1787                 SELECT id INTO attr_set.owning_lib FROM actor.org_unit WHERE shortname = UPPER(tmp_attr_set.ol); -- INT
1788                 IF NOT FOUND THEN
1789                     attr_set.import_error := 'import.item.invalid.owning_lib';
1790                     attr_set.error_detail := tmp_attr_set.ol;
1791                     RETURN NEXT attr_set; CONTINUE;
1792                 END IF;
1793             END IF;
1794
1795             IF tmp_attr_set.clib != '' THEN
1796                 SELECT id INTO attr_set.circ_lib FROM actor.org_unit WHERE shortname = UPPER(tmp_attr_set.clib); -- INT
1797                 IF NOT FOUND THEN
1798                     attr_set.import_error := 'import.item.invalid.circ_lib';
1799                     attr_set.error_detail := tmp_attr_set.clib;
1800                     RETURN NEXT attr_set; CONTINUE;
1801                 END IF;
1802             END IF;
1803
1804             IF tmp_attr_set.cs != '' THEN
1805                 SELECT id INTO attr_set.status FROM config.copy_status WHERE LOWER(name) = LOWER(tmp_attr_set.cs); -- INT
1806                 IF NOT FOUND THEN
1807                     attr_set.import_error := 'import.item.invalid.status';
1808                     attr_set.error_detail := tmp_attr_set.cs;
1809                     RETURN NEXT attr_set; CONTINUE;
1810                 END IF;
1811             END IF;
1812
1813             IF COALESCE(tmp_attr_set.circ_mod, '') = '' THEN
1814
1815                 -- no circ mod defined, see if we should apply a default
1816                 SELECT INTO attr_set.circ_modifier TRIM(BOTH '"' FROM value)
1817                     FROM actor.org_unit_ancestor_setting(
1818                         'vandelay.item.circ_modifier.default',
1819                         attr_set.owning_lib
1820                     );
1821
1822                 -- make sure the value from the org setting is still valid
1823                 PERFORM 1 FROM config.circ_modifier WHERE code = attr_set.circ_modifier;
1824                 IF NOT FOUND THEN
1825                     attr_set.import_error := 'import.item.invalid.circ_modifier';
1826                     attr_set.error_detail := tmp_attr_set.circ_mod;
1827                     RETURN NEXT attr_set; CONTINUE;
1828                 END IF;
1829
1830             ELSE
1831
1832                 SELECT code INTO attr_set.circ_modifier FROM config.circ_modifier WHERE code = tmp_attr_set.circ_mod;
1833                 IF NOT FOUND THEN
1834                     attr_set.import_error := 'import.item.invalid.circ_modifier';
1835                     attr_set.error_detail := tmp_attr_set.circ_mod;
1836                     RETURN NEXT attr_set; CONTINUE;
1837                 END IF;
1838             END IF;
1839
1840             IF tmp_attr_set.circ_as != '' THEN
1841                 SELECT code INTO attr_set.circ_as_type FROM config.coded_value_map WHERE ctype = 'item_type' AND code = tmp_attr_set.circ_as;
1842                 IF NOT FOUND THEN
1843                     attr_set.import_error := 'import.item.invalid.circ_as_type';
1844                     attr_set.error_detail := tmp_attr_set.circ_as;
1845                     RETURN NEXT attr_set; CONTINUE;
1846                 END IF;
1847             END IF;
1848
1849             IF COALESCE(tmp_attr_set.cl, '') = '' THEN
1850                 -- no location specified, see if we should apply a default
1851
1852                 SELECT INTO attr_set.location TRIM(BOTH '"' FROM value)
1853                     FROM actor.org_unit_ancestor_setting(
1854                         'vandelay.item.copy_location.default',
1855                         attr_set.owning_lib
1856                     );
1857
1858                 -- make sure the value from the org setting is still valid
1859                 PERFORM 1 FROM asset.copy_location
1860                     WHERE id = attr_set.location AND NOT deleted;
1861                 IF NOT FOUND THEN
1862                     attr_set.import_error := 'import.item.invalid.location';
1863                     attr_set.error_detail := tmp_attr_set.cs;
1864                     RETURN NEXT attr_set; CONTINUE;
1865                 END IF;
1866             ELSE
1867
1868                 -- search up the org unit tree for a matching copy location
1869                 WITH RECURSIVE anscestor_depth AS (
1870                     SELECT  ou.id,
1871                         out.depth AS depth,
1872                         ou.parent_ou
1873                     FROM  actor.org_unit ou
1874                         JOIN actor.org_unit_type out ON (out.id = ou.ou_type)
1875                     WHERE ou.id = COALESCE(attr_set.owning_lib, attr_set.circ_lib)
1876                         UNION ALL
1877                     SELECT  ou.id,
1878                         out.depth,
1879                         ou.parent_ou
1880                     FROM  actor.org_unit ou
1881                         JOIN actor.org_unit_type out ON (out.id = ou.ou_type)
1882                         JOIN anscestor_depth ot ON (ot.parent_ou = ou.id)
1883                 ) SELECT  cpl.id INTO attr_set.location
1884                     FROM  anscestor_depth a
1885                         JOIN asset.copy_location cpl ON (cpl.owning_lib = a.id)
1886                     WHERE LOWER(cpl.name) = LOWER(tmp_attr_set.cl)
1887                         AND NOT cpl.deleted
1888                     ORDER BY a.depth DESC
1889                     LIMIT 1;
1890
1891                 IF NOT FOUND THEN
1892                     attr_set.import_error := 'import.item.invalid.location';
1893                     attr_set.error_detail := tmp_attr_set.cs;
1894                     RETURN NEXT attr_set; CONTINUE;
1895                 END IF;
1896             END IF;
1897
1898             attr_set.circulate      :=
1899                 LOWER( SUBSTRING( tmp_attr_set.circ, 1, 1)) IN ('t','y','1')
1900                 OR LOWER(tmp_attr_set.circ) = 'circulating'; -- BOOL
1901
1902             attr_set.deposit        :=
1903                 LOWER( SUBSTRING( tmp_attr_set.dep, 1, 1 ) ) IN ('t','y','1')
1904                 OR LOWER(tmp_attr_set.dep) = 'deposit'; -- BOOL
1905
1906             attr_set.holdable       :=
1907                 LOWER( SUBSTRING( tmp_attr_set.hold, 1, 1 ) ) IN ('t','y','1')
1908                 OR LOWER(tmp_attr_set.hold) = 'holdable'; -- BOOL
1909
1910             attr_set.opac_visible   :=
1911                 LOWER( SUBSTRING( tmp_attr_set.opac_vis, 1, 1 ) ) IN ('t','y','1')
1912                 OR LOWER(tmp_attr_set.opac_vis) = 'visible'; -- BOOL
1913
1914             attr_set.ref            :=
1915                 LOWER( SUBSTRING( tmp_attr_set.r, 1, 1 ) ) IN ('t','y','1')
1916                 OR LOWER(tmp_attr_set.r) = 'reference'; -- BOOL
1917
1918             attr_set.call_number    := tmp_attr_set.cn; -- TEXT
1919             attr_set.barcode        := tmp_attr_set.bc; -- TEXT,
1920             attr_set.alert_message  := tmp_attr_set.amessage; -- TEXT,
1921             attr_set.pub_note       := tmp_attr_set.note; -- TEXT,
1922             attr_set.priv_note      := tmp_attr_set.pnote; -- TEXT,
1923             attr_set.alert_message  := tmp_attr_set.amessage; -- TEXT,
1924             attr_set.internal_id    := tmp_attr_set.internal_id::BIGINT;
1925             attr_set.stat_cat_data  := tmp_attr_set.stat_cat_data; -- TEXT,
1926             attr_set.parts_data     := tmp_attr_set.parts_data; -- TEXT,
1927
1928             RETURN NEXT attr_set;
1929
1930         END LOOP;
1931
1932     END IF;
1933
1934     RETURN;
1935
1936 END;
1937 $$ LANGUAGE PLPGSQL;
1938
1939
1940
1941
1942 CREATE OR REPLACE FUNCTION vandelay.ingest_bib_items ( ) RETURNS TRIGGER AS $func$
1943 DECLARE
1944     attr_def    BIGINT;
1945     item_data   vandelay.import_item%ROWTYPE;
1946 BEGIN
1947
1948     IF TG_OP IN ('INSERT','UPDATE') AND NEW.imported_as IS NOT NULL THEN
1949         RETURN NEW;
1950     END IF;
1951
1952     SELECT item_attr_def INTO attr_def FROM vandelay.bib_queue WHERE id = NEW.queue;
1953
1954     FOR item_data IN SELECT * FROM vandelay.ingest_items( NEW.id::BIGINT, attr_def ) LOOP
1955         INSERT INTO vandelay.import_item (
1956             record,
1957             definition,
1958             owning_lib,
1959             circ_lib,
1960             call_number,
1961             copy_number,
1962             status,
1963             location,
1964             circulate,
1965             deposit,
1966             deposit_amount,
1967             ref,
1968             holdable,
1969             price,
1970             barcode,
1971             circ_modifier,
1972             circ_as_type,
1973             alert_message,
1974             pub_note,
1975             priv_note,
1976             internal_id,
1977             opac_visible,
1978             stat_cat_data,
1979             parts_data,
1980             import_error,
1981             error_detail
1982         ) VALUES (
1983             NEW.id,
1984             item_data.definition,
1985             item_data.owning_lib,
1986             item_data.circ_lib,
1987             item_data.call_number,
1988             item_data.copy_number,
1989             item_data.status,
1990             item_data.location,
1991             item_data.circulate,
1992             item_data.deposit,
1993             item_data.deposit_amount,
1994             item_data.ref,
1995             item_data.holdable,
1996             item_data.price,
1997             item_data.barcode,
1998             item_data.circ_modifier,
1999             item_data.circ_as_type,
2000             item_data.alert_message,
2001             item_data.pub_note,
2002             item_data.priv_note,
2003             item_data.internal_id,
2004             item_data.opac_visible,
2005             item_data.stat_cat_data,
2006             item_data.parts_data,
2007             item_data.import_error,
2008             item_data.error_detail
2009         );
2010     END LOOP;
2011
2012     RETURN NULL;
2013 END;
2014 $func$ LANGUAGE PLPGSQL;
2015
2016 CREATE TRIGGER ingest_item_trigger
2017     AFTER INSERT OR UPDATE ON vandelay.queued_bib_record
2018     FOR EACH ROW EXECUTE PROCEDURE vandelay.ingest_bib_items();
2019
2020
2021 -- evergreen.generic_map_normalizer
2022
2023 CREATE OR REPLACE FUNCTION evergreen.generic_map_normalizer ( TEXT, TEXT ) RETURNS TEXT AS $f$
2024 my $string = shift;
2025 my %map;
2026
2027 my $default = $string;
2028
2029 $_ = shift;
2030 while (/^\s*?(.*?)\s*?=>\s*?(\S+)\s*/) {
2031     if ($1 eq '') {
2032         $default = $2;
2033     } else {
2034         $map{$2} = [split(/\s*,\s*/, $1)];
2035     }
2036     $_ = $';
2037 }
2038
2039 for my $key ( keys %map ) {
2040     return $key if (grep { $_ eq $string } @{ $map{$key} });
2041 }
2042
2043 return $default;
2044
2045 $f$ LANGUAGE PLPERLU;
2046
2047 CREATE OR REPLACE FUNCTION actor.address_alert_matches (
2048         org_unit INT,
2049         street1 TEXT,
2050         street2 TEXT,
2051         city TEXT,
2052         county TEXT,
2053         state TEXT,
2054         country TEXT,
2055         post_code TEXT,
2056         mailing_address BOOL DEFAULT FALSE,
2057         billing_address BOOL DEFAULT FALSE
2058     ) RETURNS SETOF actor.address_alert AS $$
2059
2060 SELECT *
2061 FROM actor.address_alert
2062 WHERE
2063     active
2064     AND owner IN (SELECT id FROM actor.org_unit_ancestors($1))
2065     AND (
2066         (NOT mailing_address AND NOT billing_address)
2067         OR (mailing_address AND $9)
2068         OR (billing_address AND $10)
2069     )
2070     AND (
2071             (
2072                 match_all
2073                 AND COALESCE($2, '') ~* COALESCE(street1,   '.*')
2074                 AND COALESCE($3, '') ~* COALESCE(street2,   '.*')
2075                 AND COALESCE($4, '') ~* COALESCE(city,      '.*')
2076                 AND COALESCE($5, '') ~* COALESCE(county,    '.*')
2077                 AND COALESCE($6, '') ~* COALESCE(state,     '.*')
2078                 AND COALESCE($7, '') ~* COALESCE(country,   '.*')
2079                 AND COALESCE($8, '') ~* COALESCE(post_code, '.*')
2080             ) OR (
2081                 NOT match_all
2082                 AND (
2083                        $2 ~* street1
2084                     OR $3 ~* street2
2085                     OR $4 ~* city
2086                     OR $5 ~* county
2087                     OR $6 ~* state
2088                     OR $7 ~* country
2089                     OR $8 ~* post_code
2090                 )
2091             )
2092         )
2093     ORDER BY actor.org_unit_proximity(owner, $1)
2094 $$ LANGUAGE SQL;
2095
2096 CREATE OR REPLACE FUNCTION evergreen.coded_value_map_normalizer( input TEXT, ctype TEXT )
2097     RETURNS TEXT AS $F$
2098         SELECT COALESCE(value,$1)
2099             FROM config.coded_value_map
2100             WHERE ctype = $2 AND code = $1;
2101 $F$ LANGUAGE SQL;
2102
2103 -- user activity functions --
2104
2105 -- remove transient activity entries on insert of new entries
2106 CREATE OR REPLACE FUNCTION actor.usr_activity_transient_trg () RETURNS TRIGGER AS $$
2107 BEGIN
2108     DELETE FROM actor.usr_activity act USING config.usr_activity_type atype
2109         WHERE atype.transient AND
2110             NEW.etype = atype.id AND
2111             act.etype = atype.id AND
2112             act.usr = NEW.usr;
2113     RETURN NEW;
2114 END;
2115 $$ LANGUAGE PLPGSQL;
2116
2117 CREATE TRIGGER remove_transient_usr_activity
2118     BEFORE INSERT ON actor.usr_activity
2119     FOR EACH ROW EXECUTE PROCEDURE actor.usr_activity_transient_trg();
2120
2121 -- given a set of activity criteria, find the most approprate activity type
2122 CREATE OR REPLACE FUNCTION actor.usr_activity_get_type (
2123         ewho TEXT,
2124         ewhat TEXT,
2125         ehow TEXT
2126     ) RETURNS SETOF config.usr_activity_type AS $$
2127 SELECT * FROM config.usr_activity_type
2128     WHERE
2129         enabled AND
2130         (ewho  IS NULL OR ewho  = $1) AND
2131         (ewhat IS NULL OR ewhat = $2) AND
2132         (ehow  IS NULL OR ehow  = $3)
2133     ORDER BY
2134         -- BOOL comparisons sort false to true
2135         COALESCE(ewho, '')  != COALESCE($1, ''),
2136         COALESCE(ewhat,'')  != COALESCE($2, ''),
2137         COALESCE(ehow, '')  != COALESCE($3, '')
2138     LIMIT 1;
2139 $$ LANGUAGE SQL;
2140
2141 -- given a set of activity criteria, finds the best
2142 -- activity type and inserts the activity entry
2143 CREATE OR REPLACE FUNCTION actor.insert_usr_activity (
2144         usr INT,
2145         ewho TEXT,
2146         ewhat TEXT,
2147         ehow TEXT
2148     ) RETURNS SETOF actor.usr_activity AS $$
2149 DECLARE
2150     new_row actor.usr_activity%ROWTYPE;
2151 BEGIN
2152     SELECT id INTO new_row.etype FROM actor.usr_activity_get_type(ewho, ewhat, ehow);
2153     IF FOUND THEN
2154         new_row.usr := usr;
2155         INSERT INTO actor.usr_activity (usr, etype)
2156             VALUES (usr, new_row.etype)
2157             RETURNING * INTO new_row;
2158         RETURN NEXT new_row;
2159     END IF;
2160 END;
2161 $$ LANGUAGE plpgsql;
2162
2163 CREATE OR REPLACE FUNCTION evergreen.rel_bump(terms TEXT[], value TEXT, bumps TEXT[], mults NUMERIC[]) RETURNS NUMERIC AS
2164 $BODY$
2165 use strict;
2166 my ($terms,$value,$bumps,$mults) = @_;
2167
2168 my $retval = 1;
2169
2170 for (my $id = 0; $id < @$bumps; $id++) {
2171         if ($bumps->[$id] eq 'first_word') {
2172                 $retval *= $mults->[$id] if ($value =~ /^$terms->[0]/);
2173         } elsif ($bumps->[$id] eq 'full_match') {
2174                 my $fullmatch = join(' ', @$terms);
2175                 $retval *= $mults->[$id] if ($value =~ /^$fullmatch$/);
2176         } elsif ($bumps->[$id] eq 'word_order') {
2177                 my $wordorder = join('.*', @$terms);
2178                 $retval *= $mults->[$id] if ($value =~ /$wordorder/);
2179         }
2180 }
2181 return $retval;
2182 $BODY$ LANGUAGE plperlu IMMUTABLE STRICT COST 100;
2183
2184 -- user activity functions --
2185
2186
2187 -- find the most relevant set of credentials for the Z source and org
2188 CREATE OR REPLACE FUNCTION config.z3950_source_credentials_lookup
2189         (source TEXT, owner INTEGER)
2190         RETURNS config.z3950_source_credentials AS $$
2191
2192     SELECT creds.*
2193     FROM config.z3950_source_credentials creds
2194         JOIN actor.org_unit aou ON (aou.id = creds.owner)
2195         JOIN actor.org_unit_type aout ON (aout.id = aou.ou_type)
2196     WHERE creds.source = $1 AND creds.owner IN (
2197         SELECT id FROM actor.org_unit_ancestors($2)
2198     )
2199     ORDER BY aout.depth DESC LIMIT 1;
2200
2201 $$ LANGUAGE SQL STABLE;
2202
2203 -- since we are not exposing config.z3950_source_credentials
2204 -- via the IDL, providing a stored proc gives us a way to
2205 -- set values in the table via cstore
2206 CREATE OR REPLACE FUNCTION config.z3950_source_credentials_apply
2207         (src TEXT, org INTEGER, uname TEXT, passwd TEXT)
2208         RETURNS VOID AS $$
2209 BEGIN
2210     PERFORM 1 FROM config.z3950_source_credentials
2211         WHERE owner = org AND source = src;
2212
2213     IF FOUND THEN
2214         IF COALESCE(uname, '') = '' AND COALESCE(passwd, '') = '' THEN
2215             DELETE FROM config.z3950_source_credentials
2216                 WHERE owner = org AND source = src;
2217         ELSE
2218             UPDATE config.z3950_source_credentials
2219                 SET username = uname, password = passwd
2220                 WHERE owner = org AND source = src;
2221         END IF;
2222     ELSE
2223         IF COALESCE(uname, '') <> '' OR COALESCE(passwd, '') <> '' THEN
2224             INSERT INTO config.z3950_source_credentials
2225                 (source, owner, username, password)
2226                 VALUES (src, org, uname, passwd);
2227         END IF;
2228     END IF;
2229 END;
2230 $$ LANGUAGE PLPGSQL;
2231
2232 -- Handy function for transforming marc to a variant available on config.xml_transform
2233 CREATE OR REPLACE FUNCTION evergreen.marc_to (marc text, xfrm text) RETURNS TEXT AS $$
2234     SELECT evergreen.xml_pretty_print(xslt_process($1,xslt)::XML)::TEXT FROM config.xml_transform WHERE name = $2;
2235 $$ LANGUAGE SQL;
2236