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

Матеріал з Koha Ukraine Wiki
Перейти до навігації Перейти до пошуку
Рядок 105: Рядок 105:
'''-k, -keepids='''''<ПОЛЕ>''
'''-k, -keepids='''''<ПОЛЕ>''


— зберігати ідентифікатори у ''ПОЛІ'' (корисно для авторитетних записів, коли поле 001 містить ідентифікатор „authid“ Koha, яка може містити цінну інформацію для авторитетних записів, що надходять з БК (LC) або НБФ (BNF). Мало користі для бібліографічних записів).
— зберігати ідентифікатори у ''ПОЛІ'' (корисно для авторитетних записів, коли поле 001 містить ідентифікатор „authid“ Koha, яка може містити цінну інформацію для авторитетних записів, що надходять з БК (LOC) або НБФ (BNF). Мало користі для бібліографічних записів).


'''-match='''''<ПОЛЕ>''
'''-match='''''<ПОЛЕ>''
Рядок 117: Рядок 117:
'''-cleanisbn'''
'''-cleanisbn'''


— очищати ISBN-поля при внесенні у бібліографічні записи, тобто вилучати дефіси. Типово ISBN очищатимуться.
— Clean ISBN fields from entering biblio records, ie removes hyphens. By default, ISBN are cleaned. --nocleanisbn will keep ISBN unchanged.
— ОчиЧисті поля ISBN вводяться у бібліографічні записи, тобто видаляються дефіси. За замовчуванням ISBN очищено. - nocleanisbn збереже ISBN без змін.


'''-x=TAG'''
'''-nocleanisbn'''


— збереже ISBN без змін.
— Source bib TAG for reporting the source bib number


'''-y=SUBFIELD'''
'''-x='''''ОЗНАКА''


— біб-''ОЗНАКА'' джерела для звітування джерельного біб-номера
— Source SUBFIELD for reporting the source bib number


'''-idmap=FILE'''
'''-y='''''ПІДПОЛЕ''


— ''ПІДПОЛЕ'' джерела для звітування джерельного біб-номера
— FILE for the koha bib and source id

'''-idmap='''''ФАЙЛ''

— ''ФАЙЛ'' для koha bib та ідентифікатора джерела


'''-keepids'''
'''-keepids'''


