Справочники заказчика

1. Зачем это

Бумажный бланк заполняется от руки, и написать в поле можно что угодно. Но часть полей — это отметка в клетке с напечатанной подписью: «Кожа», «Пергамент», «Ткань». Такое значение переносится в электронную карту не как текст, а как значение справочника: у него есть код, и в АБИС уходит именно код.

Заказчик передал справочники в том виде, в каком они ведутся в его системе. Здесь описано, что именно передано и к каким полям относится; сами файлы лежат в Vocabularies/Source/.

Вид значения атрибута «выбор из справочника» описан в AttributeValueTypeSpec; критерий «справочник или перечисление» — там же.

2. Формат файлов

Файлы .mnu — меню АБИС ИРБИС: обычный текст в кодировке cp1251, строки идут парами (код, затем значение), последняя строка — терминатор *****.

a
Кожа
b
Пергамент
*****

Код — часть данных, а не порядковый номер. Это буква подполя в записи ИРБИС: a, b, c, у исполнителей — инициалы (КИН), у экспертов — кириллические буквы (Х, К, Б), у языков — трёхбуквенный код (rus, jpn). Коды переиспользуются между справочниками и означают в каждом своё, поэтому уникальны только внутри своего справочника.

Значение 0 («Ничего», «Нет тиснения», «Отсутствует») — не пустота, а явное «ничего не отмечено»: сотрудник посмотрел и зафиксировал отсутствие. От незаполненного поля оно отличается так же, как «Б.и.» отличается от пустого издательства.

3. Что передано

Девятнадцать справочников. Все относятся к форме ИК на издание: восемнадцать — к листу 2 «Сохранность», один (язык издания) — к листу 1.

dekor3.mnu перечислен как «Обрез», хотя часть его значений («Золото», «Тиснение») совпадает по словам с тиснением переплёта — коды у них разные, и это разные справочники.

4. Как это ложится в модель

Каждый файл становится типом значения (AttributeValueTypeSpec) вида «выбор из перечисления»: имя типа — из названия справочника, значения — парами «код — значение» в ограничениях. Отдельного хранилища значений не заводим — почему именно так и когда это изменится, сказано там же.

Поле бланка ссылается на тип не напрямую, а через атрибут вида документа: тип выбирают, описывая атрибут. Поэтому один тип обслуживает столько полей, сколько нужно: stpov — шесть мест на листе сохранности, isp — и мониторинг, и таблицу экспертов.

Заведение справочников — наполнение данными, а не правка кода. Ни новых сущностей, ни миграций: типы значений и виды документов заводятся до начала оцифровки, вместе с формами.

Исключение одно — jz.mnu: 589 языков в ограничениях типа вести нельзя. Это первый кандидат на вид «выбор из справочника», и хранилище значений появится тогда же, когда за него возьмёмся.

5. Пользователи БАН

Отдельный файл Пользователи БАН.docx — не справочник значений поля. Это соответствие учётной записи АБИС месту хранения и фонду: одиннадцать записей вида RADZSZ → ОФО, Радзивиллы Славянский фонд, BINKS → БИН, фонд по консервации и сохранности.

Он отвечает на вопрос, откуда берётся место хранения — обязательный реквизит карты, которого на бланке нет и который подставляется из профиля пользователя. То есть это материал сразу к двум вещам: к справочнику мест хранения и к настройке профиля.

6. Что видно по материалам

Справочники частично дублируют друг друга. fismat1 и fismat2 различаются одним значением («Оторван» есть у переплёта, у блока нет); sost1 и sost2 — тем же способом. Заказчик ведёт их как разные меню, потому что в его системе меню привязано к полю. Соединять их в один справочник с ограничением по полю — решение, которое надо принимать осознанно: список значений тогда придётся фильтровать на каждом поле.

Бланк и справочник расходятся. В fismat1 есть «Общие загрязнения», на бланке инв. 74870 такой клетки нет. Бланки разных редакций печатались с разным набором клеток, а справочник один и накопительный. Значит распознавание опирается на состав формы, а не на состав справочника: справочник говорит, какие значения бывают, форма — какие клетки есть на этом листе.

Один справочник — много полей. stpov используется на листе 2 шесть раз, isp — и в мониторинге, и в таблице экспертов. Это ровно тот случай, ради которого справочник отделён от перечисления.

Исполнители — живые данные. isp.mnu состоит из фамилий сотрудников. Состав меняется, это персональные данные, и в отличие от материалов покрытия такой справочник кто-то ведёт постоянно.

Опечатки заказчика сохранены. В mib.mnu — «микробиолиогических», в sost1.mnu — двойной пробел в «Не поврежден». Правим при загрузке или оставляем как есть — вопрос к заказчику; молча менять переданные данные не следует.

7. Принятые решения

Близкие справочники держим раздельно, как передано. fismat1 и fismat2 различаются одним значением, sost1 и sost2 — тем же способом. Соединять их в один набор и отбирать часть значений на каждом поле означало бы завести механизм фильтрации, которого в модели нет, ради экономии двух записей. Тип значения стоит дёшево — пусть их будет два.

Значение «Ничего» — обычное значение набора. 0 «Нет тиснения», «Отсутствует», «Без основы» хранится наравне с остальными, отдельного признака «это пустышка» нет. Поле с «Нет тиснения» заполнено во всех смыслах: ни проверка обязательности, ни выгрузка, ни показ его не различают, а признак, который нигде не читается, заводить незачем. Пустое поле по-прежнему означает «значение не указано».

8. Открытые вопросы