Как загрузить статьи в DOAJ: вручную, XML, CSV и API
Обновлено:
Журнал принят в DOAJ — теперь нужно, чтобы там появились его статьи. DOAJ не собирает их сам: метаданные каждой статьи загружает издатель. Разберём все способы, требования к данным и ошибки, из-за которых статьи дублируются или не принимаются.
Что нужно до начала
- Журнал должен быть в DOAJ, а вы — входить в аккаунт издателя, к которому он привязан. Загрузить статьи чужого журнала нельзя.
- ISSN статьи должны совпадать с записью журнала. По правилам DOAJ число ISSN в метаданных статьи должно совпадать с тем, что указано у журнала: если у журнала есть и печатный, и электронный ISSN, указывайте оба.
- У каждой статьи — ссылка на полный текст. Это обязательное поле: страница статьи или PDF на сайте журнала.
Способ 1. Вручную через форму на сайте DOAJ
В личном кабинете издателя есть форма добавления статьи. Подходит, если статей единицы: каждую нужно заполнить целиком, включая всех авторов.
Способ 2. XML-файл
Самый распространённый способ для выпусков целиком. DOAJ принимает три формата:
- DOAJ Native XML — собственный формат DOAJ;
- Crossref XML 4.4.2 и Crossref XML 5.3.1 — если вы регистрируете DOI в Crossref, тот же файл подходит и для DOAJ.
Если журнал работает на OJS, XML для DOAJ можно выгрузить плагином и загрузить сразу. Файл, собранный вручную, перед загрузкой стоит проверить по XML-схеме DOAJ.
Обязательные элементы DOAJ XML: название журнала, хотя бы один ISSN, дата публикации, название статьи и ссылка на полный текст. Остальное — авторы, ORCID, аффилиации, аннотация, ключевые слова, DOI, том, выпуск, страницы — необязательно, но без этого запись в DOAJ получается неполной и хуже находится.
Способ 3. DOAJ API
API нужен, если статьи загружает программа: сайт журнала, редакционная система или скрипт. Ключ API выдаётся издателям; он находится в личном кабинете DOAJ в разделе настроек аккаунта. Через API можно:
- создавать, изменять и удалять статьи по одной;
- загружать пакеты статей (bulk) и проверять статус загрузки.
DOAJ ограничивает частоту запросов: 2 запроса в секунду, кратковременно до 5. Пакеты при массовой загрузке DOAJ советует делать около 600 КБ, чтобы не упереться в тайм-аут обработки.
Способ 4. CSV или Excel через API
У самого DOAJ загрузки из Excel нет, но её можно сделать поверх API. В DOAJ Metadata Studio вы заполняете таблицу по шаблону, приложение проверяет каждую строку и отправляет статьи в DOAJ пакетами по 600 КБ. Подробно — в инструкции Массовая загрузка статей в DOAJ из Excel и CSV.
Загрузите одну статью через форму с проверкой ISSN, ORCID и DOI или целый выпуск из Excel.
Открыть редактор статьиКак DOAJ распознаёт дубли
Это главное, что нужно знать перед повторной загрузкой. Если вы загружаете статью с тем же DOI или той же ссылкой на полный текст, что у уже загруженной статьи вашего аккаунта, DOAJ считает её дублем и перезаписывает старую запись новыми данными. Так работают и форма, и XML, и API.
Ловушка: статьи без DOI и смена адреса сайта. Если у статьи нет DOI, DOAJ узнаёт её только по ссылке на полный текст. Журнал переехал на новый домен и загрузил архив заново — в DOAJ окажутся две копии каждой такой статьи: со старой и с новой ссылкой. Мы видели это на реальном журнале: почти три сотни дублей за одну загрузку.
Перед повторной загрузкой архива проверьте журнал на дубли — это делает вкладка «Экспорт и сверка».
Частые ошибки
| Проблема | Что делать |
|---|---|
| Статья не принимается из-за ISSN | Укажите ISSN точно как у журнала в DOAJ и в том же количестве: оба, если у журнала их два. |
| Нет ссылки на полный текст | Добавьте ссылку типа fulltext на страницу статьи или PDF. |
| Ключевых слов больше шести | DOAJ сохраняет только первые 6 — выберите самые важные. |
| ORCID в виде номера | Указывайте полную ссылку: https://orcid.org/0000-0002-1825-0097. |
| Опечатки в именах, DOI, ссылках | DOAJ не проверяет качество метаданных при загрузке — за него отвечает издатель. Исправлять ошибки потом придётся вам. |
Как проверить результат
После загрузки откройте вкладку «Экспорт и сверка», введите ISSN журнала и посмотрите сводку: сколько статей без DOI, аннотаций, ключевых слов и ORCID, есть ли дубли. Сверка со списком DOI покажет, какие статьи не дошли до DOAJ.
Посмотрите, как выглядит проверка на реальном журнале.
Запустить пример проверки