— зберігати ідентифікатори в полі 009 (корисно для авторитетних записів, де поле 001 містить ідент. „authid“ Koha, що може містити цінну інформацію для авторитетних записів, що надходять з БК (LOC) або НБФ (BNF), Це непридатне для біб-записів).
— 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'''
'''-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'''
'''-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='''''МОДУЛЬ''


— цей параметр дозволяє використовувати локальний модуль із підпрограмою налаштування, яка викликається для кожного MARC-запису. Якщо ім’я файлу не вказано, використовуватиметься LocalChanges.pm, що знаходиться у теці „migration_tools“. Ви можете передати абсолютне ім'я файлу або ім'я файлу з теки „migration_tools“.
— 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.


== Джерела ==
== Джерела ==

Версія за 17:09, 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=ФАЙЛ

ФАЙЛ, який імпортуємо

-v

— багатослівний режим. 1 означає „деяку інформацію“, 2 означає „MARC-видрук“

-fk

— відключає перевірку зовнішніх (foreign) ключів під час імпорту.

-n=КІЛЬКІСТЬ

КІЛЬКІСТЬ записів записів для імпорту. Якщо відсутня, весь файл імпортується.

-o, -offset=КІЛЬКІСТЬ

— зміщення у файлі перед імпортом, тобто КІЛЬКІСТЬ записів, які потрібно пропустити.

-commit=КІЛЬКІСТЬ

КІЛЬКІСТЬ записів, на які потрібно чекати, перш ніж виконати операцію „commit“ (вставки в БД).

-l

— журналються у файл події, виконані для кожного запису та його статусу

-append

— якщо вказано, журнальний файл буде доповнений даними. Якщо ні, файл журналу витиратиметься перед кожним виконанням.

-t, -test

— режим тестування: аналізує файл, повідомляє що буде робити, але нічого не робить.

-s

— пропускає автоматичне перетворення MARC-8 в UTF-8. Ця опція передбачена для відлагодження.

-c=РІЗНОВИД

РІЗНОВИД MARC-стандату. На даний момент підтримуються лише MARC21 та UNIMARC. MARC21 за умовчанням.

-d

— вилучити усе, що стосується бібліографічних записів у БД Koha перед імпортом. Таблиці: biblio та biblioitems (біб-записи), items (примірники).

-m=ФОРМАТ

— вхідний ФОРМАТ файлу: MARCXML або ISO2709 (типово ISO2709).

-authtypes

— yaml-файл з authoritiesTypes та відмітним полем запису для того, щоб зберегти правильний тип authtype

-yaml

— yaml-файл для виводу ідентифікаторів

-filter

— список полів, які не будуть імпортовані. Може бути будь-яке з 000 до 999 полів, підполів чи відповідність підполя значенню, наприклад, 200aзначення

-insert

— якщо вибрано, намагатися лише вставляти, коли це можливо

-update

— якщо вибрано, лише оновлювати (кожен бібліографічний запис повинен мати відповідний запис)

-all

— якщо вибрано, робити все, що потрібно

-k, -keepids=<ПОЛЕ>

— зберігати ідентифікатори у ПОЛІ (корисно для авторитетних записів, коли поле 001 містить ідентифікатор „authid“ Koha, яка може містити цінну інформацію для авторитетних записів, що надходять з БК (LOC) або НБФ (BNF). Мало користі для бібліографічних записів).

-match=<ПОЛЕ>

ПОЛЕ matchindex,fieldtomatch matchpoint, що використовується для дедуплікації fieldtomatch, може бути або від 001 до 999 або поле і список підполів на кшталт 100abcde

-i,-isbn

— якщо вибрано, відбуватиметься пошук за ISBN, і якщо знайдено такий самий ISBN, біб-запис не буде додано. Це ще один спосіб дедуплікації. Параметри -match & -isbn можуть використовуватися разом.

-cleanisbn

— очищати ISBN-поля при внесенні у бібліографічні записи, тобто вилучати дефіси. Типово ISBN очищатимуться.

-nocleanisbn

— збереже ISBN без змін.

-x=ОЗНАКА

— біб-ОЗНАКА джерела для звітування джерельного біб-номера

-y=ПІДПОЛЕ

ПІДПОЛЕ джерела для звітування джерельного біб-номера

-idmap=ФАЙЛ

ФАЙЛ для koha bib та ідентифікатора джерела

-keepids

— зберігати ідентифікатори в полі 009 (корисно для авторитетних записів, де поле 001 містить ідент. „authid“ Koha, що може містити цінну інформацію для авторитетних записів, що надходять з БК (LOC) або НБФ (BNF), Це непридатне для біб-записів).

-dedupbarcode

— якщо вибрано, то у випадку коли виявляється дублікат штрих-коду, він видаляється, і повторюється спроба додати запис, тим самим даючи запис з порожнім штрих-кодом. Це корисно, коли хтось встановлював штрих-коди відповідні ідентифікаторам біб-записів чи якось подібно (зазвичай це прийшло з іншого ПЗ).

-framework

— це код структури, до якої запитані записи будуть додаватися, коли вони будуть створені. Якщо не вказано, тоді використовуватиметься структура за умовчанням.

-custom=МОДУЛЬ

— цей параметр дозволяє використовувати локальний модуль із підпрограмою налаштування, яка викликається для кожного MARC-запису. Якщо ім’я файлу не вказано, використовуватиметься LocalChanges.pm, що знаходиться у теці „migration_tools“. Ви можете передати абсолютне ім'я файлу або ім'я файлу з теки „migration_tools“.

Джерела