SRU — Сеть разработчиков Ex Libris

Сеть разработчиков Ex Libris Документация Alma Интеграции SRU

Введение

SRU (Поиск/получение по URL-адресу) Language) и стандартный синтаксис запросов для представления запросов. В контексте библиотек SRU в основном используется для поиска и извлечения библиографических записей из каталога.

ПОДРОБНЕЕ В БЛОГАХ

Альма дает учреждениям возможность быть целью SRU. В Alma поддерживаются следующие основные операции SRU:

• объяснение
• searchRetrieve

Базовый URL-адрес для запросов SRU: https://<домен Alma>/view/sru/<код учреждения>

Примечание. учреждение должно включить целевую функциональность SRU. По умолчанию он не включен. Это делается путем определения внешнего профиля «SRU» в Alma. Дополнительную информацию см. в интерактивной справке Alma. Кроме того, учреждение может решить включить в ответ информацию о доступности. Обратитесь к интерактивной справке Alma для получения дополнительной информации о настройке «включить доступность».

Операция объяснения

Операция объяснения позволяет клиенту получить описание средств, доступных на сервере SRU. Затем он может использоваться клиентом для самостоятельной настройки и предоставления пользователю соответствующего интерфейса. Ответ включает список всех доступных для поиска индексов. Это индексы, настроенные учреждением как разрешенные в «Расширенном поиске» в Alma. Их можно использовать для операции searchRetrieve. Сортируемые индексы имеют указание «sort=true».

Обратите внимание, что каждое учреждение может настроить свой набор индексов.

Обратите внимание, что использование индексов разных ресурсов в одном поисковом запросе не поддерживается.

Например, поисковый запрос со штрих-кодом и идентификатором услуги не даст никаких результатов.

Запрос

Имя параметра	Обязательный/Необязательный	тип	Описание
Обязательный	строка	Версия протокола SRU. Должно быть «1.2»
операция	Обязательно	строка	Конкретная операция SRU. Должен быть ‘explain’

Например: https://<домен Alma>/view/sru/?version=1.2&operation=explain

Ответ

См. ответ с пояснением от песочницы Alma’s Guest

Операция SearchRetrieve

Операция searchRetrieve является основной операцией SRU. Это позволяет клиенту отправить запрос на поиск и получение соответствующих записей с сервера.

Request

Parameter name	Mandatory /Optional	type	Description
version	Mandatory	string	SRU protocol version. Должно быть «1.2» [версия 1.1 доступна, но не рекомендуется]
операция	Обязательно	строка	Конкретная операция SRU. Должно быть «searchRetrieve»
запрос	Обязательный	строка	Содержит запрос, выраженный в CQL, для обработки сервером. См. ниже дополнительную информацию о запросах CQL, поддерживаемых в Alma.
startRecord	Необязательный	число	Позиция в последовательности совпадающих записей первой возвращаемой записи. Первая позиция в последовательности — 1. Предоставленное значение должно быть больше 0. По умолчанию: 1.
maxRecords	Дополнительно	число	Количество записей, которые необходимо вернуть. Значение должно быть от 0 до 50. По умолчанию: 10
recordSchema	Необязательный	строка	Схема, запрошенная для возвращаемых записей. Currently, the supported values ​​are: marcxml dc dcx mods unimarcxml kormarcxml cnmarcxml isohold  (стандарт ISO 20775) Поддерживаемые схемы перечислены в разделе объяснения документа schemaInfo. Примечание : при отсутствии перекрестного перехода между форматами возвращается формат, в котором была изначально создана запись.

Например: 1.2&operation=searchRetrieve&recordSchema=marcxml&query=alma.all_for_ui=история

Запросы CQL

Оператор поиска SRU выражается в синтаксисе CQL.

Общий язык запросов

(CQL) — это формальный язык для представления запросов к системам поиска информации, таким как веб-индексы, библиографические каталоги и информация о музейных коллекциях. Цель разработки состоит в том, чтобы запросы были доступны для чтения и записи человеком, а язык был интуитивно понятным, сохраняя при этом выразительность более сложных языков.

