Просмотр исходного текста страницы ИРБИС-Навигатор

==Что это такое?==

ИРБИС-Навигатор – это клиентское приложение, предназначенное для выполнения ПРОИЗВОЛЬНЫХ операций с базами данных ИРБИС на основе интерфейсов, ПРОГРАММИРУЕМЫХ с помощью Языка форматирования ИРБИС и HTML. Дополнительно ИРБИС-Навигатор может выполнять функции стандартного Web-браузера.

==Для чего это нужно?==

В исходном виде (т.е. в том виде, в котором он поставляется) ИРБИС-Навигатор представляет собой инструментальное средство, адресованное ПОЛЬЗОВАТЕЛЯМ-РАЗРАБОТЧИКАМ, перед которыми стоят задачи создания оригинальных (специализированных) приложений для КОНЕЧНЫХ пользователей баз данных ИРБИС. При этом предполагается, что пользователи-разработчики знакомы с языком форматирования ИРБИС и HTML.

==Как это работает?==

Внешне работу ИРБИС-Навигатора можно представить как работу стандартного Web-браузера, который помимо выполнения URL-ссылок может выполнять специальные ИРБИС-ссылки. Но при этом важно понимать, что выполнение ИРБИС-ссылок является ОСНОВНОЙ функцией, а работа с URL-ссылками – дополнительной и даже ПОБОЧНОЙ. Также важно отметить, что работа с БД через ИРБИС-ссылки НЕ ТРЕБУЕТ модуля Web-ИРБИС. Т.е. обращение к БД ИРБИС из ИРБИС-Навигатора производится точно так же, как и из других АРМов – с использованием внутреннего «движка» системы.

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

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

Необходимо помнить, что при указании значений поименованных параметров можно использовать только  латиницу, цифры и некоторые специальные символы – для передачи остальных символов используется специальное представление (для этого в языке форматирования введен специальный форматный выход <tt>&unifor(‘+3E..’))</tt>.

Помимо собственно ИРБИС-ссылок, работа с которыми является ГЛАВНОЙ функцией ИРБИС-Навигатора, предлагаются дополнительные оригинальные (т.е. интерпретируемые ТОЛЬКО ИРБИС-Навигатором) конструкции HTML.

1. Включение в HTML-страницу графических данных на основе их относительной адресации в системе ИРБИС.

 <IMG SRC="IRBIS:path,dbname,filename" .....>
где:
* path – относительный путь в системе ИРБИС. Принимает значения:
** 0 – основная директория ИРБИС;
** 1 – общая директория БД (.\DATAI);
** 2,3,10 – директория БД.
* dbname – имя БД (имеет смысл, если path принимает значения 2,3,10).
* 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). Список типов ИРБИС-тэга в дальнейшем будет пополняться (принимаются заявки пользователей).

==Выполнение ИРБИС-ссылки==

Каждая ИРБИС-ссылка, выполняемая ИРБИС-Навигатором, представляет собой ОДНУ команду. Результатом выполнения ИРБИС-ссылки (соответствующей команды) является HTML-страница, которая отображается в ИРБИС-Навигаторе (см. ниже Дополнение). В общем случае результирующая HTML-страница состоит из трех частей:
* Верхний колонтитул 
* Основная часть 
* Нижний колонтитул 

Верхний колонтитул формируется как результат форматирования МОДЕЛЬНОЙ записи с помощью формата, имя которого задается параметром TOPPFTNAME (см. список параметров ИРБИС-ссылки). Если данный параметр в ссылке не задается, верхний колонтитул не формируется.

Основная часть формируется как результат форматирования одного или группы документов БД (имя которой задается параметром I21DBN), полученных в результате выполнения соответствующей команды. Документы форматируются с помощью формата, имя которого задается параметром PFTNAME. Если в результате выполнения команды не получен (или не формируется) ни один документ, форматируется МОДЕЛЬНАЯ запись. Есть команды (например, 4 – Просмотр словаря и 5 – Просмотр списка/справочника), в результате выполнения которых создается ТОЛЬКО модельная запись.

