Структура ИРБИС-ссылки

ИРБИС-ссылка является «надстройкой» 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:1,,IBIS,FULLW0_WN,@6

Та же самая ссылка с использованием поименованных параметров:

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). Список типов ИРБИС-тэга в дальнейшем будет пополняться (принимаются заявки пользователей).