Преминете към основното съдържание

OMI-SPEC-221 — Архитектура на справочната библиотека и регистъра

Статус​

Чернова

Версия: 0.1.0

Старият идентификатор: OMI-SPEC-007

Цел​

Настоящата спецификация определя как приложенията, използващи протокола „OMI“, откриват, идентифицират, събират, използват повторно, синхронизират и експортират библиографски записи за даден ръкопис.

Архитектурата е проектирана около прост работен процес за авторите:

  1. да добавите цитираното произведение веднъж;
  2. да го използвате отново на различни места в ръкописа;
  3. цитирайте го с точни указатели;
  4. да актуализира метаданните си, без да пренаписва всяко цитиране;
  5. експортиране на ръкописа и библиографията в различни издателски системи.

Архитектурни слоеве​

External bibliographic services and catalogues
                    ↓
          Resolution and reconciliation
                    ↓
       Manuscript Reference Library
                    ↓
           Citation Occurrences
                    ↓
       Rendering and publication exports

Слоевете са разделени умишлено.

  • Външните услуги спомагат за откриването и обогатяването на записите.
  • В справочната библиотека се съхраняват избрани записи от ръкописа.
  • Позоваванията сочат към записи в библиотеката.
  • Рендерите генерират бележки под линия, цитати по автор и дата, библиографии, връзки и структурирани файлове за експортиране.

Библиотека с ръкописи​

Всеки ръкопис може да съдържа или да се позовава на специална библиотека с произведения, използвани в този ръкопис.

Библиотеката не е просто форматиран списък с литература. Тя представлява колекция от структурирани Bibliographic Records.

{
  "referenceLibrary": {
    "records": [
      "bib_01JXYZ",
      "bib_01JXYA"
    ]
  }
}

Даден запис може да съществува в библиотеката, преди да бъде цитиран. Това улеснява съставянето на предварителни списъци с литература, събирането на източници, редакционната проверка и последващото им добавяне.

Добавете веднъж, цитирайте многократно​

Когато даден автор добави произведение, OMI създава или използва вече съществуващ библиографски запис.

Всяко появяване на цитат сочи към този запис:

Reference Library
└── bib_01: Example Book
    ├── Citation 1: p. 12
    ├── Citation 2: pp. 55–57
    └── Citation 3: chapter 4

По този начин се избягва многократното въвеждане на метаданни и се гарантира последователно представяне.

Откриване и импортиране​

Приложенията могат да поддържат няколко метода за въвеждане:

  • DOI търсене;
  • Търсене по ISBN;
  • Импортиране на URL адреси;
  • търсене по заглавие или автор;
  • търсене на идентификатор на хранилище;
  • търсене в каталога на библиотеката;
  • поставяне на форматирана препратка;
  • импортиране на CSL JSON, BibTeX, BibLaTeX, RIS, EndNote XML или други поддържани формати;
  • ръчно въвеждане;
  • избор от друг ръкопис в „OMI“ или от библиотеката на потребителя.

Импортираните данни трябва да бъдат нормализирани съгласно модела на библиографския запис, като се запази произходът на източника.

Външни източници​

Една реализация на „OMI“ може да извършва заявки към публични или оторизирани услуги, като например:

  • Crossref
  • DataCite
  • OpenAlex
  • PubMed
  • Europe PMC
  • ORCID
  • ROR
  • библиотечни каталози
  • институционални хранилища
  • дисциплинарни хранилища
  • национални библиографии
  • архивни каталози

Архитектурата не изисква наличието на един централен доставчик.

OMI определя интерфейси и изисквания към данните, така че имплементациите да могат да комбинират няколко доставчика и да продължат да функционират, когато един от доставчиците е недостъпен.

Без централизиран библиографски монопол​

OMI не бива да се създава задължителна централна база данни, към която всеки ръкопис трябва да се обръща.

Един валиден ръкопис от типа „OMI“ трябва да остава използваем, когато:

  • оригиналната услуга за търсене е изключена;
  • авторът преминава към друга реализация на OMI;
  • издателят обработва ръкописа в среда без интернет връзка;
  • външен запис се променя или изчезва.

Следователно ръкописът или пакетът с него трябва да съдържат библиографските данни, необходими за тълкуването и представянето на цитираните източници.

Външните услуги са източници за откриване и обогатяване на данни, а не единствени източници на достоверна информация или достъпност.

Работен процес по разрешаване на проблеми​

Типичната последователност от стъпки е:

