Параметры ИРБИС-ссылки

Команда
(значение параметра C21COM)

Параметры команды

ИМЯ
(по умолчанию)

СОДЕРЖАНИЕ

ЗНАЧЕНИЕ
по умолчанию

ПОЯСНЕНИЯ

Модельное поле
(по умолчанию)

(любая – т.е. соответствующие параметры могут использоваться для любой команды)

SERVERIP

IP-адрес сервера БД ИРБИС

-

Является параметром «длительного» действия, определяюшим контекст работы. Действует для всех последующих команд, пока не будет задано иное значение

-

SERVERPORT

Порт сервера БД ИРБИС

-

(то же самое)

-

DBNAME_DEFAULT

Имя БД, используемое по умолчанию (т.е. в тех случаях, когда явно не задан параметр I21DBN)

-

(то же самое)

-

PFTNAME_DEFAULT

Имя формата, используемое по умолчанию (т.е. в тех случаях, когда явно не задан параметр PFTNAME)

-

(то же самое)

-

CHECKNAME

Значение параметра NAME для тэга <input type=”checkboxname=…>, на основании которого ведется список отмеченных (отобранных) элементов

Значениями отобранных (отмеченных) элементов являются значения параметра VALUE для тэга INPUT

-

(то же самое)
Каждый раз при задании данного параметра список отмеченных элементов обнуляется. Кол-во отмеченных элементов передается через модельное поле (1003). Собственно отобранные элементы передаются через повторения модельного поля 1004 подполе А (кроме случая использования команды 5 - см. ниже)

1003

1004

CHECKPFT

Имя формата для постобработки отобранных (отмеченных) элементов.

-

Используется для форматирования модельной записи, через которую передаются отобранные (отмеченные) элементы – через поле 1004 подполе A

1004

CHECKCLEAR

В случае непустого (любого) значения определяет обнуление списка отмеченных элементов

 

 

 

TOPPFTNAME

Имя формата для формирования  верхнего колон-титула результирующей страницы

-

Формат используется для форматирования МОДЕЛЬНОЙ записи

-

BOTTOMPFTNAME

Имя формата для формирования  нижнего колон-титула результирующей страницы

-

(то же самое)

-

I21DBN

Имя БД

Значение параметра DBNAME_DEFAULT

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

1000

PFTNAME

Имя формата для формирования основной части результирующей страницы

Значение параметра PFTNAME_DEFAULT

Формат должен находиться в директории соответств. БД или в общем депозитарии

1012

RELOAD

Правило обновления результирующей страницы при переходах (ВПЕРЕД, НАЗАД…)

0

Принимает два значения:
0 – страница не обновляется;
1 – страница каждый раз обновляется

-

PRINTCOM

Признак печати результирующей страницы

0

Принимает три значения:

0 – страница отображается в окне навигатора (по умолчанию);

1 – страница распечатывается с предварительным просмотром;

2 – страница распечатывается без предварительного просмотра

3 – страница распечатывается в указанный файл

 

1
Просмотр одного документа
(Ссылка на один документ)

KEY

Ключ для доступа к документу

-

Может задаваться в виде:
<termin> - в этом случае по ссылке берется первый документ;
@MFN – берется документ с указанным MFN

-

ENTRY_MFN

MFN документа

-

Учитывается в случае, если не задан KEY.
Если MFN=0, предполагается НОВЫЙ документ.
Если не задан ни KEY, ни ENTRY_MFN, используется МОДЕЛЬНАЯ запись.

-

2
Поиск/Просмотр
(Ссылка на группу документов)


S21STR

Текст с терминами поиска при единственном ВИДЕ поиска

ОСОБЫЙ СЛУЧАЙ:

если S21STR=* и задан CHECKPFT, текст для поиска формируется как результат форматирования отобранных элементов по формату CHECKPFT (см. CHECKPFT)

-

 

1001

***S21STR

Текст с терминами поиска для одного ВИДА поиска.

-

Произвольный префикс *** определяет группу  разноименных параметров, относящихся к одному ВИДУ поиска

 

***S21P01

Правило извлечения терминов поиска из текста

0