Запрос CQL состоит из одного предложения поиска или нескольких предложений поиска, связанных логическими операторами. Каждое предложение поиска состоит из следующих компонентов: индекс, отношение и условие поиска.

• Доступные для поиска индексы перечислены в ответе операции объяснения и являются индексами, которые        поддерживаются в расширенном поиске Alma.
• Операторы отношений, поддерживаемые SRU, которые согласованы с расширенным поиском Alma:
  • Для всех полей индекса поддерживаются отношения «=» (содержит фразу) и «все» (содержит слова).
  • Для поисковых индексов, которые являются числовыми, датами или диапазонами, ‘<' (меньше), '>‘ (больше), ‘<=' (меньше и равно), '>=’ (больше и равно) , ‘==’ (равно), ‘<>‘ (не равно) поддерживаются отношения.
  • Символ «*» можно использовать в качестве подстановочного знака с оператором «все». Например, «название всего мира*» [найти записи, в которых заголовок содержит строку: «Мир», например. «Всемирная история»].
  • Для поиска пустой строки Alma поддерживает использование ==””. Например, title==”” [найти записи с пустым заголовком].
  • Оператор «==» также можно использовать для поиска фразы, содержащей тире или подчеркивание.
• Условия поиска должны быть заключены в двойные кавычки, если они содержат любой из следующих символов: < > = / ( )  и пробел.

Исключение подавленных записей

По умолчанию поиск SRU возвращает также подавленные записи.

Запрос можно ограничить, чтобы он возвращал только непогашенные записи, добавив в поисковый запрос «alma.mms_tagSuppressed=false».

Например:  query=alma.issn=1234%20 и %20alma.mms_tagSuppressed=false

Sort

. Спецификация сортировки включается в конец запроса CQL в следующем формате:

sortBy index/sort. descending или sortBy index/sort.ascending

Например: <базовый URL>?version=1.2&operation=searchRetrieve&recordSchema= marcxml&query=alma.title=t sortBy alma.title/sort.descending

Для сортировки можно использовать индексы с указанием sort=”true” в ответе объяснения .

Ответ

Ответ на запрос SRU searchRetrieve представляет собой XML-документ. В таблице ниже представлены сводка и описание элементов, представленных в XML-документе:

Элемент	Обязательный/необязательный	тип	Описание
059	Обязательный	string	1.2 [версия 1.1 доступна, но устарела]
numberOfRecords	Обязательный	число	Записи, совпавшие по номеру	. Если запрос не выполнен, это будет 0.
Записи	Необязательно	последовательность	Последовательность записей, соответствующих запросу или суррогатной диагностике. Поскольку в настоящее время поддерживается схема marcxml, записи должны быть возвращены в соответствии с форматом схемы marc21 xml.
диагностики	Дополнительно	последовательность	Последовательность несуррогатных диагностических данных, сгенерированных во время выполнения, в случае сбоя запроса. Структура включает следующие поля: uri — номер ошибки Message — сообщение об ошибке См. Diagnostic.xsd

Примечание : подавленные записи не возвращаются как часть ответа SRU.

Электронные ресурсы, управляемые в сетевой зоне

В среде консорциума электронными ресурсами можно управлять от имени участников сетевой зоны. Можно получить библиографические записи и инвентарную информацию, которые управляются в сетевой зоне и доступны для конкретного члена. Для этого в профиле интеграции SRU доступна опция конфигурации «Включить результаты электронных ресурсов, управляемых в Сети». Для получения дополнительной информации обратитесь к OLH.

Обогащение данных: идентификаторы
Библиографическая запись, полученная из Alma, дополнена дополнительными идентификаторами: идентификатор MMS зоны сети и идентификатор зоны сообщества Alma добавляются к записи в дополнительных полях 035 marc. Идентификатор зоны сообщества добавляется с префиксом (EXLCZ), а идентификатор сетевой зоны добавляется с префиксом (EXLNZ- network_code ). Локальный идентификатор MMS находится в поле 001 marc. Эти дополнительные общие идентификаторы можно использовать для лучшей идентификации общей записи. Локальный идентификатор MMS следует использовать, когда есть необходимость вызвать API в учреждении для записи.

