Команда выгрузки записей - “экспорт” (E)

Команда чтения внешнего файла - “файл”(2)

Команда использует параметры:

1. 
   IMAGE_FILE_NAME – полный или относительный путь к файлу;
   
2. 
   IMAGE_FILE_MFN – номер записи в случае, если файл лежит в архиве полнотекстовой базы данных
   
3. 
   IMAGE_FILE_DOWNLOAD – флаг, заставляющий браузер не открыть скачанный файл, а вызвать диалог с предложением открыть или сохранить его на диск. По умолчанию 0.
   

В параметре IMAGE_FILE_NAME могут быть имена файлов, полные или относительные адреса. Тем не менее, использование абсолютных произвольных адресов является небезопасным, так как это позволяет выгружать с сервера произвольные файлы. Поэтому настоятельно рекомендуется ограничить их возможный диапазон, установив в INI файле WEB ИРБИС параметр Safe_File_Download=1 и перечислив через точку с запятой допустимые пути расположения файлов в параметре Safe_File_Paths.

Safe_File_Download=1

Safe_File_Paths=C:\irbis\datai\books\files;C:\web\images\

В случае если в параметре IMAGE_FILE_NAME указан относительный путь или имя файла, к нему будет добавляться нужный путь из Safe_File_Paths. Если указан абсолютный путь, то он принимается только тогда когда соответствует одному из путей Safe_File_Paths.

http://127.0.0.1/cgi-bin/irbis64r_91/cgiirbis_64.exe?Z21ID=4444&P21DBN=IBIS&I21DBN=IBIS&C21COM=2&IMAGE_FILE_NAME=image.jpg&IMAGE_FILE_DOWNLOAD=1

Команда чтения внутреннего двоичного объекта из библиографической записи – «интегрированный файл»(3)

Команда показа внутренних двоичных ресурсов библиографической записи работает только в ИРБИС 64. Она использует параметры:

BINARY_RESOURCE_MFN - номер записи

BINARY_RESOURCE_OCC - номер повторения

Пример выгрузки внутреннего ресурса записи №100 из повторения 1

http://127.0.0.1/cgi-bin/irbis64r_91/cgiirbis_64.exe?C21COM=3&I21DBN=IBIS&P21DBN=IBIS&BINARY_RESOURCE_OCC=1&BINARY_RESOURCE_MFN=100

Команда получения количества найденных документов в удалённой базе – «количество найденных»(G)

Команда используется при распределённом поиске по ИРБИС-корпорации. По своему синтаксису она полностью аналогична команде S, но возвращает не найденные записи, а лишь строку RESULT=[количество найденных записей]. Она может применяться в форматах, в функции &unifor(‘+3G[запрос к удалённой БД]’), что позволяет легко узнать количество найденных записей и вывести его в формат или фрейм.

Пример запроса по ключевому слову «история»:

http://127.0.0.1/cgi-bin/irbis64r_91/cgiirbis_64.exe?I21DBN=IBIS&P21DBN=IBIS&C21COM=G&S21ALL=<.>K=история<.>

Обработка фреймов

Правила объединения фреймов

Результат выполнения текущей команды(поиска, например), как правило «обрамляется» набором фреймов. Этот набор фреймов берётся из секции, соответствующей псевдониму базы(параметр I21DBN) и параметра соответствующего текущей команде. Но возможен так же вывод произвольного фрейма, название которого задано в параметр S21FRAME с использованием произвольной базы указанный в параметре I21DBN. Эта опция должна быть активирована параметром DirectAcess=1 в секции [MAIN] INI файла WEB ИРБИС.

Директивы фреймов

Директивы фреймов могут использоваться в дополнение к HTML тегам при формировании WEB ИРБИС ответа. В большинстве случаев предполагается, что на одной строке фрейма находится только одна команда.

Все команды выполняются в следующем приоритете:

1. 
   Директивы вставки формата
   
2. 
   Директивы вставки файла(фрейма)
   
3. 
   Директивы вставки PHP
   
4. 
   Директивы вставки системных значений
   

Таким образом, обеспечивается, например, возможность генерировать в формате команду вставки файла.