Нижний колонтитул формируется как результат форматирования МОДЕЛЬНОЙ записи с помощью формата, имя которого задается параметром BOTTOMPFTNAME. Если данный параметр в ссылке не задается, нижний колонтитул не формируется.

Модельная запись – это условная запись, которая временно создается в процессе выполнения команды и содержит модельные поля. Среди модельных полей можно выделить фиксированные и произвольные. Фиксированные модельные поля содержат значения определенных параметров, передаваемых через ссылку, а также результаты выполнения соответствующих команд. Произвольные модельные поля содержат значения произвольных параметров, передаваемых через ссылку. Назначение и содержание произвольных параметров определяет пользователь.

Модельные поля доступны ТОЛЬКО при форматировании модельной записи. При форматировании реальных записей БД (являющихся результатом выполнения ИРБИС-ссылки) доступны значения произвольных параметров ЧЕРЕЗ СООТВЕТСТВУЮЩИЕ ГЛОБАЛЬНЫЕ ПЕРЕМЕННЫЕ языка форматирования.

Список модельных полей дается в таблице Параметры ИРБИС-ссылки.

Форматы, задаваемые параметрами PFTNAME, TOPPFTNAME, BOTTOMPFTNAME, должны находиться в директории соответствующей БД (задаваемой параметром I21DBN) или в депозитарии общих ресурсов системы (только для ИРБИС64). Данные форматы должны быть HTML-форматами – т.е. они могут содержать HTML-тэги и НЕ могут содержать RTF-конструкции. (Разумеется, HTML-тэги включаются в форматы через литералы.)

Дополнение (от 20.07.2009):  Результатом выполнения очередной ИРБИС-ссылки может быть следующая ИРБИС-ссылка (соответствующая команда). Таким образом реализуется "конвейерная" обработка. Это позволяет выполнять пакетно (друг за другом) несколько связанных элементарных команд, реализующих некую законченную технологию.

==Замечания и рекомендации для пользователей-разработчиков==