User input
   ↓
Identifier normalization
   ↓
Provider lookup
   ↓
Candidate records
   ↓
Reconciliation and deduplication
   ↓
User or automated selection
   ↓
Local bibliographic record

Резолверът трябва да върне:

  • записи за кандидатите;
  • съвпадащи идентификатори;
  • време за извличане и получаване;
  • увереност;
  • конфликти;
  • места за достъп;
  • предупреждения за оттегляния, поправки или неясна идентичност, когато има такива.

Помирение​

Различните доставчици могат да предоставят различни метаданни за едно и също произведение.

При съгласуването трябва да се вземат предвид:

  • постоянни идентификатори;
  • нормализирано заглавие;
  • имена и идентификатори на сътрудниците;
  • година на издаване;
  • заглавие на контейнера;
  • том, брой и страници;
  • издание и версия;
  • език;
  • източникът и актуалността.

Системата не трябва да избира без предупреждение стойност, която е в противоречие, когато това противоречие може да засегне научното значение.

Възможните резултати включват:

  • точно съвпадение;
  • вероятно съвпадение;
  • отделна версия;
  • връзка между превода и изданието;
  • нерешен конфликт;
  • отделен запис.

Местни и споделени библиотеки​

Реализациите могат да поддържат няколко обхвата:

  • библиотека с ръкописи;
  • работно пространство или библиотека с проекти;
  • лична библиотека;
  • институционална библиотека;
  • публична споделена колекция.

Всяка ръкопис трябва да посочва кои записи са част от неговия авторитетен пакет, дори когато тези записи произхождат от споделена библиотека.

Актуализациите на споделен запис не трябва автоматично да променят подаден или публикуван ръкопис, освен ако не е взето изрично решение за версиониране.

Вмъкване на цитат​

Редакторът трябва да дава възможност на авторите да търсят в библиотеката с ръкописи и да вмъкват цитати, без да се налага да въвеждат отново библиографските метаданни.

При вмъкването на цитати може да се събират:

  • тип и стойност на локатора;
  • префикс;
  • суфикс;
  • режим на цитиране;
  • изключване на името на автора или датата, когато това е оправдано;
  • цел или връзка на цитирането;
  • бележка или коментар.

Вмъкнатият обект се подчинява на стандарта „Citation Model“.

Онлайн достъп и предварителен преглед​

Когато библиографският запис съдържа онлайн адрес, приложението може да предлага:

  • отвори началната страница;
  • отвори пълния текст;
  • показване на резюме или преглед на метаданните;
  • показване на наличността на хранилището;
  • показване на лиценза и условията за достъп;
  • вграждайте съдържание, когато това е технически и правно допустимо.

OMI трябва да се прави разграничение между:

  • наличност на метаданни;
  • обществен достъп до ресурса;
  • разрешение за вграждане;
  • разрешение за преразпространение.

Самият URL адрес не означава, че имате права за преразпространение.

Списъци с източници и списъци с литература​

Един библиотечен запис може да има състояние, специфично за даден ръкопис:

  • цитирано;
  • без източник;
  • допълнителна литература;
  • изключен от окончателния списък с литература;
  • проверено от редакцията;
  • изисква проверка.

Профилите за публикации определят кои щати се появяват в изведената библиография.

Това е подходящо за дисциплини, в които списъците с източници, архивните описи, списъците с първични източници или разделите с допълнителна литература се различават от традиционните библиографии.

Предотвратяване на дублирането​

Преди добавянето на нов запис, приложението трябва да провери библиотеката с ръкописи и съответните споделени библиотеки.

При вероятен дубликат трябва да се покаже съществуващият запис и да се обясни на какво се основава съвпадението.

Потребителят може:

  • да се използва отново съществуващият запис;
  • обединяване на записи;
  • поддържайте отделни версии;
  • отхвърли предложеното съвпадение.

При обединяването трябва да се запазят идентификаторите, произходът, локалните корекции и предишните връзки към цитати.

Работа в офлайн режим​

Основното управление на референциите трябва да функционира без постоянен достъп до мрежата.

Реализациите с възможност за работа офлайн трябва да позволяват:

  • ръчно създаване на записи;
  • вмъкване на цитати от записи в кеша;
  • визуализация на библиографията;
  • решаване и валидиране в опашката;
  • по-късна синхронизация с външни източници.

Подобренията, свързани с мрежовата среда, не трябва да правят ръкописа неразбираем или неподходящ за цитиране.

