Відмінності між версіями «Bulkmarcimport.pl»

Матеріал з Koha Ukraine Wiki
Перейти до: навігація, пошук
(Опис)
(Опис)
Рядок 16: Рядок 16:
  
 
'''-h'''
 
'''-h'''
 +
 
— екран з цією довідкою (англійською)
 
— екран з цією довідкою (англійською)
  
 
'''-b, -biblios'''
 
'''-b, -biblios'''
 +
 
— тип імпорту: бібліографічні записи
 
— тип імпорту: бібліографічні записи
  
-a, -authorities
+
'''-a, -authorities'''
 +
 
 +
— тип імпорту: авторитетні записи (файли)
 +
 
 +
'''-file=FILE'''
 +
 
 +
— The FILE to import
 +
 
 +
'''-v'''
 +
 
 +
— Verbose mode. 1 means "some infos", 2 means "MARC dumping"
 +
 
 +
'''-fk'''
 +
 
 +
— Turn off foreign key checks during import.
 +
 
 +
'''-n=NUMBER'''
 +
 
 +
— The NUMBER of records to import. If missing, all the file is imported
 +
 
 +
'''-o, -offset=NUMBER'''
 +
 
 +
— File offset before importing, ie NUMBER of records to skip.
 +
 
 +
'''-commit=NUMBER'''
 +
 
 +
— The NUMBER of records to wait before performing a 'commit' operation
 +
 
 +
'''-l'''
 +
 
 +
— File logs actions done for each record and their status into file
 +
 
 +
'''-append'''
 +
 
 +
— If specified, data will be appended to the logfile. If not, the logfile will be erased for each execution.
 +
 
 +
'''-t, -test'''
 +
 
 +
— Test mode: parses the file, saying what he would do, but doing nothing.
 +
 
 +
'''-s'''
 +
 
 +
— Skip automatic conversion of MARC-8 to UTF-8. This option is provided for debugging.
 +
 
 +
'''-c=CHARACTERISTIC'''
 +
 
 +
— The CHARACTERISTIC MARC flavour. At the moment, only MARC21 and UNIMARC are supported. MARC21 by default.
 +
 
 +
'''-d'''
 +
 
 +
— Delete EVERYTHING related to biblio in koha-DB before import. Tables: biblio, biblioitems, items
 +
 
 +
'''-m=FORMAT'''
 +
 
 +
—  Input file FORMAT: MARCXML or ISO2709 (defaults to ISO2709)
 +
 
 +
'''-authtypes'''
 +
 
 +
—  file yamlfile with authoritiesTypes and distinguishable record field in order to store the correct authtype
 +
 
 +
'''-yaml'''
  
    Type of import: authority records
+
—  yaml file format a yaml file with ids
-file=FILE
 
  
    The FILE to import
+
'''-filter'''
-v
 
  
    Verbose mode. 1 means "some infos", 2 means "MARC dumping"
+
— list of fields that will not be imported. Can be any from 000 to 999 or field, subfield and subfield's matching value such as 200avalue
-fk
 
  
    Turn off foreign key checks during import.
+
'''-insert'''
-n=NUMBER
 
  
    The NUMBER of records to import. If missing, all the file is imported
+
— if set, only insert when possible
-o, -offset=NUMBER
 
  
    File offset before importing, ie NUMBER of records to skip.
+
'''-update'''
-commit=NUMBER
 
  
    The NUMBER of records to wait before performing a 'commit' operation
+
— if set, only updates (any biblio should have a matching record)
-l
 
  
    File logs actions done for each record and their status into file
+
'''-all'''
-append
 
  
    If specified, data will be appended to the logfile. If not, the logfile will be erased for each execution.
+
— if set, do whatever is required
-t, -test
 
  
    Test mode: parses the file, saying what he would do, but doing nothing.
+
'''-k, -keepids=<FIELD>'''
-s
 
  
    Skip automatic conversion of MARC-8 to UTF-8. This option is provided for debugging.
+
— Field store ids in FIELD (usefull for authorities, where 001 contains the authid for Koha, that can contain a very valuable info for authorities coming from LOC or BNF. useless for biblios probably)
-c=CHARACTERISTIC
 
  
    The CHARACTERISTIC MARC flavour. At the moment, only MARC21 and UNIMARC are supported. MARC21 by default.
