Назначение модуля Record

НАЧАЛО >> Руководство пользователя >> Назначение модуля Record📄 Скачать в DOCX

Record - служебный модуль модели записи ИРБИС 128. Он предоставляет объект ObjectDataRecord и набор функций для чтения, изменения, преобразования и хранения записей, с которыми работают пользовательские и административные модули системы.

Модуль не является отдельным пользовательским АРМ. Его справка нужна разработчикам и администраторам сопровождения, которые разбирают автодокументацию функций или диагностируют обработку записей в других модулях.

1. Основные задачи

создание нового объекта записи через Record->GetNew();
работа с полями, повторениями и подполями записи;
разбор записей из текстового формата ИРБИС, JSON, MARC и MarcWeb;
выгрузка записи в массив, JSON, XML, MARC и текстовые форматы;
хранение служебных данных записи по SID;
ускоренное повторное чтение записей через кеш Record_Content и карту Record_SidMap;
работа с SID-файлами и встроенными SQLite-базами записи;
управление связями между записями;
применение FST и GBL к записи;
поддержка служебных счетчиков, блокировок и кэша.

2. Модель записи

Запись представлена классом ObjectDataRecord. Основное содержимое хранится в массиве Content: метка поля указывает на список повторений, а каждое повторение содержит набор подполей. Порядок меток полей для ИРБИС не является значимым, но порядок повторений одного поля сохраняется.

Основные служебные свойства:

mfn - MFN записи в базе данных;
Status - статус записи;
RecVersion - версия записи;
_sid - системный идентификатор записи для хранения связанных файлов и служебных данных;
curocc - текущее повторение поля для коротких функций доступа.

3. Работа с полями

Для чтения и изменения структуры записи используются функции GetField, GetFieldA, GetFieldAA, GetSubField, SetField, SetFieldA, SetFieldAA, SetSubField, FieldAdd, FieldDelete, SubFieldDelete, SortField и связанные с ними короткие функции v, d, n, f, sf.

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

4. SID и служебные данные

SID используется для хранения данных, связанных с записью вне основного массива полей: файлов, SQLite-таблиц, метаданных, временных данных и блокировок. Для этого используются функции EnsureSid, GetSid, SetSid, GetSidFile, SetSidFile, GetSidDb, InitSidDb, SetSidDbData, LockSidElm, UnlockSidElm и связанные функции.

SID-хранилище применяется там, где данные записи должны сопровождаться внешними файлами или служебными таблицами, например при работе с полными текстами, логами и временными результатами обработки.

Повторное чтение содержимого записи и поиск записи по SID дополнительно используют системный кеш Cache. Подробности см. в разделе Кеширование содержимого записи и SID.

5. Связи записей

Функции CreateLink, AppendLink, GetLinks, GetLinkedRecords, GetBackLinked, KillLink, KillLinkSide и UnionLinks используются для управления связями между записями. Тип связи задается вызывающим модулем и должен быть согласован с его бизнес-логикой.

6. Автодокументация

Полный список функций, их параметров и action ExportWDelete доступен в автодокументации модуля:

функции: ?id=Help/Show&m=Help/Help/Module/Functions&module=Record;
действия: ?id=Help/Show&m=Help/Help/Module/Actions&module=Record.

Для пользовательских сценариев следует обращаться к справке тех модулей, которые используют записи: Database, Cataloguer, FT, Bookland, Corrector и другим предметным разделам.