Создание и настройка справочника в конфигурации 1С 8.3

· 10 мин

Содержание

Справочник создаётся в Конфигураторе: дерево конфигурации → ветка Справочники → правой кнопкой Добавить. Дальше вы заполняете имя, настраиваете код и наименование, при необходимости включаете иерархию, добавляете реквизиты и табличные части — и обновляете конфигурацию базы данных клавишей F7. Ниже — каждый из этих шагов с конкретными полями и значениями, которые нужно задать.

Справочник — это объект метаданных для хранения списков: номенклатуры, контрагентов, статей затрат, физлиц. От документа он отличается тем, что не формирует движений по регистрам, а просто хранит записи, на которые ссылаются другие объекты. Добавить справочник можно только в Конфигураторе (или в режиме расширения конфигурации ), в режиме 1С:Предприятие создаются уже сами элементы, а не структура.

С чего начать: открыть Конфигуратор и найти ветку справочников

Запустите информационную базу в режиме Конфигуратор. Если конфигурация на поддержке поставщика (типовая — БП 3.0, ЗУП 3.1, УТ 11), для прямого редактирования её сначала снимают с поддержки или, что правильнее, правят через расширение конфигурации . Расширения появились в платформе 8.3.6 и позволяют добавлять объекты, не трогая типовой код.

В типовую конфигурацию на поддержке новые объекты добавляйте через расширение (Конфигурация → Расширения конфигурации), а не снятием замка. Иначе каждое обновление от 1С будет конфликтовать с вашими правками.

Откройте дерево конфигурации (Конфигурация → Открыть конфигурацию). Найдите корневую ветку Справочники. Кликните по ней правой кнопкой и выберите Добавить, либо выделите ветку и нажмите Insert. Откроется окно редактирования свойств нового справочника с набором вкладок слева: Основные, Подсистемы, Данные, Нумерация, Формы, Поле ввода, Команды, Макеты, Ввод на основании, Права, Прочее.

Можно пойти и через конструктор: в том же окне обычно работают по вкладкам сверху вниз — это и есть мастер создания объекта.

Имя, синоним и представление: вкладка «Основные»

Это первое, что нужно заполнить. Три ключевых поля:

  • Имя — служебный идентификатор для кода. Только латиница и кириллица без пробелов, например СтатьиЗатрат. По нему объект виден во встроенном языке.
  • Синоним — то, как справочник называется для пользователя в интерфейсе: Статьи затрат. Заполняется автоматически из имени с разбивкой по заглавным буквам, поправьте падеж и регистр.
  • Комментарий — свободная заметка для разработчика, в интерфейс не выводится.

Ниже задаются представления — как объект называется в заголовках форм:

  • Представление объекта — название одного элемента в единственном числе: «Статья затрат».
  • Представление списка — название формы списка: «Статьи затрат».

Имя после ввода данных в базу лучше не менять: на него могут ссылаться запросы, обработки и код в расширениях. Синоним и представления правьте свободно — они на структуру не влияют.

На вкладке Подсистемы отметьте галочками разделы, в которых справочник должен появиться в панели разделов интерфейса «Такси». Без этого в режиме 1С:Предприятие пользователь его просто не увидит в меню (открыть можно будет только через Функции для технического специалиста).

Код и наименование: вкладка «Данные»

Здесь настраивается, как устроены записи справочника.

ПолеЧто задаётТипичное значение
Длина кодаРазрядность кода элемента9 или 11
Тип кодаЧисло или СтрокаСтрока (гибче при префиксах)
Длина наименованияМакс. длина поля «Наименование»50–150
Основное представлениеЧто показывать в ссылкеВ виде наименования

Пару слов про тип кода. Числовой код проще сортируется, но строковый удобнее, когда нужны буквенные префиксы («АА-0001»). Если код не важен бизнесу — оставьте число длиной 9.

Основное представление определяет, что увидит пользователь, когда справочник подставляется в поле другого документа. Для большинства справочников это В виде наименования. Если смысл несёт именно код (например, коды ОКВЭД) — поставьте В виде кода.

Добавление реквизитов и табличных частей — тоже на этой логике, но технически отдельная ветка внутри справочника. О них ниже.

Иерархия и владельцы: вложенные списки и подчинение

Два свойства, которые часто нужны и которые путают новичков. Оба настраиваются на собственных вкладках справочника и напрямую влияют на то, как пользователь будет искать и вводить записи.

