Как устроено окно настройки справочника и документа в Конфигураторе

Окно редактирования объекта конфигурации открывается в Конфигураторе двойным щелчком по справочнику, документу или регистру в дереве конфигурации. Это многостраничная форма: слева список вкладок («Основные», «Подсистемы», «Данные», «Формы», «Команды», «Макеты», «Права», «Прочее» и другие), справа настройки выбранной вкладки. Набор вкладок зависит от вида объекта: у документа есть «Движения» и «Нумерация», у справочника — «Иерархия» и «Владельцы».

Частое заблуждение: окно редактирования считают «полным» списком свойств объекта. Это не так. В окне собраны самые нужные настройки в удобном порядке, а полный перечень свойств живёт в палитре свойств (Alt+Enter). Окно и палитра правят одни и те же данные, просто показывают их по-разному.

Как открыть окно редактирования и чем оно отличается от палитры свойств

Окно редактирования есть во всех конфигурациях на платформе 8.3 — это часть Конфигуратора, а не типового решения. Работает одинаково в Бухгалтерии, ЗУП, УТ и в самописной базе.

Способы открыть окно:

1. 🖱️ Двойной щелчок по объекту в дереве конфигурации.
2. 📋 Правая кнопка мыши по объекту → Изменить.
3. ⌨️ Выделить объект и нажать Enter.

Если по двойному щелчку вместо окна открывается палитра свойств, значит, поведение переключено в настройках. Откройте Сервис → Параметры и найдите на вкладке общих настроек переключатель редактирования объекта конфигурации: «С помощью окна редактирования» или «С помощью палитры свойств».

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

С этой вкладки начинается любой объект. Три поля определяют, как объект называется в коде и как его видит пользователь.

• 🔤 Имя — идентификатор в коде: Справочники.Номенклатура, Документы.РеализацияТоваровУслуг. Только буквы, цифры и подчёркивание, первым символом не цифра, без пробелов.
• 🏷️ Синоним — название для пользователя: «Номенклатура», «Реализация (акты, накладные)». Подставляется в заголовки форм и в меню. Заполняется автоматически из имени, но его стоит поправить руками.
• 💬 Комментарий — заметка для разработчика. Пользователь её не видит.

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

Подсистемы и функциональные опции

Следующие две вкладки отвечают за то, где объект появится в интерфейсе.

• 📂 Подсистемы — галочки разделов командного интерфейса. Отметили «Продажи» — команда открытия списка появится в этом разделе. Не отметили ни одного — объект в меню не попадёт, его можно открыть только кодом или через Все функции.
• 🔘 Функциональные опции — включают объект в опции, которые можно отключить в настройках программы. Выключенная опция прячет объект из интерфейса.

Вкладка «Данные»: реквизиты и табличные части

Здесь описывается, какие данные хранит объект. Вкладка разделена на три зоны: стандартные поля, реквизиты, табличные части.

Стандартные поля

У справочника это код и наименование. В окне задают:

• длину кода и его тип (строка или число);
• длину наименования;
• основное представление — в виде наименования или в виде кода.

Длину наименования на практике берут с запасом: 100–150 символов для номенклатуры. Если поставить 25, полное название товара не поместится, а увеличивать длину потом придётся через реструктуризацию таблицы.

У документа стандартных полей другие — номер и дата. Длина и тип номера, а также периодичность его уникальности (в пределах года, квартала, месяца, дня) настраиваются на вкладке «Нумерация».

Реквизиты и табличные части

Кнопка добавления над списком реквизитов создаёт новое поле. У каждого реквизита задают:

Табличная часть — вложенная таблица: строки товаров в накладной, список сотрудников в приказе. У неё свои реквизиты. Добавляется она в нижней зоне вкладки, реквизиты строк — двойным щелчком по табличной части.

Ввод по строке

У справочников на вкладке «Данные» также настраивается ввод по строке — по каким полям ищется элемент, когда пользователь начинает печатать в поле выбора. По умолчанию это наименование и код. Можно добавить, например, артикул — тогда номенклатура будет находиться и по нему.

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

У справочников есть ещё две вкладки, которые меняют саму структуру данных.

• 🌳 Иерархия — включает группы или вложенность элементов. Иерархия групп и элементов подходит для номенклатуры: папки «Товары», «Услуги». Иерархия элементов — для подразделений, где каждый элемент может быть родителем. Здесь же ограничивают число уровней.
• 🔗 Владельцы — делают справочник подчинённым. Классический пример — «Договоры контрагентов»: каждый договор принадлежит конкретному контрагенту, и в поле выбора видны только его договоры.

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

Вкладка «Формы»: какие окна увидит пользователь

На вкладке «Формы» две части: основные формы и список всех форм объекта.

Основные формы — это назначения. Для справочника это форма элемента, группы, списка, выбора и выбора группы. Для документа — форма документа, списка и выбора. Если основная форма не указана, платформа построит её автоматически по реквизитам.

Чтобы создать свою форму:

