Создание и настройка справочника в конфигурации 1С 8.3
Содержание
Справочник создаётся в Конфигураторе: дерево конфигурации → ветка Справочники → правой кнопкой Добавить. Дальше вы заполняете имя, настраиваете код и наименование, при необходимости включаете иерархию, добавляете реквизиты и табличные части — и обновляете конфигурацию базы данных клавишей F7. Ниже — каждый из этих шагов с конкретными полями и значениями, которые нужно задать.
Справочник — это объект метаданных для хранения списков: номенклатуры, контрагентов, статей затрат, физлиц. От документа он отличается тем, что не формирует движений по регистрам, а просто хранит записи, на которые ссылаются другие объекты. Добавить справочник можно только в Конфигураторе (или в режиме расширения конфигурации
), в режиме 1С:Предприятие создаются уже сами элементы, а не структура.
С чего начать: открыть Конфигуратор и найти ветку справочников
Запустите информационную базу в режиме Конфигуратор. Если конфигурация на поддержке поставщика (типовая — БП 3.0, ЗУП 3.1, УТ 11), для прямого редактирования её сначала снимают с поддержки или, что правильнее, правят через расширение конфигурации
. Расширения появились в платформе 8.3.6 и позволяют добавлять объекты, не трогая типовой код.
В типовую конфигурацию на поддержке новые объекты добавляйте через расширение (Конфигурация → Расширения конфигурации), а не снятием замка. Иначе каждое обновление от 1С будет конфликтовать с вашими правками.
Откройте дерево конфигурации (Конфигурация → Открыть конфигурацию). Найдите корневую ветку Справочники. Кликните по ней правой кнопкой и выберите Добавить, либо выделите ветку и нажмите Insert. Откроется окно редактирования свойств нового справочника с набором вкладок слева: Основные, Подсистемы, Данные, Нумерация, Формы, Поле ввода, Команды, Макеты, Ввод на основании, Права, Прочее.
Можно пойти и через конструктор: в том же окне обычно работают по вкладкам сверху вниз — это и есть мастер создания объекта.
Имя, синоним и представление: вкладка «Основные»
Это первое, что нужно заполнить. Три ключевых поля:
- Имя — служебный идентификатор для кода. Только латиница и кириллица без пробелов, например
СтатьиЗатрат. По нему объект виден во встроенном языке. - Синоним — то, как справочник называется для пользователя в интерфейсе:
Статьи затрат. Заполняется автоматически из имени с разбивкой по заглавным буквам, поправьте падеж и регистр. - Комментарий — свободная заметка для разработчика, в интерфейс не выводится.
Ниже задаются представления — как объект называется в заголовках форм:
- Представление объекта — название одного элемента в единственном числе: «Статья затрат».
- Представление списка — название формы списка: «Статьи затрат».
Имя после ввода данных в базу лучше не менять: на него могут ссылаться запросы, обработки и код в расширениях. Синоним и представления правьте свободно — они на структуру не влияют.
На вкладке Подсистемы отметьте галочками разделы, в которых справочник должен появиться в панели разделов интерфейса «Такси». Без этого в режиме 1С:Предприятие пользователь его просто не увидит в меню (открыть можно будет только через Функции для технического специалиста).
Код и наименование: вкладка «Данные»
Здесь настраивается, как устроены записи справочника.
| Поле | Что задаёт | Типичное значение |
|---|---|---|
| Длина кода | Разрядность кода элемента | 9 или 11 |
| Тип кода | Число или Строка | Строка (гибче при префиксах) |
| Длина наименования | Макс. длина поля «Наименование» | 50–150 |
| Основное представление | Что показывать в ссылке | В виде наименования |
Пару слов про тип кода. Числовой код проще сортируется, но строковый удобнее, когда нужны буквенные префиксы («АА-0001»). Если код не важен бизнесу — оставьте число длиной 9.
Основное представление определяет, что увидит пользователь, когда справочник подставляется в поле другого документа. Для большинства справочников это В виде наименования. Если смысл несёт именно код (например, коды ОКВЭД) — поставьте В виде кода.
Добавление реквизитов и табличных частей — тоже на этой логике, но технически отдельная ветка внутри справочника. О них ниже.
Иерархия и владельцы: вложенные списки и подчинение
Два свойства, которые часто нужны и которые путают новичков. Оба настраиваются на собственных вкладках справочника и напрямую влияют на то, как пользователь будет искать и вводить записи.
Иерархия включается галочкой Иерархический справочник на вкладке Иерархия. Дальше выбираете вид:
- Иерархия групп и элементов — классические папки. Группа — это контейнер, в неё кладут элементы. Так устроена номенклатура: группа «Материалы», внутри — позиции.
- Иерархия элементов — родителем может быть любой элемент, отдельных папок нет. Подходит для структур вроде «подразделение → отдел».
Там же задаётся Количество уровней иерархии — ограничьте, если глубина фиксированная.
Владельцы (вкладка Владельцы) делают справочник подчинённым. Классический пример — «Договоры контрагентов»: каждый договор принадлежит конкретному контрагенту. Добавьте в список владельцев справочник Контрагенты, и тогда элемент договора нельзя создать без указания контрагента-владельца.
Иерархия и подчинение — разные механизмы. Иерархия — вложенность внутри одного справочника. Владелец — связь «родитель из другого справочника». Их можно сочетать.
Нумерация кода и предопределённые элементы
Два свойства, до которых новички обычно не доходят, а зря — они экономят много правок потом.
Вкладка «Нумерация» управляет тем, как присваивается код:
Автонумерация— платформа сама подставляет следующий код при создании элемента. Снимать галочку стоит, только если код ведётся вручную по внешнему правилу.Контроль уникальности— запрещает два элемента с одинаковым кодом. Для большинства справочников держите включённым.Серии кода— в каких границах код уникален. Варианты:Во всём справочнике,В пределах подчинения,В пределах подчинения владельцу. Для подчинённого справочника (договоры у контрагента) логична серия в пределах владельца — тогда нумерация договоров идёт своя у каждого контрагента.
Предопределённые элементы — записи, которые создаются прямо в Конфигураторе и гарантированно существуют в любой базе. Нужны, когда на конкретный элемент ссылается код: например, статья затрат «Прочие», к которой программа привязывает автоматические операции.
Создаются на вкладке Прочее → Предопределённые (кнопка открывает список) или в ветке Предопределённые внутри справочника. У каждого задаётся Имя — по нему элемент доступен из встроенного языка как Справочники.СтатьиЗатрат.Прочие.
Предопределённый элемент нельзя удалить интерактивно в режиме 1С:Предприятие — только пометить. Удаляется он лишь из Конфигуратора. Не делайте предопределёнными те записи, которые пользователь должен вести и чистить сам.
Реквизиты и составные типы: как хранить дополнительные поля
Код и наименование есть у любого справочника по умолчанию. Всё остальное — свои реквизиты.
Разверните справочник в дереве, найдите ветку Реквизиты, правой кнопкой Добавить. Для реквизита задаются Имя, Синоним и, главное, Тип.
Тип выбирается в окне редактирования типа. Варианты:
- Примитивный — Число, Строка, Дата, Булево.
- Ссылочный — ссылка на другой объект:
СправочникСсылка.Контрагенты,ПеречислениеСсылка.ВидыЦен. - Составной тип — реквизит, который может хранить значение одного из нескольких типов.
Составной тип включается галочкой Составной тип в окне выбора типа. После этого отмечаете несколько типов сразу — например, реквизит «Источник» может ссылаться и на Справочник.Контрагенты, и на Справочник.Организации. В режиме 1С:Предприятие пользователь сначала выбирает, какого типа значение вводит, потом само значение.
Составной тип удобен, но тяжелее для запросов и индексов. Если вариантов значения немного и они известны заранее — подумайте, не обойтись ли отдельными реквизитами или перечислением.
Если к элементу нужен список строк (например, контактные лица у контрагента) — добавьте табличную часть: ветка Табличные части → Добавить, а внутри неё — свои реквизиты-колонки.
Удобно сразу проверить, что тип каждого реквизита выбран осознанно:
Формы и отображение для пользователя
Платформа 8.3 умеет генерировать формы автоматически. Если не создавать ни одной формы вручную, при открытии справочника в режиме 1С:Предприятие система построит форму списка и форму элемента сама, по составу реквизитов. Для простого справочника этого достаточно — создавать формы не обязательно.
Собственная форма нужна, когда:
- надо убрать лишние поля или изменить их порядок;
- добавить условное оформление, кнопки, свой код в обработчики;
- сделать разную компоновку для разных ролей.
Создаётся форма на вкладке Формы: нажмите значок лупы (конструктор) у нужного вида — Форма списка, Форма элемента, Форма выбора. Откроется конструктор формы; оставьте нужные реквизиты в колонке справа и нажмите Готово. Назначьте созданную форму основной в полях «Основная форма списка / элемента» на той же вкладке.
Не создавайте формы «про запас». Пустую автогенерируемую форму платформа всегда построит сама и будет обновлять её при добавлении реквизитов. Как только вы сделали форму руками — добавлять на неё новые поля придётся тоже руками.
Права доступа к справочнику
Права назначаются не в самом справочнике, а в ролях. Роль — отдельный объект метаданных в ветке Общие → Роли.
Откройте нужную роль двойным кликом — появится таблица: слева объекты конфигурации, справа права. Найдите ваш справочник и отметьте галочками нужные права:
- Чтение — видеть элементы;
- Добавление, Изменение, Удаление — соответствующие действия;
- Просмотр и Интерактивное удаление — права на действия через интерфейс;
- Ввод по строке — подбор по началу наименования в полях ввода.
Для нового справочника как минимум включите Чтение и Просмотр в тех ролях, где он должен быть доступен. Если оставить права пустыми во всех ролях пользователя — справочник будет невидим, хотя в конфигурации он есть.
Удобный приём: откройте роль администратора (полные права) как образец и сверьте по ней, какие права обычно нужны вашему объекту, затем повторите нужный набор в пользовательских ролях. Не выдавайте Удаление всем подряд — интерактивное удаление ссылочных данных ломает ссылки в документах.
Можно ограничивать доступ и построчно — через Ограничения доступа к данным (RLS) в той же роли, но это уже отдельная большая тема; для старта хватает прав на объект целиком.
Тестирование и обновление конфигурации базы данных
Пока вы правили объект, изменения жили только в основной конфигурации. Чтобы они попали в рабочую структуру базы, её нужно обновить.
Порядок:
- Нажмите
F7илиКонфигурация → Обновить конфигурацию базы данных. - Платформа покажет окно со списком изменений («Реорганизация информации»). Проверьте, что в списке именно ваш справочник и его реквизиты.
- Нажмите
Принять.
Обновление структуры базы требует монопольного доступа: если в базе работают пользователи, платформа попросит их завершить сеансы. В файловой базе достаточно закрыть все клиентские подключения; в клиент-серверной — завершить сеансы через консоль администрирования. Делайте это в согласованное окно, а не в разгар рабочего дня.
После обновления запустите базу в режиме 1С:Предприятие клавишей F5 (или Начать отладку). Проверьте:
- справочник виден в нужном разделе панели (если отметили подсистемы);
- открывается список и создаётся элемент;
- все реквизиты на форме, ссылочные поля подставляют значения;
- иерархия работает, если включали (создаётся группа, элемент кладётся внутрь).
Если после обновления справочник не появился в меню — почти всегда дело в двух вещах: не отмечены подсистемы на вкладке Подсистемы или не выданы права в роли пользователя. Проверьте оба пункта.
Частые вопросы
Можно ли добавить справочник в типовую конфигурацию, не ломая обновления?
Конфигурация → Расширения конфигурации). Новый объект живёт в расширении, типовая конфигурация остаётся на поддержке и спокойно обновляется от 1С. Для своих объектов это предпочтительный способ.