1. Идентификация
| Параметр | Значение |
|---|---|
| Тип объекта | Справочник (Catalog) |
| Имя | ГруппыВнешнихПользователей |
| Полное имя | Справочник.ГруппыВнешнихПользователей |
| Синоним | «Группы внешних пользователей» |
| Конфигурация | Управление торговлей для Казахстана, ред. 3.4.5.21 |
| Подсистема | «Пользователи» (механизм из Библиотеки стандартных подсистем, БСП) |
| Иерархия | Иерархия элементов (группы могут вкладываться друг в друга) |
| Владелец | Нет (независимый справочник) |
| Основное представление | В виде наименования |
| Назначение | Объединение внешних пользователей, имеющих одинаковый доступ к данным системы. Используется в механизме ограничения доступа на уровне записей (RLS) и при настройке прав внешних пользователей (партнёров, контрагентов, физлиц, работающих через веб-клиент/личный кабинет). |
Где найти: навигационная ссылка e1cib/list/Справочник.ГруппыВнешнихПользователей. В интерфейсе — раздел НСИ и администрирование → Настройки пользователей и прав → Внешние пользователи → Группы внешних пользователей (доступно при включённой опции «Внешние пользователи»).
Справочник является служебным: он не участвует в товарном, денежном или налоговом учёте. Прикладные объекты УТ (реализации, ЭСФ, СНТ, расчёты по НДС 16 %, ИПН, ОПВ и т. д.) на него не ссылаются — он обслуживает только подсистему безопасности и разграничения доступа.
2. Реквизиты шапки и табличные части
Реквизиты шапки
| Реквизит | Тип | Назначение |
|---|---|---|
Наименование |
Строка | Имя группы (стандартный реквизит). |
Родитель |
СправочникСсылка.ГруппыВнешнихПользователей | Ссылка на вышестоящую группу (иерархия элементов). |
ВсеПользователи |
Булево | Признак предопределённой группы, в которую автоматически входят все внешние пользователи. Обычно устанавливается только у одной предопределённой группы «Все внешние пользователи»; для неё состав не редактируется вручную. |
Комментарий |
Строка (неогранич.) | Произвольное текстовое описание назначения группы. |
Табличные части
| Табличная часть | Колонки | Назначение |
|---|---|---|
Пользователи |
ВнешнийПользователь (СправочникСсылка.ВнешниеПользователи) |
Явный список внешних пользователей, входящих в группу. При флаге ВсеПользователи = Истина не заполняется. |
Назначение |
ТипПользователя (Тип / ОпределяемыйТип) |
Ограничивает, внешние пользователи с каким видом объекта-владельца (Партнёры, Контрагенты, Физические лица и др.) могут быть включены в группу. Используется формой для фильтрации подбора и для проверки корректности состава. |
Требует проверки для конкретной сборки 3.4.5.21: точный состав колонок табличной части
Назначениеи наличие служебных реквизитов (например, флага «Группа участвует в назначении задач») зависят от версии встроенной БСП. Ядро (иерархия,ВсеПользователи, ТЧПользователи) остаётся неизменным между версиями.
3. Формы
| Форма | Вид | Назначение |
|---|---|---|
ФормаЭлемента |
Форма элемента | Основная форма группы: наименование, родитель, комментарий и редактирование состава (таблица «Пользователи»). Содержит команды подбора/добавления внешних пользователей с учётом ограничений реквизита Назначение. |
ФормаСписка |
Форма списка | Просмотр иерархического списка групп; переход в состав; создание/копирование групп. Открывается по навигационной ссылке. |
ФормаВыбора |
Форма выбора | Выбор группы из других объектов и настроек прав. |
Отдельная форма группы (папки) не требуется — иерархия строится на уровне элементов, поэтому редактирование ведётся через ФормаЭлемента.
4. Ключевые процедуры модулей
Отдельного прикладного BSL-кода в evidence не приложено, поэтому ниже — типовые обработчики этого вида объекта БСП. В коде типовой конфигурации логика вынесена в общие модули подсистемы «Пользователи» (ВнешниеПользователи, ПользователиСлужебный, ПользователиВнутренние).
Модуль объекта (Справочник.ГруппыВнешнихПользователей.МодульОбъекта):
ОбработкаЗаполнения— заполнение реквизитов по умолчанию при создании новой группы.ПередЗаписью— контроль корректности: запрет ручного изменения состава у предопределённой группы «Все внешние пользователи» (ВсеПользователи = Истина), проверка соответствия состава заданномуНазначению, отсечение зацикливания иерархии.ПриЗаписи— вызов служебного метода обновления денормализованного состава групп (пересчёт участников с учётом вложенных групп) и последующее обновление ключей/наборов доступа RLS.ПередУдалением— контроль ссылок и запрет удаления предопределённой группы всех внешних пользователей.
Модуль формы элемента (ФормаЭлемента):
ПриСозданииНаСервере— блокировка редактирования состава для группы «Все внешние пользователи», настройка доступности элементов по правам текущего пользователя.- Обработчики подбора внешних пользователей (
ПользователиНачалоВыбора/ команда «Подобрать») с фильтром по реквизитуНазначение. ПослеЗаписиНаСервере— оповещение об изменении состава для обновления связанных форм.
Общие модули (обслуживают справочник):
ВнешниеПользователи— программный API: получение групп пользователя, проверка вхождения, обновление состава.ПользователиВнутренние/ПользователиСлужебный— пересчёт регистра состава групп и обновление данных RLS.
5. Проведение и движения
Справочник не является документом и не проводится — проводки по плану счетов и движения по прикладным регистрам накопления он не формирует. Соответственно, счета типового плана счетов РК (1210, 1030, 1330, 3310, 3130, 6010, 7010) и налоговые расчёты (НДС 16 %, ИПН, ОПВ 10 %, ОПВР 3,5 %, ВОСМС 2 %, ОСМС 3 %, СО 5 %, соцналог 6 %) к нему не применяются — это объект подсистемы безопасности, а не учёта.
Единственное «движение», которое инициирует запись элемента, — это обновление служебных данных механизма ограничения доступа:
| Что обновляется | Назначение |
|---|---|
Регистр сведений СоставГруппВнешнихПользователей (независимый, денормализованный) |
Плоский список пар «Группа ↔ ВнешнийПользователь», развёрнутый с учётом вложенных групп и признака ВсеПользователи. Используется в шаблонах RLS для быстрой проверки принадлежности внешнего пользователя к группе. |
| Наборы значений доступа / ключи доступа (RLS) | Пересчитываются при изменении состава, чтобы изменения прав вступили в силу без перезапуска. |
Пересчёт выполняется на сервере при записи элемента (ПриЗаписи → служебные методы БСП).
6. Связанные объекты и ввод на основании
Связанные объекты:
Справочник.ВнешниеПользователи— элементы состава группы (внешние пользователи создаются на базе партнёров, контрагентов, физических лиц).Справочник.ГруппыПользователей— аналогичный механизм для внутренних (штатных) пользователей.РегистрСведений.СоставГруппВнешнихПользователей— денормализованный состав для RLS.- Объекты подсистемы «УправлениеДоступом»: профили, группы доступа, ключи/наборы доступа — используют группы внешних пользователей как значения доступа.
Ввод на основании: не предусмотрен (ни как основание, ни на основании других объектов). Создание — вручную в списке или программно через API ВнешниеПользователи.
7. Точки расширения
- Расширение конфигурации: добавление реквизитов/команд в
ФормаЭлементаиФормаСписка, перехват обработчиков модуля объекта через аннотации&После/&Вместо(с осторожностью — логика тесно связана с ядром БСП). - Программный API БСП: методы общего модуля
ВнешниеПользователи(получение групп пользователя, проверка вхождения, программное ведение состава) — предпочтительный способ интеграции вместо прямой работы со справочником. - Дополнительные реквизиты и сведения: подсистема «Свойства» позволяет расширить группу доп. реквизитами без изменения метаданных (требует включения объекта в состав видов дополнительных сведений).
- Механизм RLS: собственные шаблоны ограничения доступа могут опираться на регистр
СоставГруппВнешнихПользователейпри разработке отраслевых ограничений видимости данных для партнёров/контрагентов. - Подписки на события записи справочника — для интеграции с внешними системами управления доступом (например, синхронизация состава групп).
Требует проверки при доработках: сигнатуры служебных процедур подсистемы «Пользователи» относятся к внутреннему API БСП и могут меняться между релизами платформы/библиотеки — опираться следует на документированные экспортные методы модуля
ВнешниеПользователи.