Система автоматизации библиотек

7.7.7.2Последовательный поиск записей по заданному поисковому выражению или по заданному диапазону записей (K)

db_name – имя базы данных

search_exp – поисковое выражение на языке ISIS

num_records – число возвращаемых записей, если параметр 0, то возвращаются MAX_POSTINGS_IN_PACKET записей.

first_record – номер первой возвращаемой записи в общем списке найденных записей если параметр 0 – возвращается только количество найденных записей.

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

есть 4 варианта определить формат BRIEF:

• 
  1-й вариант – строка формата;
  
• 
  2-й вариант – имя файла формата расположенного на сервере по 10 пути для базы данных db_name, предваряемого символом @ (например, @brief);
  
• 
  3-й вариант – символ @ - в этом случае производится ОПТИМИЗИРОВАННОЕ форматирование, имя формата определяется видом записи;
  
• 
  4-й вариант – пустая строка. В этом случае форматирование не производится.
  

SEQUENCE – критерий отбора записей последовательного поиска в виде формата, который возвращает одну строку - 0 или 1. Отбор записей в случае задания поискового выражения search_exp выполняется по всему диапазону найденных записей без ограниченя MAX_POSTINGS_IN_PACKET.

ВОЗВРАТ

Список строк. В 1-й строке – код возврата, который определяется общим результатом выполнения команды – ZERO успешно, если нет – число меньше 0. Если команда выполнена успешно, далее идут строки в следующем виде: 2-я строка – число найденных записей

Далее идет список строк:

MFN # результат_форматирования

КОММЕНТАРИЙ

Результат_форматирования – это строка, в которой заменены разделители #10#13 на #30#31.

7.7.8Группа функций форматирования

7.7.8.1Форматирование данной записи по номеру записи (G)

ПАРАМЕТРЫ

db_name – имя базы данных

MFN – номер записи в базе данных db_name

format – есть 5 вариантов определить формат:

• 
  1-й вариант – строка формата;
  
• 
  2-й вариант – имя файла формата расположенного на сервере по 10 пути для базы данных db_name, предваряемого символом @ (например @brief) ;
  
• 
  3-й вариант – символ @ - в этом случае производится ОПТИМИЗИРОВАННОЕ форматирование, имя формата определяется видом записи;
  
• 
  4-й вариант – символ * - в этом случае производится форматирование как ВЫБОР ПОЛЯ, соответствующего 1-й ссылке каждого термина (например для ссылки в виде 1.200.2.3 берется 2-е[осс] повторение 200-го[метка] поля).
  
• 
  5-й вариант – пустая строка. В этом случае возвращается только список терминов.
  

При любом варианте перед форматированием сервер проделывает следующую операцию - в любом формате специальное сочетание символов вида *** (3 звездочки) заменяется на значение метки поля, взятого из 1-й ссылки для данного термина (например, для ссылки 1.200.1.1 формат вида v*** будет заменен на v200).

ВОЗВРАТ

В 1-й строке – код возврата, который определяется общим результатом выполнения форматирования. В следующих строках сохраняется результат форматирования.

ПРИМЕР ПРОТОКОЛА

	ЗАПРОС		ВОЗВРАТ
