2 # Import an iso2709 file into Koha 3
7 # find Koha's Perl modules
8 # test carefully before changing this
10 eval { require "$FindBin::Bin/../kohalib.pl" };
14 use MARC::File::USMARC;
27 use C4::MarcModificationTemplates;
30 use Unicode::Normalize;
31 use Time::HiRes qw(gettimeofday);
37 use Koha::SearchEngine;
38 use Koha::SearchEngine::Search;
40 use open qw( :std :encoding(UTF-8) );
41 binmode( STDOUT, ":encoding(UTF-8)" );
42 my ( $input_marc_file, $number, $offset) = ('',0,0);
43 my ($version, $delete, $test_parameter, $skip_marc8_conversion, $char_encoding, $verbose, $commit, $fk_off,$format,$biblios,$authorities,$keepids,$match, $isbn_check, $logfile);
44 my ( $insert, $filters, $update, $all, $yamlfile, $authtypes, $append );
46 my ($sourcetag,$sourcesubfield,$idmapfl, $dedup_barcode);
49 my $marc_mod_template = '';
50 my $marc_mod_template_id = -1;
55 'commit:f' => \$commit,
56 'file:s' => \$input_marc_file,
58 'o|offset:f' => \$offset,
61 't|test' => \$test_parameter,
62 's' => \$skip_marc8_conversion,
63 'c:s' => \$char_encoding,
69 'k|keepids:s' => \$keepids,
70 'b|biblios' => \$biblios,
71 'a|authorities' => \$authorities,
72 'authtypes:s' => \$authtypes,
73 'filter=s@' => \$filters,
77 'match=s@' => \$match,
78 'i|isbn' => \$isbn_check,
80 'y:s' => \$sourcesubfield,
81 'idmap:s' => \$idmapfl,
82 'cleanisbn!' => \$cleanisbn,
83 'yaml:s' => \$yamlfile,
84 'dedupbarcode' => \$dedup_barcode,
85 'framework=s' => \$framework,
86 'custom:s' => \$localcust,
87 'marcmodtemplate:s' => \$marc_mod_template,
89 $biblios ||= !$authorities;
91 my $writemode = ($append) ? "a" : "w";
93 pod2usage( -msg => "\nYou must specify either --biblios or --authorities, not both.\n", -exitval ) if $biblios && $authorities;
100 if ($version || ($input_marc_file eq '')) {
101 pod2usage( -verbose => 2 );
104 if( $update && !( $match || $isbn_check ) ) {
105 warn "Using -update without -match or -isbn seems to be useless.\n";
108 if(defined $localcust) { #local customize module
110 $localcust= $localcust||'LocalChanges'; #default name
111 $localcust=~ s/^.*\/([^\/]+)$/$1/; #extract file name only
112 $localcust=~ s/\.pm$//; #remove extension
113 my $fqcust= $FindBin::Bin."/$localcust.pm"; #try migration_tools dir
118 print "WARNING: customize module $localcust.pm not found!\n";
122 require $localcust if $localcust;
123 $localcust=\&customize if $localcust;
126 if($marc_mod_template ne '') {
127 my @templates = GetModificationTemplates();
128 foreach my $this_template (@templates) {
129 if($this_template->{'name'} eq $marc_mod_template) {
130 if($marc_mod_template_id < 0) {
131 $marc_mod_template_id = $this_template->{'template_id'};
133 print "WARNING: MARC modification template name " .
134 "'$marc_mod_template' matches multiple templates. " .
135 "Please rename these templates\n";
140 if($marc_mod_template_id < 0) {
141 die "Can't located MARC modification template '$marc_mod_template'\n";
143 print "Records will be modified using MARC modofication template: $marc_mod_template\n" if $verbose;
147 my $dbh = C4::Context->dbh;
148 my $heading_fields=get_heading_fields();
151 if (defined $idmapfl) {
152 open($idmapfh, '>', $idmapfl) or die "cannot open $idmapfl \n";
155 if ((not defined $sourcesubfield) && (not defined $sourcetag)){
161 # Disable logging for the biblios and authorities import operation. It would unnecessarily
163 $ENV{OVERRIDE_SYSPREF_CataloguingLog} = 0;
164 $ENV{OVERRIDE_SYSPREF_AuthoritiesLog} = 0;
167 $dbh->do("SET FOREIGN_KEY_CHECKS = 0");
173 print "deleting biblios\n";
174 $dbh->do("DELETE FROM biblio");
175 $dbh->do("ALTER TABLE biblio AUTO_INCREMENT = 1");
176 $dbh->do("DELETE FROM biblioitems");
177 $dbh->do("ALTER TABLE biblioitems AUTO_INCREMENT = 1");
178 $dbh->do("DELETE FROM items");
179 $dbh->do("ALTER TABLE items AUTO_INCREMENT = 1");
182 print "deleting authorities\n";
183 $dbh->do("truncate auth_header");
185 $dbh->do("truncate zebraqueue");
190 if ($test_parameter) {
191 print "TESTING MODE ONLY\n DOING NOTHING\n===============\n";
194 my $marcFlavour = C4::Context->preference('marcflavour') || 'MARC21';
196 # The definition of $searcher must be before MARC::Batch->new
197 my $searcher = Koha::SearchEngine::Search->new(
201 ? $Koha::SearchEngine::AUTHORITIES_INDEX
202 : $Koha::SearchEngine::BIBLIOS_INDEX
207 print "Characteristic MARC flavour: $marcFlavour\n" if $verbose;
208 my $starttime = gettimeofday;
210 my $fh = IO::File->new($input_marc_file); # don't let MARC::Batch open the file, as it applies the ':utf8' IO layer
211 if (defined $format && $format =~ /XML/i) {
212 # ugly hack follows -- MARC::File::XML, when used by MARC::Batch,
213 # appears to try to convert incoming XML records from MARC-8
214 # to UTF-8. Setting the BinaryEncoding key turns that off
215 # TODO: see what happens to ISO-8859-1 XML files.
216 # TODO: determine if MARC::Batch can be fixed to handle
217 # XML records properly -- it probably should be
218 # be using a proper push or pull XML parser to
219 # extract the records, not using regexes to look
220 # for <record>.*</record>.
221 $MARC::File::XML::_load_args{BinaryEncoding} = 'utf-8';
222 my $recordformat= ($marcFlavour eq "MARC21"?"USMARC":uc($marcFlavour));
223 #UNIMARC Authorities have a different way to manage encoding than UNIMARC biblios.
224 $recordformat=$recordformat."AUTH" if ($authorities and $marcFlavour ne "MARC21");
225 $MARC::File::XML::_load_args{RecordFormat} = $recordformat;
226 $batch = MARC::Batch->new( 'XML', $fh );
228 $batch = MARC::Batch->new( 'USMARC', $fh );
230 $batch->warnings_off();
231 $batch->strict_off();
233 my $commitnum = $commit ? $commit : 50;
238 print "Skipping file offset: $offset records\n";
239 $batch->next() while ($offset--);
242 my ($tagid,$subfieldid);
247 ( $tagid, $subfieldid ) =
248 GetMarcFromKohaField( "biblio.biblionumber" );
252 # the SQL query to search on isbn
253 my $sth_isbn = $dbh->prepare("SELECT biblionumber,biblioitemnumber FROM biblioitems WHERE isbn=?");
255 $dbh->{AutoCommit} = 0;
258 $loghandle= IO::File->new($logfile, $writemode) ;
259 print $loghandle "id;operation;status\n";
265 eval { $record = $batch->next() };
267 print "Bad MARC record $i: $@ skipped\n";
268 # FIXME - because MARC::Batch->next() combines grabbing the next
269 # blob and parsing it into one operation, a correctable condition
270 # such as a MARC-8 record claiming that it's UTF-8 can't be recovered
271 # from because we don't have access to the original blob. Note
272 # that the staging import can deal with this condition (via
273 # C4::Charset::MarcToUTF8Record) because it doesn't use MARC::Batch.
276 # skip if we get an empty record (that is MARC valid, but will result in AddBiblio failure
277 last unless ( $record );
279 if( ($verbose//1)==1 ) { #no dot for verbose==2
280 print "." . ( $i % 100==0 ? "\n$i" : '' );
283 # transcode the record to UTF8 if needed & applicable.
284 if ($record->encoding() eq 'MARC-8' and not $skip_marc8_conversion) {
285 # FIXME update condition
286 my ($guessed_charset, $charset_errors);
287 ($record, $guessed_charset, $charset_errors) = MarcToUTF8Record($record, $marcFlavour.(($authorities and $marcFlavour ne "MARC21")?'AUTH':''));
288 if ($guessed_charset eq 'failed') {
289 warn "ERROR: failed to perform character conversion for record $i\n";
293 SetUTF8Flag($record);
294 if($marc_mod_template_id > 0) {
295 print "Modifying MARC\n" if $verbose;
296 ModifyRecordWithTemplate( $marc_mod_template_id, $record );
298 &$localcust($record) if $localcust;
300 # remove trailing - in isbn (only for biblios, of course)
302 my $tag = $marcFlavour eq 'UNIMARC' ? '010' : '020';
303 my $field = $record->field($tag);
304 $isbn = $field && $field->subfield('a');
305 if ( $isbn && $cleanisbn ) {
307 $field->update('a' => $isbn);
311 # search for duplicates (based on Local-number)
313 $originalid = GetRecordId( $record, $tagid, $subfieldid );
316 my $query = build_query( $match, $record );
317 my $server = ( $authorities ? 'authorityserver' : 'biblioserver' );
318 $debug && warn $query;
319 my ( $error, $results, $totalhits ) = $searcher->simple_search_compat( $query, 0, 3, [$server] );
320 # changed to warn so able to continue with one broken record
321 if ( defined $error ) {
322 warn "unable to search the database for duplicates : $error";
323 printlog( { id => $id || $originalid || $match, op => "match", status => "ERROR" } ) if ($logfile);
326 $debug && warn "$query $server : $totalhits";
327 if ( $results && scalar(@$results) == 1 ) {
328 my $marcrecord = C4::Search::new_record_from_zebra( $server, $results->[0] );
329 SetUTF8Flag($marcrecord);
330 $id = GetRecordId( $marcrecord, $tagid, $subfieldid );
331 if ( $authorities && $marcFlavour ) {
332 #Skip if authority in database is the same as the on in database
333 if ( $marcrecord->field('005') && $record->field('005') &&
334 $marcrecord->field('005')->data && $record->field('005')->data &&
335 $marcrecord->field('005')->data >= $record->field('005')->data ) {
337 $yamlhash->{$originalid}->{'authid'} = $id;
339 # we recover all subfields of the heading authorities
341 foreach my $field ( $marcrecord->field("2..") ) {
342 push @subfields, map { ( $_->[0] =~ /[a-z]/ ? $_->[1] : () ) } $field->subfields();
344 $yamlhash->{$originalid}->{'subfields'} = \@subfields;
345 $yamlhash->{$originalid}->{'updated'} = 0;
350 } elsif ( $results && scalar(@$results) > 1 ) {
351 $debug && warn "more than one match for $query";
353 $debug && warn "nomatch for $query";
356 if ($keepids && $originalid) {
358 if ( length($keepids) == 3 ) {
359 $storeidfield = MARC::Field->new( $keepids, $originalid );
361 $storeidfield = MARC::Field->new( substr( $keepids, 0, 3 ), "", "", substr( $keepids, 3, 1 ), $originalid );
363 $record->insert_fields_ordered($storeidfield);
364 $record->delete_field( $record->field($tagid) );
366 foreach my $stringfilter (@$filters) {
367 if ( length($stringfilter) == 3 ) {
368 foreach my $field ( $record->field($stringfilter) ) {
369 $record->delete_field($field);
370 $debug && warn "removed : ", $field->as_string;
372 } elsif ($stringfilter =~ /([0-9]{3})([a-z0-9])(.*)/) {
374 my $removesubfield = $2;
375 my $removematch = $3;
376 if ( ( $removetag > "010" ) && $removesubfield ) {
377 foreach my $field ( $record->field($removetag) ) {
378 $field->delete_subfield( code => "$removesubfield", match => $removematch );
379 $debug && warn "Potentially removed : ", $field->subfield($removesubfield);
384 unless ($test_parameter) {
386 use C4::AuthoritiesMarc;
387 my $authtypecode=GuessAuthTypeCode($record, $heading_fields);
388 my $authid= ($id?$id:GuessAuthId($record));
389 if ($authid && GetAuthority($authid) && $update ){
390 ## Authority has an id and is in database : Replace
391 eval { ( $authid ) = ModAuthority($authid,$record, $authtypecode) };
393 warn "Problem with authority $authid Cannot Modify";
394 printlog({id=>$originalid||$id||$authid, op=>"edit",status=>"ERROR"}) if ($logfile);
397 printlog({id=>$originalid||$id||$authid, op=>"edit",status=>"ok"}) if ($logfile);
400 elsif (defined $authid) {
401 ## An authid is defined but no authority in database : add
402 eval { ( $authid ) = AddAuthority($record,$authid, $authtypecode) };
404 warn "Problem with authority $authid Cannot Add ".$@;
405 printlog({id=>$originalid||$id||$authid, op=>"insert",status=>"ERROR"}) if ($logfile);
408 printlog({id=>$originalid||$id||$authid, op=>"insert",status=>"ok"}) if ($logfile);
412 ## True insert in database
413 eval { ( $authid ) = AddAuthority($record,"", $authtypecode) };
415 warn "Problem with authority $authid Cannot Add".$@;
416 printlog({id=>$originalid||$id||$authid, op=>"insert",status=>"ERROR"}) if ($logfile);
419 printlog({id=>$originalid||$id||$authid, op=>"insert",status=>"ok"}) if ($logfile);
423 $yamlhash->{$originalid}->{'authid'} = $authid;
425 foreach my $field ( $record->field("2..") ) {
426 push @subfields, map { ( $_->[0] =~ /[a-z]/ ? $_->[1] : () ) } $field->subfields();
428 $yamlhash->{$originalid}->{'subfields'} = \@subfields;
429 $yamlhash->{$originalid}->{'updated'} = 1;
433 my ( $biblionumber, $biblioitemnumber, $itemnumbers_ref, $errors_ref );
435 # check for duplicate, based on ISBN (skip it if we already have found a duplicate with match parameter
436 if (!$biblionumber && $isbn_check && $isbn) {
437 # warn "search ISBN : $isbn";
438 $sth_isbn->execute($isbn);
439 ($biblionumber,$biblioitemnumber) = $sth_isbn->fetchrow;
441 if (defined $idmapfl) {
442 if ($sourcetag < "010"){
443 if ($record->field($sourcetag)){
444 my $source = $record->field($sourcetag)->data();
445 printf($idmapfh "%s|%s\n",$source,$biblionumber);
448 my $source=$record->subfield($sourcetag,$sourcesubfield);
449 printf($idmapfh "%s|%s\n",$source,$biblionumber);
452 # create biblio, unless we already have it ( either match or isbn )
455 $biblioitemnumber = Koha::Biblios->find( $biblionumber )->biblioitem->biblioitemnumber;
458 eval { ModBiblio( $record, $biblionumber, GetFrameworkCode($biblionumber) ) };
460 warn "ERROR: Edit biblio $biblionumber failed: $@\n";
461 printlog( { id => $id || $originalid || $biblionumber, op => "update", status => "ERROR" } ) if ($logfile);
464 printlog( { id => $id || $originalid || $biblionumber, op => "update", status => "ok" } ) if ($logfile);
467 printlog( { id => $id || $originalid || $biblionumber, op => "insert", status => "warning : already in database" } ) if ($logfile);
471 eval { ( $biblionumber, $biblioitemnumber ) = AddBiblio( $record, '', { defer_marc_save => 1 } ) };
473 warn "ERROR: Adding biblio $biblionumber failed: $@\n";
474 printlog( { id => $id || $originalid || $biblionumber, op => "insert", status => "ERROR" } ) if ($logfile);
477 printlog( { id => $id || $originalid || $biblionumber, op => "insert", status => "ok" } ) if ($logfile);
480 warn "WARNING: Updating record ".($id||$originalid)." failed";
481 printlog( { id => $id || $originalid || $biblionumber, op => "update", status => "warning : not in database" } ) if ($logfile);
485 eval { ( $itemnumbers_ref, $errors_ref ) = AddItemBatchFromMarc( $record, $biblionumber, $biblioitemnumber, '' ); };
486 my $error_adding = $@;
487 # Work on a clone so that if there are real errors, we can maybe
489 my $clone_record = $record->clone();
490 C4::Biblio::_strip_item_fields($clone_record, '');
491 # This sets the marc fields if there was an error, and also calls
493 ModBiblioMarc( $clone_record, $biblionumber, $framework );
494 if ( $error_adding ) {
495 warn "ERROR: Adding items to bib $biblionumber failed: $error_adding";
496 printlog({id=>$id||$originalid||$biblionumber, op=>"insertitem",status=>"ERROR"}) if ($logfile);
497 # if we failed because of an exception, assume that
498 # the MARC columns in biblioitems were not set.
502 printlog({id=>$id||$originalid||$biblionumber, op=>"insertitem",status=>"ok"}) if ($logfile);
504 if ($dedup_barcode && grep { exists $_->{error_code} && $_->{error_code} eq 'duplicate_barcode' } @$errors_ref) {
505 # Find the record called 'barcode'
506 my ($tag, $sub) = C4::Biblio::GetMarcFromKohaField( 'items.barcode' );
507 # Now remove any items that didn't have a duplicate_barcode error,
508 # erase the barcodes on items that did, and re-add those items.
510 foreach my $i (0 .. $#{$errors_ref}) {
511 my $ref = $errors_ref->[$i];
512 if ($ref && ($ref->{error_code} eq 'duplicate_barcode')) {
513 $dupes{$ref->{item_sequence}} = 1;
514 # Delete the error message because we're going to
516 delete $errors_ref->[$i];
520 foreach my $field ($record->field($tag)) {
523 # Here we remove the barcode
524 $field->delete_subfield(code => $sub);
526 # otherwise we delete the field because we don't want
528 $record->delete_fields($field);
531 # Now re-add the record as before, adding errors to the prev list
533 eval { ( $itemnumbers_ref, $more_errors ) = AddItemBatchFromMarc( $record, $biblionumber, $biblioitemnumber, '' ); };
535 warn "ERROR: Adding items to bib $biblionumber failed: $@\n";
536 printlog({id=>$id||$originalid||$biblionumber, op=>"insertitem",status=>"ERROR"}) if ($logfile);
537 # if we failed because of an exception, assume that
538 # the MARC columns in biblioitems were not set.
539 ModBiblioMarc( $record, $biblionumber, $framework );
542 printlog({id=>$id||$originalid||$biblionumber, op=>"insertitem",status=>"ok"}) if ($logfile);
544 push @$errors_ref, @{ $more_errors };
546 if ($#{ $errors_ref } > -1) {
547 report_item_errors($biblionumber, $errors_ref);
549 $yamlhash->{$originalid} = $biblionumber if ($yamlfile);
551 $dbh->commit() if (0 == $i % $commitnum);
553 print $record->as_formatted()."\n" if ($verbose//0)==2;
554 last if $i == $number;
557 $dbh->{AutoCommit} = 1;
561 $dbh->do("SET FOREIGN_KEY_CHECKS = 1");
564 # Restore CataloguingLog and AuthoritiesLog
565 delete $ENV{OVERRIDE_SYSPREF_CataloguingLog};
566 delete $ENV{OVERRIDE_SYSPREF_AuthoritiesLog};
568 my $timeneeded = gettimeofday - $starttime;
569 print "\n$i MARC records done in $timeneeded seconds\n";
571 print $loghandle "file : $input_marc_file\n";
572 print $loghandle "$i MARC records done in $timeneeded seconds\n";
576 open my $yamlfileout, q{>}, "$yamlfile" or die "cannot open $yamlfile \n";
577 print $yamlfileout Dump($yamlhash);
582 my $marcrecord=shift;
587 return $marcrecord->field($tag)->data() if $marcrecord->field($tag);
590 if ($marcrecord->field($tag)){
591 return $marcrecord->subfield($tag,$subfield);
600 foreach my $matchingpoint (@$match){
601 my $string = build_simplequery($matchingpoint,$record);
602 push @searchstrings,$string if (length($string)>0);
605 return join(" $op ",@searchstrings);
607 sub build_simplequery {
611 my ($index,$recorddata)=split /,/,$element;
612 if ($recorddata=~/(\d{3})(.*)/) {
613 my ($tag,$subfields) =($1,$2);
614 foreach my $field ($record->field($tag)){
615 if (length($field->as_string("$subfields"))>0){
616 push @searchstrings,"$index:\"".$field->as_string("$subfields")."\"";
621 return join(" $op ",@searchstrings);
623 sub report_item_errors {
624 my $biblionumber = shift;
625 my $errors_ref = shift;
627 foreach my $error (@{ $errors_ref }) {
629 my $msg = "Item not added (bib $biblionumber, item tag #$error->{'item_sequence'}, barcode $error->{'item_barcode'}): ";
630 my $error_code = $error->{'error_code'};
631 $error_code =~ s/_/ /g;
632 $msg .= "$error_code $error->{'error_information'}";
637 my $logelements=shift;
638 print $loghandle join( ";", map { defined $_ ? $_ : "" } @$logelements{qw<id op status>} ), "\n";
640 sub get_heading_fields{
643 $headingfields=YAML::LoadFile($authtypes);
644 $headingfields={C4::Context->preference('marcflavour')=>$headingfields};
645 $debug && warn YAML::Dump($headingfields);
647 unless ($headingfields){
648 $headingfields=$dbh->selectall_hashref("SELECT auth_tag_to_report, authtypecode from auth_types",'auth_tag_to_report',{Slice=>{}});
649 $headingfields={C4::Context->preference('marcflavour')=>$headingfields};
651 return $headingfields;
656 bulkmarcimport.pl - Import bibliographic/authority records into Koha
660 $ export KOHA_CONF=/etc/koha.conf
661 $ perl misc/migration_tools/bulkmarcimport.pl -d -commit 1000 \\
662 -file /home/jmf/koha.mrc -n 3000
666 Don't use this script before you've entered and checked your MARC parameters
667 tables twice (or more!). Otherwise, the import won't work correctly and you
668 will get invalid data.
676 This version/help screen
678 =item B<-b, -biblios>
680 Type of import: bibliographic records
682 =item B<-a, -authorities>
684 Type of import: authority records
686 =item B<-file>=I<FILE>
688 The I<FILE> to import
692 Verbose mode. 1 means "some infos", 2 means "MARC dumping"
696 Turn off foreign key checks during import.
698 =item B<-n>=I<NUMBER>
700 The I<NUMBER> of records to import. If missing, all the file is imported
702 =item B<-o, -offset>=I<NUMBER>
704 File offset before importing, ie I<NUMBER> of records to skip.
706 =item B<-commit>=I<NUMBER>
708 The I<NUMBER> of records to wait before performing a 'commit' operation
712 File logs actions done for each record and their status into file
716 If specified, data will be appended to the logfile. If not, the logfile will be erased for each execution.
720 Test mode: parses the file, saying what it would do, but doing nothing.
724 Skip automatic conversion of MARC-8 to UTF-8. This option is provided for
727 =item B<-c>=I<CHARACTERISTIC>
729 The I<CHARACTERISTIC> MARC flavour. At the moment, only I<MARC21> and
730 I<UNIMARC> are supported. MARC21 by default.
734 Delete EVERYTHING related to biblio in koha-DB before import. Tables: biblio,
737 =item B<-m>=I<FORMAT>
739 Input file I<FORMAT>: I<MARCXML> or I<ISO2709> (defaults to ISO2709)
743 file yamlfile with authoritiesTypes and distinguishable record field in order
744 to store the correct authtype
748 yaml file format a yaml file with ids
752 list of fields that will not be imported. Can be any from 000 to 999 or field,
753 subfield and subfield's matching value such as 200avalue
757 if set, only insert when possible
761 if set, only updates (any biblio should have a matching record)
765 if set, do whatever is required
767 =item B<-k, -keepids>=<FIELD>
769 Field store ids in I<FIELD> (useful for authorities, where 001 contains the
770 authid for Koha, that can contain a very valuable info for authorities coming
771 from LOC or BNF. useless for biblios probably)
773 =item B<-match>=<FIELD>
775 I<FIELD> matchindex,fieldtomatch matchpoint to use to deduplicate fieldtomatch
776 can be either 001 to 999 or field and list of subfields as such 100abcde
780 If set, a search will be done on isbn, and, if the same isbn is found, the
781 biblio is not added. It's another method to deduplicate. B<-match> & B<-isbn>
786 Clean ISBN fields from entering biblio records, ie removes hyphens. By default,
787 ISBN are cleaned. --nocleanisbn will keep ISBN unchanged.
791 Source bib I<TAG> for reporting the source bib number
793 =item B<-y>=I<SUBFIELD>
795 Source I<SUBFIELD> for reporting the source bib number
797 =item B<-idmap>=I<FILE>
799 I<FILE> for the koha bib and source id
803 Store ids in 009 (useful for authorities, where 001 contains the authid for
804 Koha, that can contain a very valuable info for authorities coming from LOC or
805 BNF. useless for biblios probably)
807 =item B<-dedupbarcode>
809 If set, whenever a duplicate barcode is detected, it is removed and the attempt
810 to add the record is retried, thereby giving the record a blank barcode. This
811 is useful when something has set barcodes to be a biblio ID, or similar
812 (usually other software.)
816 This is the code for the framework that the requested records will have attached
817 to them when they are created. If not specified, then the default framework
820 =item B<-custom>=I<MODULE>
822 This parameter allows you to use a local module with a customize subroutine
823 that is called for each MARC record.
824 If no filename is passed, LocalChanges.pm is assumed to be in the
825 migration_tools subdirectory. You may pass an absolute file name or a file name
826 from the migration_tools directory.
828 =item B<-marcmodtemplate>=I<TEMPLATE>
830 This parameter allows you to specify the name of an existing MARC
831 modification template to apply as the MARC records are imported (these
832 templates are created in the "MARC modification templates" tool in Koha).
833 If not specified, no MARC modification templates are used (default).