Attachment 109795 Details for Bug 24857 – Bug 24857: Update Database

[patch] Bug 24857: Update Database

Bug-24857-Update-Database.patch (text/plain), 8.50 KB, created by Kyle M Hall (khall) on 2020-09-09 13:47:10 UTC

(hide)

Description:

Filename:

MIME Type:

Creator: Kyle M Hall (khall)

Created: 2020-09-09 13:47:10 UTC

Size: 8.50 KB

patch

obsolete

>From 7a246c2dcc702576c4342bda062fbb9cf3bf3b5e Mon Sep 17 00:00:00 2001
>From: Kyle M Hall <kyle@bywatersolutions.com>
>Date: Thu, 5 Dec 2019 08:54:49 -0500
>Subject: [PATCH] Bug 24857: Update Database
>
>We have a partner that needs Volume Level Holds.
>This is a feature that some ILSs have that allows the creation of volumes at the bibliographic level,
>with items being optionally assigned to a given volume. This facilitates the ability to place holds
>at a volume level, rather than on a specific item or any available item on a record.
>
>Test Plan:
>1) Apply the patches for this bug
>2) Run updatedatabase.pl
>3) Restart all the things!
>4) Enable the new syspref EnableVolumes
>5) Browse to detail.pl for a record with items
>6) Note the new volumes tab
>7) Test creating, editing and deleting volumes
>8) On the Holdings tab, select one or more items using the checkboxes
>8) Note new selection options for setting a volume for items,
>   and for clearing a volume for items.
>9) Test adding and clearing the volume set for items
>
>Signed-off-by: Andrew Fuerste-Henry <andrew@bywatersolutions.com>
>
>Signed-off-by: Rebecca  Coert <rcoert@arlingtonva.us>
>---
> .../data/mysql/atomicupdate/volumes.perl      | 40 +++++++++++++++++++
> installer/data/mysql/kohastructure.sql        | 31 ++++++++++++++
> installer/data/mysql/sysprefs.sql             |  1 +
> .../admin/preferences/circulation.pref        |  8 +++-
> 4 files changed, 79 insertions(+), 1 deletion(-)
> create mode 100644 installer/data/mysql/atomicupdate/volumes.perl
>
>diff --git a/installer/data/mysql/atomicupdate/volumes.perl b/installer/data/mysql/atomicupdate/volumes.perl
>new file mode 100644
>index 0000000000..7f60669fe8
>--- /dev/null
>+++ b/installer/data/mysql/atomicupdate/volumes.perl
>@@ -0,0 +1,40 @@
>+$DBversion = 'XXX'; # will be replaced by the RM
>+if ( CheckVersion( $DBversion ) ) {
>+    $dbh->do(q{
>+        INSERT IGNORE INTO systempreferences ( `variable`, `value`, `options`, `explanation`, `type` ) VALUES
>+        ('EnableVolumes','0','','Enable volumes feature','YesNo');
>+    });
>+
>+    unless ( TableExists('volumes') ) {
>+        $dbh->do(q{
>+            CREATE TABLE `volumes` ( -- information related to bibliographic records in Koha
>+            `id` int(11) NOT NULL auto_increment, -- primary key, unique identifier assigned by Koha
>+            `biblionumber` INT(11) NOT NULL default 0, -- foreign key linking this table to the biblio table
>+            `display_order` INT(4) NOT NULL default 0, -- specifies the 'sort order' for volumes
>+            `description` MEDIUMTEXT default NULL, -- equivilent to enumchron
>+            `created_on` TIMESTAMP NULL, -- Time and date the volume was created
>+            `updated_on` TIMESTAMP NOT NULL ON UPDATE CURRENT_TIMESTAMP DEFAULT CURRENT_TIMESTAMP, -- Time and date of the latest change on the volume (description)
>+            PRIMARY KEY  (`id`),
>+            CONSTRAINT `volumes_ibfk_1` FOREIGN KEY (`biblionumber`) REFERENCES `biblio` (`biblionumber`) ON DELETE CASCADE ON UPDATE CASCADE
>+            ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci;
>+        });
>+    }
>+
>+    unless ( TableExists('volume_items') ) {
>+        $dbh->do(q{
>+            CREATE TABLE `volume_items` ( -- information related to bibliographic records in Koha
>+            `id` int(11) NOT NULL auto_increment, -- primary key, unique identifier assigned by Koha
>+            `volume_id` int(11) NOT NULL default 0, -- foreign key making this table a 1 to 1 join from items to volumes
>+            `itemnumber` int(11) NOT NULL default 0, -- foreign key linking this table to the items table
>+            PRIMARY KEY  (`id`),
>+            UNIQUE KEY (volume_id,itemnumber),
>+            CONSTRAINT `volume_items_iifk_1` FOREIGN KEY (`itemnumber`) REFERENCES `items` (`itemnumber`) ON DELETE CASCADE ON UPDATE CASCADE,
>+            CONSTRAINT `volume_items_vifk_1` FOREIGN KEY (`volume_id`) REFERENCES `volumes` (`id`) ON DELETE CASCADE ON UPDATE CASCADE
>+            ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci;
>+        });
>+    }
>+
>+    # Always end with this (adjust the bug info)
>+    SetVersion( $DBversion );
>+    print "Upgrade to $DBversion done (Bug XXXXX - Add ability to define volumes for items on a record)\n";
>+}
>diff --git a/installer/data/mysql/kohastructure.sql b/installer/data/mysql/kohastructure.sql
>index a1f886f748..f9c33a52ed 100644
>--- a/installer/data/mysql/kohastructure.sql
>+++ b/installer/data/mysql/kohastructure.sql
>@@ -1750,6 +1750,37 @@ CREATE TABLE `patronimage` ( -- information related to patron images
>   CONSTRAINT `patronimage_fk1` FOREIGN KEY (`borrowernumber`) REFERENCES `borrowers` (`borrowernumber`) ON DELETE CASCADE ON UPDATE CASCADE
> ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci;
> 
>+--
>+-- Table structure for table `volumes`
>+--
>+
>+DROP TABLE IF EXISTS `volumes`;
>+CREATE TABLE `volumes` ( -- information related to bibliographic records in Koha
>+  `id` int(11) NOT NULL auto_increment, -- primary key, unique identifier assigned by Koha
>+  `biblionumber` INT(11) NOT NULL default 0, -- foreign key linking this table to the biblio table
>+  `display_order` INT(4) NOT NULL default 0, -- specifies the 'sort order' for volumes
>+  `description` MEDIUMTEXT default NULL, -- equivilent to enumchron
>+  `created_on` TIMESTAMP NULL, -- Time and date the volume was created
>+  `updated_on` TIMESTAMP NOT NULL ON UPDATE CURRENT_TIMESTAMP DEFAULT CURRENT_TIMESTAMP, -- Time and date of the latest change on the volume (description)
>+  PRIMARY KEY  (`id`),
>+  CONSTRAINT `volumes_ibfk_1` FOREIGN KEY (`biblionumber`) REFERENCES `biblio` (`biblionumber`) ON DELETE CASCADE ON UPDATE CASCADE
>+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci;
>+
>+--
>+-- Table structure for table `volume_items`
>+--
>+
>+DROP TABLE IF EXISTS `volume_items`;
>+CREATE TABLE `volume_items` ( -- information related to bibliographic records in Koha
>+  `id` int(11) NOT NULL auto_increment, -- primary key, unique identifier assigned by Koha
>+  `volume_id` int(11) NOT NULL default 0, -- foreign key making this table a 1 to 1 join from items to volumes
>+  `itemnumber` int(11) NOT NULL default 0, -- foreign key linking this table to the items table
>+  PRIMARY KEY  (`id`),
>+  UNIQUE KEY (volume_id,itemnumber),
>+  CONSTRAINT `volume_items_iifk_1` FOREIGN KEY (`itemnumber`) REFERENCES `items` (`itemnumber`) ON DELETE CASCADE ON UPDATE CASCADE,
>+  CONSTRAINT `volume_items_vifk_1` FOREIGN KEY (`volume_id`) REFERENCES `volumes` (`id`) ON DELETE CASCADE ON UPDATE CASCADE
>+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci;
>+
> --
> -- Table structure for table `reserves`
> --
>diff --git a/installer/data/mysql/sysprefs.sql b/installer/data/mysql/sysprefs.sql
>index 1df6a1fb53..c851acad25 100644
>--- a/installer/data/mysql/sysprefs.sql
>+++ b/installer/data/mysql/sysprefs.sql
>@@ -698,6 +698,7 @@ INSERT INTO systempreferences ( `variable`, `value`, `options`, `explanation`, `
> ('UseICU','0','1','Tell Koha if ICU indexing is in use for Zebra or not.','YesNo'),
> ('UseTransportCostMatrix','0','','Use Transport Cost Matrix when filling holds','YesNo'),
> ('UseWYSIWYGinSystemPreferences','0','','Show WYSIWYG editor when editing certain HTML system preferences.','YesNo'),
>+('EnableVolumes','0','','Enable volumes feature','YesNo'),
> ('viewISBD','1','','Allow display of ISBD view of bibiographic records','YesNo'),
> ('viewLabeledMARC','0','','Allow display of labeled MARC view of bibiographic records','YesNo'),
> ('viewMARC','1','','Allow display of MARC view of bibiographic records','YesNo'),
>diff --git a/koha-tmpl/intranet-tmpl/prog/en/modules/admin/preferences/circulation.pref b/koha-tmpl/intranet-tmpl/prog/en/modules/admin/preferences/circulation.pref
>index 710b86cbe1..9c95aaa6f3 100644
>--- a/koha-tmpl/intranet-tmpl/prog/en/modules/admin/preferences/circulation.pref
>+++ b/koha-tmpl/intranet-tmpl/prog/en/modules/admin/preferences/circulation.pref
>@@ -628,7 +628,13 @@ Circulation:
>             - the last patron to return an item. This setting is independent of the opacreadinghistory and AnonymousPatron system preferences.
>     Holds policy:
>         -
>-            - In the staff interface, split the holds queue into separate tables by
>+            - pref: EnableVolumes
>+              choices:
>+                  yes: Enable
>+                  no: "Don't enable"
>+            - volumes feature to allow collecting groups of items on a record into volumes.
>+        -
>+            - In the staff client, split the holds queue into separate tables by
>             - pref: HoldsSplitQueue
>               choices:
>                   nothing: nothing
>-- 
>2.24.1 (Apple Git-126)

Actions: View | Diff | Splinter Review

Attachments on bug 24857: 100652 | 100653 | 100654 | 100655 | 100656 | 100657 | 100658 | 100659 | 100660 | 100661 | 100662 | 101637 | 101638 | 101639 | 101640 | 101641 | 101642 | 101643 | 101644 | 101645 | 101646 | 101647 | 101648 | 101650 | 101651 | 101652 | 101653 | 101654 | 101655 | 101656 | 101657 | 101658 | 101659 | 101660 | 101661 | 101670 | 101671 | 101672 | 101673 | 101674 | 101675 | 101676 | 101677 | 101678 | 101679 | 101680 | 101681 | 101730 | 101731 | 101732 | 101733 | 101734 | 101735 | 101736 | 101737 | 101738 | 101739 | 101740 | 101741 | 101752 | 101753 | 101754 | 101755 | 101756 | 101757 | 101758 | 101759 | 101760 | 101761 | 101762 | 101763 | 104952 | 104953 | 104954 | 104955 | 104956 | 104957 | 104958 | 104959 | 104960 | 104961 | 104962 | 104963 | 104964 | 104966 | 106728 | 106729 | 106730 | 106731 | 106732 | 106733 | 106734 | 106735 | 106736 | 106737 | 106738 | 106739 | 106740 | 106741 | 108443 | 108444 | 108445 | 108446 | 108447 | 108448 | 108449 | 108450 | 108451 | 108452 | 108453 | 108454 | 108455 | 108456 | 108666 | 108667 | 108668 | 108669 | 108670 | 108671 | 108672 | 108673 | 108674 | 108675 | 108676 | 108677 | 108678 | 108679 | 108680 | 108681 | 108682 | 108683 | 108684 | 108685 | 108686 | 109074 | 109075 | 109076 | 109077 | 109078 | 109079 | 109080 | 109081 | 109082 | 109083 | 109084 | 109085 | 109086 | 109087 | 109088 | 109089 | 109090 | 109091 | 109092 | 109093 | 109094 | 109795 | 109796 | 109797 | 109798 | 109799 | 109800 | 109801 | 109802 | 109803 | 109804 | 109805 | 109806 | 109807 | 109808 | 109809 | 109810 | 109811 | 109812 | 109813 | 109814 | 109815 | 109894 | 109901 | 109902 | 109903 | 109904 | 109905 | 109906 | 109907 | 109908 | 109909 | 109910 | 109911 | 109912 | 109913 | 109914 | 109915 | 109916 | 109917 | 109918 | 109919 | 109920 | 109921 | 109922 | 109923 | 113136 | 113137 | 113138 | 113139 | 113140 | 113141 | 113142 | 113143 | 113144 | 113145 | 113146 | 113147 | 113148 | 113149 | 113150 | 113151 | 113152 | 113153 | 113154 | 113155 | 113156 | 113157 | 113158 | 113159 | 113160 | 113168 | 113169 | 113170 | 113171 | 113172 | 113173 | 113174 | 113175 | 113176 | 113177 | 113178 | 113179 | 113180 | 113181 | 113182 | 113183 | 113184 | 113185 | 113186 | 113187 | 113188 | 113189 | 113190 | 113191 | 120495 | 120496 | 120497 | 120498 | 120499 | 120500 | 120501 | 120502 | 120503 | 120504 | 120505 | 120506 | 120507 | 120508 | 120509 | 120510 | 120511 | 120512 | 120513 | 120514 | 120515 | 120516 | 120517 | 120518 | 122808 | 122809 | 122810 | 122811 | 122812 | 122813 | 122814 | 122815 | 122816 | 122817 | 122818 | 122819 | 122820 | 122821 | 122822 | 122823 | 122824 | 122825 | 122826 | 122827 | 122828 | 122829 | 122830 | 122831 | 123882 | 123883 | 123884 | 123885 | 123886 | 123887 | 123888 | 123889 | 123890 | 123891 | 123892 | 123893 | 123894 | 123895 | 123896 | 123897 | 123898 | 123899 | 123900 | 123901 | 123902 | 123903 | 123904 | 123905 | 123906 | 123907 | 123908 | 123909 | 123910 | 123912 | 124021 | 124022 | 124023 | 124024 | 124025 | 124026 | 124027 | 124028 | 124029 | 124030 | 124031 | 124032 | 124033 | 124034 | 124035 | 124036 | 124037 | 124038 | 124039 | 124040 | 124041 | 124042 | 124043 | 124044 | 124045 | 124046 | 124047 | 124048 | 124049 | 124050 | 124051 | 124052 | 124053 | 124331 | 124332 | 124333 | 124334 | 124335 | 124336 | 124337 | 124338 | 124339 | 124340 | 124341 | 124342 | 124343 | 124344 | 124345 | 124346 | 124347 | 124348 | 124349 | 124351 | 124352 | 124353 | 124354 | 124355 | 124356 | 124357 | 124358 | 124359 | 124360 | 124361 | 124362 | 124363 | 124421 | 124463 | 124583 | 124584 | 124585 | 124586 | 124587 | 124588 | 124589 | 124590 | 124591 | 124592 | 124593 | 124594 | 124595 | 124596 | 124597 | 124598 | 124599 | 124600 | 124601 | 124602 | 124603 | 124604 | 124605 | 124606 | 124607 | 124608 | 124609 | 124610 | 124611 | 124612 | 124613 | 124614 | 124615 | 131449 | 131450 | 131451 | 131452 | 131453 | 131454 | 131455 | 131456 | 134288 | 134289 | 134290 | 134291 | 134292 | 134293 | 134294 | 134295 | 134296 | 135590 | 135591 | 135592 | 135593 | 135594 | 135595 | 135596 | 135597 | 135598 | 135599 | 135600 | 135601 | 135602 | 135603 | 135604 | 135605 | 135606 | 135607 | 135608 | 135609 | 135610 | 135614 | 135615 | 135616 | 135617 | 135618 | 135619 | 135620 | 135621 | 135622 | 135623 | 135624 | 135625 | 135626 | 135627 | 135628 | 135629 | 137259 | 137260 | 137261 | 137262 | 137263 | 137264 | 137265 | 137266 | 137267 | 137268 | 137311 | 137314 | 137315 | 137316 | 137317 | 137318 | 137319 | 137320 | 137321 | 137322 | 137323 | 137441 | 137442 | 137443 | 137608 | 138933