1. Нажмите кнопку добавления в списке форм.
2. Откроется конструктор формы: выберите тип (форма элемента, списка, выбора) и отметьте реквизиты, которые попадут на форму.
3. Поставьте флажок «Назначить форму основной», если она должна открываться по умолчанию.
4. Нажмите «Готово» — откроется редактор управляемой формы.

В редакторе формы три основные панели: элементы, реквизиты и команды формы, а снизу — модуль формы. Порядок полей и группы меняются перетаскиванием в дереве элементов.

Макеты рядом с формами

Вкладка «Макеты» хранит печатные формы и шаблоны: табличные документы, двоичные данные, схемы компоновки. Кнопка конструктора печати создаёт макет и процедуру печати по выбранным реквизитам — для простой печатной формы этого хватает.

Модули объекта и менеджера: где живёт программная логика

Код объекта хранится в двух модулях. Открываются они с вкладки «Прочее» или из контекстного меню объекта в дереве: «Открыть модуль объекта», «Открыть модуль менеджера».

Основные события модуля объекта справочника:

• 💾 ПередЗаписью(Отказ) — последняя проверка перед записью, можно отменить запись.
• ✅ ПриЗаписи(Отказ) — объект уже записан в транзакции, можно писать связанные данные.
• 📥 ОбработкаЗаполнения(ДанныеЗаполнения, ТекстЗаполнения, СтандартнаяОбработка) — заполнение нового объекта, в том числе при вводе на основании.
• 🔎 ОбработкаПроверкиЗаполнения(Отказ, ПроверяемыеРеквизиты) — своя проверка заполнения поверх флажков на вкладке «Данные».

У документа к ним добавляется ОбработкаПроведения(Отказ, Режим), а ПередЗаписью получает ещё два параметра: режим записи и режим проведения.

Пример: запретить запись контрагента без ИНН, если это юрлицо.

Процедура ОбработкаПроверкиЗаполнения(Отказ, ПроверяемыеРеквизиты)

    Если ЮрФизЛицо = Перечисления.ЮрФизЛицо.ЮрЛицо Тогда
        ПроверяемыеРеквизиты.Добавить("ИНН");
    КонецЕсли;

КонецПроцедуры

Здесь ЮрФизЛицо и ИНН — реквизиты вашего справочника, а перечисление должно существовать в конфигурации. Пример показывает приём: платформа сама выдаст сообщение о незаполненном поле и не даст записать элемент.

Вкладка «Команды»: кнопки и пункты меню объекта

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

Чтобы добавить команду:

1. На вкладке «Команды» нажмите кнопку добавления.
2. Задайте имя и синоним — синоним станет текстом кнопки.
3. В свойстве Группа выберите, куда команда попадёт: командная панель формы, панель навигации , раздел.
4. В Типе параметра команды укажите ссылку на объект, если команда работает с выделенной строкой.
5. Откройте модуль команды и напишите обработчик.

Обработчик команды выполняется на клиенте:

&НаКлиенте
Процедура ОбработкаКоманды(ПараметрКоманды, ПараметрыВыполненияКоманды)

    ПараметрыФормы = Новый Структура("Ключ", ПараметрКоманды);
    ОткрытьФорму("Документ.ЗаказКлиента.ФормаОбъекта", ПараметрыФормы);

КонецПроцедуры

Имя формы в примере условное — подставьте свой объект.

Ввод на основании

Отдельная вкладка «Ввод на основании» задаёт, из каких объектов можно создать этот, и для каких он сам служит основанием. Отметили связь — в форме появится подменю «Создать на основании». Кнопка конструктора ввода на основании сама сгенерирует ОбработкаЗаполнения с переносом реквизитов.

Движения документа

У документа есть вкладка «Движения»: здесь отмечают регистры, в которые он пишет при проведении. Кнопка конструктора движений создаёт ОбработкаПроведения по сопоставлению реквизитов документа и измерений регистра. Для простых случаев это быстрее ручного кода, для сложных — хорошая заготовка.

Права и прочие настройки объекта

Вкладка «Права» показывает матрицу: слева роли конфигурации, справа права на этот объект — чтение, добавление, изменение, удаление, просмотр, интерактивные действия. Для документа добавляются проведение и отмена проведения.

Это быстрый способ проверить доступ к одному объекту: не нужно открывать каждую роль по очереди.

На вкладке «Прочее» кроме модулей находятся:

• 📌 Предопределённые элементы (у справочников, планов счетов, планов видов характеристик) — элементы, на которые можно ссылаться из кода по имени.
• 📖 Справочная информация — текст справки по объекту для пользователей.

Почему окно открывается, но ничего не редактируется

Это самый частый вопрос новичков. Окно доступно, поля видны, но изменить ничего нельзя. Причин немного, и каждая проверяется за минуту.

После любых изменений в окне редактирования они сохраняются только в основной конфигурации. Чтобы пользователи их увидели, выполните Конфигурация → Обновить конфигурацию базы данных (F7).

Обновление структуры базы данных при изменении реквизитов требует монопольного доступа: попросите пользователей выйти из программы и заранее сделайте резервную копию.

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