misc/migration_tools/bulkmarcimport.pl

   1 #!/usr/bin/perl
   2 # small script that import an iso2709 file into koha 2.0
   3
   4 use strict;
   5 # use warnings;
   6
   7 # Koha modules used
   8 use MARC::File::USMARC;
   9 # Uncomment the line below and use MARC::File::XML again when it works better.
  10 # -- thd
  11 # use MARC::File::XML;
  12 use MARC::Record;
  13 use MARC::Batch;
  14 use MARC::Charset;
  15
  16 # According to kados, an undocumented feature of setting MARC::Charset to
  17 # ignore_errors(1) is that errors are not ignored.  Instead of deleting the
  18 # whole subfield when a character does not translate properly from MARC8 into
  19 # UTF-8, just the problem characters are deleted.  This should solve at least
  20 # some of the fixme problems for fMARC8ToUTF8().
  21 #
  22 # Problems remain if there are MARC 21 records where 000/09 is set incorrectly.
  23 # -- thd.
  24 # MARC::Charset->ignore_errors(1);
  25
  26 use C4::Context;
  27 use C4::Biblio;
  28 use Time::HiRes qw(gettimeofday);
  29 use Getopt::Long;
  30 binmode(STDOUT, ":utf8");
  31
  32 use Getopt::Long;
  33
  34 my ( $input_marc_file, $number) = ('',0);
  35 my ($version, $delete, $test_parameter,$char_encoding, $verbose, $commit,$fk_off);
  36
  37 $|=1;
  38
  39 GetOptions(
  40     'commit:f'    => \$commit,
  41     'file:s'    => \$input_marc_file,
  42     'n:f' => \$number,
  43     'h' => \$version,
  44     'd' => \$delete,
  45     't' => \$test_parameter,
  46     'c:s' => \$char_encoding,
  47     'v:s' => \$verbose,
  48     'fk' => \$fk_off,
  49 );
  50
  51 # FIXME:  Management of error conditions needed for record parsing problems
  52 # and MARC8 character sets with mappings to Unicode not yet included in
  53 # MARC::Charset.  The real world rarity of these problems is not fully tested.
  54 # Unmapped character sets will throw a warning currently and processing will
  55 # continue with the error condition.  A fairly trivial correction should
  56 # address some record parsing and unmapped character set problems but I need
  57 # time to implement a test and correction for undef subfields and revert to
  58 # MARC8 if mappings are missing. -- thd
  59 sub fMARC8ToUTF8($$) {
  60     my ($record) = shift;
  61     my ($verbose) = shift;
  62     if ($verbose) {
  63         if ($verbose >= 2) {
  64             my $leader = $record->leader();
  65             $leader =~ s/ /#/g;
  66             print "\n000 " . $leader;
  67         }
  68     }
  69     foreach my $field ($record->fields()) {
  70         if ($field->is_control_field()) {
  71             if ($verbose) {
  72                 if ($verbose >= 2) {
  73                     my $fieldName = $field->tag();
  74                     my $fieldValue = $field->data();
  75                     $fieldValue =~ s/ /#/g;
  76                     print "\n" . $fieldName;
  77                     print ' ' . $fieldValue;
  78                 }
  79             }
  80         } else {
  81             my @subfieldsArray;
  82             my $fieldName = $field->tag();
  83             my $indicator1Value = $field->indicator(1);
  84             my $indicator2Value = $field->indicator(2);
  85             if ($verbose) {
  86                 if ($verbose >= 2) {
  87                     $indicator1Value =~ s/ /#/;
  88                     $indicator2Value =~ s/ /#/;
  89                     print "\n" . $fieldName . ' ' .
  90                             $indicator1Value .
  91                     $indicator2Value;
  92                 }
  93             }
  94             foreach my $subfield ($field->subfields()) {
  95                 my $subfieldName = $subfield->[0];
  96                 my $subfieldValue = $subfield->[1];
  97                 $subfieldValue = MARC::Charset::marc8_to_utf8($subfieldValue);
  98
  99                 # Alas, MARC::Field::update() does not work correctly.
 100                 ## push (@subfieldsArray, $subfieldName, $subfieldValue);
 101
 102                 push @subfieldsArray, [$subfieldName, $subfieldValue];
 103                 if ($verbose) {
 104                     if ($verbose >= 2) {
 105                         print " \$" . $subfieldName . ' ' . $subfieldValue;
 106                     }
 107                 }
 108             }
 109
 110             # Alas, MARC::Field::update() does not work correctly.
 111             #
 112             # The first instance in the field of a of a repeated subfield
 113             # overwrites the content from later instances with the content
 114             # from the first instance.
 115             ## $field->update(@subfieldsArray);
 116
 117             foreach my $subfieldRow(@subfieldsArray) {
 118                 my $subfieldName = $subfieldRow->[0];
 119                 $field->delete_subfields($subfieldName);
 120             }
 121             foreach my $subfieldRow(@subfieldsArray) {
 122                 $field->add_subfields(@$subfieldRow);
 123             }
 124
 125             if ($verbose) {
 126                 if ($verbose >= 2) {
 127                     # Reading the indicator values again is not necessary.
 128                     # They were not converted.
 129                     # $indicator1Value = $field->indicator(1);
 130                     # $indicator2Value = $field->indicator(2);
 131                     # $indicator1Value =~ s/ /#/;
 132                     # $indicator2Value =~ s/ /#/;
 133                     print "\nCONVERTED TO UTF-8:\n" . $fieldName . ' ' .
 134                             $indicator1Value .
 135                     $indicator2Value;
 136                     foreach my $subfield ($field->subfields()) {
 137                         my $subfieldName = $subfield->[0];
 138                         my $subfieldValue = $subfield->[1];
 139                         print " \$" . $subfieldName . ' ' . $subfieldValue;
 140                     }
 141                 }
 142             }
 143             if ($verbose) {
 144                 if ($verbose >= 2) {
 145                     print "\n" if $verbose;
 146                 }
 147             }
 148         }
 149     }
 150     $record->encoding('UTF-8');
 151     return $record;
 152 }
 153
 154
 155 if ($version || ($input_marc_file eq '')) {
 156     print <<EOF
 157 small script to import an iso2709 file into Koha.
 158 parameters :
 159 \th : this version/help screen
 160 \tfile /path/to/file/to/dump : the file to dump
 161 \tv : verbose mode. 1 means "some infos", 2 means "MARC dumping"
 162 \tfk : Turn off foreign key checks during import.
 163 \tn : the number of records to import. If missing, all the file is imported
 164 \tcommit : the number of records to wait before performing a 'commit' operation
 165 \tt : test mode : parses the file, saying what he would do, but doing nothing.
 166 \tc : the characteristic MARC flavour. At the moment, only MARC21 and UNIMARC
 167 \tsupported. MARC21 by default.
 168 \td : delete EVERYTHING related to biblio in koha-DB before import  :tables :
 169 \t\tbiblio, \t\tbiblioitems, \t\tsubjects,\titems
 170 \tmarc_biblio,
 171 \t\tmarc_subfield_table, \tmarc_word, \t\tmarc_blob_subfield
 172 IMPORTANT : don't use this script before you've entered and checked your MARC parameters tables twice (or more!).
 173 Otherwise, the import won't work correctly and you will get invalid data.
 174
 175 SAMPLE :
 176 \t\$ export KOHA_CONF=/etc/koha.conf
 177 \t\$ perl misc/migration_tools/bulkmarcimport.pl -d -commit 1000 -file /home/jmf/koha.mrc -n 3000
 178 EOF
 179 ;#'
 180 die;
 181 }
 182
 183 my $dbh = C4::Context->dbh;
 184
 185 if ($delete) {
 186     print "deleting biblios\n";
 187     $dbh->do("truncate biblio");
 188     $dbh->do("truncate biblioitems");
 189     $dbh->do("truncate items");
 190 }
 191 if ($fk_off) {
 192         $dbh->do("SET FOREIGN_KEY_CHECKS = 0");
 193 }
 194 if ($test_parameter) {
 195     print "TESTING MODE ONLY\n    DOING NOTHING\n===============\n";
 196 }
 197
 198 my $marcFlavour = C4::Context->preference('marcflavour') || 'MARC21';
 199
 200 print "Characteristic MARC flavour: $marcFlavour\n" if $verbose;
 201 # die;
 202 my $starttime = gettimeofday;
 203 my $batch = MARC::Batch->new( 'USMARC', $input_marc_file );
 204 $batch->warnings_off();
 205 $batch->strict_off();
 206 my $i=0;
 207 my $commitnum = 50;
 208
 209 if ($commit) {
 210
 211 $commitnum = $commit;
 212
 213 }
 214
 215 #1st of all, find item MARC tag.
 216 my ($tagfield,$tagsubfield) = &GetMarcFromKohaField("items.itemnumber",'');
 217 # $dbh->do("lock tables biblio write, biblioitems write, items write, marc_biblio write, marc_subfield_table write, marc_blob_subfield write, marc_word write, marc_subfield_structure write, stopwords write");
 218 while ( my $record = $batch->next() ) {
 219 # warn "=>".$record->as_formatted;
 220 # warn "I:".$i;
 221 # warn "NUM:".$number;
 222     $i++;
 223     print ".";
 224     print "\r$i" unless $i % 100;
 225 #     if ($i==$number) {
 226 #         z3950_extended_services('commit',set_service_options('commit'));
 227 #         print "COMMIT OPERATION SUCCESSFUL\n";
 228 #
 229 #         my $timeneeded = gettimeofday - $starttime;
 230 #         die "$i MARC records imported in $timeneeded seconds\n";
 231 #     }
 232 #     # perform the commit operation ever so often
 233 #     if ($i==$commit) {
 234 #         z3950_extended_services('commit',set_service_options('commit'));
 235 #         $commit+=$commitnum;
 236 #         print "COMMIT OPERATION SUCCESSFUL\n";
 237 #     }
 238     #now, parse the record, extract the item fields, and store them in somewhere else.
 239
 240     ## create an empty record object to populate
 241     my $newRecord = MARC::Record->new();
 242     $newRecord->leader($record->leader());
 243
 244     # go through each field in the existing record
 245     foreach my $oldField ( $record->fields() ) {
 246
 247     # just reproduce tags < 010 in our new record
 248     #
 249     # Fields are not necessarily only numeric in the actual world of records
 250     # nor in what I would recommend for additonal safe non-interfering local
 251     # use fields.  The following regular expression match is much safer than
 252     # a numeric evaluation. -- thd
 253     if ( $oldField->tag() =~ m/^00/ ) {
 254         $newRecord->append_fields( $oldField );
 255         next();
 256     }
 257
 258     # store our new subfield data in this list
 259     my @newSubfields = ();
 260
 261     # go through each subfield code/data pair
 262     foreach my $pair ( $oldField->subfields() ) {
 263         #$pair->[1] =~ s/\<//g;
 264         #$pair->[1] =~ s/\>//g;
 265         push( @newSubfields, $pair->[0], $pair->[1] ); #char_decode($pair->[1],$char_encoding) );
 266     }
 267
 268     # add the new field to our new record
 269     my $newField = MARC::Field->new(
 270         $oldField->tag(),
 271         $oldField->indicator(1),
 272         $oldField->indicator(2),
 273         @newSubfields
 274     );
 275
 276     $newRecord->append_fields( $newField );
 277
 278     }
 279
 280     warn "$i ==>".$newRecord->as_formatted() if $verbose eq 2;
 281     my @fields = $newRecord->field($tagfield);
 282     my @items;
 283     my $nbitems=0;
 284
 285     foreach my $field (@fields) {
 286         my $item = MARC::Record->new();
 287         $item->append_fields($field);
 288         push @items,$item;
 289         $newRecord->delete_field($field);
 290         $nbitems++;
 291     }
 292     print "$i : $nbitems items found\n" if $verbose;
 293     # now, create biblio and items with Addbiblio call.
 294     unless ($test_parameter) {
 295     warn "NEWREC : ".$newRecord->as_formatted;
 296         my ($bibid,$oldbibitemnum) = AddBiblio($newRecord,'');
 297         warn "ADDED biblio NB $bibid in DB\n" if $verbose;
 298         for (my $i=0;$i<=$#items;$i++) {
 299 #             warn "here is the biblioitemnumber $oldbibitemnum";
 300             AddItem($items[$i],$bibid,$oldbibitemnum);
 301         }
 302     }
 303 }
 304 if ($fk_off) {
 305         $dbh->do("SET FOREIGN_KEY_CHECKS = 1");
 306 }
 307 # final commit of the changes
 308 #z3950_extended_services('commit',set_service_options('commit'));
 309 #print "COMMIT OPERATION SUCCESSFUL\n";
 310
 311 my $timeneeded = gettimeofday - $starttime;
 312 print "$i MARC records done in $timeneeded seconds\n";