Синхронизация и контрол на промените​

Външните метаданни могат да се променят след импорта. Реализациите на OMI могат да предлагат операции за обновяване, но актуализациите трябва да подлежат на преглед.

При сравнението на актуализациите трябва да се прави разграничение между:

  • новодобавени полета;
  • разлики, свързани единствено с форматирането;
  • коригирани метаданни;
  • противоречащи си метаданни;
  • промени във версията или състоянието;
  • премахнати или пренасочени места за достъп.

Приетите актуализации създават нова ревизия на записа. Публикуваните версии на ръкописа запазват библиографския статус, използван за съответната публикация.

Валидиране​

При проверката на референтната библиотека може да се отчете следното:

  • неразрешени записи;
  • дублиращи се записи;
  • липсват задължителни метаданни;
  • неправилно оформени идентификатори;
  • неработещи или пренасочени връзки;
  • цитирани записи, които липсват в библиотеката;
  • неизползвани записи;
  • оттеглени или коригирани цели;
  • несъответствия в датите, обемите, броя на изданията или номерацията на страниците;
  • неподдържани типове ресурси;
  • конфликти в метаданните между източниците.

Правилата за валидиране могат да се конфигурират според профилите на публикациите и дисциплините.

Внос и износ​

Библиотеката трябва да поддържа оперативно съвместим обмен чрез формати като:

  • CSL JSON
  • BibTeX
  • BibLaTeX
  • RIS
  • JATS XML
  • Crossref XML
  • DataCite XML или JSON
  • MODS
  • Dublin Core
  • Формати, съвместими със Zotero

При износ трябва да се запазват стабилните идентификатори OMI, когато целевият формат позволява добавяне на разширения.

Пълният пакет „OMI“ трябва да съдържа достатъчно библиографски метаданни, за да може цитатите да се визуализират и валидират без да се налага да се правят запитвания към външни услуги.

API Отговорности​

Една референтна услуга API може да предоставя операции като:

search(query, providers)
resolve(identifier)
import(record, source)
reconcile(candidates)
addToLibrary(recordId, manuscriptId)
mergeRecords(sourceIds, targetId)
refresh(recordId)
validateLibrary(manuscriptId)
exportLibrary(manuscriptId, format)

Спецификацията определя поведението и договорите за данни, а не конкретен задължителен мрежов протокол или език за реализация.

Поверителност и сигурност​

При внедряването трябва да се има предвид, че референтните колекции могат да разкрият изследователски интереси, непубликувани проекти, сътрудници и чувствителни източници.

Изискванията включват:

  • явен контрол върху споделянето;
  • достъп с минимални права до библиотеките на работната среда;
  • няма задължително публично разкриване на документи, за които няма позовавания;
  • ясни искания от доставчиците и уведомления за поверителност;
  • защита срещу злонамерени импортирани метаданни;
  • безопасно боравене с URL адреси на външни сайтове и вградени прегледи.

Пример за работния процес​

  1. Авторът се регистрира в DOI.
  2. Резолверът изпраща заявки към конфигурираните доставчици.
  3. Метаданните на кандидатите са съгласувани.
  4. Избраната работа се съхранява като „bib_01JXYZ“ в библиотеката с ръкописи.
  5. Авторът цитира страници 12 и 45–47.
  6. Редакторът проверява записа.
  7. Профилът на публикацията съдържа бележки под линия и библиография.
  8. Одобреният ръкопис експортира структурирани библиографски записи към JATS, XML и метаданни на Crossref.

Бъдещи задачи​

Бъдещите спецификации могат да определят:

  • федеративни публични библиографски регистри;
  • подписани или проверими твърдения за метаданни;
  • обмен на графики с цитати;
  • речници за целта на цитиране;
  • услуги за контрол на авторитетите;
  • съвместно подбиране на записи;
  • оценяване на произхода;
  • връзки между цитираните твърдения и точните пасажи от източника.

Хронология на промените​

  • 0.1.0 — Прехвърлено от временния адрес OMI-SPEC-007 към основния адрес OMI-SPEC-221.

Обобщение​

Архитектурата на справочната библиотека и регистъра позволява на авторите да добавят дадено произведение само веднъж и да го цитират последователно в целия текст на ръкописа.

Тя съчетава външно търсене с преносима библиотека на ниво ръкопис, избягва зависимостта от един доставчик, поддържа работни процеси както онлайн, така и офлайн, запазва проследимостта и позволява надежден експорт към системи за научно публикуване.