Структура
ИРБИС-ссылки
ИРБИС-ссылка является «надстройкой» HTML для реализации функций ИРБИС-Навигатора.
В общем виде ИРБИС-ссылка имеет следующий вид:
IRBIS:[параметры_ссылки]
ИРБИС-ссылка может использоваться и формироваться в HTML-странице ТОЧНО так же, как и URL-ссылка.
Все параметры ИРБИС-ссылки могут передаваться методом GET (т.е. непосредственно в ссылке после символа ?) или методом POST.
Для обеспечения преемственности по отношению к ссылкам, применяемым в стандартных форматах для других АРМов ИРБИС, часть параметров может передаваться позиционно в основной части ссылки (до символа ?). Т.е. в общем виде ИРБИС-ссылка может быть представлена как:
IRBIS:[позиционные_параметры]?[поименованные параметры]
Каждая ИРБИС-ссылка реализует ОДНУ команду, поэтому среди передаваемых параметров ОБЯЗАТЕЛЬНО должен присутствовать параметр, идентифицирующий команду, - имя этого параметра по умолчанию C21COM.
Перечень всех параметров, сгруппированных по командам, представлен в следующей таблице…
Поименованные параметры передаются в соответствии с правилами и структурой URL.
В качестве позиционных параметров могут передаваться ТОЛЬКО следующие параметры:
- идентификатор
команды (C21COM);
- имя БД (I21DBN);
-
имя формата (PFTNAME);
- ключ (KEY);
- путь (PATH);
-
имя файлового ресурса (FILENAME).
Для всех команд, кроме 3, структура позиционных параметров имеет вид:
N,,dbname,pftname,key
где N – идентификатор команды.
Для команды 3 структура позиционных параметров имеет вид:
3,path,dbname,filename
Повторим, что наличие и структура позиционных параметров связаны исключительно с обеспечением преемственности по отношению к ссылкам, применяемым в «обычных» форматах ИРБИС. Тем, для кого затруднительно понимание позиционных параметров, можно рекомендовать их вообще не использовать, а применять только поименованные параметры.
Примеры ИРБИС-ссылок:
Та же самая ссылка с использованием поименованных параметров:
IRBIS:?C21COM=1&I21DBN=IBIS&PFTNAME=FULLW0_WN&KEY=@6
То же самое со смешанным использованием позиционных и поименованных параметров:
IRBIS:1,,IBIS,,@6?PFTNAME=FULLW0_WN
Необходимо помнить, что при указании значений поименованных параметров можно использовать только латиницу, цифры и некоторые специальные символы – для передачи остальных символов используется специальное представление (для этого в языке форматирования введен специальный форматный выход &unifor(‘+3E..’)).
Помимо собственно ИРБИС-ссылок, работа с которыми является ГЛАВНОЙ функцией ИРБИС-Навигатора, предлагаются дополнительные оригинальные (т.е. интерпретируемые ТОЛЬКО ИРБИС-Навигатором) конструкции HTML.
1. Включение в HTML-страницу графических данных на основе их относительной адресации в системе ИРБИС.
<IMG
SRC=”IRBIS:path,dbname,filename” …..>
где:
path – относительный путь в системе ИРБИС. Принимает значения:
0 – основная директория ИРБИС;
1 – общая директория БД (.\DATAI);
2,3,10 – директория БД;
11 – путь, определяемый 11 строкой в файле <dbname>.par
12 – обозначает внутренний двоичный ресурс; в этом случае вместо filename необходимо указывать конструкцию:
mfn,numb
где mfn – номер документа, numb – порядковый номер внутреннего двоичного ресурса;
13 – обозначает внешний (по отношению к ИРБИС) ресурс; в этом случае filename должен содержать полный путь
dbname – имя БД (имеет смысл, если path принимает значения 2,3,10,11,12).
filename – имя графического файла.
Пример...<img src="irbis:0,,IRBIS.GIF">
Дополнение с версии 2012.1:
В качестве filename можно указывать PDF-файл. В этом случае конструкция имеет вид:
<IMG
SRC=”IRBIS:path/page,dbname,filename” …..>
где page – номер страницы PDF-файла (по умолчанию -1)
При этом страница PDF-файла отображается в виде графического образа в формате JPEG.
Пример...<img src="irbis:10/5,IBIS,1.PDF">
2. Отображение на HTML-странице штрих-кода.
<IMG SRC=”IRBIS:!!ШШШ!!” …..>
где: ШШШ – значение штрих-кода.
При отображении штрих-кодов используются параметры INI-файла BARCODEHEIGHT и BARCODETYPE
Пример...<img src="irbis:!!12345678!!">
3. Использование ИРБИС-тэга.
<IRBIS TYPE=”N”>
Смысл ИРБИС-тэга определяется значением параметра TYPE. Пока предлагается одно значение TYPE=0. Такой тэг интерпретируется как порядковый номер документа в списке с учетом порядкового номера первого документа в выводимой порции (значение параметра S21STN). Список типов ИРБИС-тэга в дальнейшем будет пополняться (принимаются заявки пользователей).