1	Код команды	G	Код команды	G
2	АРМ	R	Идентификатор	463302
3	Код команды	G	Номер команды	3
4	Идентификатор	463302
5	Номер команды	3
6	Имя (для работы форматера с ини файлом своего клиенту)	MASTERKEY
7	Пароль	MASTER
8
9
10
	База данных	IBIS	Код возврата	0
	format	@IBISW	Результат форматирования	{\pard\tx4\b \b Р 9(С)1 Ильин\par К 21\par \b0 \b Карамзин, Николай Михайлович.\b0 \par \tab
	Кол-во MFN	1
	Список MFN	22

7.7.8.2Форматирование группы записей (G)

ПАРАМЕТРЫ

db_name – имя базы данных для определения контекста форматирования

MFNList – список номеров записей организованный следующим образом:

• 
  1-й вариант – 1-я строка MFNList это 0, следующие строки определяют диапазон форматируемых записей minmfn, maxmfn. Если maxmfn = 0, то этот параметр определяется как максимальный номер записи в данной базе.
  
• 
  2-й вариант – 1-я строка MFNList больше 0, в этом случае MFNList - это список номеров записей, число которых задается в 1-й строке.
  

format – есть 5 вариантов определить формат:

• 
  1-й вариант – строка формата;
  
• 
  2-й вариант – имя файла формата расположенного на сервере по 10 пути для базы данных db_name, предваряемого символом @ (например @brief) ;
  
• 
  3-й вариант – символ @ - в этом случае производится ОПТИМИЗИРОВАННОЕ форматирование, имя формата определяется видом записи;
  
• 
  4-й вариант – символ * - в этом случае производится форматирование как ВЫБОР ПОЛЯ, соответствующего 1-й ссылке каждого термина (например для ссылки в виде 1.200.2.3 берется 2-е[осс] повторение 200-го[метка] поля).
  
• 
  5-й вариант – пустая строка. В этом случае возвращается только список терминов.
  

При любом варианте перед форматированием сервер проделывает следующую операцию - в любом формате специальное сочетание символов вида *** (3 звездочки) заменяется на значение метки поля, взятого из 1-й ссылки для данного термина (например, для ссылки 1.200.1.1 формат вида v*** будет заменен на v200).

ВОЗВРАТ

Список строк. В 1-й строке – код возврата, который определяется общим результатом выполнения команды. При успешном выполнении в следующих строках сохраняется результат форматирования

MFN # результат_форматирования

КОММЕНТАРИЙ

Если запись физически удалена - MFN отрицательный.

Результат_форматирования – это строка, в которой заменены разделители #10#13 на #30#31. Возврат функции форматирования одной записи не определен.

ПРИМЕР ПРОТОКОЛА

	ЗАПРОС		ВОЗВРАТ
1	Код команды	G	Код команды	G
2	АРМ	R	Идентификатор	240954
3	Код команды	G	Номер команды	16
4	Идентификатор	240954
5	Номер команды	16
6	Имя (для работы форматера с ини файлом своего клиенту)	MASTERKEY
7	Пароль	MASTER
8
9
10
	База данных	IBIS	Код возврата	0
	MFN	@brief	Результат форматирования	22#Карамзин, Николай Михайлович. История государства Российского [Текст] : В 12 томах. Т.2 : [Г.1015-1169], 1830. - [4],367,[2],120 с.
	Кол-во MFN	4		23#Азбукина З.М. Определитель грибов России. Порядок головневые [Текст]. Вып.2 : Семейство Тиллетиевые / З.М. Азбукина, И.В. Каратыгин; Отв. ред. А.Н. Мельник, 1995. - 263 с.
	Список MFN	22		24#Крол Э. Все об Internet [Текст] : Руководство и кат. / Э.Крол; Пер.с англ. С.М.Тимачева, 1995. - 591 с.
		23		25#Дарахвелидзе П. Delphi - среда визуального программирования [Текст] / П.Дарахвелидзе, Е.Марков, 1996. - 352 с.

7.7.8.3Форматирование виртуальной записи (G)

ПАРАМЕТРЫ

db_name – имя базы данных для определения контекста форматирования

format – есть 5 вариантов определить формат:

• 
  1-й вариант – строка формата;
  
• 
  2-й вариант – имя файла формата расположенного на сервере по 10 пути для базы данных db_name, предваряемого символом @ (например @brief) ;
  
• 
  3-й вариант – символ @ - в этом случае производится ОПТИМИЗИРОВАННОЕ форматирование, имя формата определяется видом записи;
  
• 
  4-й вариант – символ * - в этом случае производится форматирование как ВЫБОР ПОЛЯ, соответствующего 1-й ссылке каждого термина (например для ссылки в виде 1.200.2.3 берется 2-е[осс] повторение 200-го[метка] поля).
  
• 
  5-й вариант – пустая строка. В этом случае возвращается только список терминов.
  

При любом варианте перед форматированием сервер проделывает следующую операцию - в любом формате специальное сочетание символов вида *** (3 звездочки) заменяется на значение метки поля, взятого из 1-й ссылки для данного термина (например, для ссылки 1.200.1.1 формат вида v*** будет заменен на v200).

Rec – строка, состоящая из группы следующих параметров:

MFN#STATUS#30#310#VERSION#30#31TAG1#FIELD1#30#31 … TAG1#FIELD1#30#31

ВОЗВРАТ

Список строк. В 1-й строке – код возврата, который определяется общим результатом выполнения команды. При успешном выполнении в следующих строках сохраняется результат форматирования

КОММЕНТАРИЙ

Результат_форматирования – это строка, в которой заменены разделители #10#13 на #30#31.

ПРИМЕР ПРОТОКОЛА

	ЗАПРОС		ВОЗВРАТ
1	Код команды	G	Код команды	G
2	АРМ	R	Идентификатор	240954
3	Код команды	G	Номер команды	16
4	Идентификатор	240954
5	Номер команды	16
6	Имя (для работы форматера с ини файлом своего клиенту)	MASTERKEY
7	Пароль	MASTER
8
9
10
	База данных	IBIS	Код возврата	0
	format	@brief	Результат форматирования	Карамзин, Николай Михайлович. История государства Российского [Текст] : В 12 томах. Т.2 : [Г.1015-1169], 1830. - [4],367,[2],120 с.
	Константное значение	-2
	Rec	MFN#STATUS#30#310#VERSION#30#31TAG1#FIELD1#30#31 … TAG1#FIELD1#30#31

7.7.9Администраторские команды

7.7.9.1Получить список логически удаленных, физически удаленных, неактуализированных и заблокированных записей. (0)

ПАРАМЕТРЫ

db_name – имя базы данных для определения контекста форматирования

ВОЗВРАТ

Код возврата. 0 если успех.

Список логически удаленных

Список физически удаленных

Список неактуализированных

Список заблокированных

Максимальный mfn в БД

Флаг блокировки БД

ПРИМЕР ПРОТОКОЛА

	ЗАПРОС		ВОЗВРАТ
1	Код команды	0	Код команды	0
2	АРМ	A	Идентификатор	240954
3	Код команды	0	Номер команды	16
4	Идентификатор	240954
5	Номер команды	16
6	Имя	MASTERKEY
7	Пароль	MASTER
8
9
10
	База данных	IBIS	Код возврата	0
				LogDel
				PhisDel
				NotActual
				Locked
				MaxMfn
				IsDbLocked

7.7.9.2Опустошение БД (S)

ПАРАМЕТРЫ

db_name – имя базы данных для определения контекста форматирования

ВОЗВРАТ

Код возврата. 0 если успех.

ПРИМЕР ПРОТОКОЛА

	ЗАПРОС		ВОЗВРАТ
1	Код команды	S	Код команды	S
2	АРМ	A	Идентификатор	240954
3	Код команды	S	Номер команды	16
4	Идентификатор	240954
5	Номер команды	16
6	Имя	MASTERKEY
7	Пароль	MASTER
8
9
10
	База данных	IBIS	Код возврата	0

7.7.9.3Разблокировать запись (Q)

ПАРАМЕТРЫ

db_name – имя базы данных для определения контекста форматирования

mfnlist – набор строк, в каждой строке mfn для разблокирования

ВОЗВРАТ

Код возврата. 0 если успех.

ПРИМЕР ПРОТОКОЛА

	ЗАПРОС		ВОЗВРАТ
1	Код команды	Q	Код команды	Q
2	АРМ	A	Идентификатор	240954
3	Код команды	Q	Номер команды	16
4	Идентификатор	240954
5	Номер команды	16
6	Имя	MASTERKEY
7	Пароль	MASTER
8
9
10
	База данных	IBIS	Код возврата	0
	Mfn 1	125
	Mfn 2	137

жүктеу/скачать 6.79 Mb.

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