Разработка и Конфигурация · 10 мин
Как создать объект конфигурации «Справочник» в 1С
Как создать объект конфигурации «Справочник» в 1С: настройка длины кода и наименования, иерархия, реквизиты, формы, подчинённые справочники и проверка результата.
Справочник — один из базовых объектов конфигурации 1С, предназначенный для хранения условно-постоянной информации: номенклатуры, контрагентов, сотрудников, складов, валют. Элементы справочника многократно используются в документах и отчётах, поэтому правильное проектирование справочника напрямую влияет на удобство учёта и скорость работы пользователей.
Создание справочника выполняется в конфигураторе и занимает несколько минут, однако ошибки на этапе проектирования — неверная длина кода, отсутствие нужных реквизитов, неправильно выбранная иерархия — потребуют доработок уже на работающей базе, где есть данные. Ниже разобран полный цикл: от добавления объекта до проверки результата в режиме предприятия.
Инструкция ориентирована на платформу 1С:Предприятие 8.3 с управляемым приложением. Для обычных форм шаги аналогичны, отличается только редактор форм.
Что нужно подготовить до создания справочника
Перед добавлением объекта определите, какие данные он будет хранить и как будет использоваться. Ответьте на вопросы: нужна ли группировка элементов по папкам (иерархия), будут ли элементы привязаны к владельцу (например, договоры к контрагенту), какие дополнительные поля потребуются помимо стандартного наименования.
Убедитесь, что у вас есть права на изменение конфигурации и что конфигурация не находится на полной поддержке без возможности изменения. Если конфигурация типовая и закрыта от редактирования, объект добавить не получится — сначала потребуется включить возможность изменения, что снимает конфигурацию с полной автоматической поддержки.
Также заранее продумайте имя объекта. Имя справочника — это идентификатор, по которому к нему обращаются в коде (например, Справочники.Номенклатура). После того как на справочник появятся ссылки в других объектах и в программном коде, переименование потребует аккуратной правки всех обращений.
Добавление объекта в дереве конфигурации
Откройте конфигуратор, загрузите конфигурацию через меню «Конфигурация — Открыть конфигурацию». В дереве объектов найдите ветку «Справочники», щёлкните по ней правой кнопкой мыши и выберите «Добавить». Откроется палитра свойств нового объекта — основной инструмент настройки.
На закладке «Основные» задайте имя (латиницей или кириллицей, без пробелов) и синоним — то название, которое увидят пользователи в интерфейсе. Платформа автоматически предложит представление объекта и списка, их можно уточнить: например, «Сотрудник» для элемента и «Сотрудники» для списка.
- 1Откройте конфигуратор и конфигурацию базы
- 2В ветке «Справочники» выберите «Добавить»
- 3Задайте имя и синоним объекта
- 4Настройте длину кода и наименования, иерархию, реквизиты
- 5Создайте формы элемента и списка
- 6Обновите конфигурацию базы данных (F7)
- 7Проверьте объект в режиме предприятия
На закладке «Подсистемы» отметьте, в каких разделах интерфейса справочник будет виден пользователям. Если не включить объект ни в одну подсистему, пользователи не увидят его в панели навигации, хотя программно он будет доступен.
Настройка кода, наименования и нумерации
На закладке «Данные» задаются ключевые параметры: длина кода, длина наименования, тип кода (число или строка) и основное представление объекта. Длину наименования выбирайте с запасом: если номенклатура может содержать названия по 100–150 символов, не ограничивайтесь стандартными 25. Увеличить длину позже можно, но на больших базах реструктуризация займёт время.
Тип кода «Число» подходит для автоматической порядковой нумерации, «Строка» — когда код несёт смысловую нагрузку (артикулы, шифры). Для большинства учётных справочников достаточно числового кода с автонумерацией: пользователю не придётся вводить код вручную.
На закладке «Нумерация» доступны свойства автонумерации, контроля уникальности и серий кодов (в пределах всего справочника, подчинения или периодичности). Включённый контроль уникальности не позволит создать два элемента с одинаковым кодом — для строковых кодов это полезно, но усложняет ручной ввод.
Иерархия, владельцы и реквизиты
Иерархический справочник
Если элементы нужно группировать в папки (группы товаров, структура подразделений), на закладке «Иерархия» установите флаг «Иерархический справочник». Выберите вид иерархии: «Список» — группы и элементы на одном уровне структуры, «Группы и элементы» — классический вариант с папками, где группа не может быть выбрана как значение в документах.
Подчинённые справочники
Когда элементы одного справочника должны принадлежать элементам другого (договоры — контрагентам, единицы измерения — номенклатуре), на закладке «Владельцы» укажите справочник-владелец. В форме списка подчинённого справочника появится отбор по владельцу, а в коде станет доступно свойство Владелец.
Реквизиты и табличные части
Дополнительные поля добавляются на закладке «Данные» кнопкой «Добавить реквизит». Для каждого реквизита укажите имя, тип данных и, при необходимости, признак обязательности заполнения. Реквизиты с типом «СправочникСсылка», «ПеречислениеСсылка», «Дата», «Булево» покрывают большинство задач. Если к элементу нужно прикрепить список строк (например, состав комплекта), добавьте табличную часть и определите её колонки.
Сравнение вариантов
Подходит для классификации: товары по группам, статьи затрат. Ограничение — избыточная вложенность затрудняет поиск
Подходит, когда элементы не имеют смысла без владельца: договоры, банковские счета. Ограничение — нельзя использовать элемент без указания владельца
Подходит для коротких списков: валюты, ставки, причины. Ограничение — при росте числа элементов список становится неудобным без групп
Формы, права и интерфейс
На закладке «Формы» сгенерируйте основные формы: форму элемента и форму списка. Конструктор форм создаст управляемые формы автоматически — достаточно выбрать тип формы и отметить, какие реквизиты вывести. Без формы элемента пользователь не сможет редактировать объект в интерактивном режиме.
Проверьте права доступа: на закладке «Права» или в существующих ролях должны быть установлены права на чтение, добавление, изменение справочника. Если роли настраиваются отдельно, новый объект по умолчанию может оказаться недоступен пользователям — это частая причина жалоб «справочник не виден» после обновления.
Дополнительно настройте закладки «Ввод по строке» (по каким полям работает быстрый поиск при вводе в полях документов), «Быстрый выбор» и «Поле блокировки данных». Ввод по строке по наименованию и коду заметно ускоряет подбор элементов в документах.
Обновление конфигурации и проверка результата
После настройки нажмите F7 или выберите «Конфигурация — Обновить конфигурацию базы данных». Платформа покажет список изменений структуры — для нового справочника будет создана таблица. Подтвердите обновление. При работе по сети пользователей попросят завершить сеансы, если обновление выполняется в монопольном режиме.
Запустите режим предприятия и проверьте: справочник отображается в нужной подсистеме, создаётся новый элемент, код присваивается автоматически, реквизиты редактируются, элемент сохраняется без ошибок. Создайте тестовый документ или откройте объект, где справочник используется, и убедитесь, что выбор элемента работает через ввод по строке.
Как проверить результат
Справочник виден в панели навигации подсистемы
Объект отсутствует — проверьте подсистемы и права
Форма открывается, код заполняется автоматически, запись проходит
Ошибка открытия формы или записи — проверьте формы и обязательные реквизиты
Подбор по вводу строки находит элементы
Поиск не срабатывает — настройте «Ввод по строке»
Частые вопросы о создании справочников
Можно ли изменить длину наименования после того, как в справочнике есть данные?
Да, увеличение длины выполняется штатно через обновление конфигурации базы данных, данные сохраняются. Уменьшение длины приведёт к обрезанию существующих значений при реструктуризации, поэтому перед уменьшением проверьте максимальную фактическую длину значений в базе.
Чем справочник отличается от плана видов характеристик?
Справочник хранит однородные сущности с фиксированным набором реквизитов. План видов характеристик предназначен для описания произвольных свойств с разными типами значений и обычно используется в механизмах свойств и категорий. Для обычных учётных списков — номенклатуры, контрагентов — всегда выбирайте справочник.
Как сделать, чтобы пользователь не мог удалить элемент справочника?
Прямого удаления можно избежать, убрав право «Удаление» и «Интерактивное удаление» в ролях пользователей, оставив только пометку удаления. Дополнительно в модуле объекта можно реализовать проверки в обработчике ПередУдалением. Даже пометка удаления контролируется механизмом удаления помеченных объектов, который проверяет ссылки на элемент.
Нужно ли создавать индексы для реквизитов справочника?
Если по реквизиту часто выполняется поиск или отбор (например, по ИНН контрагента), включите у реквизита свойство «Индексировать». Это ускоряет запросы ценой дополнительного места в базе и небольшого замедления записи. Индексировать все реквизиты подряд не нужно.
Можно ли добавить справочник в типовую конфигурацию без снятия с поддержки?
Новый объект конфигурации добавить без включения возможности изменения нельзя — это требование механизма поддержки. Если снимать конфигурацию с поддержки нежелательно, рассмотрите альтернативы: дополнительные реквизиты и сведения, дополнительные отчеты и обработки или хранение данных в существующих справочниках с расширением через механизм расширений конфигурации.
Почему после обновления пользователи получают ошибку «Нарушение прав доступа»?
Новый объект не попадает автоматически во все роли — права на него нужно явно добавить в роли, назначенные пользователям. Откройте нужную роль в конфигураторе, найдите справочник в списке объектов и установите права на чтение, добавление и изменение, затем обновите конфигурацию базы данных.
Что важно запомнить
Справочник создаётся в конфигураторе через ветку «Справочники»: задаются имя, длина кода и наименования, иерархия, владельцы и реквизиты, затем формы и права. Перед изменением рабочей базы делайте резервную копию, а после обновления проверяйте видимость объекта, создание элемента и работу поиска в режиме предприятия.