6 # This script checks for required updates to the database.
8 # Part of the Koha Library Software www.koha.org
9 # Licensed under the GPL.
12 # - Would also be a good idea to offer to do a backup at this time...
14 # NOTE: If you do something more than once in here, make it table driven.
24 use MARC::File::XML ( BinaryEncoding => 'utf8' );
26 # FIXME - The user might be installing a new database, so can't rely
27 # on /etc/koha.conf anyway.
34 %existingtables, # tables already in database
38 $type, $null, $key, $default, $extra,
39 $prefitem, # preference item in systempreferences table
46 my $dbh = C4::Context->dbh;
47 print "connected to your DB. Checking & modifying it\n" unless $silent;
48 $|=1; # flushes output
53 # Tables to add if they don't exist
55 categorytable => "(categorycode char(5) NOT NULL default '',
56 description text default '',
57 itemtypecodes text default '',
58 PRIMARY KEY (categorycode)
60 subcategorytable => "(subcategorycode char(5) NOT NULL default '',
61 description text default '',
62 itemtypecodes text default '',
63 PRIMARY KEY (subcategorycode)
65 mediatypetable => "(mediatypecode char(5) NOT NULL default '',
66 description text default '',
67 itemtypecodes text default '',
68 PRIMARY KEY (mediatypecode)
71 `timestamp` TIMESTAMP NOT NULL ,
72 `user` INT( 11 ) NOT NULL ,
73 `module` TEXT default '',
74 `action` TEXT default '' ,
75 `object` INT(11) default '' ,
76 `info` TEXT default '' ,
77 PRIMARY KEY ( `timestamp` , `user` )
80 module varchar(20) NOT NULL default '',
81 code varchar(20) NOT NULL default '',
82 name varchar(100) NOT NULL default '',
83 title varchar(200) NOT NULL default '',
85 PRIMARY KEY (module,code)
88 alertid int(11) NOT NULL auto_increment,
89 borrowernumber int(11) NOT NULL default '0',
90 type varchar(10) NOT NULL default '',
91 externalid varchar(20) NOT NULL default '',
92 PRIMARY KEY (alertid),
93 KEY borrowernumber (borrowernumber),
94 KEY type (type,externalid)
97 `idnew` int(10) unsigned NOT NULL auto_increment,
98 `title` varchar(250) NOT NULL default '',
100 `lang` varchar(4) NOT NULL default '',
101 `timestamp` timestamp NOT NULL default CURRENT_TIMESTAMP,
102 PRIMARY KEY (`idnew`)
104 repeatable_holidays => "(
105 `id` int(11) NOT NULL auto_increment,
106 `branchcode` varchar(4) NOT NULL default '',
107 `weekday` smallint(6) default NULL,
108 `day` smallint(6) default NULL,
109 `month` smallint(6) default NULL,
110 `title` varchar(50) NOT NULL default '',
111 `description` text NOT NULL,
114 special_holidays => "(
115 `id` int(11) NOT NULL auto_increment,
116 `branchcode` varchar(4) NOT NULL default '',
117 `day` smallint(6) NOT NULL default '0',
118 `month` smallint(6) NOT NULL default '0',
119 `year` smallint(6) NOT NULL default '0',
120 `isexception` smallint(1) NOT NULL default '1',
121 `title` varchar(50) NOT NULL default '',
122 `description` text NOT NULL,
125 overduerules =>"(`branchcode` varchar(255) NOT NULL default '',
126 `categorycode` char(2) NOT NULL default '',
127 `delay1` int(4) default '0',
128 `letter1` varchar(20) default NULL,
129 `debarred1` char(1) default '0',
130 `delay2` int(4) default '0',
131 `debarred2` char(1) default '0',
132 `letter2` varchar(20) default NULL,
133 `delay3` int(4) default '0',
134 `letter3` varchar(20) default NULL,
135 `debarred3` int(1) default '0',
136 PRIMARY KEY (`branchcode`,`categorycode`)
138 cities => "(`cityid` int auto_increment,
139 `city_name` char(100) NOT NULL,
140 `city_zipcode` char(20),
141 PRIMARY KEY (`cityid`)
143 roadtype => "(`roadtypeid` int auto_increment,
144 `road_type` char(100) NOT NULL,
145 PRIMARY KEY (`roadtypeid`)
149 labelid int(11) NOT NULL auto_increment,
150 itemnumber varchar(100) NOT NULL default '',
151 timestamp timestamp(14) NOT NULL,
152 PRIMARY KEY (labelid)
156 id int(4) NOT NULL auto_increment,
157 barcodetype char(100) default '',
158 title tinyint(1) default '0',
159 isbn tinyint(1) default '0',
160 itemtype tinyint(1) default '0',
161 barcode tinyint(1) default '0',
162 dewey tinyint(1) default '0',
163 class tinyint(1) default '0',
164 author tinyint(1) default '0',
165 papertype char(100) default '',
166 startrow int(2) default NULL,
170 reviewid integer NOT NULL auto_increment,
171 borrowernumber integer,
172 biblionumber integer,
175 datereviewed datetime,
176 PRIMARY KEY (reviewid)
178 borrowers_to_borrowers => "(
185 my %requirefields = (
186 subscription => { 'letter' => 'char(20) NULL', 'distributedto' => 'text NULL'},
187 itemtypes => { 'imageurl' => 'char(200) NULL'},
188 aqbookfund => { 'branchcode' => 'varchar(4) NULL'},
189 aqbudget => { 'branchcode' => 'varchar(4) NULL'},
190 auth_header => { 'marc' => 'BLOB NOT NULL', 'linkid' => 'BIGINT(20) NULL'},
191 auth_subfield_structure =>{ 'hidden' => 'TINYINT(3) NOT NULL UNSIGNED ZEROFILL', 'kohafield' => 'VARCHAR(45) NOT NULL', 'linkid' => 'TINYINT(1) NOT NULL UNSIGNED', 'isurl' => 'TINYINT(1) UNSIGNED'},
192 statistics => { 'associatedborrower' => 'integer'},
193 # tablename => { 'field' => 'fieldtype' },
196 my %dropable_table = (
197 sessionqueries => 'sessionqueries',
198 marcrecorddone => 'marcrecorddone',
200 itemsprices => 'itemsprices',
201 biblioanalysis => 'biblioanalysis',
203 # tablename => 'tablename',
206 my %uselessfields = (
207 # tablename => "field1,field2",
208 borrowers => "suburb,altstreetaddress,altsuburb,altcity,studentnumber,school,area,preferredcont,altcp",
209 deletedborrowers=> "suburb,altstreetaddress,altsuburb,altcity,studentnumber,school,area,preferredcont,altcp",
211 # the other hash contains other actions that can't be done elsewhere. they are done
212 # either BEFORE of AFTER everything else, depending on "when" entry (default => AFTER)
214 # The tabledata hash contains data that should be in the tables.
215 # The uniquefieldrequired hash entry is used to determine which (if any) fields
216 # must not exist in the table for this row to be inserted. If the
217 # uniquefieldrequired entry is already in the table, the existing data is not
218 # modified, unless the forceupdate hash entry is also set. Fields in the
219 # anonymous "forceupdate" hash will be forced to be updated to the default
220 # values given in the %tabledata hash.
224 # { uniquefielrequired => 'fieldname', # the primary key in the table
225 # fieldname => fieldvalue,
226 # fieldname2 => fieldvalue2,
229 systempreferences => [
231 uniquefieldrequired => 'variable',
232 variable => 'Activate_Log',
234 forceupdate => { 'explanation' => 1,
236 explanation => 'Turn Log Actions on DB On an Off',
240 uniquefieldrequired => 'variable',
241 variable => 'IndependantBranches',
243 forceupdate => { 'explanation' => 1,
245 explanation => 'Turn Branch independancy management On an Off',
249 uniquefieldrequired => 'variable',
250 variable => 'ReturnBeforeExpiry',
252 forceupdate => { 'explanation' => 1,
254 explanation => 'If Yes, Returndate on issuing can\'t be after borrower card expiry',
258 uniquefieldrequired => 'variable',
259 variable => 'opacstylesheet',
261 forceupdate => { 'explanation' => 1,
263 explanation => 'Enter a complete URL to use an alternate stylesheet in OPAC',
267 uniquefieldrequired => 'variable',
268 variable => 'opacsmallimage',
270 forceupdate => { 'explanation' => 1,
272 explanation => 'Enter a complete URL to an image, will be on top/left instead of the Koha logo',
276 uniquefieldrequired => 'variable',
277 variable => 'opaclargeimage',
279 forceupdate => { 'explanation' => 1,
281 explanation => 'Enter a complete URL to an image, will be on the main page, instead of the Koha logo',
285 uniquefieldrequired => 'variable',
286 variable => 'delimiter',
288 forceupdate => { 'explanation' => 1,
290 explanation => 'separator for reports exported to spreadsheet',
294 uniquefieldrequired => 'variable',
296 value => 'OPENOFFICE.ORG',
297 forceupdate => { 'explanation' => 1,
300 explanation => 'Define the default application for report exportations into files',
302 options => 'EXCEL|OPENOFFICE.ORG'
305 uniquefieldrequired => 'variable',
306 variable => 'Delimiter',
308 forceupdate => { 'explanation' => 1,
311 explanation => 'Define the default separator character for report exportations into files',
313 options => ';|tabulation|,|/|\|#'
316 uniquefieldrequired => 'variable',
317 variable => 'SubscriptionHistory',
319 forceupdate => { 'explanation' => 1,
322 explanation => 'Define the information level for serials history in OPAC',
324 options => 'simplified|full'
327 uniquefieldrequired => 'variable',
328 variable => 'hidelostitems',
330 forceupdate => { 'explanation' => 1,
332 explanation => 'show or hide "lost" items in OPAC.',
336 uniquefieldrequired => 'variable',
337 variable => 'IndependantBranches',
339 forceupdate => { 'explanation' => 1,
341 explanation => 'Turn Branch independancy management On an Off',
345 uniquefieldrequired => 'variable',
346 variable => 'ReturnBeforeExpiry',
348 forceupdate => { 'explanation' => 1,
350 explanation => 'If Yes, Returndate on issuing can\'t be after borrower card expiry',
354 uniquefieldrequired => 'variable',
355 variable => 'Disable_Dictionary',
357 forceupdate => { 'explanation' => 1,
359 explanation => 'Disables Dictionary buttons if set to yes',
363 uniquefieldrequired => 'variable',
364 variable => 'hide_marc',
366 forceupdate => { 'explanation' => 1,
368 explanation => 'hide marc specific datas like subfield code & indicators to library',
372 uniquefieldrequired => 'variable',
373 variable => 'NotifyBorrowerDeparture',
375 forceupdate => { 'explanation' => 1,
377 explanation => 'Delay before expiry where a notice is sent when issuing',
381 uniquefieldrequired => 'variable',
382 variable => 'OpacPasswordChange',
384 forceupdate => { 'explanation' => 1,
386 explanation => 'Enable/Disable password change in OPAC (disable it when using LDAP auth)',
390 uniquefieldrequired => 'variable',
391 variable => 'useDaysMode',
393 forceupdate => { 'explanation' => 1,
395 explanation => 'How to calculate return dates : Calendar means holidays will be controled, Days means the return date don\'t depend on holidays',
397 options => 'Calendar|Days'
400 uniquefieldrequired => 'variable',
401 variable => 'borrowerMandatoryField',
402 value => 'zipcode|surname',
403 forceupdate => { 'explanation' => 1,
405 explanation => 'List all mandatory fields for borrowers',
409 uniquefieldrequired => 'variable',
410 variable => 'borrowerRelationship',
411 value => 'father|mother,grand-mother',
412 forceupdate => { 'explanation' => 1,
414 explanation => 'The relationships between a guarantor & a guarantee (separated by | or ,)',
418 uniquefieldrequired => 'variable',
419 variable => 'ReservesMaxPickUpDelay',
421 forceupdate => { 'explanation' => 1,
423 explanation => 'Maximum delay to pick up a reserved document',
427 uniquefieldrequired => 'variable',
428 variable => 'TransfersMaxDaysWarning',
430 forceupdate => { 'explanation' => 1,
432 explanation => 'Max delay before considering the transfer has potentialy a problem',
436 uniquefieldrequired => 'variable',
437 variable => 'memberofinstitution',
439 forceupdate => { 'explanation' => 1,
441 explanation => 'Are your patrons members of institutions',
445 uniquefieldrequired => 'variable',
446 variable => 'ReadingHistory',
448 forceupdate => { 'explanation' => 1,
450 explanation => 'Allow reading record info retrievable from issues and oldissues tables',
454 uniquefieldrequired => 'variable',
455 variable => 'IssuingInProcess',
457 forceupdate => { 'explanation' => 1,
459 explanation => 'Allow no debt alert if the patron is issuing item that accumulate debt',
463 uniquefieldrequired => 'variable',
464 variable => 'AutomaticItemReturn',
466 forceupdate => { 'explanation' => 1,
468 explanation => 'This Variable allow or not to return automaticly to his homebranch',
472 uniquefieldrequired => 'variable',
473 variable => 'reviewson',
475 forceupdate => { 'explanation' => 1,
477 explanation => 'Allows patrons to submit reviews from the opac',
484 my %fielddefinitions = (
486 # { field => 'fieldname',
487 # type => 'fieldtype',
505 field => 'booksellerid',
515 field => 'listprice',
516 type => 'varchar(10)',
523 field => 'invoiceprice',
524 type => 'varchar(10)',
533 field => 'borrowernumber',
535 null => 'NULL', # can be null when a borrower is deleted and the foreign key rule executed
541 field => 'itemnumber',
543 null => 'NULL', # can be null when a borrower is deleted and the foreign key rule executed
550 { field => 'firstname',
554 { field => 'initials',
558 { field => 'B_email',
561 after => 'B_zipcode',
564 field => 'streetnumber', # street number (hidden if streettable table is empty)
570 field => 'streettype', # street table, list builded from a system table
573 after => 'streetnumber',
580 field => 'B_streetnumber', # street number (hidden if streettable table is empty)
586 field => 'B_streettype', # street table, list builded from a system table
589 after => 'B_streetnumber',
598 field => 'address2', # complement address
610 field => 'contactfirstname', # contact's firstname
613 after => 'contactname',
616 field => 'contacttitle', # contact's title
619 after => 'contactfirstname',
623 deletedborrowers => [
624 { field => 'firstname',
628 { field => 'initials',
632 { field => 'B_email',
635 after => 'B_zipcode',
638 field => 'streetnumber', # street number (hidden if streettable table is empty)
644 field => 'streettype', # street table, list builded from a system table
647 after => 'streetnumber',
654 field => 'B_streetnumber', # street number (hidden if streettable table is empty)
660 field => 'B_streettype', # street table, list builded from a system table
663 after => 'B_streetnumber',
672 field => 'address2', # complement address
684 field => 'contactfirstname', # contact's firstname
687 after => 'contactname',
690 field => 'contacttitle', # contact's title
693 after => 'contactfirstname',
700 type => 'varchar(15)',
707 field => 'branchprinter',
708 type => 'varchar(100)',
717 field => 'category_type',
727 field => 'waitingdate',
739 # { indexname => 'index detail'
743 { indexname => 'shelfnumber',
744 content => 'shelfnumber',
746 { indexname => 'itemnumber',
747 content => 'itemnumber',
751 { indexname => 'biblionumber',
752 content => 'biblionumber',
756 { indexname => 'homebranch',
757 content => 'homebranch',
759 { indexname => 'holdingbranch',
760 content => 'holdingbranch',
764 { indexname => 'PRIMARY',
770 { indexname => 'booksellerid',
771 content => 'booksellerid',
775 { indexname => 'basketno',
776 content => 'basketno',
779 aqorderbreakdown => [
780 { indexname => 'ordernumber',
781 content => 'ordernumber',
783 { indexname => 'bookfundid',
784 content => 'bookfundid',
788 { indexname => 'PRIMARY',
789 content => 'currency',
797 # { key => 'the key in table' (must be indexed)
798 # foreigntable => 'the foreigntable name', # (the parent)
799 # foreignkey => 'the foreign key column(s)' # (in the parent)
800 # onUpdate => 'CASCADE|SET NULL|NO ACTION| RESTRICT',
801 # onDelete => 'CASCADE|SET NULL|NO ACTION| RESTRICT',
805 { key => 'shelfnumber',
806 foreigntable => 'bookshelf',
807 foreignkey => 'shelfnumber',
808 onUpdate => 'CASCADE',
809 onDelete => 'CASCADE',
811 { key => 'itemnumber',
812 foreigntable => 'items',
813 foreignkey => 'itemnumber',
814 onUpdate => 'CASCADE',
815 onDelete => 'CASCADE',
818 # onDelete is RESTRICT on reference tables (branches, itemtype) as we don't want items to be
819 # easily deleted, but branches/itemtype not too easy to empty...
821 { key => 'biblionumber',
822 foreigntable => 'biblio',
823 foreignkey => 'biblionumber',
824 onUpdate => 'CASCADE',
825 onDelete => 'CASCADE',
828 foreigntable => 'itemtypes',
829 foreignkey => 'itemtype',
830 onUpdate => 'CASCADE',
831 onDelete => 'RESTRICT',
835 { key => 'biblioitemnumber',
836 foreigntable => 'biblioitems',
837 foreignkey => 'biblioitemnumber',
838 onUpdate => 'CASCADE',
839 onDelete => 'CASCADE',
841 { key => 'homebranch',
842 foreigntable => 'branches',
843 foreignkey => 'branchcode',
844 onUpdate => 'CASCADE',
845 onDelete => 'RESTRICT',
847 { key => 'holdingbranch',
848 foreigntable => 'branches',
849 foreignkey => 'branchcode',
850 onUpdate => 'CASCADE',
851 onDelete => 'RESTRICT',
854 additionalauthors => [
855 { key => 'biblionumber',
856 foreigntable => 'biblio',
857 foreignkey => 'biblionumber',
858 onUpdate => 'CASCADE',
859 onDelete => 'CASCADE',
863 { key => 'biblionumber',
864 foreigntable => 'biblio',
865 foreignkey => 'biblionumber',
866 onUpdate => 'CASCADE',
867 onDelete => 'CASCADE',
871 { key => 'booksellerid',
872 foreigntable => 'aqbooksellers',
874 onUpdate => 'CASCADE',
875 onDelete => 'RESTRICT',
880 foreigntable => 'aqbasket',
881 foreignkey => 'basketno',
882 onUpdate => 'CASCADE',
883 onDelete => 'CASCADE',
885 { key => 'biblionumber',
886 foreigntable => 'biblio',
887 foreignkey => 'biblionumber',
888 onUpdate => 'SET NULL',
889 onDelete => 'SET NULL',
893 { key => 'listprice',
894 foreigntable => 'currency',
895 foreignkey => 'currency',
896 onUpdate => 'CASCADE',
897 onDelete => 'CASCADE',
899 { key => 'invoiceprice',
900 foreigntable => 'currency',
901 foreignkey => 'currency',
902 onUpdate => 'CASCADE',
903 onDelete => 'CASCADE',
906 aqorderbreakdown => [
907 { key => 'ordernumber',
908 foreigntable => 'aqorders',
909 foreignkey => 'ordernumber',
910 onUpdate => 'CASCADE',
911 onDelete => 'CASCADE',
913 { key => 'bookfundid',
914 foreigntable => 'aqbookfund',
915 foreignkey => 'bookfundid',
916 onUpdate => 'CASCADE',
917 onDelete => 'CASCADE',
921 { key => 'frombranch',
922 foreigntable => 'branches',
923 foreignkey => 'branchcode',
924 onUpdate => 'CASCADE',
925 onDelete => 'CASCADE',
928 foreigntable => 'branches',
929 foreignkey => 'branchcode',
930 onUpdate => 'CASCADE',
931 onDelete => 'CASCADE',
933 { key => 'itemnumber',
934 foreigntable => 'items',
935 foreignkey => 'itemnumber',
936 onUpdate => 'CASCADE',
937 onDelete => 'CASCADE',
941 { key => 'categorycode',
942 foreigntable => 'categories',
943 foreignkey => 'categorycode',
944 onUpdate => 'CASCADE',
945 onDelete => 'CASCADE',
948 foreigntable => 'itemtypes',
949 foreignkey => 'itemtype',
950 onUpdate => 'CASCADE',
951 onDelete => 'CASCADE',
954 issues => [ # constraint is SET NULL : when a borrower or an item is deleted, we keep the issuing record
956 { key => 'borrowernumber',
957 foreigntable => 'borrowers',
958 foreignkey => 'borrowernumber',
959 onUpdate => 'SET NULL',
960 onDelete => 'SET NULL',
962 { key => 'itemnumber',
963 foreigntable => 'items',
964 foreignkey => 'itemnumber',
965 onUpdate => 'SET NULL',
966 onDelete => 'SET NULL',
970 { key => 'borrowernumber',
971 foreigntable => 'borrowers',
972 foreignkey => 'borrowernumber',
973 onUpdate => 'CASCADE',
974 onDelete => 'CASCADE',
976 { key => 'biblionumber',
977 foreigntable => 'biblio',
978 foreignkey => 'biblionumber',
979 onUpdate => 'CASCADE',
980 onDelete => 'CASCADE',
982 { key => 'itemnumber',
983 foreigntable => 'items',
984 foreignkey => 'itemnumber',
985 onUpdate => 'CASCADE',
986 onDelete => 'CASCADE',
988 { key => 'branchcode',
989 foreigntable => 'branches',
990 foreignkey => 'branchcode',
991 onUpdate => 'CASCADE',
992 onDelete => 'CASCADE',
995 borrowers => [ # foreign keys are RESTRICT as we don't want to delete borrowers when a branch is deleted
996 # but prevent deleting a branch as soon as it has 1 borrower !
997 { key => 'categorycode',
998 foreigntable => 'categories',
999 foreignkey => 'categorycode',
1000 onUpdate => 'RESTRICT',
1001 onDelete => 'RESTRICT',
1003 { key => 'branchcode',
1004 foreigntable => 'branches',
1005 foreignkey => 'branchcode',
1006 onUpdate => 'RESTRICT',
1007 onDelete => 'RESTRICT',
1010 deletedborrowers => [ # foreign keys are RESTRICT as we don't want to delete borrowers when a branch is deleted
1011 # but prevent deleting a branch as soon as it has 1 borrower !
1012 { key => 'categorycode',
1013 foreigntable => 'categories',
1014 foreignkey => 'categorycode',
1015 onUpdate => 'RESTRICT',
1016 onDelete => 'RESTRICT',
1018 { key => 'branchcode',
1019 foreigntable => 'branches',
1020 foreignkey => 'branchcode',
1021 onUpdate => 'RESTRICT',
1022 onDelete => 'RESTRICT',
1026 { key => 'borrowernumber',
1027 foreigntable => 'borrowers',
1028 foreignkey => 'borrowernumber',
1029 onUpdate => 'CASCADE',
1030 onDelete => 'CASCADE',
1032 { key => 'itemnumber',
1033 foreigntable => 'items',
1034 foreignkey => 'itemnumber',
1035 onUpdate => 'SET NULL',
1036 onDelete => 'SET NULL',
1039 auth_tag_structure => [
1040 { key => 'authtypecode',
1041 foreigntable => 'auth_types',
1042 foreignkey => 'authtypecode',
1043 onUpdate => 'CASCADE',
1044 onDelete => 'CASCADE',
1047 # FIXME : don't constraint auth_*_table and auth_word, as they may be replaced by zebra
1052 my %column_change = (
1056 from => 'emailaddress',
1061 from => 'streetaddress',
1063 after => 'initials',
1066 from => 'faxnumber',
1071 from => 'textmessaging',
1077 to => 'contactnote',
1078 after => 'opacnote',
1081 from => 'physstreet',
1086 from => 'streetcity',
1088 after => 'B_address',
1101 from => 'homezipcode',
1108 after => 'B_zipcode',
1113 after => 'dateenrolled',
1116 from => 'guarantor',
1117 to => 'guarantorid',
1118 after => 'contactname',
1121 from => 'textmessaging',
1127 to => 'contactnotes',
1128 after => 'opacnotes',
1131 from => 'altrelationship',
1132 to => 'relationship',
1133 after => 'borrowernotes',
1137 deletedborrowers => [
1139 from => 'emailaddress',
1144 from => 'streetaddress',
1146 after => 'initials',
1149 from => 'faxnumber',
1154 from => 'textmessaging',
1160 to => 'contactnote',
1161 after => 'opacnote',
1164 from => 'physstreet',
1169 from => 'streetcity',
1171 after => 'B_address',
1184 from => 'homezipcode',
1191 after => 'B_zipcode',
1196 after => 'dateenrolled',
1199 from => 'guarantor',
1200 to => 'guarantorid',
1201 after => 'contactname',
1204 from => 'textmessaging',
1210 to => 'contactnotes',
1211 after => 'opacnotes',
1214 from => 'altrelationship',
1215 to => 'relationship',
1216 after => 'borrowernotes',
1222 foreach my $table (keys %column_change) {
1223 $sth = $dbh->prepare("show columns from $table");
1226 while ( ( $column, $type, $null, $key, $default, $extra ) = $sth->fetchrow )
1228 $types{$column}->{type} ="$type";
1229 $types{$column}->{null} = "$null";
1230 $types{$column}->{key} = "$key";
1231 $types{$column}->{default} = "$default";
1232 $types{$column}->{extra} = "$extra";
1234 my $tablerows = $column_change{$table};
1235 foreach my $row ( @$tablerows ) {
1236 if ($types{$row->{from}}->{type}) {
1237 print "altering $table $row->{from} to $row->{to}\n";
1238 # ALTER TABLE `borrowers` CHANGE `faxnumber` `fax` TEXT CHARACTER SET utf8 COLLATE utf8_general_ci NULL DEFAULT NULL
1239 # alter table `borrowers` change `faxnumber` `fax` type text null after phone
1241 "alter table `$table` change `$row->{from}` `$row->{to}` $types{$row->{from}}->{type} ".
1242 ($types{$row->{from}}->{null} eq 'YES'?" NULL":" NOT NULL").
1243 ($types{$row->{from}}->{default}?" default ".$types{$row->{from}}->{default}:"").
1244 "$types{$row->{from}}->{extra} after $row->{after} ";
1251 #-------------------
1256 # Get version of MySQL database engine.
1257 my $mysqlversion = `mysqld --version`;
1258 $mysqlversion =~ /Ver (\S*) /;
1260 if ( $mysqlversion ge '3.23' ) {
1261 print "Could convert to MyISAM database tables...\n" unless $silent;
1264 #---------------------------------
1267 # Collect all tables into a list
1268 $sth = $dbh->prepare("show tables");
1270 while ( my ($table) = $sth->fetchrow ) {
1271 $existingtables{$table} = 1;
1275 # Now add any missing tables
1276 foreach $table ( keys %requiretables ) {
1277 unless ( $existingtables{$table} ) {
1278 print "Adding $table table...\n" unless $silent;
1279 my $sth = $dbh->prepare("create table $table $requiretables{$table}");
1282 print "Error : $sth->errstr \n";
1288 # now drop useless tables
1289 foreach $table ( keys %dropable_table ) {
1290 if ( $existingtables{$table} ) {
1291 print "Dropping unused table $table\n" if $debug and not $silent;
1292 $dbh->do("drop table $table");
1294 print "Error : $dbh->errstr \n";
1299 #---------------------------------
1302 foreach $table ( keys %requirefields ) {
1303 print "Check table $table\n" if $debug and not $silent;
1304 $sth = $dbh->prepare("show columns from $table");
1307 while ( ( $column, $type, $null, $key, $default, $extra ) = $sth->fetchrow )
1309 $types{$column} = $type;
1311 foreach $column ( keys %{ $requirefields{$table} } ) {
1312 print " Check column $column [$types{$column}]\n" if $debug and not $silent;
1313 if ( !$types{$column} ) {
1315 # column doesn't exist
1316 print "Adding $column field to $table table...\n" unless $silent;
1317 $query = "alter table $table
1318 add column $column " . $requirefields{$table}->{$column};
1319 print "Execute: $query\n" if $debug;
1320 my $sti = $dbh->prepare($query);
1323 print "**Error : $sti->errstr \n";
1330 foreach $table ( keys %fielddefinitions ) {
1331 print "Check table $table\n" if $debug;
1332 $sth = $dbh->prepare("show columns from $table");
1335 while ( ( $column, $type, $null, $key, $default, $extra ) = $sth->fetchrow )
1337 $definitions->{$column}->{type} = $type;
1338 $definitions->{$column}->{null} = $null;
1339 $definitions->{$column}->{null} = 'NULL' if $null eq 'YES';
1340 $definitions->{$column}->{key} = $key;
1341 $definitions->{$column}->{default} = $default;
1342 $definitions->{$column}->{extra} = $extra;
1344 my $fieldrow = $fielddefinitions{$table};
1345 foreach my $row (@$fieldrow) {
1346 my $field = $row->{field};
1347 my $type = $row->{type};
1348 my $null = $row->{null};
1349 # $null = 'YES' if $row->{null} eq 'NULL';
1350 my $key = $row->{key};
1351 my $default = $row->{default};
1352 my $null = $row->{null};
1353 # $default="''" unless $default;
1354 my $extra = $row->{extra};
1355 my $def = $definitions->{$field};
1356 my $after = ($row->{after}?" after ".$row->{after}:"");
1358 unless ( $type eq $def->{type}
1359 && $null eq $def->{null}
1360 && $key eq $def->{key}
1361 && $extra eq $def->{extra} )
1363 if ( $null eq '' ) {
1366 if ( $key eq 'PRI' ) {
1367 $key = 'PRIMARY KEY';
1369 unless ( $extra eq 'auto_increment' ) {
1373 # if it's a new column use "add", if it's an old one, use "change".
1375 if ($definitions->{$field}->{type}) {
1376 $action="change $field"
1380 # if it's a primary key, drop the previous pk, before altering the table
1382 if ($key ne 'PRIMARY KEY') {
1383 $sth =$dbh->prepare("alter table $table $action $field $type $null $key $extra default ? $after");
1385 $sth =$dbh->prepare("alter table $table drop primary key, $action $field $type $null $key $extra default ? $after");
1387 $sth->execute($default);
1388 print " alter or create $field in $table\n" unless $silent;
1393 # Populate tables with required data
1396 # synch table and deletedtable.
1397 foreach my $table (('borrowers','items','biblio','biblioitems')) {
1398 my %deletedborrowers;
1399 print "synch'ing $table\n";
1400 $sth = $dbh->prepare("show columns from deleted$table");
1402 while ( my ( $column, $type, $null, $key, $default, $extra ) = $sth->fetchrow ) {
1403 $deletedborrowers{$column}=1;
1405 $sth = $dbh->prepare("show columns from $table");
1408 while ( my ( $column, $type, $null, $key, $default, $extra ) = $sth->fetchrow ) {
1409 unless ($deletedborrowers{$column}) {
1410 my $newcol="alter table deleted$table add $column $type";
1411 if ($null eq 'YES') {
1412 $newcol .= " NULL ";
1414 $newcol .= " NOT NULL ";
1416 $newcol .= "default $default" if $default;
1417 $newcol .= " after $previous" if $previous;
1419 print "creating column $column\n";
1425 foreach my $table ( keys %tabledata ) {
1426 print "Checking for data required in table $table...\n" unless $silent;
1427 my $tablerows = $tabledata{$table};
1428 foreach my $row (@$tablerows) {
1429 my $uniquefieldrequired = $row->{uniquefieldrequired};
1430 my $uniquevalue = $row->{$uniquefieldrequired};
1431 my $forceupdate = $row->{forceupdate};
1434 "select $uniquefieldrequired from $table where $uniquefieldrequired=?"
1436 $sth->execute($uniquevalue);
1438 foreach my $field (keys %$forceupdate) {
1439 if ($forceupdate->{$field}) {
1440 my $sth=$dbh->prepare("update systempreferences set $field=? where $uniquefieldrequired=?");
1441 $sth->execute($row->{$field}, $uniquevalue);
1445 print "Adding row to $table: " unless $silent;
1449 foreach my $field ( keys %$row ) {
1450 next if $field eq 'uniquefieldrequired';
1451 next if $field eq 'forceupdate';
1452 my $value = $row->{$field};
1453 push @values, $value;
1454 print " $field => $value" unless $silent;
1455 $fieldlist .= "$field,";
1456 $placeholders .= "?,";
1458 print "\n" unless $silent;
1459 $fieldlist =~ s/,$//;
1460 $placeholders =~ s/,$//;
1463 "insert into $table ($fieldlist) values ($placeholders)");
1464 $sth->execute(@values);
1470 # check indexes and create them when needed
1472 print "Checking for index required...\n" unless $silent;
1473 foreach my $table ( keys %indexes ) {
1475 # read all indexes from $table
1477 $sth = $dbh->prepare("show index from $table");
1479 my %existingindexes;
1480 while ( my ( $table, $non_unique, $key_name, $Seq_in_index, $Column_name, $Collation, $cardinality, $sub_part, $Packed, $comment ) = $sth->fetchrow ) {
1481 $existingindexes{$key_name} = 1;
1483 # read indexes to check
1484 my $tablerows = $indexes{$table};
1485 foreach my $row (@$tablerows) {
1486 my $key_name=$row->{indexname};
1487 if ($existingindexes{$key_name} eq 1) {
1488 # print "$key_name existing";
1490 print "\tCreating index $key_name in $table\n";
1492 if ($row->{indexname} eq 'PRIMARY') {
1493 $sql = "alter table $table ADD PRIMARY KEY ($row->{content})";
1495 $sql = "alter table $table ADD INDEX $key_name ($row->{content}) $row->{type}";
1498 print "Error $sql : $dbh->err \n" if $dbh->err;
1504 # check foreign keys and create them when needed
1506 print "Checking for foreign keys required...\n" unless $silent;
1507 foreach my $table ( keys %foreign_keys ) {
1509 # read all indexes from $table
1511 $sth = $dbh->prepare("show table status like '$table'");
1513 my $stat = $sth->fetchrow_hashref;
1514 # read indexes to check
1515 my $tablerows = $foreign_keys{$table};
1516 foreach my $row (@$tablerows) {
1517 my $foreign_table=$row->{foreigntable};
1518 if ($stat->{'Comment'} =~/$foreign_table/) {
1519 # print "$foreign_table existing\n";
1521 print "\tCreating foreign key $foreign_table in $table\n";
1522 # first, drop any orphan value in child table
1523 if ($row->{onDelete} ne "RESTRICT") {
1524 my $sql = "delete from $table where $row->{key} not in (select $row->{foreignkey} from $row->{foreigntable})";
1526 print "SQL ERROR: $sql : $dbh->err \n" if $dbh->err;
1528 my $sql="alter table $table ADD FOREIGN KEY $row->{key} ($row->{key}) REFERENCES $row->{foreigntable} ($row->{foreignkey})";
1529 $sql .= " on update ".$row->{onUpdate} if $row->{onUpdate};
1530 $sql .= " on delete ".$row->{onDelete} if $row->{onDelete};
1533 print "====================
1534 An error occured during :
1536 It probably means there is something wrong in your DB : a row ($table.$row->{key}) refers to a value in $row->{foreigntable}.$row->{foreignkey} that does not exist. solve the problem and run updater again (or just the previous SQL statement).
1537 You can find those values with select
1538 \t$table.* from $table where $row->{key} not in (select $row->{foreignkey} from $row->{foreigntable})
1539 ====================\n
1550 # create frameworkcode row in biblio table & fill it with marc_biblio.frameworkcode.
1553 # 1st, get how many biblio we will have to do...
1554 $sth = $dbh->prepare('select count(*) from marc_biblio');
1556 my ($totaltodo) = $sth->fetchrow;
1558 $sth = $dbh->prepare("show columns from biblio");
1561 my $bibliofwexist=0;
1562 while ( ( $column, $type, $null, $key, $default, $extra ) = $sth->fetchrow ){
1563 $bibliofwexist=1 if $column eq 'frameworkcode';
1565 unless ($bibliofwexist) {
1566 print "moving biblioframework to biblio table\n";
1567 $dbh->do('ALTER TABLE `biblio` ADD `frameworkcode` VARCHAR( 4 ) NOT NULL AFTER `biblionumber`');
1568 $sth = $dbh->prepare('select biblionumber,frameworkcode from marc_biblio');
1570 my $sth_update = $dbh->prepare('update biblio set frameworkcode=? where biblionumber=?');
1572 while (my ($biblionumber,$frameworkcode) = $sth->fetchrow) {
1573 $sth_update->execute($frameworkcode,$biblionumber);
1575 print "\r$totaldone / $totaltodo" unless ($totaldone % 100);
1581 # moving MARC data from marc_subfield_table to biblioitems.marc
1583 $sth = $dbh->prepare("show columns from biblioitems");
1587 while ( ( $column, $type, $null, $key, $default, $extra ) = $sth->fetchrow ){
1588 $marcdone=1 if ($type eq 'blob' && $column eq 'marc') ;
1590 unless ($marcdone) {
1591 print "moving MARC record to biblioitems table\n";
1592 # changing marc field type
1593 $dbh->do('ALTER TABLE `biblioitems` CHANGE `marc` `marc` BLOB NULL DEFAULT NULL ');
1594 # adding marc xml, just for convenience
1595 $dbh->do('ALTER TABLE `biblioitems` ADD `marcxml` TEXT CHARACTER SET utf8 COLLATE utf8_general_ci NOT NULL ');
1596 # moving data from marc_subfield_value to biblio
1597 $sth = $dbh->prepare('select bibid,biblionumber from marc_biblio');
1599 my $sth_update = $dbh->prepare('update biblioitems set marc=?, marcxml=? where biblionumber=?');
1601 while (my ($bibid,$biblionumber) = $sth->fetchrow) {
1602 my $record = MARCgetbiblio($dbh,$bibid);
1603 #Force UTF-8 in record leader
1604 $record->encoding('UTF-8');
1605 print $record->as_formatted if ($biblionumber==3902);
1606 $sth_update->execute($record->as_usmarc(),$record->as_xml_record(),$biblionumber);
1608 print "\r$totaldone / $totaltodo" unless ($totaldone % 100);
1614 # at last, remove useless fields
1615 foreach $table ( keys %uselessfields ) {
1616 my @fields = split /,/,$uselessfields{$table};
1619 foreach my $fieldtodrop (@fields) {
1620 $fieldtodrop =~ s/\t//g;
1621 $fieldtodrop =~ s/\n//g;
1623 $sth = $dbh->prepare("show columns from $table");
1625 while ( my ( $column, $type, $null, $key, $default, $extra ) = $sth->fetchrow )
1627 $exists =1 if ($column eq $fieldtodrop);
1630 print "deleting $fieldtodrop field in $table...\n" unless $silent;
1631 my $sth = $dbh->prepare("alter table $table drop $fieldtodrop");
1638 # MOVE all tables TO UTF-8 and innoDB
1639 $sth = $dbh->prepare("show table status");
1641 while ( my $table = $sth->fetchrow_hashref ) {
1642 # if ($table->{Engine} ne 'InnoDB') {
1643 # $dbh->do("ALTER TABLE $table->{Name} TYPE = innodb");
1644 # print "moving $table->{Name} to InnoDB\n";
1646 unless ($table->{Collation} =~ /^utf8/) {
1647 $dbh->do("ALTER TABLE $table->{Name} CONVERT TO CHARACTER SET utf8");
1648 $dbh->do("ALTER TABLE $table->{Name} DEFAULT CHARACTER SET utf8 COLLATE utf8_general_ci");
1649 # FIXME : maybe a ALTER TABLE tbl_name CONVERT TO CHARACTER SET utf8 would be better, def char set seems to work fine. If any problem encountered, let's try with convert !
1650 print "moving $table->{Name} to utf8\n";
1658 # those 2 subs are a copy of Biblio.pm, version 2.2.4
1659 # they are useful only once, for moving from 2.2 to 3.0
1660 # the MARCgetbiblio & MARCgetitem subs in Biblio.pm
1661 # are still here, but uses other tables
1662 # (the ones that are filled by updatedatabase !)
1667 # Returns MARC::Record of the biblio passed in parameter.
1668 my ( $dbh, $bibid ) = @_;
1669 my $record = MARC::Record->new();
1674 "select bibid,subfieldid,tag,tagorder,tag_indicator,subfieldcode,subfieldorder,subfieldvalue,valuebloblink
1675 from marc_subfield_table
1676 where bibid=? order by tag,tagorder,subfieldorder
1681 "select subfieldvalue from marc_blob_subfield where blobidlink=?");
1682 $sth->execute($bibid);
1683 my $prevtagorder = 1;
1684 my $prevtag = 'XXX';
1686 my $field; # for >=10 tags
1687 my $prevvalue; # for <10 tags
1688 while ( my $row = $sth->fetchrow_hashref ) {
1690 if ( $row->{'valuebloblink'} ) { #---- search blob if there is one
1691 $sth2->execute( $row->{'valuebloblink'} );
1692 my $row2 = $sth2->fetchrow_hashref;
1694 $row->{'subfieldvalue'} = $row2->{'subfieldvalue'};
1696 if ( $row->{tagorder} ne $prevtagorder || $row->{tag} ne $prevtag ) {
1697 $previndicator .= " ";
1698 if ( $prevtag < 10 ) {
1699 if ($prevtag ne '000') {
1700 $record->add_fields( ( sprintf "%03s", $prevtag ), $prevvalue ) unless $prevtag eq "XXX"; # ignore the 1st loop
1702 $record->leader(sprintf("%24s",$prevvalue));
1706 $record->add_fields($field) unless $prevtag eq "XXX";
1709 $prevtagorder = $row->{tagorder};
1710 $prevtag = $row->{tag};
1711 $previndicator = $row->{tag_indicator};
1712 if ( $row->{tag} < 10 ) {
1713 $prevvalue = $row->{subfieldvalue};
1716 $field = MARC::Field->new(
1717 ( sprintf "%03s", $prevtag ),
1718 substr( $row->{tag_indicator} . ' ', 0, 1 ),
1719 substr( $row->{tag_indicator} . ' ', 1, 1 ),
1720 $row->{'subfieldcode'},
1721 $row->{'subfieldvalue'}
1726 if ( $row->{tag} < 10 ) {
1727 $record->add_fields( ( sprintf "%03s", $row->{tag} ),
1728 $row->{'subfieldvalue'} );
1731 $field->add_subfields( $row->{'subfieldcode'},
1732 $row->{'subfieldvalue'} );
1734 $prevtag = $row->{tag};
1735 $previndicator = $row->{tag_indicator};
1739 # the last has not been included inside the loop... do it now !
1740 if ( $prevtag ne "XXX" )
1741 { # check that we have found something. Otherwise, prevtag is still XXX and we
1742 # must return an empty record, not make MARC::Record fail because we try to
1743 # create a record with XXX as field :-(
1744 if ( $prevtag < 10 ) {
1745 $record->add_fields( $prevtag, $prevvalue );
1749 # my $field = MARC::Field->new( $prevtag, "", "", %subfieldlist);
1750 $record->add_fields($field);
1758 # Returns MARC::Record of the biblio passed in parameter.
1759 my ( $dbh, $bibid, $itemnumber ) = @_;
1760 my $record = MARC::Record->new();
1762 # search MARC tagorder
1765 "select tagorder from marc_subfield_table,marc_subfield_structure where marc_subfield_table.tag=marc_subfield_structure.tagfield and marc_subfield_table.subfieldcode=marc_subfield_structure.tagsubfield and bibid=? and kohafield='items.itemnumber' and subfieldvalue=?"
1767 $sth2->execute( $bibid, $itemnumber );
1768 my ($tagorder) = $sth2->fetchrow_array();
1770 #---- TODO : the leader is missing
1773 "select bibid,subfieldid,tag,tagorder,tag_indicator,subfieldcode,subfieldorder,subfieldvalue,valuebloblink
1774 from marc_subfield_table
1775 where bibid=? and tagorder=? order by subfieldcode,subfieldorder
1780 "select subfieldvalue from marc_blob_subfield where blobidlink=?");
1781 $sth->execute( $bibid, $tagorder );
1782 while ( my $row = $sth->fetchrow_hashref ) {
1783 if ( $row->{'valuebloblink'} ) { #---- search blob if there is one
1784 $sth2->execute( $row->{'valuebloblink'} );
1785 my $row2 = $sth2->fetchrow_hashref;
1787 $row->{'subfieldvalue'} = $row2->{'subfieldvalue'};
1789 if ( $record->field( $row->{'tag'} ) ) {
1792 #--- this test must stay as this, because of strange behaviour of mySQL/Perl DBI with char var containing a number...
1793 #--- sometimes, eliminates 0 at beginning, sometimes no ;-\\\
1794 if ( length( $row->{'tag'} ) < 3 ) {
1795 $row->{'tag'} = "0" . $row->{'tag'};
1797 $field = $record->field( $row->{'tag'} );
1800 $field->add_subfields( $row->{'subfieldcode'},
1801 $row->{'subfieldvalue'} );
1802 $record->delete_field($field);
1803 $record->add_fields($field);
1807 if ( length( $row->{'tag'} ) < 3 ) {
1808 $row->{'tag'} = "0" . $row->{'tag'};
1811 MARC::Field->new( $row->{'tag'}, " ", " ",
1812 $row->{'subfieldcode'} => $row->{'subfieldvalue'} );
1813 $record->add_fields($temp);
1824 # Revision 1.152 2006/06/27 09:26:37 btoumi
1825 # modify (initials,phone ) fields property in borrowers and deletedborrowers table
1827 # Revision 1.151 2006/06/22 10:33:14 btoumi
1828 # sorry i forget deletedborrowers table
1829 # modify firstname field from deletedborrowers table
1831 # Revision 1.149 2006/06/20 22:35:47 rangi
1832 # Code to allow the associated borrowers to work
1834 # Revision 1.148 2006/06/17 22:12:01 rangi
1835 # Adding id field to reviews table
1837 # Revision 1.147 2006/06/17 03:36:41 rangi
1838 # Table definition for the reviews table
1840 # Revision 1.146 2006/06/17 03:29:41 rangi
1841 # Variable to allow librarians to switch reviews on or off
1843 # Revision 1.145 2006/06/16 09:45:02 btoumi
1844 # updatedatabase.pl: add change of borrowers table to deletedborrowers table
1845 # deletemem.pl: delete use of warn function
1847 # Revision 1.144 2006/06/08 15:36:31 alaurin
1848 # Add a new system preference 'AutomaticItemReturn' :
1850 # if this prefence is switched on: the document returned in another library than homebranch, the system automaticly transfer the document to his homebranch (with notification for librarian in returns.tmpl) .
1852 # switch off : the document stay in the holdingbranch ...
1855 # - comment C4::acquisition (not using in request.pl).
1856 # - correcting date in request.pl
1857 # -add the new call of function getbranches in request.pl
1859 # Revision 1.143 2006/06/07 02:02:47 bob_lyon
1860 # merging katipo changes...
1862 # adding new preference IssuingInProcess
1864 # Revision 1.142 2006/06/06 23:42:46 bob_lyon
1865 # Merging Katipo changes...
1867 # Adding new system pref where one can still retrieve a correct reading
1868 # record history if one has moved older data from issues to oldissues table
1869 # to speed up issues speed
1871 # Revision 1.141 2006/06/01 03:18:11 rangi
1872 # Adding a new column to the statistics table
1874 # Revision 1.140 2006/05/22 22:40:45 rangi
1875 # Adding new systempreference allowing for the library to add borrowers to institutions (rest homes, parishes, schools, classes etc).
1877 # Revision 1.139 2006/05/19 19:31:29 tgarip1957
1878 # Added new fields to auth_header and auth_subfield_table to allow ZEBRA use of authorities and new MARC framework like structure.
1879 # Authority tables are modified to be compatible with new MARC frameworks. This change is part of Authority Linking & Zebra authorities. Requires change in Mysql database. It will break head unless all changes regarding this is implemented. This warning will take place on all commits regarding this
1881 # Revision 1.138 2006/05/19 16:51:44 alaurin
1882 # update database for :
1883 # - new feature ip and printer management
1884 # adding two fields in branches table (branchip,branchprinter)
1886 # - waiting date : adding one field in reserves table(waiting date) to calculate the Maximum delay to pick up a reserved document when it's available
1888 # new system preference :
1889 # - ReservesMaxPickUpDelay : Maximum delay to pick up a reserved document
1890 # TransfersMaxDaysWarning : Max delay before considering the transfer as potentialy a problem
1892 # Revision 1.137 2006/04/18 09:36:36 plg
1893 # bug fixed: typo fixed in labels and labels_conf tables creation query.
1895 # Revision 1.136 2006/04/17 21:55:33 sushi
1896 # Added 'labels' and 'labels_conf' tables, for spine lable tool.
1898 # Revision 1.135 2006/04/15 02:37:03 tgarip1957
1899 # Marc record should be set to UTF-8 in leader.Force it.
1900 # XML should be with<record> wrappers
1902 # Revision 1.134 2006/04/14 09:37:29 tipaul
1903 # improvements from SAN Ouest Provence :
1904 # * introducing a category_type into categories. It can be A (adult), C (children), P (Professionnal), I (institution/organisation).
1905 # * each category_type has it's own forms to create members.
1906 # * the borrowers table has been heavily modified (many fields changed), to get something more logic & readable
1907 # * reintroducing guarantor/guanrantee system that is now independant from hardcoded C/A for categories
1908 # * updating templates to fit template rules
1910 # (see mail feb, 17 on koha-devel "new features for borrowers" for more details)
1912 # Revision 1.133 2006/04/13 08:36:42 plg
1913 # new: function C4::Date::get_date_format_string_for_DHTMLcalendar based on
1914 # the system preference prefered date format.
1916 # improvement: book fund list and budget list screen redesigned. Filters on
1917 # each field. Columns are not sortable yet. Using DHTML Calendar to fill date
1918 # fields instead of manual filling. Pagination system. From the book fund
1919 # list, you can reach the budget list, filtered on a book fund, or not. A
1920 # budget can be added only from book fund list screen.
1922 # bug fixed: branchcode was missing in table aqbudget.
1924 # bug fixed: when setting a branchcode to a book fund, all associated budgets
1925 # move to this branchcode.
1927 # modification: when adding/modifying budget/fund, MySQL specific "REPLACE..."
1928 # statements replaced by standard SQL compliant statement.
1930 # bug fixed: when adding/modifying a budget, if the book fund is associated to
1931 # a branch, the branch selection is disabled and set to the book fund branch.
1933 # Revision 1.132 2006/04/06 12:37:05 hdl
1934 # Bugfixing : aqbookfund needed a field.
1936 # Revision 1.131 2006/03/03 17:02:22 tipaul
1937 # commit for holidays and news management.
1938 # (some forgotten files)
1940 # Revision 1.130 2006/03/03 16:35:21 tipaul
1941 # commit for holidays and news management.
1943 # Contrib from Tümer Garip (from Turkey) :
1945 # in /tools/ the holiday.pl script let you define holidays (days where the library is closed), branch by branch. You can define 3 types of holidays :
1946 # - single day : only this day is closed
1947 # - repet weekly (like "sunday") : the day is holiday every week
1948 # - repet yearly (like "July, 4") : this day is closed every year.
1950 # You can also put exception :
1951 # - sunday is holiday, but "2006 March, 5th" the library will be open
1953 # The holidays are used for return date calculation : the return date is set to the next date where the library is open. A systempreference (useDaysMode) set ON (Calendar) or OFF (Normal) the calendar calculation.
1955 # Revision 1.129 2006/02/27 18:19:33 hdl
1956 # New table used in overduerules.pl tools page.
1958 # Revision 1.128 2006/01/25 15:16:06 tipaul
1960 # * removing useless tables
1961 # * adding useful indexes
1962 # * altering some columns definitions
1963 # * The goal being to have updater working fine for foreign keys.
1965 # For me it's done, let me know if it works for you. You can see an updated schema of the DB (with constraints) on the wiki
1967 # Revision 1.127 2006/01/24 17:57:17 tipaul
1968 # DB improvements : adding foreign keys on some tables. partial stuff done.
1970 # Revision 1.126 2006/01/06 16:39:42 tipaul
1971 # synch'ing head and rel_2_2 (from 2.2.5, including npl templates)
1972 # Seems not to break too many things, but i'm probably wrong here.
1973 # at least, new features/bugfixes from 2.2.5 are here (tested on some features on my head local copy)
1975 # - removing useless directories (koha-html and koha-plucene)
1977 # Revision 1.125 2006/01/04 15:54:55 tipaul
1978 # utf8 is a : go for beta test in HEAD.
1979 # some explanations :
1980 # - updater/updatedatabase => will transform all tables in innoDB (not related to utf8, just to warn you) AND collate them in utf8 / utf8_general_ci. The SQL command is : ALTER TABLE tablename DEFAULT CHARACTER SET utf8 COLLATE utf8_general_ci.
1981 # - *-top.inc will show the pages in utf8
1982 # - THE HARD THING : for me, mysql-client and mysql-server were set up to communicate in iso8859-1, whatever the mysql collation ! Thus, pages were improperly shown, as datas were transmitted in iso8859-1 format ! After a full day of investigation, someone on usenet pointed "set NAMES 'utf8'" to explain that I wanted utf8. I could put this in my.cnf, but if I do that, ALL databases will "speak" in utf8, that's not what we want. Thus, I added a line in Context.pm : everytime a DB handle is opened, the communication is set to utf8.
1983 # - using marcxml field and no more the iso2709 raw marc biblioitems.marc field.
1985 # Revision 1.124 2005/10/27 12:09:05 tipaul
1986 # new features for serial module :
1987 # - the last 5 issues are now shown, and their status can be changed (but not reverted to "waited", as there can be only one "waited")
1988 # - the library can create a "distribution list". this paper contains a list of borrowers (selected from the borrower list, or manually entered), and print it for a given issue. once printed, the sheet can be put on the issue and distributed to every reader on the list (one by one).
1990 # Revision 1.123 2005/10/26 09:13:37 tipaul
1991 # big commit, still breaking things...
1993 # * synch with rel_2_2. Probably the last non manual synch, as rel_2_2 should not be modified deeply.
1994 # * code cleaning (cleaning warnings from perl -w) continued
1996 # Revision 1.122 2005/09/02 14:18:38 tipaul
1997 # new feature : image for itemtypes.
1999 # * run updater/updatedatabase to create imageurl field in itemtypes.
2000 # * go to Koha >> parameters >> itemtypes >> modify (or add) an itemtype. You will see around 20 nice images to choose between (thanks to owen). If you prefer your own image, you also can type a complete url (http://www.myserver.lib/path/to/my/image.gif)
2001 # * go to OPAC, and search something. In the result list, you now have the picture instead of the text itemtype.
2003 # Revision 1.121 2005/08/24 08:49:03 hdl
2004 # Adding a note field in serial table.
2005 # This will allow librarian to mention a note on a peculiar waiting serial number.
2007 # Revision 1.120 2005/08/09 14:10:32 tipaul
2008 # 1st commit to go to zebra.
2009 # don't update your cvs if you want to have a working head...
2011 # this commit contains :
2012 # * updater/updatedatabase : get rid with marc_* tables, but DON'T remove them. As a lot of things uses them, it would not be a good idea for instance to drop them. If you really want to play, you can rename them to test head without them but being still able to reintroduce them...
2013 # * Biblio.pm : modify MARCgetbiblio to find the raw marc record in biblioitems.marc field, not from marc_subfield_table, modify MARCfindframeworkcode to find frameworkcode in biblio.frameworkcode, modify some other subs to use biblio.biblionumber & get rid of bibid.
2014 # * other files : get rid of bibid and use biblionumber instead.
2017 # * does not do anything on zebra yet.
2018 # * if you rename marc_subfield_table, you can't search anymore.
2019 # * you can view a biblio & bibliodetails, go to MARC editor, but NOT save any modif.
2020 # * don't try to add a biblio, it would add data poorly... (don't try to delete either, it may work, but that would be a surprise ;-) )
2022 # IMPORTANT NOTE : you need MARC::XML package (http://search.cpan.org/~esummers/MARC-XML-0.7/lib/MARC/File/XML.pm), that requires a recent version of MARC::Record
2023 # Updatedatabase stores the iso2709 data in biblioitems.marc field & an xml version in biblioitems.marcxml Not sure we will keep it when releasing the stable version, but I think it's a good idea to have something readable in sql, at least for development stage.
2025 # Revision 1.119 2005/08/04 16:07:58 tipaul
2026 # Synch really broke this script...
2028 # Revision 1.118 2005/08/04 16:02:55 tipaul
2029 # oops... error in synch between 2.2 and head
2031 # Revision 1.117 2005/08/04 14:24:39 tipaul
2032 # synch'ing 2.2 and head
2034 # Revision 1.116 2005/08/04 08:55:54 tipaul
2035 # Letters / alert system, continuing...
2037 # * adding a package Letters.pm, that manages Letters & alerts.
2038 # * adding feature : it's now possible to define a "letter" for any subscription created. If a letter is defined, users in OPAC can put an alert on the subscription. When an issue is marked "arrived", all users in the alert will recieve a mail (as defined in the "letter"). This last part (= send the mail) is not yet developped. (Should be done this week)
2039 # * adding feature : it's now possible to "put to an alert" in OPAC, for any serial subscription. The alert is stored in a new table, called alert. An alert can be put only if the librarian has activated them in subscription (and they activate it just by choosing a "letter" to sent to borrowers on new issues)
2040 # * adding feature : librarian can see in borrower detail which alerts they have put, and a user can see in opac-detail which alert they have put too.
2042 # Note that the system should be generic enough to manage any type of alert.
2043 # I plan to extend it soon to virtual shelves : a borrower will be able to put an alert on a virtual shelf, to be warned when something is changed in the virtual shelf (mail being sent once a day by cron, or manually by the shelf owner. Anyway, a mail won't be sent on every change, users would be spammed by Koha ;-) )
2045 # Revision 1.115 2005/08/02 16:15:34 tipaul
2046 # adding 2 fields to letter system :
2047 # * module (acquisition, catalogue...) : it will be usefull to show the librarian only letters he may be interested by.
2048 # * title, that will be used as mail subject.
2050 # Revision 1.114 2005/07/28 15:10:13 tipaul
2051 # Introducing new "Letters" system : Letters will be used everytime you want to sent something to someone (through mail or paper). For example, sending a mail for overdues use letter that you can put as parameters. Sending a mail to a borrower when a suggestion is validated uses a letter too.
2052 # the letter table contains 3 fields :
2053 # * code => the code of the letter
2054 # * name => the complete name of the letter
2055 # * content => the complete text. It's a TEXT field type, so has no limits.
2057 # My next goal now is to work on point 2-I "serial issue alert"
2058 # With this feature, in serials, a user can subscribe the "issue alert". For every issue arrived/missing, a mail is sent to all subscribers of this list. The mail warns the user that the issue is arrive or missing. Will be in head.
2059 # (see mail on koha-devel, 2005/04/07)
2061 # The "serial issue alert" will be the 1st to use this letter system that probably needs some tweaking ;-)
2063 # Once it will be stabilised default letters (in any languages) could be added during installer to help the library begin with this new feature.
2065 # Revision 1.113 2005/07/28 08:38:41 tipaul
2066 # For instance, the return date does not rely on the borrower expiration date. A systempref will be added in Koha, to modify return date calculation schema :
2067 # * ReturnBeforeExpiry = yes => return date can't be after expiry date
2068 # * ReturnBeforeExpiry = no => return date can be after expiry date
2070 # Revision 1.112 2005/07/26 08:19:47 hdl
2071 # Adding IndependantBranches System preference variable in order to manage Branch independancy.
2073 # Revision 1.111 2005/07/25 15:35:38 tipaul
2074 # we have decided that moving to Koha 3.0 requires being already in Koha 2.2.x
2075 # So, the updatedatabase script can highly be cleaned (90% removed).
2076 # Let's play with the new Koha DB structure now ;-)