Для записей семейства DCMI (dc, dcx) идентификатор MMS добавляется к dc:identifier с использованием следующей структуры: alma:institution_code/bibs/mms_id

Обогащение данных: доступность

Можно настроить Alma для возврата информации о доступности как части ответа SRU. Расширение возвращается API GET BIB.

См. ответ SRU с образцом доступности

Примеры (в тестовой среде Alma’s Guest):

• searchRetrieveResponseЭто операция поиска, ключевые слова = история. В ответе должны быть возвращены только 3 записи, с четвертой по шестую.
• searchRetrieveResponse with errorЭто операция поиска с использованием несуществующего индекса.

Дополнительные сведения см. в разделе SRU в гостевой песочнице.

Важное примечание : Интеграция SRU предназначена для интеграции поиска Alma с другими автоматизированными системами в целях межбиблиотечного абонемента, копирования каталога или выбора. Использование интеграции SRU для других рабочих процессов, таких как массовый экспорт записей, не поддерживается. Поэтому за один поиск можно получить до 10 000 записей.

Онлайн-курсы и сертификаты от лучших преподавателей. Присоединяйтесь бесплатно

Начните новую карьеру всего за 6 месяцев

Просмотреть все роли

Менеджер проекта

Надзор за планированием и выполнением проектов, чтобы обеспечить их успех

Средняя заработная плата начального уровня

Все профессии

$37 960 ^*

Руководитель проекта

$67 500 ^**

Вакансии: 396 314 ^**

Прогнозируемый 10-летний рост: +10,2% ^***

«Получение сертификата Google Project Management: Professional Certificate является одним из самых больших достижений в моем моя новая карьера».

– Адриенн

Рекомендуемый профессиональный сертификат

«Получение моего сертификата Google Project Management: Professional Certificate является одним из самых больших достижений, которых я добился в своем образовании, и это был ключевой шаг к моей новой карьере.»

– Адриенн

* Занятость, заработная плата и прогнозируемое изменение занятости по типовому начальному уровню образования: Бюро трудовой статистики США. Сентябрь 2022 г., www.bls.gov/emp/tables/education-summary.htm. ** Данные о медианной зарплате (медиана при опыте работы от 0 до 2 лет) и данные о вакансиях взяты из отчета о вакансиях Lightcast™ в США. Данные о вакансиях, относящихся к рекомендуемым программам (01.09.2021 — 01.09.2021) *** Данные о темпах роста взяты из отчета о вакансиях Lightcast™ в США. Данные о вакансиях, относящихся к рекомендуемым программам (9/01/2021 — 01/09/22)

Степень магистра и бакалавра

Найдите высшую степень, которая подходит вашей жизни

Революционная цена на 100% онлайн-степени от лучших университетов.

Сертификаты MasterTrack

Откройте новые двери с обучением на уровне выпускников

Получите университетский сертификат и кредит на получение степени.

Ознакомьтесь с сертификатами MasterTrack

Университетские сертификаты

Ускорьте свой рост благодаря обучению на уровне выпускников

Получите недорогие сертификаты, выданные университетом, в лучших школах.

Курсы и специализации

Курсы, которые можно пройти за день

Выберите из более чем 5400 курсов по таким темам, как бизнес-аналитика, графический дизайн, Python и т. д.

Изучение навыков

100% бесплатно

Начните обучение с бесплатных курсов

Изучите бесплатные онлайн-курсы от лучших университетов и компаний мира.

Изучите бесплатные курсы

Изучите Coursera

Data Science

425 courses

Business

1095 courses

Computer Science

668 courses

Health

471 courses

Social Sciences

401 courses

Personal Development

137 courses

Arts и гуманитарные науки

338 курсов

Физические и инженерные науки

413 курсов

Изучение языков

150 курсов

Информационные технологии

145 курсов

Математика и логика

70 курсов

Результаты учащихся на Coursera на текущей работе и найти новую работу.

No related posts.