Принимает следующие значения:
0 – весь текст рассматривается как один термин;
1 – терминами являются слова, извлеченные из текста;
2 – термином является первое слова текста (до пробела);
3 – то же, что 1 и дополнительно – у слов отсекаются окончания;
4 – терминами являются элементы, отобранные (отмеченные) в соответствии с действующим параметром CHECKNAME. При этом игнорируется значение соответствующего параметра ***S21STR

 

***S21P02

Применение аппарата правого усечения терминов поиска

0

Принимет следующие значения:
0 – правое усечение не используется;
1 – правое усечение используется

 

***S21P03

Префикс для терминов поиска

-

Совпадает с префиксом соответствующего словаря (ВИДА поиска)

 

***S21P04

Квалификатор для терминов поиска – в виде последовательности меток, разделенных запятой

-

Связан с точками входа ТВП инвертирования, образующими соответствующий словарь

 

***S21P05

Название поиска на естественном языке

Значение параметра
***S21P03

 

 

***S21LOG

Логика связи терминов поиска (одного вида)

0

Принимает следующие значения;
0 – логика ИЛИ;
1 – логика И;
2 – логика ФРАЗА ЦЕЛИКОМ;
3 – логика НЕТ

 

S21LOG

Логика связи разных видов поиска

1

Принимает следующие значения;
0 – логика ИЛИ;
1 – логика И

 

S21STN

Порядковый номер первого документа в выдаваемой порции

1

 

 

S21CNR

Размер порции выдаваемых документов

5

 

1006

S21ALL

Поисковое выражение на языке запросов ИРБИС

-

Если также заданы виды поиска ***S21STR, то они объединяются с S21ALL логикой И – тем самым реализуется ПОИСК В НАЙДЕННОМ. В результирующее модельное поле (1007) помещается объединенное поисковое выражение


1007

QUERY

Формулировка запроса (S21ALL) на естественном языке

-

В результирующее модельное поле (1010) помещается формулировка итогового запроса на естественном языке

1010

S21ALLTRM

Термины для разметки (раскраски) выходной страницы

-

Термины разделяются символом |.
Минимальная длина раскрашиваемого термина определяется параметром INI-файла MINLKWLIGHT

1009

KEY

Термин для доступа к документам

-

Используется если НЕ заданы  S21ALL и ни один из ***S21STR.
Рассматривается только как термин (т.е. конструкция @MFN здесь НЕ применима)
ЕСЛИ НЕ ЗАДАНЫ НИ S21ALL, НИ ОДИН ИЗ ***S21STR, НИ KEY в качестве результата поиска рассматривается ВСЯ БД – так реализуется режим просмотра БД в целом.

 

 

 

 

Результат поиска (кол-во документов) сохраняется в модельном поле (1002) модельной записи

1002

 

 

 

Порядковый номер (^A) и MFN (^B) первого док-та в порции сохраняется в модельном поле (1008) модельной записи

1008^A…^B

 

 

 

Порядковый номер (^A) и MFN (^B) последнего док-та в порции сохраняется в модельном поле (1005) модельной записи

1005^A…^B

3
Ссылка на файловый ресурс через относительную адресацию ИРБИС

PATH

Относительный путь в системе ИРБИС

-

Принимает следующие значения:
0 – основная директория ИРБИС;
1 – общая директория БД (.\DATAI);
2,3,10 – директория БД;
11 – обращение к файлу, который находится по пути в соответствии с 11 строкой файла DBNAME.PAR;

12 – обращение к внутреннему двоичному ресурсу; в этом случае значение параметра FILENAME задается в виде MFN,N – где MFN – номер документа, N – порядковый номер внутреннего двоичного ресурса

13 – обращение к внешнему файлу; в этом случае параметр FILENAME должен  содержать полный путь

.

 

FILENAME

Имя файлового ресурса (имя файла с расширением)

-

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

 

4
Просмотр словаря
(Ссылка на фрагмент/порцию словаря)

T21TRM

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

-

 

 

T21PRF

Префикс терминов словаря (вид словаря)

-

 

1011

T21CNR

Размер порции терминов словаря

100

 

1006

T21NEXT

