Техническая документация web ирбис64 и web ирбис32
жүктеу/скачать 0.86 Mb.
|
- Бұл бет үшін навигация:
- Приложение 3. Специфические для WEB ИРБИС функции UNIFOR
- Приложение 4. Отличия WEB ИРБИС 32 и WEB ИРБИС 64
- Приложение 5. Дополнения в составе WEB ИРБИС
- Приложение 6. Электронные библиотеки в WEB ИРБИС (выгрузка внешних файлов)
- Ссылки на файлы в полнотекстовых базах
- Ссылки на файлы в библиографических базах
- Определение доступных для выгрузки директорий
- Ограничение доступа к полнотекстовым документам
- Распространённые проблемы
- Приложение 7. Использование WebToIrbisServer
- Настройка APMов клиентов для работы с WebToIrbisServer
- Настройка WebToIrbisServer
Секция PARAMETRS
Секция PHP
Секция IRBISSERVER
Секция FULLTEXT
Приложение 3. Специфические для WEB ИРБИС функции UNIFOR&unifor('+3J[имя базы],[префикс][термин с усечением]) – аналог &uf(‘J, но поддерживает усечение искомого термина. &unifor(‘+3G[URL к внешнему сайту WEB ИРБИС, с запросом G]’) – вывод количества документов, найденных во внешней базе по команде G.(команда возвращает строку RESULT=[кол-во найденных по запросу документов]) &unifor('+3S[имя базы],[количество выводимых записей],[ограничитель][формат][ограничитель],[формат или @имя файла с форматом]) – расформатирует найденные по запросу записи. Если [количество выводимых записей]=0, то возвращает только количество найденных по запросу документов &unifor('+3E' - перевод в формат URI для передачи серверу. &unifor('+3D' – перевод из URI (применяется шлюзом при работе по методу GET). &unifor('+3U' – перевод ANSI в UTF8 – применяется в WEB ИРБИС32 для формирования ссылок в кодировке UTF8. &unifor('+3W' – перевод UTF8 в ANSI. &unifor('+3+' – перевод знака + в %2B для правильной передачи поискового запроса содержащего логику ИЛИ в ссылках. Приложение 4. Отличия WEB ИРБИС 32 и WEB ИРБИС 64В WEB ИРБИС 32 отсутствует: А) Функция поиска похожих документов Б) Режим *S21LOG 4, превращающий запрос в полнотекстовый с ранжированием В) Возможность поиска с использованием тематического рубрикатора В) возможность использования команды 3(выгрузка внутреннего двоичного ресурса библиографической записи) Для формирования GET запросов(генерации ссылок) в WEB ИРБИС 32 наряду с перекодировкой в URI (функция &unifor(‘+3E’)) осуществляется перекодировка запросов в UTF8(функция &unifor(‘+3U’)) Идентификатор поколения – 32 или 64 отражается в названиях папок и других ресурсов Перевод интерфейса в WEB 32 выполняется лишь частично и не затрагивает библиографические описания Приложение 5. Дополнения в составе WEB ИРБИСВ составе WEB ИРБИС могут поставляться расширения: Z39 клиент и сервер. Поставляются только в полной версии WEB ИРБИС. Подробно описаны в документации. Расширение для ведения базы данных статистики запросов и отображения статистики на сайте. СЕРВИС WebIrbis_service_64.exe, который позволяет по ссылке из формата показа найденных документов открыть заданный MFN в АРМ Каталогизатор. Консольная версия WEB ИРБИС для использования в сторонних программах. Расширения(кроме z39) располагаются в директории AddIns инсталляционного архива Webirbis.zip и содержат инструкции по использованию в файлах readme.txt Приложение 6. Электронные библиотеки в WEB ИРБИС (выгрузка внешних файлов)ВведениеБазы ИРБИС можно условно разделить на два типа: полнотекстовые и библиографические. Как первый, так и второй тип может включать ссылки на электронные документы. Их ключевое различие в том, что в полнотекстовых базах содержимое документа попадает в словарь и может использоваться для поиска, а в библиографических для поиска доступны только элементы библиографической записи, созданной библиографом. Кроме того, для создания полнотекстовых баз требуется АРМ Администратор Fulltext. Полнотекстовая база может создаваться путём добавления файлов или выборки внешних объектов из библиографической базы. Поэтому ссылки на электронные документы генерируются в ней автоматически. В полнотекстовой и библиографической базе несколько отличаются поля, где расположены гиперссылки. Ссылки на файлы в полнотекстовых базахВ подполе 952^B формируется абсолютный или относительный путь к файлу на диске (например, C:\file.pdf), в подполе 952^I — сетевой путь к файлу (например, http://libname.ru/file.pdf). Сетевой путь к файлу, указанный в подполе ^I, не модифицируется форматом (ed_reference_fulltext.pft). На его основе непосредственно генерируется гиперссылка на файл. Подполе ^B может преобразовываться и формировать гиперссылку, или выступать в роли параметра шлюза, который находит и возвращает нужный файл. При наличии значений параметров FullTextPathDbn и FullTextPathWeb в секции [MAIN] INI файла WEB ИРБИС, предпринимается попытка преобразовать локальный путь к файлу, указанный в подполе ^B, в сетевой. (например, C:/dir/file.pdf может быть заменён на путь http://libname.ru/dir/file.pdf) Префиксная часть локального пути, заданная в FullTextPathDbn (например, FullTextPathDbn =С:/), заменяется на префиксную часть сетевого пути (например, FullTextPathWeb=http://libname.ru/) В том случае если параметры FullTextPathDbn и FullTextPathWeb не заданы, значение подполя ^B передаётся шлюзу, который возвращает браузеру нужный файл. Шлюз может выгружать файлы по локальным путям (например, C:/dir/file.pdf) и FTP путям (например, ftp://libname.ru/dir/file.pdf) Но в случае если WEB сервер запускается как служба Windows, шлюз не будет работать с путями в локальной сети (например, \\my_computer\c\file.pdf и X:/file.pft) Следует обратить внимание на то, что открытие файлов по сетевым путям никак не регистрируется в статистике WEB ИРБИС. Статистика отражает выгрузку только тех файлов, которые были выгружены через шлюз. Т.е. ссылки на которые даны в подполе v952^b при отсутствующих значениях параметров FullTextPathDbn и FullTextPathWeb. При использовании в полнотекстовом АРМе Администратор режима разбиения «Каждая страница PDF(DJVU) файла как отдельный документ» результатом поиска оказываются записи, соответствующие только одной странице документа. Подполе ^B таких записей содержит имя несуществующего файла, префикс которого является реальным именем файла, а суффикс — номером страницы. Между именем файла и номером страницы находится разделитель, определяемый параметром FULL_TEXT_FileNamePrefixDiv в секции [FullText] INI файла WEB ИРБИС. Руководствуясь этими данными при обращении к файлу, шлюз выделяет из базового файла нужную страницу и передаёт её в браузер. Операция разбиения файла на страницы выполняется консольными приложениями pdf2pdf.exe или djvused.exe, которые располагается в директории cgi WEB ИРБИС. Выделенные страницы сохраняются во временном файле, в директории, где находится основной файл документа. При использовании этого режима следует учитывать ряд ограничений: 1. Директория с основным файлом документа должна быть открыта для консольного приложения на запись; 2. Запуск шлюзом другого приложения в IIS невозможен без специальной настройки сервера; 3. Если структура документа не корректна, приложение может не справиться с выделением нужной страницы. В этом случае пользователь получает сообщение «FILE NOT FOUND»
Все файлы в этом режиме передаются пользователю через шлюз (начиная с последних обновлений версии 2010.1 ) и ссылка генерируется форматом ed_reference.pft Подполя А и I являются альтернативными, то есть: одно из подполей обязательно должно быть заполнено; заполнение обоих подполей в одном повторении не имеет смысла. Например, при размещении объекта непосредственно в папке базы данных адрес может иметь вид: ^Aмой_доклад.doc При размещении объекта во вложенной папке в папке базы данных: ^A\SUBDIR_NAME \мой_доклад.doc Кроме того, путь может иметь абсолютный вид: ^AC:\DIR_NAME\мой_доклад.doc Подполе I используется в тех случаях, когда внешний объект (файл) находится вне папки соответствующей базы данных. В этом случае указывается URL. Примеры заполнения подполя:
и
Определение доступных для выгрузки директорийВ связи с тем, что WEB ИРБИС может выгрузить любой файл на жестком диске по запросу неавторизованного пользователя, необходимо обязательно применять ограничение доступных адресов. Рекомендуется ограничить их возможный диапазон, установив в INI файле WEB ИРБИС параметр Safe_File_Download=1 и перечислив через точку с запятой допустимые пути расположения файлов в параметре Safe_File_Paths. Например: Safe_File_Download=1 Safe_File_Paths=C:\irbis\datai\books\files;C:\web\images\ В случае если в записи указан относительный путь или имя файла, к нему будет добавляться нужный путь из Safe_File_Paths. Если указан абсолютный путь, то он принимается только тогда когда соответствует одному из путей Safe_File_Paths. Таким образом, решается как задача обеспечения безопасности, так и задача дополнения относительных путей нужными значениями. Другой способ установки путей к папкам с полнотекстовыми файлами для каждой базы – их указание в 11 параметре PAR файла базы (начиная с версии 2012.1). Например: 1=.\datai\ibis\ 2=.\datai\ibis\ 3=.\datai\ibis\ 4=.\datai\ibis\ 5=.\datai\ibis\ 6=.\datai\ibis\ 7=.\datai\ibis\ 8=.\datai\ibis\ 9=.\datai\ibis\ 10=.\datai\ibis\ 11=C:\ebooks
Отдельных категорий пользователей (в этом случае категории должны указываться в подполе 951^d) Пользователей, находящихся в локальной сети библиотеки (если заполнено поле 951^l и IP пользователя частично совпадает со значением параметра local_mask INI файла WEB ИРБИС)
Например, не приемлемы пути: \\host_name\file.pft или когда файл находится на сетевом диске X:\file.pft Ведение полнотекстовых баз значительно упрощает расположение полнотекстового АРМа Администратор и шлюза на одном физическом сервере. Если АРМ Читатель для полнотекстовых баз не используется, при этом полностью отпадает необходимость в дополнительных настройках шлюза или модулей. Поэтому если хранение электронной коллекции на WEB сервере не возможно, целесообразно создать на сервере, где она хранится, WEB или HTTP сервер, с которого документы будут выгружаться шлюзом и передаваться клиенту. Ограничение может быть снято с помощью установки для Apache прав NET_SERVICE. Приложение 7. Использование WebToIrbisServerВведениеПриложение WebToIrbisServer является средством обеспечения работы с ИРБИС TCP/IP сервером по протоколу HTTP. При соответствующей настройке клиентов ИРБИС(подробней — ниже), они начинают формировать запросы так же, как обычные браузеры к WEB серверу. Эти запросы поступает на приложение WebToIrbisServer(выступает в роли CGI), которое передаёт их в стандарте ИРБИС TCP/IP серверу. Использование WebToIrbisServer может быть полезным в двух случаях: Когда требуется обеспечить работу внешних (находящихся в интернете) клиентов, но открытие порта ИРБИС-сервера (по умолчанию — 6666) невозможно. Когда требуется обеспечить работу клиентов, подключённых с помощью нестабильного канала связи. (для обеспечения стабильности ИРБИС TCP/IP сервера). Приложение поставляется в составе WEB ИРБИС и располагается в директории CGI. (например: \cgi-bin\irbis64r_11\WebToIrbisServer.exe)
#IP или доменное имя сервера (library.gpntb.ru) ServerIP=193.233.14.9 #Порт сервера. Стандартно для WEB серверов — 80 ServerPort=80 #Переключатель в режим HTTP WebServer=1 #Путь к WebToIrbisServer.exe, который должен указываться относительно адреса сервера WebCgi=/cgi-bin/irbis64r_91/WebToIrbisServer.exe В серверном INI файле требуется указать: StartBlockSocket=0 BlockSocket=0 Настройка WebToIrbisServerНастройка WebToIrbisServer выполняется в INI файле WEB ИРБИС (файле irbis_server.ini, который находится в CGI директории). Параметры WebToIrbisServer задаются в секции [IrbisServer] #Адрес ИРБИС TCP/IP сервера IP=127.0.0.1 #Порт ИРБИС TCP/IP сервера PORT=6666 #ожидание ответа(в секундах) CGITimeOut=3 1 Здесь и далее XX означает номер версии WEB ИРБИС. Например: 91. 2 Здесь и далее YY означает поколение системы: 32 или 64. 3 Все указанные здесь названия фреймов, технологии и пути выступают лишь как иллюстрации и могут быть изменены в новых версиях системы. 4 Здесь далее приводятся значения по умолчанию для базовой поставки WEB ИРБИС. жүктеу/скачать 0.86 Mb. Достарыңызбен бөлісу:
|