Просмотр исходного текста страницы Технология Веб-ИРБИС

Параметры поступают к веб-шлюзу Ирбис 64 в форме параметров HTTP-запроса. Поступившие параметры определяют действия, которые должен выполнить шлюз.

Параметры могут приходить в шлюз по методу POST или GET.

Параметры делятся на ''предустановленные'' и ''пользовательские''.

==Предустановленные параметры шлюза==

Предустановленные параметры могут использоваться для взаимодействия с шлюзом только по оговоренной методике. Набор предустановленных параметров, а также методика их использования предопределяются в процессе разработки системы Ирбис. Параметры перечислены в таблице, там же описана методика их использования.

===Основные параметры шлюза===

* <tt>C21COM</tt> – команда, которую должен выполнить веб-шлюз.
* <tt>I21DBN</tt> – имя [[Профили|профиля]]. Веб-шлюз Ирбис в соответствии с именем профиля определяет набор [[Фреймы|фреймов]], из которых составит ответ клиенту. Веб-шлюз Ирбис ищет названия фреймов в [[файл irbis_server.ini|файле irbis_server.ini]] в секции, название которой соответствует значению параметра <tt>I21DBN</tt> (подробнее в разделе [[#Роль фреймов в работе веб-шлюза Ирбис|Роль фреймов в работе веб-шлюза Ирбис]]).
* <tt>P21DBN</tt> – имя базы данных.
* <tt>Z21ID</tt> – значение параметра авторизации.

===Команды шлюза===

Значение параметра <tt>C21COM</tt> определяет команду, которую должен выполнить веб-шлюз Ирбис.

'''Таблица.''' Команды веб-шлюза Ирбис.
{|
 |
 {| class="standard"
  !Значение параметра <tt>C21COM</tt>||Описание команды||Соответствующий параметр в <tt>irbis_server.ini</tt>
  |-
  |'''F'''||'''''показ''''' – команда показа страницы||ShowFrames
  |-
  |'''S'''||'''''поиск''''' – команда выполнения и показа результатов поиска||SearchFrames
  |-
  |'''T'''||'''''словарь''''' – команда показа терминов словаря||DictionryFrames
  |-
  |'''Z'''||'''''заказ''''' – команда отбора записей в корзину заказов||ZakazFrames
  |-
  |'''R'''||'''''запись''''' – команда редактуры записей||RecUpdateFrames
  |-
  |'''E'''||'''''экспорт''''' – команда выгрузки записей||
  |-
  |'''2'''||'''''файл''''' – команда чтения внешнего объекта||
  |-
  |'''4'''||'''''скачать''''' – команда заимствования записи||
 |}
|}

Механизм составления веб-шлюзом Ирбис ответа клиенту отличается в зависимости от формы ответа.

В ответ на команды '''F''', '''S''', '''T''', '''Z''', '''R''' веб-шлюз Ирбис генерирует и отправляет клиенту HTML-страницу. Соответствующий параметр в <tt>irbis_server.ini</tt> используется веб-шлюзом Ирбис для получения набора фреймов, на основе которых генерируется HTML-страница, которую шлюз отправляет клиенту.

Команды '''E''', '''2''', '''4''' не требуют задания последовательности фреймов. Шлюз выдает в ответ на эти команды не HTML-страницу и не использует фреймы.

===Роль фреймов в работе веб-шлюза Ирбис===

Веб-шлюз Ирбис при получении команд '''F''', '''S''', '''T''', '''Z''', '''R''' выполняет следующую последовательность действий:
* Веб-шлюз получил запрос. Запрос содержит параметры <tt>C21COM</tt>, <tt>I21DBN</tt> и другие.
* В файле <tt>irbis_server.ini</tt> веб-шлюз находит секцию, имя которой соответствует значению параметра <tt>I21DBN</tt>. Иными словами: с одной стороны, в качестве значения параметра <tt>I21DBN</tt> указывается имя профиля, с другой стороны, для каждого профиля в файле <tt>irbis_server.ini</tt> должна содержаться секция, имя которой совпадает с именем профиля.
* В указанной секции файла <tt>irbis_server.ini</tt> веб-шлюз находит значение параметра, соответствующего указанной в параметре <tt>C21COM</tt> команде (см. таблицу ''Команды веб-шлюза Ирбис''). Полученное значение должно представлять собой список фреймов.
* Фреймы обрабатываются, и результат, представляющий собой HTML-страницу, отправляется клиенту в качестве ответа.

===Все предустановленные параметры===

==Пользовательские параметры==

Пользовательские параметры отличаются тем, что веб-шлюз Ирбис может выполнять с ними следующие действия:
* при получении HTTP-запроса шлюз принимает данные, переданные ему с помощью пользовательских параметров;
* в свой ответ на HTTP-запрос клиента (обычно – в генерируемую html-страницу, передаваемую клиенту) может включить набор пользовательских параметров вместе с их значениями, полученными в запросе.
Количество пользовательских параметров и их назначение может определяться в процессе внедрения и конфигурирования Ирбис 64.

===Применение пользовательских параметров для передачи данных между веб-страницами===

Пользовательские параметры позволяют передавать данные при переходе между веб-страницами, сгенерированными Веб-шлюзом Ирбис 64. Процесс передачи данных происходит в два этапа: 1) данные передаются на веб-шлюз в виде параметров запроса; 2) веб-шлюз передаёт данные вместе со сформированной страницей в скрытых полях форм HTML.

===Добавление пользовательского параметра===

Добавление пользовательского параметра осуществляется в несколько шагов:
* '''добавление ''пользовательского параметра'' в [[файл irbis_server.ini|настроечный файл <tt>irbis_server.ini</tt>]]'''
: Необходимо добавить описание нового ''пользовательского параметра'' в настроечный файл <tt>irbis_server.ini</tt>, задав имя и метку параметра. Для этого в секции <tt>[PARAMETRS]</tt> используются ''параметры ini файла'' <tt>PARNAME_</tt> и <tt>PARTAG_</tt> (не стоит путать термины ''пользовательские параметры'' веб-шлюза и ''параметры ini файла''), где вместо знака подчёркивания ставится номер пользовательского параметра по порядку, например:
 PARNAME2=C21COM
 PARTAG2=2222
: В этом примере мы видим описание второго по порядку из определённых в секции <tt>[PARAMETRS]</tt> параметров: имя параметра <tt>C21COM</tt>, метка параметра <tt>2222</tt>. Имя и метка параметров должны быть уникальными. После того как описание ''пользовательского параметра'' добавлено необходимо изменить значение параметра <tt>PARCOUNT</tt> в секции <tt>[PARAMETRS]</tt>, его значение должно быть равно порядковому номеру последнего описания ''пользовательского параметра''.
: ''Примечание:'' обратите внимание, что в файле <tt>irbis_server.ini</tt> хранятся описания не только пользовательских параметров, а присутствует также описания предустановленных параметров.
* '''использование в файлах <tt>.frm</tt> команд <tt><!FORMAT=INSERT_ALL_PARAMETERS></tt> и <tt><!FORMAT=INSERT_ALL_PARAMETERS_IN_QUERY></tt>'''
: Команда <tt><!FORMAT=INSERT_ALL_PARAMETERS></tt> обеспечивает вставку в код HTML-страницы всех непустых переданных веб-шлюзу параметров в виде скрытых элементов формы, например:
 <input type="hidden" name="PARAM_NAME" value="PARAM_VALUE">
: Команда <tt><!FORMAT=INSERT_ALL_PARAMETERS_IN_QUERY></tt> вставляет в код HTML-страницы гиперссылку, содержащую все переданные веб-шлюзу параметры.

[[Категория:Веб-шлюз Ирбис]]
[[Категория:Ирбис 64]]