2. Особливості протоколу oai-pmh

   1. OAI-PMH запити

OAI-PMH запити виражаються у вигляді запитів HTTP. Типова реалізація використовує стандартний веб-сервер, який налаштований на відправку OAI-PMH запитів та програмне забезпечення для обробки цих запитів. OAI-PMH запити повинні бути представлені за допомогою HTTP GET або POST методів. Сховища повинні підтримувати як GET, так і POST методи. Існує єдина база URL для всіх запитів. Базовий URL визначає інтернет хост і порт та шлях із сервера HTTP, що служить сховищем. Сховища виставляють свій базовий URL як значення елемента baseURL в Identify відповіді. На додаток до базового URL, всі запити складаються зі списку ключових аргументів, які приймають форму key=value (ключ = значення). Аргументи можуть з'являтися в будь-якому порядку, а багатозначні аргументи повинні відокремлюватись один від одного амперсандом [&].Кожен запит OAI-PMH повинен мати щонайменше одну пару key=value, що конкретизує цей запит, виданий харвестером [4].

2. OAI-PMH відповіді

Усі відповіді на OAI-PMH запити формуються у вигляді XML-документів. XML-дані, що отримані внаслідок виконання OAI-PMH запитів перевіряються по XML-схемі валідації відповідей. Відповіді на OAI-PMH запити включають такі пункти:

1. Перший тег містить зазначення версії та кодування XML

(<?xml version="1.0" encoding="UTF-8" ?>)

2. Залишковий контент укладено в кореневий елемент з ім'ям OAI-PMH. Цей елемент повинен мати три властивості, які визначають простір імен XML, що використовуються у відповіді та розташування схеми валідації

• xmlns - значення, яке має бути простором імен URI протоколу OAI-PMH (http://www.openarchives.org/OAI/2.0/);

• xmlns:xsi - значення, яке повинне бути простором імен URI XML-схеми (http://www.w3.org/2001/XMLSchema-instance)

• xsi:schemaLocation - це пара, першою частиною якої є простір імен URI OAI-PMH (http://www.openarchives.org/OAI/2.0/), і друга частина - URL XML-схеми для перевірки відповідей (http://www.openarchives.org/OAI/2.0/OAI-PMH.xsd).

3. Наступні два елементи що йдуть після кореневого є:

• responseDate - UTCdatetime із зазначенням часу та дати, коли відповідь була надіслана. Має бути виражене в стандарті UTC (Coordinated Universal Time).

• request -- вказує протокол запиту, який створює відповідь.

4. Третім елементом після коренового є:

• помилки елементів;

• елемент з тим же ім'ям, що й дієслово відповідного OAI-PMH запита.

Зразки виконання запитів наведені у додатках (додаток А, додаток Б, додаток В)[2].

3. Повідомлення про помилки

У випадку, коли трапляються помилки, сховище повинне зазначати це в протоколі; відповідь на запит може включати декілька елементів помилок. Сховища повинні повідомляти про всі помилки, які виникають при обробці запиту. Кожен елемент помилки повинен мати атрибут коду, який зазначається з нового рядка, також елемент помилки може мати значення вільного текстового рядка та має можливість надавати інформацію про помилку, яка є корисною для користувача. Всі види помилок, які можуть виникати при обробці запитів наведені в таблиці 1.1. [4].

Таблиця 1.1.