Меню
ИРБИС-ссылки в HTML-форматах
НАЧАЛО >> Оглавление >> Общее описание >> Язык форматирования ИРБИС >> Специальные конструкции языка форматирования >> ИРБИС-ссылки в HTML-форматах📄 Скачать в DOCX
ИРБИС-ссылка - это ссылка или источник изображения, который начинается с IRBIS: и выводится HTML-форматом. При показе результата в ИРБИС 128 обработчик форматов преобразует такие конструкции в рабочие переходы: поиск записей, открытие одного документа, открытие файлового ресурса или вывод графического объекта.
Пример ИРБИС-ссылки в HTML-результате формата
1. Где применяется
ИРБИС-ссылки используют в HTML-форматах показа, когда из одной записи нужно перейти к связанным документам, открыть прикрепленный файл или вывести изображение из ресурсов базы.
Переход по ссылке выполняется в контексте текущего АРМа:
- в АРМе Каталогизатор ссылка с поиском переключает базу, указанную в ссылке, и запускает поиск в списке записей Каталогизатора;
- в АРМе Читатель ссылка с поиском открывает результат поиска в читательском интерфейсе;
- в других АРМах ссылка не должна принудительно переводить пользователя в АРМ Читатель; ее результат зависит от обработчика, подключенного в текущем интерфейсе;
- если переход выполняется из открытого редактора записи, редактор получает событие закрытия перед переходом по ссылке.
2. Ссылка в атрибуте href
Общий позиционный вид:
<a href="IRBIS:C21COM,PATH,I21DBN,PFTNAME,KEY">Текст ссылки</a>Параметры:
C21COM- тип команды;PATH- путь к файловому ресурсу или служебный параметр команды;I21DBN- имя базы данных; если не задано, используется текущая база формата;PFTNAME- имя формата или имя файла, в зависимости от команды;KEY- поисковый термин или идентификатор записи.
Допускается форма с именованными параметрами после ?, например:
<a href="IRBIS:?C21COM=2&I21DBN=IBIS&KEY=K%3D%D0%BA%D1%80%D0%B0%D0%B5%D0%B2%D0%B5%D0%B4%D0%B5%D0%BD%D0%B8%D0%B5">Найти связанные записи</a>Для href="IRBIS:..." поддерживаются основные команды:
C21COM |
Назначение | Результат в ИРБИС 128 |
|---|---|---|
0 |
Внешний URL | Открывается URL, указанный в позиции I21DBN. |
1 |
Один документ | Открывается форматированный документ через WIrbis/Format; KEY должен содержать MFN в виде @<mfn>. |
2 |
Группа документов по поиску | В текущий АРМ передается событие поиска с базой I21DBN и выражением KEY. |
3 |
Файловый ресурс | Открывается ресурс из 951A или внутренний ресурс 953 при PATH=12. |
Пример ссылки для поиска записей в базе IBIS:
<a href="IRBIS:2,,IBIS,,K=краеведение">Найти документы по теме</a>Для перехода к одному документу укажите MFN через @:
<a href="IRBIS:1,,IBIS,brief,@125">Открыть запись</a>3. Ссылка в атрибуте src
Атрибут src="IRBIS:..." применяют для вывода графических и файловых ресурсов внутри HTML-страницы.
Позиционный вид для ресурса:
<img src="IRBIS:PATH,I21DBN,PFTNAME,KEY" alt="Обложка">Если PATH=12, ресурс берется из внутреннего двоичного ресурса записи: PFTNAME используется как MFN, KEY - как номер повторения. Для остальных путей открывается файл из ресурса 951A, где PFTNAME используется как имя файла.
Поддерживается и короткий вариант по штрихкоду:
<img src="IRBIS:!!123456!!" alt="Фото читателя">4. Практические правила
Задавайте в ссылке базу I21DBN, если переход должен выполняться не в текущей базе формата. Для поисковых ссылок используйте то же поисковое выражение, которое пользователь мог бы выполнить вручную в соответствующем АРМе.
Не подставляйте в KEY произвольный текст без префикса поиска, если в целевом АРМе ожидается выражение вида K=..., A=..., I=... или другое допустимое условие. Для перехода к одному документу используйте C21COM=1 и KEY=@<mfn>, а не поисковую команду.
Если ссылка должна открывать файл, проверьте, где хранится ресурс: в поле 951A или во внутреннем ресурсе 953. Для 953 нужен PATH=12; для 951A указывают путь ресурса и имя файла.
Перед передачей формата пользователям проверьте его в том АРМе, где он будет использоваться. Одна и та же ИРБИС-ссылка может запускать поиск в Каталогизаторе или в АРМе Читатель, потому что обработчик перехода выбирается текущим интерфейсом.