Протокол работы TCP/IP сервера ИРБИС 64 — различия между версиями

Материал из Wikipedia
Перейти к: навигация, поиск
(Функции работы с контекстом)
(Работа с мастер-файлом базы данных)
Строка 188: Строка 188:
 
== Работа с мастер-файлом базы данных ==
 
== Работа с мастер-файлом базы данных ==
 
=== Прочитать запись ===
 
=== Прочитать запись ===
 +
{| style="width:100%;background-color:gray;" cellspacing="1"
 +
|- style="background-color:white;"
 +
!style="width:20%;"|Объявление функции
 +
!style="width:30%;"|Параметры
 +
!style="width:30%;"|Возврат
 +
!style="width:20%;"|Комментарий
 +
|- style="background-color:white;"
 +
|<span style="color:blue">function</span> name(
 +
:parameter: '''type''';
 +
:answer: '''TStringList'''
 +
): integer;
 +
|
 +
|
 +
|
 +
|}
 
=== Прочитать запись и произвести ее расформатирование ===
 
=== Прочитать запись и произвести ее расформатирование ===
 +
{| style="width:100%;background-color:gray;" cellspacing="1"
 +
|- style="background-color:white;"
 +
!style="width:20%;"|Объявление функции
 +
!style="width:30%;"|Параметры
 +
!style="width:30%;"|Возврат
 +
!style="width:20%;"|Комментарий
 +
|- style="background-color:white;"
 +
|<span style="color:blue">function</span> name(
 +
:parameter: '''type''';
 +
:answer: '''TStringList'''
 +
): integer;
 +
|
 +
|
 +
|
 +
|}
 
=== Записать запись ===
 
=== Записать запись ===
 +
{| style="width:100%;background-color:gray;" cellspacing="1"
 +
|- style="background-color:white;"
 +
!style="width:20%;"|Объявление функции
 +
!style="width:30%;"|Параметры
 +
!style="width:30%;"|Возврат
 +
!style="width:20%;"|Комментарий
 +
|- style="background-color:white;"
 +
|<span style="color:blue">function</span> name(
 +
:parameter: '''type''';
 +
:answer: '''TStringList'''
 +
): integer;
 +
|
 +
|
 +
|
 +
|}
 
=== Записать группу записей ===
 
=== Записать группу записей ===
 +
{| style="width:100%;background-color:gray;" cellspacing="1"
 +
|- style="background-color:white;"
 +
!style="width:20%;"|Объявление функции
 +
!style="width:30%;"|Параметры
 +
!style="width:30%;"|Возврат
 +
!style="width:20%;"|Комментарий
 +
|- style="background-color:white;"
 +
|<span style="color:blue">function</span> name(
 +
:parameter: '''type''';
 +
:answer: '''TStringList'''
 +
): integer;
 +
|
 +
|
 +
|
 +
|}
 
=== Разблокировать запись ===
 
=== Разблокировать запись ===
 +
{| style="width:100%;background-color:gray;" cellspacing="1"
 +
|- style="background-color:white;"
 +
!style="width:20%;"|Объявление функции
 +
!style="width:30%;"|Параметры
 +
!style="width:30%;"|Возврат
 +
!style="width:20%;"|Комментарий
 +
|- style="background-color:white;"
 +
|<span style="color:blue">function</span> name(
 +
:parameter: '''type''';
 +
:answer: '''TStringList'''
 +
): integer;
 +
|
 +
|
 +
|
 +
|}
 
=== Актуализировать запись ===
 
=== Актуализировать запись ===
 +
{| style="width:100%;background-color:gray;" cellspacing="1"
 +
|- style="background-color:white;"
 +
!style="width:20%;"|Объявление функции
 +
!style="width:30%;"|Параметры
 +
!style="width:30%;"|Возврат
 +
!style="width:20%;"|Комментарий
 +
|- style="background-color:white;"
 +
|<span style="color:blue">function</span> name(
 +
:parameter: '''type''';
 +
:answer: '''TStringList'''
 +
): integer;
 +
|
 +
|
 +
|
 +
|}
 
=== Получить максимальный MFN базы данных ===
 
=== Получить максимальный MFN базы данных ===
 +
{| style="width:100%;background-color:gray;" cellspacing="1"
 +
|- style="background-color:white;"
 +
!style="width:20%;"|Объявление функции
 +
!style="width:30%;"|Параметры
 +
!style="width:30%;"|Возврат
 +
!style="width:20%;"|Комментарий
 +
|- style="background-color:white;"
 +
|<span style="color:blue">function</span> name(
 +
:parameter: '''type''';
 +
:answer: '''TStringList'''
 +
): integer;
 +
|
 +
|
 +
|
 +
|}
 +
 
== Функции работы со словарем базы данных ==
 
== Функции работы со словарем базы данных ==
 
=== Получить список терминов словаря, начиная с данного ===
 
=== Получить список терминов словаря, начиная с данного ===

Версия 19:25, 6 февраля 2010

Все функции работы с сервером ИРБИС64 имеют параметры запроса и строки ответа в последнем параметре функции. То есть шаблон функции может быть представлен в виде: function(A1...AN; answer: TStringList) Где