Направление чтения словаря: 1 – вперед (по возрастанию); 0 – назад (по убыванию)

1

 

 

T21PREV

Начинать ли порцию с предыдущего термина, если не найден начальный

(1 – ДА; 0 – НЕТ)

0

 

 

 

 

 

Каждый термин порции (^A) и соответствующее ему кол-во ссылок (^B) сохраняется как повторение модельного поля (1004)  модельной записи

(1004^A…^B)

 

 

 

Первый термин порции  (^A) и соответствующее ему кол-во ссылок (^B) сохраняется в модельном поле (1008)  модельной записи

1008^A…^B

 

 

 

Последний термин порции  (^A) и соответствующее ему кол-во ссылок (^B) сохраняется в модельном поле (1005)  модельной записи

1005^A…^B

5
Просмотр списка/справочника
(Ссылка на список / справочник)

LISTNAME

Имя списка/справочника (имя файла с расширением)

 

Если список НЕ задан, предполагается список отмеченных (отобранных) элементов в соответствии с параметром CHECKNAME

 

PATH

Относительный путь в системе ИРБИС

 

(см. выше)

 

 

 

 

Каждый элемент списка (^A) и соответствующее ему пояснение, если списком является MNU,  (^B) сохраняется как повторение модельного поля (1004) модельной записи

(1004^A…^B)

 

 

 

Первый элемент списка (^A) и соответствующее ему пояснение, если списком является MNU,  (^B) сохраняется в модельном поле (1008) модельной записи

1008^A…^B

 

 

 

Последний элемент списка (^A) и соответствующее ему пояснение, если списком является MNU,  (^B) сохраняется в модельном поле (1005) модельной записи

1005^A…^B

6
Редактирование/ввод документа (записи)

ENTRY_MFN

MFN редактируемого док-та

-

Если MFN=0, создается НОВЫЙ документ.
Если MFN<0, соответствующий документ УДАЛЯЕТСЯ

 

tag_nnR21STR

Значение поля

-

tag – метка поля;
nn – порядковый номер поля в записи (при MFN<=0 или R21UPD=0 НЕ ИСПОЛЬЗУЕТСЯ)

 

tag_nn_dR21SUB

Значение подполя

 

Используется только при R21UPD=0.

tag – метка поля;

nn – номер повторения;

d – разделитель подполя

 

R21UPD

Режим редактирования

0

Принимает два значения:
0 – режим полного обновления записи, т.е. запись опустошается и создается заново;
1 – режим замены/добавления, т.е. для полей с tag_nn, имеющимися в записи, действует правило замены, для остальных – правило добавления

 

ENTRY_DBNFLC

Имя формата для ФЛК записи в целом

-

При отрицательном результате ФЛК редактирование НЕ проходит

 

R21IFP

Необходимость актуализации записи

1

Принимает два значения:
0–отредактированная или вновь созданная запись НЕ актуализируется;
1- отредактированная или вновь созданная запись актуализируется

 

ENTRY_MESSAGE

Сообщение, которое выдается при благополучном выполнении команды вместо стандартного

-

Если в качестве значения задается символ ! – никаких сообщений при благополучном выполнении команды не выдается

 

ENTRY_AFTERACTION

Код действия после выполнения команды

1

Принимает значения:

0 – страница (интерфейс) после выполнения команды не изменяется

1 – стандартное действие

 

7
Экспорт документов

EXPORT_FROMMFN

Начальный MFN экспортируемых документов

EXPORT_TOMFN

 

 

EXPORT_TOMFN

Конечный MFN экспортируемых документов

EXPORT_FROMMFN

 

 

S21ALL

Поисковое выражение на языке запросов ИРБИС

-

Если задан – экспортируются документы по результату поиска (с учетом заданных EXPORT_FROMMFN и EXPORT_TOMFN)
ЕСЛИ НЕ ЗАДАНЫ НИ S21ALL, НИ EXPORT_FROMMFN, НИ EXPORT_TOMFN – экспортируются отмеченные (отобранные) документы в соответствии с параметром CHECKNAME (т.е. в этом случае отобранные элементы безусловно рассматриваются как MFN)

 

