Bulkmarcimport.pl
Назва
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=<ПОЛЕ>
— зберігати ідентифікатор запису у ПОЛІ (напр. 009 чи 900a) (корисно для авторитетних записів, коли поле 001 містить ідентифікатор „authid“ Koha, водночас джерельне 001 може містити цінну інформацію про авторитетні записи, що надходять з БК (LOC) або НБФ (BNF). Мало користі для бібліографічних записів).(±)
-match=<ПОЛЕ>
— ПОЛЕ matchindex,fieldtomatch matchpoint, що використовується для дедуплікації fieldtomatch, може бути або від 001 до 999 або поле і список підполів на кшталт 100abcde
-i,-isbn
— якщо вибрано, відбуватиметься пошук за ISBN, і якщо знайдено такий самий ISBN, біб-запис не буде додано. Це ще один спосіб дедуплікації. Параметри -match & -isbn можуть використовуватися разом.
-cleanisbn
— очищати ISBN-поля при внесенні у бібліографічні записи, тобто вилучати дефіси. Типово ISBN очищатимуться.
-nocleanisbn
— збереже ISBN без змін.
-x=ОЗНАКА
— біб-ОЗНАКА джерельного біб-номера (±)
-y=ПІДПОЛЕ
— ПІДПОЛЕ джерельного біб-номера (використовується для ознак >= 10) (±)
-idmap=ФАЙЛ
— ФАЙЛ-мапа з експортом джерельних біб-номерів та biblionumber з Koha (±)
-dedupbarcode
— якщо вибрано, то у випадку коли виявляється дублікат штрих-коду, він видаляється, і повторюється спроба додати запис, тим самим даючи запис з порожнім штрих-кодом. Це корисно, коли хтось встановлював штрих-коди відповідні ідентифікаторам біб-записів чи якось подібно (зазвичай це прийшло з іншого ПЗ).
-framework
— це код структури, до якої запитані записи будуть додаватися, коли вони будуть створені. Якщо не вказано, тоді використовуватиметься структура за умовчанням.
-custom=МОДУЛЬ
— цей параметр дозволяє використовувати локальний модуль із підпрограмою налаштування, яка викликається для кожного MARC-запису. Якщо ім’я файлу не вказано, використовуватиметься LocalChanges.pm (пр. тут), що знаходиться у теці „migration_tools“. Ви можете передати абсолютне ім'я файлу або ім'я файлу з теки „migration_tools“.
Джерела
- https://perldoc.koha-community.org/misc/migration_tools/bulkmarcimport.html
- http://git.koha-community.org/gitweb/?p=koha.git;a=blob;f=misc/migration_tools/bulkmarcimport.pl;h=9a3b44c2826b71067abe58ab98f7bd6cd58f35ce;hb=refs/heads/master
- https://github.com/Koha-Community/Koha/blob/master/misc/migration_tools/bulkmarcimport.pl