1 package C4::ImportBatch;
3 # Copyright (C) 2007 LibLime, 2012 C & P Bibliography Services
5 # This file is part of Koha.
7 # Koha is free software; you can redistribute it and/or modify it
8 # under the terms of the GNU General Public License as published by
9 # the Free Software Foundation; either version 3 of the License, or
10 # (at your option) any later version.
12 # Koha is distributed in the hope that it will be useful, but
13 # WITHOUT ANY WARRANTY; without even the implied warranty of
14 # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
15 # GNU General Public License for more details.
17 # You should have received a copy of the GNU General Public License
18 # along with Koha; if not, see <http://www.gnu.org/licenses>.
24 use C4::Koha qw( GetNormalizedISBN );
33 use C4::Items qw( AddItemFromMarc ModItemFromMarc );
34 use C4::Charset qw( MarcToUTF8Record SetUTF8Flag StripNonXmlChars );
35 use C4::AuthoritiesMarc qw( AddAuthority GuessAuthTypeCode GetAuthorityXML ModAuthority DelAuthority );
36 use C4::MarcModificationTemplates qw( ModifyRecordWithTemplate );
38 use Koha::Plugins::Handler;
41 our (@ISA, @EXPORT_OK);
49 GetImportRecordMarcXML
50 GetRecordFromImportBiblio
55 AddItemsToImportBiblio
67 GetStagedWebserviceBatches
68 GetImportBatchRangeDesc
69 GetNumberOfNonZ3950ImportBatches
72 GetItemNumbersFromImportBatch
76 GetImportBatchOverlayAction
77 SetImportBatchOverlayAction
78 GetImportBatchNoMatchAction
79 SetImportBatchNoMatchAction
80 GetImportBatchItemAction
81 SetImportBatchItemAction
84 GetImportRecordOverlayStatus
85 SetImportRecordOverlayStatus
88 SetMatchedBiblionumber
89 GetImportRecordMatches
90 SetImportRecordMatches
92 RecordsFromMARCXMLFile
93 RecordsFromISO2709File
100 C4::ImportBatch - manage batches of imported MARC records
108 =head2 GetZ3950BatchId
110 my $batchid = GetZ3950BatchId($z3950server);
112 Retrieves the ID of the import batch for the Z39.50
113 reservoir for the given target. If necessary,
114 creates the import batch.
118 sub GetZ3950BatchId {
119 my ($z3950server) = @_;
121 my $dbh = C4::Context->dbh;
122 my $sth = $dbh->prepare("SELECT import_batch_id FROM import_batches
123 WHERE batch_type = 'z3950'
125 $sth->execute($z3950server);
126 my $rowref = $sth->fetchrow_arrayref();
128 if (defined $rowref) {
131 my $batch_id = AddImportBatch( {
132 overlay_action => 'create_new',
133 import_status => 'staged',
134 batch_type => 'z3950',
135 file_name => $z3950server,
142 =head2 GetWebserviceBatchId
144 my $batchid = GetWebserviceBatchId();
146 Retrieves the ID of the import batch for webservice.
147 If necessary, creates the import batch.
151 my $WEBSERVICE_BASE_QRY = <<EOQ;
152 SELECT import_batch_id FROM import_batches
153 WHERE batch_type = 'webservice'
154 AND import_status = 'staged'
156 sub GetWebserviceBatchId {
159 my $dbh = C4::Context->dbh;
160 my $sql = $WEBSERVICE_BASE_QRY;
162 foreach my $field (qw(matcher_id overlay_action nomatch_action item_action)) {
163 if (my $val = $params->{$field}) {
164 $sql .= " AND $field = ?";
168 my $id = $dbh->selectrow_array($sql, undef, @args);
171 $params->{batch_type} = 'webservice';
172 $params->{import_status} = 'staged';
173 return AddImportBatch($params);
176 =head2 GetImportRecordMarc
178 my ($marcblob, $encoding) = GetImportRecordMarc($import_record_id);
182 sub GetImportRecordMarc {
183 my ($import_record_id) = @_;
185 my $dbh = C4::Context->dbh;
186 my ( $marc, $encoding ) = $dbh->selectrow_array(q|
187 SELECT marc, encoding
189 WHERE import_record_id = ?
190 |, undef, $import_record_id );
192 return $marc, $encoding;
195 sub GetRecordFromImportBiblio {
196 my ( $import_record_id, $embed_items ) = @_;
198 my ($marc) = GetImportRecordMarc($import_record_id);
199 my $record = MARC::Record->new_from_usmarc($marc);
201 EmbedItemsInImportBiblio( $record, $import_record_id ) if $embed_items;
206 sub EmbedItemsInImportBiblio {
207 my ( $record, $import_record_id ) = @_;
208 my ( $itemtag, $itemsubfield ) = GetMarcFromKohaField( "items.itemnumber" );
209 my $dbh = C4::Context->dbh;
210 my $import_items = $dbh->selectall_arrayref(q|
211 SELECT import_items.marcxml
213 WHERE import_record_id = ?
214 |, { Slice => {} }, $import_record_id );
216 for my $import_item ( @$import_items ) {
217 my $item_marc = MARC::Record::new_from_xml($import_item->{marcxml}, 'UTF-8');
218 push @item_fields, $item_marc->field($itemtag);
220 $record->append_fields(@item_fields);
224 =head2 GetImportRecordMarcXML
226 my $marcxml = GetImportRecordMarcXML($import_record_id);
230 sub GetImportRecordMarcXML {
231 my ($import_record_id) = @_;
233 my $dbh = C4::Context->dbh;
234 my $sth = $dbh->prepare("SELECT marcxml FROM import_records WHERE import_record_id = ?");
235 $sth->execute($import_record_id);
236 my ($marcxml) = $sth->fetchrow();
242 =head2 AddImportBatch
244 my $batch_id = AddImportBatch($params_hash);
252 foreach (qw( matcher_id template_id branchcode
253 overlay_action nomatch_action item_action
254 import_status batch_type file_name comments record_type )) {
255 if (exists $params->{$_}) {
257 push @vals, $params->{$_};
260 my $dbh = C4::Context->dbh;
261 $dbh->do("INSERT INTO import_batches (".join( ',', @fields).")
262 VALUES (".join( ',', map '?', @fields).")",
265 return $dbh->{'mysql_insertid'};
268 =head2 GetImportBatch
270 my $row = GetImportBatch($batch_id);
272 Retrieve a hashref of an import_batches row.
279 my $dbh = C4::Context->dbh;
280 my $sth = $dbh->prepare_cached("SELECT b.*, p.name as profile FROM import_batches b LEFT JOIN import_batch_profiles p ON p.id = b.profile_id WHERE import_batch_id = ?");
281 $sth->bind_param(1, $batch_id);
283 my $result = $sth->fetchrow_hashref;
289 =head2 AddBiblioToBatch
291 my $import_record_id = AddBiblioToBatch($batch_id, $record_sequence,
292 $marc_record, $encoding, $update_counts);
296 sub AddBiblioToBatch {
297 my $batch_id = shift;
298 my $record_sequence = shift;
299 my $marc_record = shift;
300 my $encoding = shift;
301 my $update_counts = @_ ? shift : 1;
303 my $import_record_id = _create_import_record($batch_id, $record_sequence, $marc_record, 'biblio', $encoding, C4::Context->preference('marcflavour'));
304 _add_biblio_fields($import_record_id, $marc_record);
305 _update_batch_record_counts($batch_id) if $update_counts;
306 return $import_record_id;
309 =head2 ModBiblioInBatch
311 ModBiblioInBatch($import_record_id, $marc_record);
315 sub ModBiblioInBatch {
316 my ($import_record_id, $marc_record) = @_;
318 _update_import_record_marc($import_record_id, $marc_record, C4::Context->preference('marcflavour'));
319 _update_biblio_fields($import_record_id, $marc_record);
323 =head2 AddAuthToBatch
325 my $import_record_id = AddAuthToBatch($batch_id, $record_sequence,
326 $marc_record, $encoding, $update_counts, [$marc_type]);
331 my $batch_id = shift;
332 my $record_sequence = shift;
333 my $marc_record = shift;
334 my $encoding = shift;
335 my $update_counts = @_ ? shift : 1;
336 my $marc_type = shift || C4::Context->preference('marcflavour');
338 $marc_type = 'UNIMARCAUTH' if $marc_type eq 'UNIMARC';
340 my $import_record_id = _create_import_record($batch_id, $record_sequence, $marc_record, 'auth', $encoding, $marc_type);
341 _add_auth_fields($import_record_id, $marc_record);
342 _update_batch_record_counts($batch_id) if $update_counts;
343 return $import_record_id;
346 =head2 ModAuthInBatch
348 ModAuthInBatch($import_record_id, $marc_record);
353 my ($import_record_id, $marc_record) = @_;
355 my $marcflavour = C4::Context->preference('marcflavour');
356 _update_import_record_marc($import_record_id, $marc_record, $marcflavour eq 'UNIMARC' ? 'UNIMARCAUTH' : 'USMARC');
360 =head2 BatchStageMarcRecords
362 ( $batch_id, $num_records, $num_items, @invalid_records ) =
363 BatchStageMarcRecords(
364 $record_type, $encoding,
365 $marc_records, $file_name,
366 $marc_modification_template, $comments,
367 $branch_code, $parse_items,
368 $leave_as_staging, $progress_interval,
374 sub BatchStageMarcRecords {
375 my $record_type = shift;
376 my $encoding = shift;
377 my $marc_records = shift;
378 my $file_name = shift;
379 my $marc_modification_template = shift;
380 my $comments = shift;
381 my $branch_code = shift;
382 my $parse_items = shift;
383 my $leave_as_staging = shift;
385 # optional callback to monitor status
387 my $progress_interval = 0;
388 my $progress_callback = undef;
390 $progress_interval = shift;
391 $progress_callback = shift;
392 $progress_interval = 0 unless $progress_interval =~ /^\d+$/ and $progress_interval > 0;
393 $progress_interval = 0 unless 'CODE' eq ref $progress_callback;
396 my $batch_id = AddImportBatch( {
397 overlay_action => 'create_new',
398 import_status => 'staging',
399 batch_type => 'batch',
400 file_name => $file_name,
401 comments => $comments,
402 record_type => $record_type,
405 SetImportBatchItemAction($batch_id, 'always_add');
407 SetImportBatchItemAction($batch_id, 'ignore');
411 my $marc_type = C4::Context->preference('marcflavour');
412 $marc_type .= 'AUTH' if ($marc_type eq 'UNIMARC' && $record_type eq 'auth');
413 my @invalid_records = ();
416 # FIXME - for now, we're dealing only with bibs
418 foreach my $marc_record (@$marc_records) {
420 if ($progress_interval and (0 == ($rec_num % $progress_interval))) {
421 &$progress_callback($rec_num);
424 ModifyRecordWithTemplate( $marc_modification_template, $marc_record ) if ( $marc_modification_template );
426 my $import_record_id;
427 if (scalar($marc_record->fields()) == 0) {
428 push @invalid_records, $marc_record;
431 # Normalize the record so it doesn't have separated diacritics
432 SetUTF8Flag($marc_record);
435 if ($record_type eq 'biblio') {
436 $import_record_id = AddBiblioToBatch($batch_id, $rec_num, $marc_record, $encoding, int(rand(99999)), 0);
438 my @import_items_ids = AddItemsToImportBiblio($batch_id, $import_record_id, $marc_record, 0);
439 $num_items += scalar(@import_items_ids);
441 } elsif ($record_type eq 'auth') {
442 $import_record_id = AddAuthToBatch($batch_id, $rec_num, $marc_record, $encoding, int(rand(99999)), 0, $marc_type);
446 unless ($leave_as_staging) {
447 SetImportBatchStatus($batch_id, 'staged');
449 # FIXME branch_code, number of bibs, number of items
450 _update_batch_record_counts($batch_id);
451 return ($batch_id, $num_valid, $num_items, @invalid_records);
454 =head2 AddItemsToImportBiblio
456 my @import_items_ids = AddItemsToImportBiblio($batch_id,
457 $import_record_id, $marc_record, $update_counts);
461 sub AddItemsToImportBiblio {
462 my $batch_id = shift;
463 my $import_record_id = shift;
464 my $marc_record = shift;
465 my $update_counts = @_ ? shift : 0;
467 my @import_items_ids = ();
469 my $dbh = C4::Context->dbh;
470 my ($item_tag,$item_subfield) = &GetMarcFromKohaField( "items.itemnumber" );
471 foreach my $item_field ($marc_record->field($item_tag)) {
472 my $item_marc = MARC::Record->new();
473 $item_marc->leader("00000 a "); # must set Leader/09 to 'a'
474 $item_marc->append_fields($item_field);
475 $marc_record->delete_field($item_field);
476 my $sth = $dbh->prepare_cached("INSERT INTO import_items (import_record_id, status, marcxml)
478 $sth->bind_param(1, $import_record_id);
479 $sth->bind_param(2, 'staged');
480 $sth->bind_param(3, $item_marc->as_xml("USMARC"));
482 push @import_items_ids, $dbh->{'mysql_insertid'};
486 if ($#import_items_ids > -1) {
487 _update_batch_record_counts($batch_id) if $update_counts;
488 _update_import_record_marc($import_record_id, $marc_record, C4::Context->preference('marcflavour'));
490 return @import_items_ids;
493 =head2 BatchFindDuplicates
495 my $num_with_matches = BatchFindDuplicates($batch_id, $matcher,
496 $max_matches, $progress_interval, $progress_callback);
498 Goes through the records loaded in the batch and attempts to
499 find duplicates for each one. Sets the matching status
500 of each record to "no_match" or "auto_match" as appropriate.
502 The $max_matches parameter is optional; if it is not supplied,
505 The $progress_interval and $progress_callback parameters are
506 optional; if both are supplied, the sub referred to by
507 $progress_callback will be invoked every $progress_interval
508 records using the number of records processed as the
513 sub BatchFindDuplicates {
514 my $batch_id = shift;
516 my $max_matches = @_ ? shift : 10;
518 # optional callback to monitor status
520 my $progress_interval = 0;
521 my $progress_callback = undef;
523 $progress_interval = shift;
524 $progress_callback = shift;
525 $progress_interval = 0 unless $progress_interval =~ /^\d+$/ and $progress_interval > 0;
526 $progress_interval = 0 unless 'CODE' eq ref $progress_callback;
529 my $dbh = C4::Context->dbh;
531 my $sth = $dbh->prepare("SELECT import_record_id, record_type, marc
533 WHERE import_batch_id = ?");
534 $sth->execute($batch_id);
535 my $num_with_matches = 0;
537 while (my $rowref = $sth->fetchrow_hashref) {
539 if ($progress_interval and (0 == ($rec_num % $progress_interval))) {
540 &$progress_callback($rec_num);
542 my $marc_record = MARC::Record->new_from_usmarc($rowref->{'marc'});
544 if (defined $matcher) {
545 @matches = $matcher->get_matches($marc_record, $max_matches);
547 if (scalar(@matches) > 0) {
549 SetImportRecordMatches($rowref->{'import_record_id'}, @matches);
550 SetImportRecordOverlayStatus($rowref->{'import_record_id'}, 'auto_match');
552 SetImportRecordMatches($rowref->{'import_record_id'}, ());
553 SetImportRecordOverlayStatus($rowref->{'import_record_id'}, 'no_match');
557 return $num_with_matches;
560 =head2 BatchCommitRecords
562 my ($num_added, $num_updated, $num_items_added, $num_items_replaced, $num_items_errored, $num_ignored) =
563 BatchCommitRecords($batch_id, $framework,
564 $progress_interval, $progress_callback);
568 sub BatchCommitRecords {
569 my $batch_id = shift;
570 my $framework = shift;
572 # optional callback to monitor status
574 my $progress_interval = 0;
575 my $progress_callback = undef;
577 $progress_interval = shift;
578 $progress_callback = shift;
579 $progress_interval = 0 unless $progress_interval =~ /^\d+$/ and $progress_interval > 0;
580 $progress_interval = 0 unless 'CODE' eq ref $progress_callback;
586 my $num_items_added = 0;
587 my $num_items_replaced = 0;
588 my $num_items_errored = 0;
590 # commit (i.e., save, all records in the batch)
591 SetImportBatchStatus($batch_id, 'importing');
592 my $overlay_action = GetImportBatchOverlayAction($batch_id);
593 my $nomatch_action = GetImportBatchNoMatchAction($batch_id);
594 my $item_action = GetImportBatchItemAction($batch_id);
597 my $dbh = C4::Context->dbh;
598 my $sth = $dbh->prepare("SELECT import_records.import_record_id, record_type, status, overlay_status, marc, encoding
600 LEFT JOIN import_auths ON (import_records.import_record_id=import_auths.import_record_id)
601 LEFT JOIN import_biblios ON (import_records.import_record_id=import_biblios.import_record_id)
602 WHERE import_batch_id = ?");
603 $sth->execute($batch_id);
604 my $marcflavour = C4::Context->preference('marcflavour');
606 my $userenv = C4::Context->userenv;
607 my $logged_in_patron = Koha::Patrons->find( $userenv->{number} );
610 while (my $rowref = $sth->fetchrow_hashref) {
611 $record_type = $rowref->{'record_type'};
613 if ($progress_interval and (0 == ($rec_num % $progress_interval))) {
614 &$progress_callback($rec_num);
616 if ($rowref->{'status'} eq 'error' or $rowref->{'status'} eq 'imported') {
622 if ($marcflavour eq 'UNIMARC' && $record_type eq 'auth') {
623 $marc_type = 'UNIMARCAUTH';
624 } elsif ($marcflavour eq 'UNIMARC') {
625 $marc_type = 'UNIMARC';
627 $marc_type = 'USMARC';
629 my $marc_record = MARC::Record->new_from_usmarc($rowref->{'marc'});
631 if ($record_type eq 'biblio') {
632 # remove any item tags - rely on BatchCommitItems
633 ($item_tag,$item_subfield) = &GetMarcFromKohaField( "items.itemnumber" );
634 foreach my $item_field ($marc_record->field($item_tag)) {
635 $marc_record->delete_field($item_field);
639 my ($record_result, $item_result, $record_match) =
640 _get_commit_action($overlay_action, $nomatch_action, $item_action,
641 $rowref->{'overlay_status'}, $rowref->{'import_record_id'}, $record_type);
645 if ($record_result eq 'create_new') {
647 if ($record_type eq 'biblio') {
648 my $biblioitemnumber;
649 ($recordid, $biblioitemnumber) = AddBiblio($marc_record, $framework);
650 $query = "UPDATE import_biblios SET matched_biblionumber = ? WHERE import_record_id = ?"; # FIXME call SetMatchedBiblionumber instead
651 if ($item_result eq 'create_new' || $item_result eq 'replace') {
652 my ($bib_items_added, $bib_items_replaced, $bib_items_errored) = BatchCommitItems($rowref->{'import_record_id'}, $recordid, $item_result);
653 $num_items_added += $bib_items_added;
654 $num_items_replaced += $bib_items_replaced;
655 $num_items_errored += $bib_items_errored;
658 $recordid = AddAuthority($marc_record, undef, GuessAuthTypeCode($marc_record));
659 $query = "UPDATE import_auths SET matched_authid = ? WHERE import_record_id = ?";
661 my $sth = $dbh->prepare_cached($query);
662 $sth->execute($recordid, $rowref->{'import_record_id'});
664 SetImportRecordStatus($rowref->{'import_record_id'}, 'imported');
665 } elsif ($record_result eq 'replace') {
667 $recordid = $record_match;
669 if ($record_type eq 'biblio') {
670 my $oldbiblio = Koha::Biblios->find( $recordid );
671 $oldxml = GetXmlBiblio($recordid);
673 # remove item fields so that they don't get
674 # added again if record is reverted
675 # FIXME: GetXmlBiblio output should not contain item info any more! So the next foreach should not be needed. Does not hurt either; may remove old 952s that should not have been there anymore.
676 my $old_marc = MARC::Record->new_from_xml(StripNonXmlChars($oldxml), 'UTF-8', $rowref->{'encoding'}, $marc_type);
677 foreach my $item_field ($old_marc->field($item_tag)) {
678 $old_marc->delete_field($item_field);
680 $oldxml = $old_marc->as_xml($marc_type);
682 my $context = { source => 'batchimport' };
683 if ($logged_in_patron) {
684 $context->{categorycode} = $logged_in_patron->categorycode;
685 $context->{userid} = $logged_in_patron->userid;
688 ModBiblio($marc_record, $recordid, $oldbiblio->frameworkcode, {
689 overlay_context => $context
691 $query = "UPDATE import_biblios SET matched_biblionumber = ? WHERE import_record_id = ?"; # FIXME call SetMatchedBiblionumber instead
693 if ($item_result eq 'create_new' || $item_result eq 'replace') {
694 my ($bib_items_added, $bib_items_replaced, $bib_items_errored) = BatchCommitItems($rowref->{'import_record_id'}, $recordid, $item_result);
695 $num_items_added += $bib_items_added;
696 $num_items_replaced += $bib_items_replaced;
697 $num_items_errored += $bib_items_errored;
700 $oldxml = GetAuthorityXML($recordid);
702 ModAuthority($recordid, $marc_record, GuessAuthTypeCode($marc_record));
703 $query = "UPDATE import_auths SET matched_authid = ? WHERE import_record_id = ?";
705 my $sth = $dbh->prepare_cached("UPDATE import_records SET marcxml_old = ? WHERE import_record_id = ?");
706 $sth->execute($oldxml, $rowref->{'import_record_id'});
708 my $sth2 = $dbh->prepare_cached($query);
709 $sth2->execute($recordid, $rowref->{'import_record_id'});
711 SetImportRecordOverlayStatus($rowref->{'import_record_id'}, 'match_applied');
712 SetImportRecordStatus($rowref->{'import_record_id'}, 'imported');
713 } elsif ($record_result eq 'ignore') {
714 $recordid = $record_match;
716 if ($record_type eq 'biblio' and defined $recordid and ( $item_result eq 'create_new' || $item_result eq 'replace' ) ) {
717 my ($bib_items_added, $bib_items_replaced, $bib_items_errored) = BatchCommitItems($rowref->{'import_record_id'}, $recordid, $item_result);
718 $num_items_added += $bib_items_added;
719 $num_items_replaced += $bib_items_replaced;
720 $num_items_errored += $bib_items_errored;
721 # still need to record the matched biblionumber so that the
722 # items can be reverted
723 my $sth2 = $dbh->prepare_cached("UPDATE import_biblios SET matched_biblionumber = ? WHERE import_record_id = ?"); # FIXME call SetMatchedBiblionumber instead
724 $sth2->execute($recordid, $rowref->{'import_record_id'});
725 SetImportRecordOverlayStatus($rowref->{'import_record_id'}, 'match_applied');
727 SetImportRecordStatus($rowref->{'import_record_id'}, 'ignored');
731 SetImportBatchStatus($batch_id, 'imported');
732 return ($num_added, $num_updated, $num_items_added, $num_items_replaced, $num_items_errored, $num_ignored);
735 =head2 BatchCommitItems
737 ($num_items_added, $num_items_errored) =
738 BatchCommitItems($import_record_id, $biblionumber);
742 sub BatchCommitItems {
743 my ( $import_record_id, $biblionumber, $action ) = @_;
745 my $dbh = C4::Context->dbh;
747 my $num_items_added = 0;
748 my $num_items_errored = 0;
749 my $num_items_replaced = 0;
751 my $sth = $dbh->prepare( "
752 SELECT import_items_id, import_items.marcxml, encoding
754 JOIN import_records USING (import_record_id)
755 WHERE import_record_id = ?
756 ORDER BY import_items_id
758 $sth->bind_param( 1, $import_record_id );
761 while ( my $row = $sth->fetchrow_hashref() ) {
762 my $item_marc = MARC::Record->new_from_xml( StripNonXmlChars( $row->{'marcxml'} ), 'UTF-8', $row->{'encoding'} );
764 # Delete date_due subfield as to not accidentally delete item checkout due dates
765 my ( $MARCfield, $MARCsubfield ) = GetMarcFromKohaField( 'items.onloan' );
766 $item_marc->field($MARCfield)->delete_subfield( code => $MARCsubfield );
768 my $item = TransformMarcToKoha( $item_marc );
770 my $duplicate_barcode = exists( $item->{'barcode'} ) && Koha::Items->find({ barcode => $item->{'barcode'} });
771 my $duplicate_itemnumber = exists( $item->{'itemnumber'} );
773 my $updsth = $dbh->prepare("UPDATE import_items SET status = ?, itemnumber = ? WHERE import_items_id = ?");
774 if ( $action eq "replace" && $duplicate_itemnumber ) {
775 # Duplicate itemnumbers have precedence, that way we can update barcodes by overlaying
776 ModItemFromMarc( $item_marc, $biblionumber, $item->{itemnumber} );
777 $updsth->bind_param( 1, 'imported' );
778 $updsth->bind_param( 2, $item->{itemnumber} );
779 $updsth->bind_param( 3, $row->{'import_items_id'} );
782 $num_items_replaced++;
783 } elsif ( $action eq "replace" && $duplicate_barcode ) {
784 my $itemnumber = $duplicate_barcode->itemnumber;
785 ModItemFromMarc( $item_marc, $biblionumber, $itemnumber );
786 $updsth->bind_param( 1, 'imported' );
787 $updsth->bind_param( 2, $item->{itemnumber} );
788 $updsth->bind_param( 3, $row->{'import_items_id'} );
791 $num_items_replaced++;
792 } elsif ($duplicate_barcode) {
793 $updsth->bind_param( 1, 'error' );
794 $updsth->bind_param( 2, 'duplicate item barcode' );
795 $updsth->bind_param( 3, $row->{'import_items_id'} );
797 $num_items_errored++;
799 # Remove the itemnumber if it exists, we want to create a new item
800 my ( $itemtag, $itemsubfield ) = GetMarcFromKohaField( "items.itemnumber" );
801 $item_marc->field($itemtag)->delete_subfield( code => $itemsubfield );
803 my ( $item_biblionumber, $biblioitemnumber, $itemnumber ) = AddItemFromMarc( $item_marc, $biblionumber );
805 $updsth->bind_param( 1, 'imported' );
806 $updsth->bind_param( 2, $itemnumber );
807 $updsth->bind_param( 3, $row->{'import_items_id'} );
815 return ( $num_items_added, $num_items_replaced, $num_items_errored );
818 =head2 BatchRevertRecords
820 my ($num_deleted, $num_errors, $num_reverted, $num_items_deleted,
821 $num_ignored) = BatchRevertRecords($batch_id);
825 sub BatchRevertRecords {
826 my $batch_id = shift;
828 my $logger = Koha::Logger->get( { category => 'C4.ImportBatch' } );
830 $logger->trace("C4::ImportBatch::BatchRevertRecords( $batch_id )");
835 my $num_reverted = 0;
837 my $num_items_deleted = 0;
838 # commit (i.e., save, all records in the batch)
839 SetImportBatchStatus($batch_id, 'reverting');
840 my $overlay_action = GetImportBatchOverlayAction($batch_id);
841 my $nomatch_action = GetImportBatchNoMatchAction($batch_id);
842 my $dbh = C4::Context->dbh;
843 my $sth = $dbh->prepare("SELECT import_records.import_record_id, record_type, status, overlay_status, marcxml_old, encoding, matched_biblionumber, matched_authid
845 LEFT JOIN import_auths ON (import_records.import_record_id=import_auths.import_record_id)
846 LEFT JOIN import_biblios ON (import_records.import_record_id=import_biblios.import_record_id)
847 WHERE import_batch_id = ?");
848 $sth->execute($batch_id);
850 my $marcflavour = C4::Context->preference('marcflavour');
851 while (my $rowref = $sth->fetchrow_hashref) {
852 $record_type = $rowref->{'record_type'};
853 if ($rowref->{'status'} eq 'error' or $rowref->{'status'} eq 'reverted') {
857 if ($marcflavour eq 'UNIMARC' && $record_type eq 'auth') {
858 $marc_type = 'UNIMARCAUTH';
859 } elsif ($marcflavour eq 'UNIMARC') {
860 $marc_type = 'UNIMARC';
862 $marc_type = 'USMARC';
865 my $record_result = _get_revert_action($overlay_action, $rowref->{'overlay_status'}, $rowref->{'status'});
867 if ($record_result eq 'delete') {
869 if ($record_type eq 'biblio') {
870 $num_items_deleted += BatchRevertItems($rowref->{'import_record_id'}, $rowref->{'matched_biblionumber'});
871 $error = DelBiblio($rowref->{'matched_biblionumber'});
873 DelAuthority({ authid => $rowref->{'matched_authid'} });
875 if (defined $error) {
879 SetImportRecordStatus($rowref->{'import_record_id'}, 'reverted');
881 } elsif ($record_result eq 'restore') {
883 my $old_record = MARC::Record->new_from_xml(StripNonXmlChars($rowref->{'marcxml_old'}), 'UTF-8', $rowref->{'encoding'}, $marc_type);
884 if ($record_type eq 'biblio') {
885 my $biblionumber = $rowref->{'matched_biblionumber'};
886 my $oldbiblio = Koha::Biblios->find( $biblionumber );
888 $logger->info("C4::ImportBatch::BatchRevertRecords: Biblio record $biblionumber does not exist, restoration of this record was skipped") unless $oldbiblio;
889 next unless $oldbiblio; # Record has since been deleted. Deleted records should stay deleted.
891 $num_items_deleted += BatchRevertItems($rowref->{'import_record_id'}, $rowref->{'matched_biblionumber'});
892 ModBiblio($old_record, $biblionumber, $oldbiblio->frameworkcode);
894 my $authid = $rowref->{'matched_authid'};
895 ModAuthority($authid, $old_record, GuessAuthTypeCode($old_record));
897 SetImportRecordStatus($rowref->{'import_record_id'}, 'reverted');
898 } elsif ($record_result eq 'ignore') {
899 if ($record_type eq 'biblio') {
900 $num_items_deleted += BatchRevertItems($rowref->{'import_record_id'}, $rowref->{'matched_biblionumber'});
902 SetImportRecordStatus($rowref->{'import_record_id'}, 'reverted');
905 if ($record_type eq 'biblio') {
906 # remove matched_biblionumber only if there is no 'imported' item left
907 $query = "UPDATE import_biblios SET matched_biblionumber = NULL WHERE import_record_id = ?"; # FIXME Remove me
908 $query = "UPDATE import_biblios SET matched_biblionumber = NULL WHERE import_record_id = ? AND NOT EXISTS (SELECT * FROM import_items WHERE import_items.import_record_id=import_biblios.import_record_id and status='imported')";
910 $query = "UPDATE import_auths SET matched_authid = NULL WHERE import_record_id = ?";
912 my $sth2 = $dbh->prepare_cached($query);
913 $sth2->execute($rowref->{'import_record_id'});
917 SetImportBatchStatus($batch_id, 'reverted');
918 return ($num_deleted, $num_errors, $num_reverted, $num_items_deleted, $num_ignored);
921 =head2 BatchRevertItems
923 my $num_items_deleted = BatchRevertItems($import_record_id, $biblionumber);
927 sub BatchRevertItems {
928 my ($import_record_id, $biblionumber) = @_;
930 my $dbh = C4::Context->dbh;
931 my $num_items_deleted = 0;
933 my $sth = $dbh->prepare_cached("SELECT import_items_id, itemnumber
935 JOIN items USING (itemnumber)
936 WHERE import_record_id = ?");
937 $sth->bind_param(1, $import_record_id);
939 while (my $row = $sth->fetchrow_hashref()) {
940 my $item = Koha::Items->find($row->{itemnumber});
941 if ($item->safe_delete){
942 my $updsth = $dbh->prepare("UPDATE import_items SET status = ? WHERE import_items_id = ?");
943 $updsth->bind_param(1, 'reverted');
944 $updsth->bind_param(2, $row->{'import_items_id'});
947 $num_items_deleted++;
954 return $num_items_deleted;
959 CleanBatch($batch_id)
961 Deletes all staged records from the import batch
962 and sets the status of the batch to 'cleaned'. Note
963 that deleting a stage record does *not* affect
964 any record that has been committed to the database.
969 my $batch_id = shift;
970 return unless defined $batch_id;
972 C4::Context->dbh->do('DELETE FROM import_records WHERE import_batch_id = ?', {}, $batch_id);
973 SetImportBatchStatus($batch_id, 'cleaned');
978 DeleteBatch($batch_id)
980 Deletes the record from the database. This can only be done
981 once the batch has been cleaned.
986 my $batch_id = shift;
987 return unless defined $batch_id;
989 my $dbh = C4::Context->dbh;
990 my $sth = $dbh->prepare('DELETE FROM import_batches WHERE import_batch_id = ?');
991 $sth->execute( $batch_id );
994 =head2 GetAllImportBatches
996 my $results = GetAllImportBatches();
998 Returns a references to an array of hash references corresponding
999 to all import_batches rows (of batch_type 'batch'), sorted in
1000 ascending order by import_batch_id.
1004 sub GetAllImportBatches {
1005 my $dbh = C4::Context->dbh;
1006 my $sth = $dbh->prepare_cached("SELECT * FROM import_batches
1007 WHERE batch_type IN ('batch', 'webservice')
1008 ORDER BY import_batch_id ASC");
1012 while (my $row = $sth->fetchrow_hashref) {
1013 push @$results, $row;
1019 =head2 GetStagedWebserviceBatches
1021 my $batch_ids = GetStagedWebserviceBatches();
1023 Returns a references to an array of batch id's
1024 of batch_type 'webservice' that are not imported
1028 my $PENDING_WEBSERVICE_BATCHES_QRY = <<EOQ;
1029 SELECT import_batch_id FROM import_batches
1030 WHERE batch_type = 'webservice'
1031 AND import_status = 'staged'
1033 sub GetStagedWebserviceBatches {
1034 my $dbh = C4::Context->dbh;
1035 return $dbh->selectcol_arrayref($PENDING_WEBSERVICE_BATCHES_QRY);
1038 =head2 GetImportBatchRangeDesc
1040 my $results = GetImportBatchRangeDesc($offset, $results_per_group);
1042 Returns a reference to an array of hash references corresponding to
1043 import_batches rows (sorted in descending order by import_batch_id)
1044 start at the given offset.
1048 sub GetImportBatchRangeDesc {
1049 my ($offset, $results_per_group) = @_;
1051 my $dbh = C4::Context->dbh;
1052 my $query = "SELECT b.*, p.name as profile FROM import_batches b
1053 LEFT JOIN import_batch_profiles p
1054 ON b.profile_id = p.id
1055 WHERE b.batch_type IN ('batch', 'webservice')
1056 ORDER BY b.import_batch_id DESC";
1058 if ($results_per_group){
1059 $query .= " LIMIT ?";
1060 push(@params, $results_per_group);
1063 $query .= " OFFSET ?";
1064 push(@params, $offset);
1066 my $sth = $dbh->prepare_cached($query);
1067 $sth->execute(@params);
1068 my $results = $sth->fetchall_arrayref({});
1073 =head2 GetItemNumbersFromImportBatch
1075 my @itemsnos = GetItemNumbersFromImportBatch($batch_id);
1079 sub GetItemNumbersFromImportBatch {
1080 my ($batch_id) = @_;
1081 my $dbh = C4::Context->dbh;
1083 SELECT itemnumber FROM import_items
1084 INNER JOIN items USING (itemnumber)
1085 INNER JOIN import_records USING (import_record_id)
1086 WHERE import_batch_id = ?|;
1087 my $sth = $dbh->prepare( $sql );
1088 $sth->execute($batch_id);
1090 while ( my ($itm) = $sth->fetchrow_array ) {
1096 =head2 GetNumberOfImportBatches
1098 my $count = GetNumberOfImportBatches();
1102 sub GetNumberOfNonZ3950ImportBatches {
1103 my $dbh = C4::Context->dbh;
1104 my $sth = $dbh->prepare("SELECT COUNT(*) FROM import_batches WHERE batch_type != 'z3950'");
1106 my ($count) = $sth->fetchrow_array();
1111 =head2 GetImportBiblios
1113 my $results = GetImportBiblios($importid);
1117 sub GetImportBiblios {
1118 my ($import_record_id) = @_;
1120 my $dbh = C4::Context->dbh;
1121 my $query = "SELECT * FROM import_biblios WHERE import_record_id = ?";
1122 return $dbh->selectall_arrayref(
1130 =head2 GetImportRecordsRange
1132 my $results = GetImportRecordsRange($batch_id, $offset, $results_per_group);
1134 Returns a reference to an array of hash references corresponding to
1135 import_biblios/import_auths/import_records rows for a given batch
1136 starting at the given offset.
1140 sub GetImportRecordsRange {
1141 my ( $batch_id, $offset, $results_per_group, $status, $parameters ) = @_;
1143 my $dbh = C4::Context->dbh;
1145 my $order_by = $parameters->{order_by} || 'import_record_id';
1146 ( $order_by ) = grep( { $_ eq $order_by } qw( import_record_id title status overlay_status ) ) ? $order_by : 'import_record_id';
1148 my $order_by_direction =
1149 uc( $parameters->{order_by_direction} // 'ASC' ) eq 'DESC' ? 'DESC' : 'ASC';
1151 $order_by .= " $order_by_direction, authorized_heading" if $order_by eq 'title';
1153 my $query = "SELECT title, author, isbn, issn, authorized_heading, import_records.import_record_id,
1154 record_sequence, status, overlay_status,
1155 matched_biblionumber, matched_authid, record_type
1157 LEFT JOIN import_auths ON (import_records.import_record_id=import_auths.import_record_id)
1158 LEFT JOIN import_biblios ON (import_records.import_record_id=import_biblios.import_record_id)
1159 WHERE import_batch_id = ?";
1161 push(@params, $batch_id);
1163 $query .= " AND status=?";
1164 push(@params,$status);
1167 $query.=" ORDER BY $order_by $order_by_direction";
1169 if($results_per_group){
1170 $query .= " LIMIT ?";
1171 push(@params, $results_per_group);
1174 $query .= " OFFSET ?";
1175 push(@params, $offset);
1177 my $sth = $dbh->prepare_cached($query);
1178 $sth->execute(@params);
1179 my $results = $sth->fetchall_arrayref({});
1185 =head2 GetBestRecordMatch
1187 my $record_id = GetBestRecordMatch($import_record_id);
1191 sub GetBestRecordMatch {
1192 my ($import_record_id) = @_;
1194 my $dbh = C4::Context->dbh;
1195 my $sth = $dbh->prepare("SELECT candidate_match_id
1196 FROM import_record_matches
1197 JOIN import_records ON ( import_record_matches.import_record_id = import_records.import_record_id )
1198 LEFT JOIN biblio ON ( candidate_match_id = biblio.biblionumber )
1199 LEFT JOIN auth_header ON ( candidate_match_id = auth_header.authid )
1200 WHERE import_record_matches.import_record_id = ? AND
1201 ( (import_records.record_type = 'biblio' AND biblio.biblionumber IS NOT NULL) OR
1202 (import_records.record_type = 'auth' AND auth_header.authid IS NOT NULL) )
1204 ORDER BY score DESC, candidate_match_id DESC");
1205 $sth->execute($import_record_id);
1206 my ($record_id) = $sth->fetchrow_array();
1211 =head2 GetImportBatchStatus
1213 my $status = GetImportBatchStatus($batch_id);
1217 sub GetImportBatchStatus {
1218 my ($batch_id) = @_;
1220 my $dbh = C4::Context->dbh;
1221 my $sth = $dbh->prepare("SELECT import_status FROM import_batches WHERE import_batch_id = ?");
1222 $sth->execute($batch_id);
1223 my ($status) = $sth->fetchrow_array();
1229 =head2 SetImportBatchStatus
1231 SetImportBatchStatus($batch_id, $new_status);
1235 sub SetImportBatchStatus {
1236 my ($batch_id, $new_status) = @_;
1238 my $dbh = C4::Context->dbh;
1239 my $sth = $dbh->prepare("UPDATE import_batches SET import_status = ? WHERE import_batch_id = ?");
1240 $sth->execute($new_status, $batch_id);
1245 =head2 SetMatchedBiblionumber
1247 SetMatchedBiblionumber($import_record_id, $biblionumber);
1251 sub SetMatchedBiblionumber {
1252 my ($import_record_id, $biblionumber) = @_;
1254 my $dbh = C4::Context->dbh;
1256 q|UPDATE import_biblios SET matched_biblionumber = ? WHERE import_record_id = ?|,
1257 undef, $biblionumber, $import_record_id
1261 =head2 GetImportBatchOverlayAction
1263 my $overlay_action = GetImportBatchOverlayAction($batch_id);
1267 sub GetImportBatchOverlayAction {
1268 my ($batch_id) = @_;
1270 my $dbh = C4::Context->dbh;
1271 my $sth = $dbh->prepare("SELECT overlay_action FROM import_batches WHERE import_batch_id = ?");
1272 $sth->execute($batch_id);
1273 my ($overlay_action) = $sth->fetchrow_array();
1275 return $overlay_action;
1280 =head2 SetImportBatchOverlayAction
1282 SetImportBatchOverlayAction($batch_id, $new_overlay_action);
1286 sub SetImportBatchOverlayAction {
1287 my ($batch_id, $new_overlay_action) = @_;
1289 my $dbh = C4::Context->dbh;
1290 my $sth = $dbh->prepare("UPDATE import_batches SET overlay_action = ? WHERE import_batch_id = ?");
1291 $sth->execute($new_overlay_action, $batch_id);
1296 =head2 GetImportBatchNoMatchAction
1298 my $nomatch_action = GetImportBatchNoMatchAction($batch_id);
1302 sub GetImportBatchNoMatchAction {
1303 my ($batch_id) = @_;
1305 my $dbh = C4::Context->dbh;
1306 my $sth = $dbh->prepare("SELECT nomatch_action FROM import_batches WHERE import_batch_id = ?");
1307 $sth->execute($batch_id);
1308 my ($nomatch_action) = $sth->fetchrow_array();
1310 return $nomatch_action;
1315 =head2 SetImportBatchNoMatchAction
1317 SetImportBatchNoMatchAction($batch_id, $new_nomatch_action);
1321 sub SetImportBatchNoMatchAction {
1322 my ($batch_id, $new_nomatch_action) = @_;
1324 my $dbh = C4::Context->dbh;
1325 my $sth = $dbh->prepare("UPDATE import_batches SET nomatch_action = ? WHERE import_batch_id = ?");
1326 $sth->execute($new_nomatch_action, $batch_id);
1331 =head2 GetImportBatchItemAction
1333 my $item_action = GetImportBatchItemAction($batch_id);
1337 sub GetImportBatchItemAction {
1338 my ($batch_id) = @_;
1340 my $dbh = C4::Context->dbh;
1341 my $sth = $dbh->prepare("SELECT item_action FROM import_batches WHERE import_batch_id = ?");
1342 $sth->execute($batch_id);
1343 my ($item_action) = $sth->fetchrow_array();
1345 return $item_action;
1350 =head2 SetImportBatchItemAction
1352 SetImportBatchItemAction($batch_id, $new_item_action);
1356 sub SetImportBatchItemAction {
1357 my ($batch_id, $new_item_action) = @_;
1359 my $dbh = C4::Context->dbh;
1360 my $sth = $dbh->prepare("UPDATE import_batches SET item_action = ? WHERE import_batch_id = ?");
1361 $sth->execute($new_item_action, $batch_id);
1366 =head2 GetImportBatchMatcher
1368 my $matcher_id = GetImportBatchMatcher($batch_id);
1372 sub GetImportBatchMatcher {
1373 my ($batch_id) = @_;
1375 my $dbh = C4::Context->dbh;
1376 my $sth = $dbh->prepare("SELECT matcher_id FROM import_batches WHERE import_batch_id = ?");
1377 $sth->execute($batch_id);
1378 my ($matcher_id) = $sth->fetchrow_array();
1385 =head2 SetImportBatchMatcher
1387 SetImportBatchMatcher($batch_id, $new_matcher_id);
1391 sub SetImportBatchMatcher {
1392 my ($batch_id, $new_matcher_id) = @_;
1394 my $dbh = C4::Context->dbh;
1395 my $sth = $dbh->prepare("UPDATE import_batches SET matcher_id = ? WHERE import_batch_id = ?");
1396 $sth->execute($new_matcher_id, $batch_id);
1401 =head2 GetImportRecordOverlayStatus
1403 my $overlay_status = GetImportRecordOverlayStatus($import_record_id);
1407 sub GetImportRecordOverlayStatus {
1408 my ($import_record_id) = @_;
1410 my $dbh = C4::Context->dbh;
1411 my $sth = $dbh->prepare("SELECT overlay_status FROM import_records WHERE import_record_id = ?");
1412 $sth->execute($import_record_id);
1413 my ($overlay_status) = $sth->fetchrow_array();
1415 return $overlay_status;
1420 =head2 SetImportRecordOverlayStatus
1422 SetImportRecordOverlayStatus($import_record_id, $new_overlay_status);
1426 sub SetImportRecordOverlayStatus {
1427 my ($import_record_id, $new_overlay_status) = @_;
1429 my $dbh = C4::Context->dbh;
1430 my $sth = $dbh->prepare("UPDATE import_records SET overlay_status = ? WHERE import_record_id = ?");
1431 $sth->execute($new_overlay_status, $import_record_id);
1436 =head2 GetImportRecordStatus
1438 my $status = GetImportRecordStatus($import_record_id);
1442 sub GetImportRecordStatus {
1443 my ($import_record_id) = @_;
1445 my $dbh = C4::Context->dbh;
1446 my $sth = $dbh->prepare("SELECT status FROM import_records WHERE import_record_id = ?");
1447 $sth->execute($import_record_id);
1448 my ($status) = $sth->fetchrow_array();
1455 =head2 SetImportRecordStatus
1457 SetImportRecordStatus($import_record_id, $new_status);
1461 sub SetImportRecordStatus {
1462 my ($import_record_id, $new_status) = @_;
1464 my $dbh = C4::Context->dbh;
1465 my $sth = $dbh->prepare("UPDATE import_records SET status = ? WHERE import_record_id = ?");
1466 $sth->execute($new_status, $import_record_id);
1471 =head2 GetImportRecordMatches
1473 my $results = GetImportRecordMatches($import_record_id, $best_only);
1477 sub GetImportRecordMatches {
1478 my $import_record_id = shift;
1479 my $best_only = @_ ? shift : 0;
1481 my $dbh = C4::Context->dbh;
1482 # FIXME currently biblio only
1483 my $sth = $dbh->prepare_cached("SELECT title, author, biblionumber,
1484 candidate_match_id, score, record_type,
1487 JOIN import_record_matches USING (import_record_id)
1488 LEFT JOIN biblio ON (biblionumber = candidate_match_id)
1489 WHERE import_record_id = ?
1490 ORDER BY score DESC, biblionumber DESC");
1491 $sth->bind_param(1, $import_record_id);
1494 while (my $row = $sth->fetchrow_hashref) {
1495 if ($row->{'record_type'} eq 'auth') {
1496 $row->{'authorized_heading'} = C4::AuthoritiesMarc::GetAuthorizedHeading( { authid => $row->{'candidate_match_id'} } );
1498 next if ($row->{'record_type'} eq 'biblio' && not $row->{'biblionumber'});
1499 push @$results, $row;
1508 =head2 SetImportRecordMatches
1510 SetImportRecordMatches($import_record_id, @matches);
1514 sub SetImportRecordMatches {
1515 my $import_record_id = shift;
1518 my $dbh = C4::Context->dbh;
1519 my $delsth = $dbh->prepare("DELETE FROM import_record_matches WHERE import_record_id = ?");
1520 $delsth->execute($import_record_id);
1523 my $sth = $dbh->prepare("INSERT INTO import_record_matches (import_record_id, candidate_match_id, score, chosen)
1524 VALUES (?, ?, ?, ?)");
1525 my $chosen = 1; #The first match is defaulted to be chosen
1526 foreach my $match (@matches) {
1527 $sth->execute($import_record_id, $match->{'record_id'}, $match->{'score'}, $chosen);
1528 $chosen = 0; #After the first we do not default to other matches
1532 =head2 RecordsFromISO2709File
1534 my ($errors, $records) = C4::ImportBatch::RecordsFromISO2709File($input_file, $record_type, $encoding);
1536 Reads ISO2709 binary porridge from the given file and creates MARC::Record-objects out of it.
1538 @PARAM1, String, absolute path to the ISO2709 file.
1539 @PARAM2, String, see stage_file.pl
1540 @PARAM3, String, should be utf8
1542 Returns two array refs.
1546 sub RecordsFromISO2709File {
1547 my ($input_file, $record_type, $encoding) = @_;
1550 my $marc_type = C4::Context->preference('marcflavour');
1551 $marc_type .= 'AUTH' if ($marc_type eq 'UNIMARC' && $record_type eq 'auth');
1553 open my $fh, '<', $input_file or die "$0: cannot open input file $input_file: $!\n";
1559 next unless $_; # skip if record has only whitespace, as might occur
1560 # if file includes newlines between each MARC record
1561 my ($marc_record, $charset_guessed, $char_errors) = MarcToUTF8Record($_, $marc_type, $encoding);
1562 push @marc_records, $marc_record;
1563 if ($charset_guessed ne $encoding) {
1565 "Unexpected charset $charset_guessed, expecting $encoding";
1569 return ( \@errors, \@marc_records );
1572 =head2 RecordsFromMARCXMLFile
1574 my ($errors, $records) = C4::ImportBatch::RecordsFromMARCXMLFile($input_file, $encoding);
1576 Creates MARC::Record-objects out of the given MARCXML-file.
1578 @PARAM1, String, absolute path to the ISO2709 file.
1579 @PARAM2, String, should be utf8
1581 Returns two array refs.
1585 sub RecordsFromMARCXMLFile {
1586 my ( $filename, $encoding ) = @_;
1587 my $batch = MARC::File::XML->in( $filename );
1588 my ( @marcRecords, @errors, $record );
1590 eval { $record = $batch->next( $encoding ); };
1594 push @marcRecords, $record if $record;
1596 return (\@errors, \@marcRecords);
1599 =head2 RecordsFromMarcPlugin
1601 Converts text of input_file into array of MARC records with to_marc plugin
1605 sub RecordsFromMarcPlugin {
1606 my ($input_file, $plugin_class, $encoding) = @_;
1607 my ( $text, @return );
1608 return \@return if !$input_file || !$plugin_class;
1611 open my $fh, '<', $input_file or die "$0: cannot open input file $input_file: $!\n";
1621 # Convert to large MARC blob with plugin
1622 $text = Koha::Plugins::Handler->run({
1623 class => $plugin_class,
1624 method => 'to_marc',
1625 params => { data => $text },
1628 # Convert to array of MARC records
1630 my $marc_type = C4::Context->preference('marcflavour');
1631 foreach my $blob ( split(/\x1D/, $text) ) {
1632 next if $blob =~ /^\s*$/;
1633 my ($marcrecord) = MarcToUTF8Record($blob, $marc_type, $encoding);
1634 push @return, $marcrecord;
1640 # internal functions
1642 sub _create_import_record {
1643 my ($batch_id, $record_sequence, $marc_record, $record_type, $encoding, $marc_type) = @_;
1645 my $dbh = C4::Context->dbh;
1646 my $sth = $dbh->prepare("INSERT INTO import_records (import_batch_id, record_sequence, marc, marcxml, marcxml_old,
1647 record_type, encoding)
1648 VALUES (?, ?, ?, ?, ?, ?, ?)");
1649 $sth->execute($batch_id, $record_sequence, $marc_record->as_usmarc(), $marc_record->as_xml($marc_type), '',
1650 $record_type, $encoding);
1651 my $import_record_id = $dbh->{'mysql_insertid'};
1653 return $import_record_id;
1656 sub _update_import_record_marc {
1657 my ($import_record_id, $marc_record, $marc_type) = @_;
1659 my $dbh = C4::Context->dbh;
1660 my $sth = $dbh->prepare("UPDATE import_records SET marc = ?, marcxml = ?
1661 WHERE import_record_id = ?");
1662 $sth->execute($marc_record->as_usmarc(), $marc_record->as_xml($marc_type), $import_record_id);
1666 sub _add_auth_fields {
1667 my ($import_record_id, $marc_record) = @_;
1670 if ($marc_record->field('001')) {
1671 $controlnumber = $marc_record->field('001')->data();
1673 my $authorized_heading = C4::AuthoritiesMarc::GetAuthorizedHeading({ record => $marc_record });
1674 my $dbh = C4::Context->dbh;
1675 my $sth = $dbh->prepare("INSERT INTO import_auths (import_record_id, control_number, authorized_heading) VALUES (?, ?, ?)");
1676 $sth->execute($import_record_id, $controlnumber, $authorized_heading);
1680 sub _add_biblio_fields {
1681 my ($import_record_id, $marc_record) = @_;
1683 my ($title, $author, $isbn, $issn) = _parse_biblio_fields($marc_record);
1684 my $dbh = C4::Context->dbh;
1685 # FIXME no controlnumber, originalsource
1686 $isbn = C4::Koha::GetNormalizedISBN($isbn);
1687 my $sth = $dbh->prepare("INSERT INTO import_biblios (import_record_id, title, author, isbn, issn) VALUES (?, ?, ?, ?, ?)");
1688 $sth->execute($import_record_id, $title, $author, $isbn, $issn) or die $sth->errstr;
1693 sub _update_biblio_fields {
1694 my ($import_record_id, $marc_record) = @_;
1696 my ($title, $author, $isbn, $issn) = _parse_biblio_fields($marc_record);
1697 my $dbh = C4::Context->dbh;
1698 # FIXME no controlnumber, originalsource
1699 # FIXME 2 - should regularize normalization of ISBN wherever it is done
1703 my $sth = $dbh->prepare("UPDATE import_biblios SET title = ?, author = ?, isbn = ?, issn = ?
1704 WHERE import_record_id = ?");
1705 $sth->execute($title, $author, $isbn, $issn, $import_record_id);
1709 sub _parse_biblio_fields {
1710 my ($marc_record) = @_;
1712 my $dbh = C4::Context->dbh;
1713 my $bibliofields = TransformMarcToKoha($marc_record, '');
1714 return ($bibliofields->{'title'}, $bibliofields->{'author'}, $bibliofields->{'isbn'}, $bibliofields->{'issn'});
1718 sub _update_batch_record_counts {
1719 my ($batch_id) = @_;
1721 my $dbh = C4::Context->dbh;
1722 my $sth = $dbh->prepare_cached("UPDATE import_batches SET
1726 WHERE import_batch_id = import_batches.import_batch_id),
1730 JOIN import_items USING (import_record_id)
1731 WHERE import_batch_id = import_batches.import_batch_id
1732 AND record_type = 'biblio')
1733 WHERE import_batch_id = ?");
1734 $sth->bind_param(1, $batch_id);
1739 sub _get_commit_action {
1740 my ($overlay_action, $nomatch_action, $item_action, $overlay_status, $import_record_id, $record_type) = @_;
1742 if ($record_type eq 'biblio') {
1743 my ($bib_result, $bib_match, $item_result);
1745 $bib_match = GetBestRecordMatch($import_record_id);
1746 if ($overlay_status ne 'no_match' && defined($bib_match)) {
1748 $bib_result = $overlay_action;
1750 if($item_action eq 'always_add' or $item_action eq 'add_only_for_matches'){
1751 $item_result = 'create_new';
1752 } elsif($item_action eq 'replace'){
1753 $item_result = 'replace';
1755 $item_result = 'ignore';
1759 $bib_result = $nomatch_action;
1760 $item_result = ($item_action eq 'always_add' or $item_action eq 'add_only_for_new') ? 'create_new' : 'ignore';
1762 return ($bib_result, $item_result, $bib_match);
1763 } else { # must be auths
1764 my ($auth_result, $auth_match);
1766 $auth_match = GetBestRecordMatch($import_record_id);
1767 if ($overlay_status ne 'no_match' && defined($auth_match)) {
1768 $auth_result = $overlay_action;
1770 $auth_result = $nomatch_action;
1773 return ($auth_result, undef, $auth_match);
1778 sub _get_revert_action {
1779 my ($overlay_action, $overlay_status, $status) = @_;
1783 if ($status eq 'ignored') {
1784 $bib_result = 'ignore';
1786 if ($overlay_action eq 'create_new') {
1787 $bib_result = 'delete';
1789 $bib_result = ($overlay_status eq 'match_applied') ? 'restore' : 'delete';
1800 Koha Development Team <http://koha-community.org/>
1802 Galen Charlton <galen.charlton@liblime.com>