EXP21FMT

Форма представления экспортируемых документов

ISO

Принимает два значения:
ISO – представление в форме ISO 2709;
TXT – представление в текстовом виде.

 

EXP21CODE

Кодировка представления экспортируемых документов

UTF8

Принимает следующие значения:
UTF8
WIN
DOS

 

EXP21FST

Имя ТВП переформатирования для экспорта

-

Указывается имя файла FST (без расширения)

 

EXPFULLTEXT

Определяет, выгружать ли связанные внешние объекты

0

Принимает два значения:

0 – не выгружать;

1 - выгружать

 

8
Импорт документов

IMP21FMT

Форма представления импортируемых документов

ISO

Принимает два значения:
ISO – представление в форме ISO 2709;
TXT – представление в текстовом виде.

 

IMP21CODE

Кодировка представления импортируемых документов

UTF8

Принимает следующие значения:
UTF8
WIN
DOS

 

IMP21FST

Имя ТВП переформатирования для импорта

-

Указывается имя файла FST (без расширения)

 

R21IFP

Необходимость актуализации импортируемых док-ов

1

Принимает два значения:
0 – импортированные записи НЕ актуализируются;
1 - импортированные записи актуализируются

 

ENTRY_DBNFLC 

Имя формата для ФЛК импортируемых док-ов в целом

-

При отрицательном результате ФЛК импортированная запись помечается как ЛОГИЧЕСКИ УДАЛЕННАЯ

 

9

Управление переходами

ACTION

Направление перехода

 

0 – перейти на домашнюю страницу

1 – перейти ВПЕРЕД

2 – перейти НАЗАД

 

10

Полнотекстовый поиск

S21STR

Текст на естественном языке для полнотекстового поиска.

ОСОБЫЙ СЛУЧАЙ:

если S21STR=* и задан CHECKPFT, текст для поиска формируется как результат форматирования отобранных элементов по формату CHECKPFT (см. CHECKPFT)

 

 

1001

S21P03

Префикс терминов

KT=

 

 

S21STN

Порядковый номер первого документа в выдаваемой порции

1

 

 

S21CNR

Размер порции выдаваемых документов

20

 

1006

S21ALL

Текст уточняемого запроса на естественном языке (для реализации поиска в найденном)

 

В результирующее модельное поле (1007) помещается текст объединенного запроса

1007

FullText_Morphology

Учитывать морфологию слов  (1) или производить отсечение и правое усечение слов (0)

0

 

 

FullText_MaxWordsDistance

Максимальное расстояние между найденными в тексте словами

-1

При –1 – не учитывается

 

FullText_MaxCountResult

Максимальное кол-во выдаваемых документов

100

 

 

 

 

 

Результат поиска (кол-во документов) сохраняется в модельном поле (1002) модельной записи

1002

 

 

 

Порядковый номер (^A) и MFN (^B) первого док-та в порции сохраняется в модельном поле (1008) модельной записи

1008^A…..^B….

 

 

 

Порядковый номер (^A) и MFN (^B) последнего док-та в порции сохраняется в модельном поле (1005) модельной записи

1005^A…..^B….

11

Выполнение функции пользователя

USERDLLNAME

Имя DLL пользователя

-

 

 

USERFUNCTIONNAME

Имя функции пользователя

-

Функция пользователя должна иметь вид, который описан в RELEASE_6_1.DOC

В случае, когда функция возвращает значение отличное от 0, данные выходного буфера рассматриваются как результирующие.

 

USERDATA

Исходные данные для функции пользователя

-

 

 

(любая)

FREEPARnn

Произвольный параметр nn

 

В модельной записи передаются через модельные поля NNN+nn

где NNN - начальная метка для произвольных параметров. По умолчанию 1100

При форматировании реальных (не модельных) записей значения произвольных параметров доступны через соответствующие глобальные переменные, т.е., например, значение произвольного параметра 10 (FREEPAR10) при форматировании реальной записи доступно через глобальную перменную с номером 1110 (G1110)

Кол-во произвольных модельных полей определяется в INI-файле параметром NUMBFREEPAR


1100

1101

.......

1100+NUMBFREEPAR