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

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

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

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

Комментарий

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

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

Содержание

1 Общие функции
2 Функции работы с контекстом
3 Работа с мастер-файлом базы данных
4 Функции работы со словарем базы данных
5 Группа функций поиска
- 5.1 Поиск записей по заданному поисковому выражению
- 5.2 Последовательный поиск записей по заданному поисковому выражению или по заданному диапазону записей
6 Группа функций форматирования
7 Печать
- 7.1 Получить выходную табличную форму по заданному набору записей
8 Статистика
- 8.1 Получить выходную табличную форму статистического распределения заданных параметров в базе данных
9 Глобальная корректировка
- 9.1 Глобальная корректировка заданного набора записей
- 9.2 Глобальная корректировка заданного набора записей с формально-логическим контролем и возможностью отменить autoin

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

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

Объявление функции

Параметры

Возврат

Комментарий

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

Объявление функции

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

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

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

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

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

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

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

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

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

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

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

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

@@ Строка 106: / Строка 106: @@
 == Функции работы с контекстом ==
 === Функция чтения текстового ресурса (файла) расположенного на сервере ИРБИС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;
+|
+|
+|
+|}
 === Очистка памяти кэша ===
+{| 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 ===
+{| 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 ===
+{| 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 ===
+{| 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;
+|
+|
+|
+|}
 == Работа с мастер-файлом базы данных ==
 === Прочитать запись ===

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

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

Содержание

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Печать

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

Статистика

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

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

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

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

Навигация

Поиск