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