Иерархия включается галочкой Иерархический справочник на вкладке Иерархия. Дальше выбираете вид:

  • Иерархия групп и элементов — классические папки. Группа — это контейнер, в неё кладут элементы. Так устроена номенклатура: группа «Материалы», внутри — позиции.
  • Иерархия элементов — родителем может быть любой элемент, отдельных папок нет. Подходит для структур вроде «подразделение → отдел».

Там же задаётся Количество уровней иерархии — ограничьте, если глубина фиксированная.

Владельцы (вкладка Владельцы) делают справочник подчинённым. Классический пример — «Договоры контрагентов»: каждый договор принадлежит конкретному контрагенту. Добавьте в список владельцев справочник Контрагенты, и тогда элемент договора нельзя создать без указания контрагента-владельца.

Иерархия и подчинение — разные механизмы. Иерархия — вложенность внутри одного справочника. Владелец — связь «родитель из другого справочника». Их можно сочетать.

Нумерация кода и предопределённые элементы

Два свойства, до которых новички обычно не доходят, а зря — они экономят много правок потом.

Вкладка «Нумерация» управляет тем, как присваивается код:

  • Автонумерация — платформа сама подставляет следующий код при создании элемента. Снимать галочку стоит, только если код ведётся вручную по внешнему правилу.
  • Контроль уникальности — запрещает два элемента с одинаковым кодом. Для большинства справочников держите включённым.
  • Серии кода — в каких границах код уникален. Варианты: Во всём справочнике, В пределах подчинения, В пределах подчинения владельцу. Для подчинённого справочника (договоры у контрагента) логична серия в пределах владельца — тогда нумерация договоров идёт своя у каждого контрагента.

Предопределённые элементы — записи, которые создаются прямо в Конфигураторе и гарантированно существуют в любой базе. Нужны, когда на конкретный элемент ссылается код: например, статья затрат «Прочие», к которой программа привязывает автоматические операции.

Создаются на вкладке Прочее → Предопределённые (кнопка открывает список) или в ветке Предопределённые внутри справочника. У каждого задаётся Имя — по нему элемент доступен из встроенного языка как Справочники.СтатьиЗатрат.Прочие.

Предопределённый элемент нельзя удалить интерактивно в режиме 1С:Предприятие — только пометить. Удаляется он лишь из Конфигуратора. Не делайте предопределёнными те записи, которые пользователь должен вести и чистить сам.

Реквизиты и составные типы: как хранить дополнительные поля

Код и наименование есть у любого справочника по умолчанию. Всё остальное — свои реквизиты.

Разверните справочник в дереве, найдите ветку Реквизиты, правой кнопкой Добавить. Для реквизита задаются Имя, Синоним и, главное, Тип.

Тип выбирается в окне редактирования типа. Варианты:

  1. Примитивный — Число, Строка, Дата, Булево.
  2. Ссылочный — ссылка на другой объект: СправочникСсылка.Контрагенты, ПеречислениеСсылка.ВидыЦен.
  3. Составной тип — реквизит, который может хранить значение одного из нескольких типов.

Составной тип включается галочкой Составной тип в окне выбора типа. После этого отмечаете несколько типов сразу — например, реквизит «Источник» может ссылаться и на Справочник.Контрагенты, и на Справочник.Организации. В режиме 1С:Предприятие пользователь сначала выбирает, какого типа значение вводит, потом само значение.

Составной тип удобен, но тяжелее для запросов и индексов. Если вариантов значения немного и они известны заранее — подумайте, не обойтись ли отдельными реквизитами или перечислением.

Если к элементу нужен список строк (например, контактные лица у контрагента) — добавьте табличную часть: ветка Табличные части → Добавить, а внутри неё — свои реквизиты-колонки.

Удобно сразу проверить, что тип каждого реквизита выбран осознанно:

Проверка реквизитов перед обновлением базы
Выполнено: 0 / 5

Формы и отображение для пользователя

Платформа 8.3 умеет генерировать формы автоматически. Если не создавать ни одной формы вручную, при открытии справочника в режиме 1С:Предприятие система построит форму списка и форму элемента сама, по составу реквизитов. Для простого справочника этого достаточно — создавать формы не обязательно.

Собственная форма нужна, когда:

  • надо убрать лишние поля или изменить их порядок;
  • добавить условное оформление, кнопки, свой код в обработчики;
  • сделать разную компоновку для разных ролей.

Создаётся форма на вкладке Формы: нажмите значок лупы (конструктор) у нужного вида — Форма списка, Форма элемента, Форма выбора. Откроется конструктор формы; оставьте нужные реквизиты в колонке справа и нажмите Готово. Назначьте созданную форму основной в полях «Основная форма списка / элемента» на той же вкладке.

