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

Материал из Wikipedia
Перейти к: навигация, поиск
(Разрегистрация клиента (сигнал окончания работы))
(добавлена шаблонная таблица опсиания функции во все подразделы "Общий функций")
Строка 71: Строка 71:
  
 
=== Подтверждение регистрации ===
 
=== Подтверждение регистрации ===
 +
{| 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;
 +
|
 +
|
 +
|
 +
|}
 +
 
=== Запись параметров в ini-файл клиента расположенный на сервере ИРБИС64 ===
 
=== Запись параметров в ini-файл клиента расположенный на сервере ИРБИС64 ===
 +
{| 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;
 +
|
 +
|
 +
|
 +
|}
 +
 
== Функции работы с контекстом ==
 
== Функции работы с контекстом ==
 
=== Функция чтения текстового ресурса (файла) расположенного на сервере ИРБИС64 ===
 
=== Функция чтения текстового ресурса (файла) расположенного на сервере ИРБИС64 ===

Версия 19:23, 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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Печать

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

Статистика

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

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

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

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