Технология Веб-ИРБИС — различия между версиями
Sokv (обсуждение | вклад) |
Sokv (обсуждение | вклад) |
||
| Строка 12: | Строка 12: | ||
* <tt>C21COM</tt> – команда, которую должен выполнить веб-шлюз. | * <tt>C21COM</tt> – команда, которую должен выполнить веб-шлюз. | ||
| − | * <tt>I21DBN</tt> – имя [[Профили|профиля]]. | + | * <tt>I21DBN</tt> – имя [[Профили|профиля]]. Веб-шлюз Ирбис в соответствии с именем профиля определяет набор [[Фреймы|фреймов]], из которых составит ответ клиенту. Веб-шлюз Ирбис ищет названия фреймов в [[файл irbis_server.ini|файле irbis_server.ini]] в секции, название которой соответствует значению параметра <tt>I21DBN</tt> (подробнее в разделе [[Параметры_веб-шлюза_Ирбис_64#Команды шлюза]]). |
* <tt>P21DBN</tt> – имя базы данных. | * <tt>P21DBN</tt> – имя базы данных. | ||
* <tt>Z21ID</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 | ||
| + | |} | ||
| + | |} | ||
| + | |||
| + | В ответ на команды '''F''', '''S''', '''T''', '''Z''', '''R''' веб-шлюз Ирбис генерирует и отправляет клиенту HTML-страницу. | ||
===Все предустановленные параметры=== | ===Все предустановленные параметры=== | ||
Версия 15:33, 6 сентября 2009
Параметры поступают к веб-шлюзу Ирбис 64 в форме параметров HTTP-запроса. Поступившие параметры определяют действия, которые должен выполнить шлюз.
Параметры могут приходить в шлюз по методу POST или GET.
Параметры делятся на предустановленные и пользовательские.
Содержание
Предустановленные параметры шлюза
Предустановленные параметры могут использоваться для взаимодействия с шлюзом только по оговоренной методике. Набор предустановленных параметров, а также методика их использования предопределяются в процессе разработки системы Ирбис. Параметры перечислены в таблице, там же описана методика их использования.
Основные параметры шлюза
- C21COM – команда, которую должен выполнить веб-шлюз.
- I21DBN – имя профиля. Веб-шлюз Ирбис в соответствии с именем профиля определяет набор фреймов, из которых составит ответ клиенту. Веб-шлюз Ирбис ищет названия фреймов в файле irbis_server.ini в секции, название которой соответствует значению параметра I21DBN (подробнее в разделе Параметры_веб-шлюза_Ирбис_64#Команды шлюза).
- P21DBN – имя базы данных.
- Z21ID – значение параметра авторизации.
Команды шлюза
Значение параметра C21COM определяет команду, которую должен выполнить веб-шлюз Ирбис.
Таблица. Команды веб-шлюза Ирбис.
|
В ответ на команды F, S, T, Z, R веб-шлюз Ирбис генерирует и отправляет клиенту HTML-страницу.
Все предустановленные параметры
Пользовательские параметры
Пользовательские параметры отличаются тем, что веб-шлюз Ирбис может выполнять с ними следующие действия:
- при получении HTTP-запроса шлюз принимает данные, переданные ему с помощью пользовательских параметров;
- в свой ответ на HTTP-запрос клиента (обычно – в генерируемую html-страницу, передаваемую клиенту) может включить набор пользовательских параметров вместе с их значениями, полученными в запросе.
Количество пользовательских параметров и их назначение может определяться в процессе внедрения и конфигурирования Ирбис 64.
Применение пользовательских параметров для передачи данных между веб-страницами
Пользовательские параметры позволяют передавать данные при переходе между веб-страницами, сгенерированными Веб-шлюзом Ирбис 64. Процесс передачи данных происходит в два этапа: 1) данные передаются на веб-шлюз в виде параметров запроса; 2) веб-шлюз передаёт данные вместе со сформированной страницей в скрытых полях форм HTML.
Добавление пользовательского параметра
Добавление пользовательского параметра осуществляется в несколько шагов:
- добавление пользовательского параметра в настроечный файл irbis_server.ini
- Необходимо добавить описание нового пользовательского параметра в настроечный файл irbis_server.ini, задав имя и метку параметра. Для этого в секции [PARAMETRS] используются параметры ini файла PARNAME_ и PARTAG_ (не стоит путать термины пользовательские параметры веб-шлюза и параметры ini файла), где вместо знака подчёркивания ставится номер пользовательского параметра по порядку, например:
PARNAME2=C21COM PARTAG2=2222
- В этом примере мы видим описание второго по порядку из определённых в секции [PARAMETRS] параметров: имя параметра C21COM, метка параметра 2222. Имя и метка параметров должны быть уникальными. После того как описание пользовательского параметра добавлено необходимо изменить значение параметра PARCOUNT в секции [PARAMETRS], его значение должно быть равно порядковому номеру последнего описания пользовательского параметра.
- Примечание: обратите внимание, что в файле irbis_server.ini хранятся описания не только пользовательских параметров, а присутствует также описания предустановленных параметров.
- использование в файлах .frm команд <!FORMAT=INSERT_ALL_PARAMETERS> и <!FORMAT=INSERT_ALL_PARAMETERS_IN_QUERY>
- Команда <!FORMAT=INSERT_ALL_PARAMETERS> обеспечивает вставку в код HTML-страницы всех непустых переданных веб-шлюзу параметров в виде скрытых элементов формы, например:
<input type="hidden" name="PARAM_NAME" value="PARAM_VALUE">
- Команда <!FORMAT=INSERT_ALL_PARAMETERS_IN_QUERY> вставляет в код HTML-страницы гиперссылку, содержащую все переданные веб-шлюзу параметры.
