Справочник «КлючиДоступа» (Catalogs.КлючиДоступа) — техническое описание

1. Идентификация

Характер объекта. Это внутренний (служебный) объект БСП, а не прикладной документ или учётный справочник. Он не участвует в бухгалтерском, налоговом или регламентированном учёте, не хранит справочных данных предметной области (контрагенты, товары, счета) и не имеет отношения к расчёту налогов и взносов. Его единственная задача — обеспечить быструю проверку прав доступа к записям прикладных объектов за счёт предвычисленных ключей.

Где найти:

• Навигационная ссылка: e1cib/list/Справочник.КлючиДоступа
• В интерфейсе: как правило, скрыт от обычных пользователей. Доступен администратору через раздел «Администрирование» → механизмы «Стандартных подсистем» (управление доступом) либо напрямую по навигационной ссылке. Прямой пункт меню для рядовых пользователей отсутствует.

2. Реквизиты шапки и табличные части

2.1. Реквизиты шапки

Пояснение по полям Значение1…Значение5. Каждое поле — элемент набора значений доступа. В качестве значений выступают ссылки на объекты, по которым ведётся ограничение (например, элементы справочников-измерений доступа: организации, склады, группы контрагентов и т. п.), а также предопределённые служебные значения. Тип полей намеренно оставлен неопределённым/составным, потому что один и тот же справочник обслуживает ключи для разных прикладных объектов с разными наборами измерений доступа. Комбинация СоставПолей + Значение1…N однозначно описывает конкретный набор ограничений, а Хеш — его свёртка для быстрого поиска.

2.2. Табличные части

Табличные части расширяют число хранимых значений сверх пяти реквизитов шапки — для наборов ограничений с большим количеством измерений.

Шапка — дополнительные значения параметров доступа (6–10):

ТабличнаяЧасть1 — дополнительные наборы значений ограничений доступа (первый расширенный блок):

Наличие вынесенных в табличные части значений (6–10 и далее) позволяет хранить наборы ограничений произвольной ширины, не увеличивая число реквизитов шапки. Заполнение конкретных полей определяется значением реквизита СоставПолей.

3. Формы

Для служебного справочника набор форм минимален и ориентирован на администрирование, а не на повседневную работу пользователя:

Специализированных форм ввода/помощников для пользователя у объекта нет: записи создаёт подсистема управления доступом автоматически.

4. Ключевые процедуры модулей

Специфического прикладного BSL-кода (evidence с путями и строками) для данного объекта не предоставлено, поэтому ниже перечислены типовые обработчики, характерные для служебного справочника этого вида в БСП. Логика наполнения и использования сосредоточена не в самом справочнике, а в общих модулях подсистемы управления доступом.

Модуль объекта / модуль менеджера (типовые обработчики):

• ПередЗаписью — контроль корректности заполнения ключа перед записью (согласованность СоставПолей, Хеш и заполненных значений).
• ОбработкаЗаполнения — начальное заполнение при программном создании ключа.
• ПриКопировании — как правило, копирование служебных ключей вручную не предполагается.

Общие модули подсистемы управления доступом (где фактически работает механизм):

• Модули типа УправлениеДоступом / УправлениеДоступомСлужебный (БСП) — рассчитывают наборы значений доступа для прикладных объектов, вычисляют Хеш и СоставПолей, находят существующий ключ или создают новый элемент справочника КлючиДоступа.
• Механизм обновления ключей — при изменении прав, состава групп доступа или профилей выполняет пересчёт и актуализацию ключей.
• Регламентное задание очистки — помечает и удаляет неиспользуемые ключи, опираясь на реквизит НеИспользуетсяС.

Требует проверки (версионно-специфично): точные имена общих модулей и регламентных заданий, а также сигнатуры процедур зависят от версии БСП, входящей в состав 3.0.74.2. Уточняйте по конфигуратору конкретной поставки.

5. Проведение и движения

Справочник не является документом и не выполняет проведение. Он не формирует бухгалтерских проводок и не создаёт движений по регистрам накопления/бухгалтерии.

Соответственно, для этого объекта не применяются ни план счетов РК, ни ставки налогов, ни расчёты по НДС/ИПН/взносам. Учётные счета РК (1210 «Краткосрочная ДЗ покупателей», 1030 «Деньги на текущих счетах», 1330 «Товары», 3310 «КЗ поставщикам», 3130 «НДС к уплате», 6010 «Доход от реализации», 7010 «Себестоимость реализации»), ставка НДС 16 %, ИПН, ОПВ, ОПВР, ВОСМС, ОСМС, СО, соцналог, а также электронные документы ЭСФ/СНТ к данному объекту отношения не имеют — это исключительно техническая инфраструктура разграничения доступа.

Как участвует в работе системы. Элементы справочника используются в шаблонах ограничения доступа (RLS): при построении запросов к прикладным данным система по Хешу и СоставуПолей сопоставляет доступные пользователю наборы значений с ключами доступа записей и отфильтровывает недоступные строки. Взаимодействие идёт с регистрами сведений подсистемы управления доступом (наборы значений доступа, группы доступа значений и т. п.), а не с учётными регистрами.

6. Связанные объекты и ввод на основании

Связанные объекты:

• Справочник.ИдентификаторыОбъектовМетаданных — источник ссылки в реквизите Список; идентифицирует прикладной объект, к которому относится ключ.
• Справочник.ИдентификаторыОбъектовРасширений — то же для объектов расширений конфигурации.
• Объекты подсистемы управления доступом БСП: профили групп доступа, группы доступа пользователей, регистры сведений с наборами значений доступа — они формируют исходные данные для расчёта ключей.
• Справочники-измерения доступа предметной области (организации, склады, группы контрагентов и др.) — их элементы попадают в поля Значение1…N как значения ограничений.

Ввод на основании: не предусмотрен — объект служебный, не является источником и приёмником ввода на основании.

7. Точки расширения

• Состав измерений доступа. Расширение прав доступа прикладных объектов (добавление/изменение измерений RLS) влияет на структуру заполняемых значений ключей. Изменения выполняются через настройку ограничений доступа БСП, а не правкой справочника.
• Расширения конфигурации. Через ИдентификаторыОбъектовРасширений механизм поддерживает ключи для объектов, добавленных расширениями; при разработке расширений с собственными ограничениями доступа ключи создаются автоматически.
• Регламент очистки. Поведение очистки устаревших ключей (по НеИспользуетсяС) настраивается параметрами регламентного задания подсистемы управления доступом.
• Не рекомендуется дорабатывать структуру самого справочника (реквизиты Хеш, СоставПолей, значения) — это внутренний контракт БСП; изменения могут нарушить работу RLS и усложнить обновление конфигурации. Кастомизацию доступа ведут штатными средствами подсистемы управления доступом.

Требует проверки (версионно-специфично): конкретный перечень поддерживаемых измерений доступа и полный набор регистров подсистемы зависят от версии БСП в поставке 3.0.74.2.