Параметры
A1...AN – параметры запроса
Возврат
answer – список строк ответа, который организован таким образом, что в первой строке как правило – числовой код возврата (в строковом представлении), далее - строки результата.
Комментарий

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

  • mrOK – пришел ответ сервера в ожидаемом формате.
  • mrCancel – ошибка при обработке запроса – нет гарантии что ответ правильный.
  • mrNo – клиент находится в процессе обработки предыдущего запроса и не может обработать данный запрос.

Содержание

Общие функции

Регистрация пользователя

Объявление функции Параметры Возврат Комментарий
function irbis_client_reg (
aserver_host: string;
aserver_port: string;
arm: char;
user_name: string;
password: string;
answer: TStringList

): integer;

aserver_host – адресс сервера в числовом виде (например 255.255.255.255)

aserver_port – рабочий порт сервера (6666)

arm – вид клиента

читатель (IRBIS_READER),
каталогизатор (IRBIS_CATALOG)
комплектатор (IRBIS_COMPLECT),
книговыдача (IRBIS_BOOKLAND).

user_name – имя пользователя

password – пароль пользователя

В answer в первой строке код возврата. Если код возврата равен ZERO, то следующие строки в answer - это ini-файл, определенный на сервере для данного пользователя. Если код возврата не равен ZERO - в answer только одна строка.
Коды возврата
ZERO
CLIENT_ALREADY_EXISTS - пользователь уже зарегистрирован.
WRONG_PASSWORD - неверный пароль.
CLIENT_ALREADY_EXISTS - пользователь уже зарегистрирован
Перед началом работы с сервером ИРБИС64 требуется произвести регистрацию с помощью данной функции. В случае успешного выполнения клиент получает ini-файл с определенными параметрами, необходимыми для работы программы.

Разрегистрация клиента (сигнал окончания работы)

Объявление функции Параметры Возврат Комментарий
function name(
parameter: type;
answer: TStringList

): integer;

Подтверждение регистрации

Объявление функции Параметры Возврат Комментарий
function name(
parameter: type;
answer: TStringList

): integer;

Запись параметров в ini-файл клиента расположенный на сервере ИРБИС64

Объявление функции Параметры Возврат Комментарий
function name(
parameter: type;
answer: TStringList

): integer;

Функции работы с контекстом

Функция чтения текстового ресурса (файла) расположенного на сервере ИРБИС64

Объявление функции Параметры Возврат Комментарий
function name(
parameter: type;
answer: TStringList

): integer;

Очистка памяти кэша

Объявление функции Параметры Возврат Комментарий
function name(
parameter: type;
answer: TStringList

): integer;

Функция чтения группы текстовых ресурсов расположенных на сервере ИРБИС64

Объявление функции Параметры Возврат Комментарий
function name(
parameter: type;
answer: TStringList

): integer;

Функция чтения двоичного ресурса (бинарного файла) расположенного на сервере ИРБИС64

Объявление функции Параметры Возврат Комментарий
function name(
parameter: type;
answer: TStringList

): integer;

Функция записи текстового ресурса (файла) на сервер ИРБИС64

Объявление функции Параметры Возврат Комментарий
function name(
parameter: type;
answer: TStringList

): integer;

Работа с мастер-файлом базы данных

Прочитать запись

Объявление функции Параметры Возврат Комментарий
function name(
parameter: type;
answer: TStringList

): integer;

Прочитать запись и произвести ее расформатирование

Объявление функции Параметры Возврат Комментарий
function name(
parameter: type;
answer: TStringList

): integer;

Записать запись

Объявление функции Параметры Возврат Комментарий
function name(
parameter: type;
answer: TStringList

): integer;

Записать группу записей

Объявление функции Параметры Возврат Комментарий
function name(
parameter: type;
answer: TStringList

): integer;

Разблокировать запись

Объявление функции Параметры Возврат Комментарий
function name(
parameter: type;
answer: TStringList

): integer;

Актуализировать запись

Объявление функции Параметры Возврат Комментарий
function name(
parameter: type;
answer: TStringList

): integer;

Получить максимальный MFN базы данных

Объявление функции Параметры Возврат Комментарий
function name(
parameter: type;
answer: TStringList

): integer;

Функции работы со словарем базы данных

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

Получить список терминов словаря, начиная с данного и расформатировать записи, соответствующие 1-й ссылке каждого термина из этого списка

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

Получить список терминов словаря в обратном порядке, начиная с данного и расформатировать записи, соответствующие 1-й ссылке каждого термина из этого списка

Получить список ссылок для данного термина

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

Получить список ссылок для данного термина и расформатировать записи им соответствующие

Группа функций поиска

Поиск записей по заданному поисковому выражению

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

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

Расформатирование данной записи по номеру записи

Расформатирование данной виртуальной записи в клиентском представлении (не содержащейся в базе данных)

Расформатирование группы записей

Печать

Получить выходную табличную форму по заданному набору записей

Статистика

Получить выходную табличную форму статистического распределения заданных параметров в базе данных

Глобальная корректировка

Глобальная корректировка заданного набора записей

Глобальная корректировка заданного набора записей с формально-логическим контролем и возможностью отменить autoin