+
'''-match=<FIELD>'''
-d
 
  
    Delete EVERYTHING related to biblio in koha-DB before import. Tables: biblio, biblioitems, items
+
— FIELD matchindex,fieldtomatch matchpoint to use to deduplicate fieldtomatch can be either 001 to 999 or field and list of subfields as such 100abcde
-m=FORMAT
 
  
    Input file FORMAT: MARCXML or ISO2709 (defaults to ISO2709)
+
'''-i,-isbn'''
-authtypes
 
  
    file yamlfile with authoritiesTypes and distinguishable record field in order to store the correct authtype
+
— If set, a search will be done on isbn, and, if the same isbn is found, the biblio is not added. It's another method to deduplicate. -match & -isbn can be both set.
-yaml
 
  
    yaml file format a yaml file with ids
+
'''-cleanisbn'''
-filter
 
  
    list of fields that will not be imported. Can be any from 000 to 999 or field, subfield and subfield's matching value such as 200avalue
+
— Clean ISBN fields from entering biblio records, ie removes hyphens. By default, ISBN are cleaned. --nocleanisbn will keep ISBN unchanged.
-insert
 
  
    if set, only insert when possible
+
'''-x=TAG'''
-update
 
  
    if set, only updates (any biblio should have a matching record)
+
—  Source bib TAG for reporting the source bib number
-all
 
  
    if set, do whatever is required
+
'''-y=SUBFIELD'''
-k, -keepids=<FIELD>
 
  
    Field store ids in FIELD (usefull for authorities, where 001 contains the authid for Koha, that can contain a very valuable info for authorities coming from LOC or BNF. useless for biblios probably)
+
— Source SUBFIELD for reporting the source bib number
-match=<FIELD>
 
  
    FIELD matchindex,fieldtomatch matchpoint to use to deduplicate fieldtomatch can be either 001 to 999 or field and list of subfields as such 100abcde
+
'''-idmap=FILE'''
-i,-isbn
 
  
    If set, a search will be done on isbn, and, if the same isbn is found, the biblio is not added. It's another method to deduplicate. -match & -isbn can be both set.
+
— FILE for the koha bib and source id
-cleanisbn
 
  
    Clean ISBN fields from entering biblio records, ie removes hyphens. By default, ISBN are cleaned. --nocleanisbn will keep ISBN unchanged.
+
'''-keepids'''
-x=TAG
 
  
    Source bib TAG for reporting the source bib number
+
—  Store ids in 009 (usefull for authorities, where 001 contains the authid for Koha, that can contain a very valuable info for authorities coming from LOC or BNF. useless for biblios probably)
-y=SUBFIELD
 
  
    Source SUBFIELD for reporting the source bib number
+
'''-dedupbarcode'''
-idmap=FILE
 
  
    FILE for the koha bib and source id
+
— If set, whenever a duplicate barcode is detected, it is removed and the attempt to add the record is retried, thereby giving the record a blank barcode. This is useful when something has set barcodes to be a biblio ID, or similar (usually other software.)
-keepids
 
  
    Store ids in 009 (usefull for authorities, where 001 contains the authid for Koha, that can contain a very valuable info for authorities coming from LOC or BNF. useless for biblios probably)
+
'''-framework'''
-dedupbarcode
 
  
    If set, whenever a duplicate barcode is detected, it is removed and the attempt to add the record is retried, thereby giving the record a blank barcode. This is useful when something has set barcodes to be a biblio ID, or similar (usually other software.)
+
— This is the code for the framework that the requested records will have attached to them when they are created. If not specified, then the default framework will be used.
-framework
 
  
    This is the code for the framework that the requested records will have attached to them when they are created. If not specified, then the default framework will be used.
+
'''-custom=MODULE'''
-custom=MODULE
 
  
    This parameter allows you to use a local module with a customize subroutine that is called for each MARC record. If no filename is passed, LocalChanges.pm is assumed to be in the migration_tools subdirectory. You may pass an absolute file name or a file name from the migration_tools directory.