# Прежде всего надо еще раз повторить, что ИРБИС-Навигатор как инструментальное средство адресован пользователям-разработчикам, знакомым с языком форматирования ИРБИС и HTML. 
# Все представленные здесь примеры имеют минимальный дизайн, т.е. во всех форматах для примеров используются минимальные конструкции HTML – сделано это намеренно, чтобы облегчить их понимание. 
# Интерфейс ИРБИС-Навигатора «стилизован» под Internet Explorer  - для того, чтобы создать для конечного пользователя привычную среду и исключить проблему дополнительного обучения. Но это вовсе не значит, что ИРБИС-Навигатор имеет «претензии» полностью заменить Interrnet Explorer. Из Interrnet Explorer взяты только те функции и интерфейсные решения, которые отвечают назначению ИРБИС-Навигатора. В связи с этим убедительная просьба ко всем, кто будет тестировать ИРБИС-Навигатор, не заниматься «ловлей» его отличий от Interrnet Explorer – разработчику они известны в полной мере. А вот замечания и предложения по существу работы ИРБИС-Навигатора принимаются без ограничений. 
# У каждого, кто будет знакомиться с ИРБИС-Навигатором, наверняка возникнет вопрос: А чем это отличается от Web-ИРБИС. Ответ может быть таким: во-первых, не нужен WWW-сервер, т.е. доступ к БД ИРБИС из ИРБИС-Навигатора осуществляется напрямую, без WWW-сервера; во-вторых, ИРБИС-Навигатор имеет средства конфигурирования общей части интерфейса (параметры INI-файла), которые позволяют жестко устанавливать рамки дозволенного для конечного пользователя, что вряд ли возможно с Web-ИРБИС; в-третьих, ИРБИС-Навигатор (файл-серверный вариант) применим при публикации БД ИРБИС на CD-ROM; в-четвертых, ИРБИС-Навигатор (клиент-серверный вариант) может работать с несколькими серверами БД ИРБИС, при этом переключение с одного сервера на другой осуществляется "прозрачно" для конечного пользователя (благодаря параметрам SERVERIP и SERVERPORT); и в-пятых, ИРБИС-Навигатор более прост и гибок в настройках, в связи с более широким применением языка форматирования – хотя последнее, может быть, и субъективно. Есть надежда, что пользователи-разработчики продолжат этот список… 
# Хочется надеяться, что у пользователей-разработчиков (особенно знатоков HTML) не вызовет сильного раздражения то обстоятельство, что конструкции HTML следует встраивать в язык форматирования в виде литералов. Это, разумеется, снижает читабельность того и другого, но другого выхода нет. Сделать обратное – встраивать язык форматирования в HTML – вряд ли возможно. 
# Создание конкретных приложений на основе ИРБИС-Навигатора в общем виде можно представить как двоякий процесс: с одной (и, разумеется, главной) стороны это разработка определенной последовательности (совокупности) страниц (они же – ссылки, они же – команды, они же – форматы), которые реализуют задачи, решаемые конечным пользователем, с другой стороны это «заточка» общей части интерфейса ИРБИС-Навигатора под конкретного пользователя с помощью параметров INI-файла (в частности, можно сделать так, что конечный пользователь не сможет выполнять никаких иных действий, кроме тех, что входят в список ИЗБРАННОЕ, который в свою очередь «жестко» подается из INI-файла – см. параметры INI-файла) 
# Список базовых команд, которые реализует ИРБИС-Навигатор, весьма невелик – пока всего 8 команд. Но это не значит, что возможности ИРБИС-Навигатора ограничены – комбинируя и параметрируя эти команды, используя все возможности HTML (в т.ч. и скрипты) можно реализовать практически любые технологии работы с БД ИРБИС (или во всяком случае те, которые имеет смысл решать с помощью ИРБИС-Навигатора. Например, пакетную глобальную корректировку нельзя и не имеет смысла  реализовывать в ИРБИС-Навигаторе, а вот автоввод – она же глобальная корректировка на основе одного документа – без проблем). Но как бы то ни было – если в процессе использования ИРБИС-Навигатора появится обоснованная потребность в новых командах, они будут включены. 
# Имена (по умолчанию) и содержание некоторых параметров ИРБИС-ссылки совпадают с параметрами Web-ИРБИС – к сожалению, только в этом эти два решения совпадают. Т.е. полной совместимости в части параметров и форматов между ИРБИС-Навигатором и Web-ИРБИС нет. 
# В процессе выполнения команды обращения к файловым ресурсам (команда 3), а также при отображении графических данных из окружения ИРБИС запрашиваемые ресурсы кэшируются (сохраняются) в рабочей директории (WORKDIR). В будущем в общей части интерфейса будет предусмотрен режим очистки кэша – пока при тестировании для этих целей можно пользоваться скрытой командой: двойной щелчок по панели управления. 
# Все пояснения, связанные с выполнением тех или иных команд, а также использованием их параметров, даются непосредственно в таблице Параметры ИРБИС-ссылки, которая безусловно является главным материалом для освоения ИРБИС-Навигатора. 
# Конкретные решения для ИРБИС-Навигатора - в виде форматов и других файловых ресурсов - могут стать "легким" объектом распространнеия или обмена между пользователями системы ИРБИС. 
# Первая (тестовая) версия ИРБИС-Навигатора НЕ ПОДДЕРЖИВАЕТ фреймов в ИРБИС-ссылках.

==Ссылки==

См. также:
* [[Базы данных ИРБИС]]
* [[АРМ Каталогизатор]]

Источники информации:
* [[Документация, поставляемая с системой ИРБИС#ИРБИС-Навигатор. Полная инструкция|ИРБИС-Навигатор. Полная инструкция]]

[[Категория:ИРБИС 64]]
[[Категория:Программные модули ИРБИС]]
[[Категория:Базы данных ИРБИС]]
[[Категория:Последние анонсированные статьи]]