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

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

Создание нового вида документа — это не просто добавление строчки в дерево метаданных. Это проектирование логики поведения объекта, определение его визуального представления и правил проведения. В данной статье мы подробно разберем весь цикл: от создания объекта до написания кода в модулях.

Прежде чем приступать к настройке, необходимо четко представлять, какую бизнес-задачу будет решать новый документ. Будет ли он менять остатки товаров или лишь фиксировать факт agreement? От этого зависят настройки табличных частей и регистров.

Создание объекта метаданных и основные свойства

Для начала работы необходимо открыть окно конфигурации. В дереве метаданных найдите ветку Документы. Нажав правой кнопкой мыши, выберите пункт Добавить. Система предложит выбрать тип создаваемого объекта, но так как мы находимся внутри ветки, тип уже предопределен.

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

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

⚠️ Внимание: Если вы измените вид нумерации (например, с "в пределах года" на "сквозная") в уже работающей базе с введенными данными, это может привести к дублированию номеров или нарушению хронологии. Проверяйте это свойство до начала эксплуатации.

Также в этом разделе настраивается длина номера и возможность его ручного изменения пользователем. Если бизнес-процесс требует жесткого контроля, лучше запретить ручное редактирование номера.

Настройка шапки и табличных частей

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

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

Табличные части предназначены для перечисления однородных объектов. Классический пример — список товаров в накладной. Каждая строка такой части может содержать номенклатуру, количество, цену и сумму.

• 📦 Номенклатура: ссылка на элемент справочника товаров.
• 🔢 Количество: числовое значение, часто с типом Число(15,3).
• 💰 Цена и Сумма: финансовые показатели, требующие точности до копеек.
• ✅ Ставка НДС: перечисление или справочник ставок налога.

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

Формы документа: интерфейс и удобство работы

В современных версиях платформы 1С формы создаются автоматически при сохранении объекта метаданных. Однако для качественного решения часто требуется доработка формы в режиме Конфигуратор или расширение в режиме Предприятие.

Форма документа состоит из командной панели, области шапки и области табличных частей. Разработчик может группировать реквизиты, добавлять вкладки и изменять порядок отображения полей. Это существенно влияет на эргономику работы оператора.

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

Элемент формы	Назначение	Особенности настройки
Поле ввода	Ввод текста или выбор значения	Можно задать список выбора или маску ввода
Табличное поле	Отображение табличной части	Поддерживает группировки, итоги и условное оформление
Кнопка команды	Вызов действия	Связывается с процедурой в модуле формы
Декорация	Визуальное разделение	Не хранит данные, используется для красоты

Не забывайте про условное оформление. Оно позволяет выделять цветом строки с отрицательным остатком или подсвечивать обязательные для заполнения поля.

Модуль объекта: проведение и логика

Сердцем любого документа является его Модуль объекта. Именно здесь прописывается вся бизнес-логика. Самым важным событием в этом модуле является процедура Проведение.

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

Процедура Проведение(Отказ, Режим)

// Очистка движений перед записью
Движения.Очистить();

// Запись движений по регистру накопления "ТоварыНаСкладах"
Движение = Движения.ТоварыНаСкладах.Добавить();
Движение.Период = Дата;
Движение.ВидДвижения = ВидДвиженияНакопления.Приход;
Движение.Склад = Склад;
Движение.Номенклатура = Товар.Номенклатура;
Движение.Количество = Товар.Количество;

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

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

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

Почему нельзя менять регистры напрямую в модуле объекта?

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

Модуль формы и клиентская логика

Для улучшения пользовательского опыта часть логики выносится в Модуль формы. Этот модуль выполняется на стороне клиента и позволяет реагировать на действия пользователя мгновенно, без обращения к серверу.

Типичная задача — автоматический пересчет суммы при изменении количества или цены. Для этого используется событие ПриИзменении у соответствующего поля табличной части.

• 🖱️ Обработка выбора: срабатывает при подборе товара из справочника.
• 🔄 Обновление: обновляет данные формы при изменении связанных объектов.
• 🎨 Оформление строки: меняет цвет строки в зависимости от условий.

Важно помнить о разделении контекстов. В модуле формы недоступны объекты метаданных напрямую, работа идет с данными формы. Для обращения к серверным функциям используются вызовы на сервер через ключевое слово НаСервере.

Оперативное проведение и блокировки

Одним из критических параметров документа является флаг Оперативное проведение. Если он установлен, система запрещает проводить документы задним числом, если дата документа меньше даты запрета загрузки данных.

Этот механизм защищает базу от хаоса, когда пользователи начинают менять историю прошлого года в середине текущего. Однако, иногда возникают ситуации, когда проведение задним числом необходимо (например, исправление ошибки бухгалтера).

В таких случаях администратор может временно сдвинуть дату запрета загрузки. Но делать это следует с осторожностью, так как это может потребовать перепроведения всех последующих документов для актуализации остатков.

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

⚠️ Внимание: Интерфейсы и возможности настройки могут отличаться в зависимости от версии платформы 1С:Предприятие (8.2, 8.3) и используемой конфигурации (Бухгалтерия, УТ, ERP). Всегда сверяйтесь с документацией к вашей конкретной версии.

Часто задаваемые вопросы (FAQ)

Как удалить проведенный документ?

Для удаления проведенного документа необходимо сначала отменить проведение (кнопка "Отмена проведения" или Ctrl+Shift+P), и только после этого удалять объект. Удаление проведенного документа без отмены проведения невозможно, так как это нарушит данные в регистрах.

Почему документ не проводится и выдает ошибку?

Наиболее частые причины: отрицательные остатки (если включен контроль), отсутствие обязательных заполненных реквизитов, блокировка документа другим пользователем или ошибка в коде модуля объекта. Текст ошибки обычно указывает на конкретную проблему.

Можно ли изменить тип документа после его создания?

Нет, тип документа является неизменяемым свойством метаданных. Если вам нужно изменить структуру кардинально, придется создавать новый вид документа и переносить данные средствами внешней обработки или запросов.

Что такое "Вид субконто" в документе?

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

Как сделать нумерацию документов независимой для разных организаций?

Стандартными средствами 1С это реализуется сложно. Обычно используют механизм "Нумераторов" — отдельных регистров сведений, где хранится последний номер для каждой организации, и в модуле объекта при записи считывают и увеличивают этот номер.