+
This parameter allows you to use a local module with a customize subroutine that is called for each MARC record. If no filename is passed, LocalChanges.pm is assumed to be in the migration_tools subdirectory. You may pass an absolute file name or a file name from the migration_tools directory.

Версія за 16:41, 12 березня 2018

Назва

bulkmarcimport.pl — імпорт бібліографічних та авторитетних записів у Коха

Використання

$ export KOHA_CONF=/etc/koha.conf
$ perl misc/migration_tools/bulkmarcimport.pl -d -commit 1000 \\
   -file /home/jmf/koha.mrc -n 3000

Застереження

Не використовуйте цей сценарій, перш ніж внесли та перевірили ваші таблиці MARC-ознак двічі (чи більше!). Інакше імпорт не буде працювати правильно, і Ви отримаєте зіпсовані дані.

Опис

-h

— екран з цією довідкою (англійською)

-b, -biblios

— тип імпорту: бібліографічні записи

-a, -authorities

— тип імпорту: авторитетні записи (файли)

-file=FILE

— The FILE to import

-v

— Verbose mode. 1 means "some infos", 2 means "MARC dumping"

-fk

— Turn off foreign key checks during import.

-n=NUMBER

— The NUMBER of records to import. If missing, all the file is imported

-o, -offset=NUMBER

— File offset before importing, ie NUMBER of records to skip.

-commit=NUMBER

— The NUMBER of records to wait before performing a 'commit' operation

-l

— File logs actions done for each record and their status into file

-append

— If specified, data will be appended to the logfile. If not, the logfile will be erased for each execution.

-t, -test

— Test mode: parses the file, saying what he would do, but doing nothing.

-s

— Skip automatic conversion of MARC-8 to UTF-8. This option is provided for debugging.

-c=CHARACTERISTIC

— The CHARACTERISTIC MARC flavour. At the moment, only MARC21 and UNIMARC are supported. MARC21 by default.

-d

— Delete EVERYTHING related to biblio in koha-DB before import. Tables: biblio, biblioitems, items

-m=FORMAT

— Input file FORMAT: MARCXML or ISO2709 (defaults to ISO2709)

-authtypes

— file yamlfile with authoritiesTypes and distinguishable record field in order to store the correct authtype

-yaml

— yaml file format a yaml file with ids

-filter

— list of fields that will not be imported. Can be any from 000 to 999 or field, subfield and subfield's matching value such as 200avalue

-insert

— if set, only insert when possible

-update

— if set, only updates (any biblio should have a matching record)

-all

— if set, do whatever is required

-k, -keepids=<FIELD>

— Field store ids in FIELD (usefull for authorities, where 001 contains the authid for Koha, that can contain a very valuable info for authorities coming from LOC or BNF. useless for biblios probably)

-match=<FIELD>

— FIELD matchindex,fieldtomatch matchpoint to use to deduplicate fieldtomatch can be either 001 to 999 or field and list of subfields as such 100abcde

-i,-isbn

— If set, a search will be done on isbn, and, if the same isbn is found, the biblio is not added. It's another method to deduplicate. -match & -isbn can be both set.

-cleanisbn

— Clean ISBN fields from entering biblio records, ie removes hyphens. By default, ISBN are cleaned. --nocleanisbn will keep ISBN unchanged.

-x=TAG

— Source bib TAG for reporting the source bib number

-y=SUBFIELD

— Source SUBFIELD for reporting the source bib number

-idmap=FILE

— FILE for the koha bib and source id

-keepids

— Store ids in 009 (usefull for authorities, where 001 contains the authid for Koha, that can contain a very valuable info for authorities coming from LOC or BNF. useless for biblios probably)

-dedupbarcode

— If set, whenever a duplicate barcode is detected, it is removed and the attempt to add the record is retried, thereby giving the record a blank barcode. This is useful when something has set barcodes to be a biblio ID, or similar (usually other software.)

-framework

— This is the code for the framework that the requested records will have attached to them when they are created. If not specified, then the default framework will be used.

-custom=MODULE

— This parameter allows you to use a local module with a customize subroutine that is called for each MARC record. If no filename is passed, LocalChanges.pm is assumed to be in the migration_tools subdirectory. You may pass an absolute file name or a file name from the migration_tools directory.