Не создавайте формы «про запас». Пустую автогенерируемую форму платформа всегда построит сама и будет обновлять её при добавлении реквизитов. Как только вы сделали форму руками — добавлять на неё новые поля придётся тоже руками.

Права доступа к справочнику

Права назначаются не в самом справочнике, а в ролях. Роль — отдельный объект метаданных в ветке Общие → Роли.

Откройте нужную роль двойным кликом — появится таблица: слева объекты конфигурации, справа права. Найдите ваш справочник и отметьте галочками нужные права:

  • Чтение — видеть элементы;
  • Добавление, Изменение, Удаление — соответствующие действия;
  • Просмотр и Интерактивное удаление — права на действия через интерфейс;
  • Ввод по строке — подбор по началу наименования в полях ввода.

Для нового справочника как минимум включите Чтение и Просмотр в тех ролях, где он должен быть доступен. Если оставить права пустыми во всех ролях пользователя — справочник будет невидим, хотя в конфигурации он есть.

Удобный приём: откройте роль администратора (полные права) как образец и сверьте по ней, какие права обычно нужны вашему объекту, затем повторите нужный набор в пользовательских ролях. Не выдавайте Удаление всем подряд — интерактивное удаление ссылочных данных ломает ссылки в документах.

Можно ограничивать доступ и построчно — через Ограничения доступа к данным (RLS) в той же роли, но это уже отдельная большая тема; для старта хватает прав на объект целиком.

Тестирование и обновление конфигурации базы данных

Пока вы правили объект, изменения жили только в основной конфигурации. Чтобы они попали в рабочую структуру базы, её нужно обновить.

Порядок:

  1. Нажмите F7 или Конфигурация → Обновить конфигурацию базы данных.
  2. Платформа покажет окно со списком изменений («Реорганизация информации»). Проверьте, что в списке именно ваш справочник и его реквизиты.
  3. Нажмите Принять.

Обновление структуры базы требует монопольного доступа: если в базе работают пользователи, платформа попросит их завершить сеансы. В файловой базе достаточно закрыть все клиентские подключения; в клиент-серверной — завершить сеансы через консоль администрирования. Делайте это в согласованное окно, а не в разгар рабочего дня.

После обновления запустите базу в режиме 1С:Предприятие клавишей F5 (или Начать отладку). Проверьте:

  • справочник виден в нужном разделе панели (если отметили подсистемы);
  • открывается список и создаётся элемент;
  • все реквизиты на форме, ссылочные поля подставляют значения;
  • иерархия работает, если включали (создаётся группа, элемент кладётся внутрь).
Проверьте себя
Где назначаются права на новый справочник?
Чем включается иерархия с папками?
Какой клавишей структура попадает в базу данных?

Если после обновления справочник не появился в меню — почти всегда дело в двух вещах: не отмечены подсистемы на вкладке Подсистемы или не выданы права в роли пользователя. Проверьте оба пункта.

Частые вопросы

Можно ли добавить справочник в типовую конфигурацию, не ломая обновления?
Да, через расширение конфигурации (Конфигурация → Расширения конфигурации). Новый объект живёт в расширении, типовая конфигурация остаётся на поддержке и спокойно обновляется от 1С. Для своих объектов это предпочтительный способ.
В чём разница между иерархией и подчинением справочника?
Иерархия — это вложенность элементов и групп внутри одного справочника (папки). Подчинение задаётся владельцем: элемент одного справочника привязан к элементу другого (договоры принадлежат контрагенту). Механизмы независимы и могут работать вместе.
Что такое составной тип реквизита и когда он нужен?
Это реквизит, который хранит значение одного из нескольких типов — например, ссылку то на контрагента, то на организацию. Включается галочкой «Составной тип» в окне выбора типа. Нужен, когда поле по смыслу разнотипное; для фиксированного набора вариантов чаще достаточно перечисления.
Обязательно ли рисовать формы вручную?
Нет. Если своих форм нет, платформа 8.3 генерирует форму списка и форму элемента автоматически по составу реквизитов. Собственную форму делают, только когда нужно управлять составом полей, оформлением или кодом обработчиков.
Справочник создан, но его не видно в «1С:Предприятии». Почему?
Две типовые причины: не отмечены подсистемы на вкладке «Подсистемы» (поэтому объекта нет в панели разделов) или не выданы права на чтение в роли пользователя. Проверьте и то, и другое, затем перезайдите в программу.