Директивы вставки системных значений

Шлюз выполняет специальные команды замены (вставки) значений во фреймы

<--HTTP_PATH--> – путь к директории HTTP DOCS WEB ИРБИС. Соответствует параметру HTTP_PATH INI файла WEB ИРБИС

<--CGI_PATH--> – путь к CGI WEB ИРБИС. Соответствует значению параметра CGI_ALIAS INI файла WEB ИРБИС

<--TIME--> – текущее время

<--MAXIMUMMFN--> –максимальный MFN базы данных

<--RUNTIMEPID--> – по умолчанию– идентификатор читателя. Присваивается при авторизации. Соответствует метке ReaderIDTag (1002).

<--DATABASE--> –имя базы данных

<--MFNCOUNT--> – порция выдаваемых записей

<--MFN--> – MFN текущей форматируемой записи

< --DB-- > – имя текущей базы данных

<--TOTALRECS--> – количество найденных записей

<--BEGINRECS-->– стартовый номер при показе записей

<--ENDRECS--> – конечный номер при показе записи

Директивы вставки файла

Каждый фрейм может включать в себя ссылки на другие файлы и фреймы, который должны быть в него вставлены.

FILE=[имя файла]>

Поиск файла происходит в директории текущей базы данных, а затем в папках с фреймами.

Директивы вставки формата

Формат может добавляться в тело фрейма с помощью обрамления короткими PHP тегами() или в конструкции FORMAT=> Все форматы, выводящие не латинские символы должны начинаться с восклицательного знака. Это обеспечивает их перекодировку в UTF8.

Применение коротких тегов в стиле PHP тегов позволяет расположить формат в произвольной части строки.

Пример задания значения по умолчанию для параметра P21DBN(значение поля 3331):

Кроме того, формат может быть многострочным.

Пример многострочного представления формата с выравниванием логических конструкций:

if v2221='URUB' then

else

'?C21COM=F&I21DBN=URUB&S21FMT=WEB_URUB0_WN&S21All=<.>U=<.>&S21CNR=30',

'&P21DBN=',v3331,

’&Z21ID=',&uf('+3E',v2225),

(if v3413<>'' then

'&R21DBN=',v3413

else

break

fi),

'">Тезаурус'

fi

?>

Директивы FORMAT= может располагаться только с новой строчки и перед ней могут находиться только символы пробела или табуляции.

Синтаксис директивы формат таков:

FORMAT=[строка формата] >

или

FORMAT=@[имя файла] >

Пример вставки формата referings:

FORMAT=@referings>

Кроме того, директива FORMAT=INSERT_ALL_PARAMETERS> формат может выполнять вставку всех параметров в виде скрытых полей:

. . . . . . . . . . . . . .

В ссылке тот же результат может быть достигнут с помощью директивы:

Результатом будет ссылка:

PARAM1_NAME=PARAM1_VALUE&PARAM_NAME2=PARAM2_VALUE. . . . . . . . .

Директивы вызова внешнего скрипта

Директива использует синтаксис:

PHP=IP=[IP адрес]:[порт],[URL]>

Если IP не задан используются параметры по умолчанию из секции [PHP] DefaultServerPORT и DefaultServerIP.

Параметры передаются строкой URI GET. Адрес и порт сервера могут отличаться от строки URL. В этом случае перед URL должна стоять строка IP=IP_ADDRESS:IP_PORT.

Например:

Директива вставки результата выполнения текущей команды

Директива идентична команде RESULT в перечне фреймов, INI файла. Она выполняет текущую команду и выводит вместо себя результаты поиска или системные сообщения. Это освобождает от необходимости разбивки фреймов на 2 части и повышает наглядность кода.

Директивы отмены раскраски найденных терминов

Искомый фрагмент в результатах поиска выделяется цветом путём обрамления парными тегами. В тех случаях, когда это недопустимо и требуется сохранить термины в неизменной форме(в ссылках, например) целесообразно использовать директивы .При этом раскраски не происходит. Директива работает в форматах вывода. (fullwebr.pft, например)

жүктеу/скачать 327.5 Kb.

Достарыңызбен бөлісу: