Как добавить вид документа в 1С

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

Прежде чем приступать, определите, действительно ли нужен новый вид документа. Часто задачу решают дополнительные реквизиты существующего документа, новая операция или подвид, реализуемый через реквизит «Вид операции». Отдельный документ оправдан, когда у объекта собственная нумерация, свой набор движений по регистрам, уникальная печатная форма и самостоятельный жизненный цикл — например, «Акт сверки взаиморасчётов» или «Заявка на ремонт».

Подготовка: что проверить перед изменением конфигурации

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

Обязательно сделайте резервную копию: для файловой базы — выгрузку в dt через Конфигуратор («Администрирование → Выгрузить информационную базу»), для серверной — средствами СУБД. Это единственный способ быстро откатиться, если обновление пройдёт с ошибкой или доработка окажется неверной.

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

Создание объекта «Документ» в конфигураторе

Откройте Конфигуратор, разверните в дереве конфигурации ветку «Документы» и выполните «Действия → Добавить» (или правый клик → «Добавить»). Откроется палитра свойств нового объекта. На закладке «Основные» задайте имя (латиницей, без пробелов, например «ЗаявкаНаРемонт») и синоним — именно синоним увидят пользователи в интерфейсе («Заявка на ремонт»). Представление объекта и представление списка заполнятся автоматически, при необходимости скорректируйте их.

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

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

1. 1
   Сделайте резервную копию базы и завершите сеансы пользователей
2. 2
   В Конфигураторе откройте ветку «Документы» и выполните «Добавить»
3. 3
   Задайте имя, синоним, настройте нумерацию и длину номера
4. 4
   На закладке «Данные» добавьте реквизиты шапки и табличные части
5. 5
   На закладке «Формы» сгенерируйте форму документа и форму списка
6. 6
   Настройте права доступа для ролей и включите документ в подсистемы
7. 7
   Обновите конфигурацию базы данных (F7) и проверьте результат в режиме Предприятия

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

Закладка «Данные» определяет структуру документа. Реквизиты шапки добавляйте кнопкой «Добавить» в верхней таблице: для каждого задайте имя, тип и, при необходимости, обязательность заполнения («Проверка заполнения: Выдавать ошибку»). Используйте ссылочные типы (СправочникСсылка, ДокументСсылка) вместо строк — это обеспечит целостность данных и удобный выбор из списков.

Если документ содержит перечень позиций (товары, работы, сотрудники), добавьте табличную часть, а внутри неё — реквизиты колонок. Для колонок с количеством и суммами задайте точность (обычно 3 знака для количества, 2 для сумм) и неотрицательное значение. Не создавайте табличную часть «на всякий случай»: пустые табличные части усложняют форму и запросы.

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

Формы, журналы и размещение в интерфейсе

На закладке «Формы» нажмите кнопку с лупой у поля «Форма документа» — запустится конструктор. Выберите тип «Форма документа», оставьте автоматическое размещение реквизитов и завершите создание. Аналогично создайте «Форму списка», чтобы пользователи видели журнал документов. Автоматически созданные формы достаточны для старта; позже их можно доработать: группировка полей, условное оформление, команды печати.

Чтобы документ был виден пользователям, включите его в подсистемы на закладке «Подсистемы» — от этого зависит, в каких разделах командного интерфейса появится ссылка на список. Также документ можно добавить в журналы (закладка «Журналы» у самого документа либо настройка журнала), чтобы он отображался рядом с родственными документами, например в общем журнале «Складские документы».

Проверьте поле «Ввод на основании» и «Является основанием для», если документ участвует в цепочках: например, «Заявка» → «Заказ» → «Реализация». Это настраивается на закладке «Ввод на основании» и требует обработчика «ОбработкаЗаполнения» в модуле объекта.

Права доступа и роли

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

Разделяйте права осмысленно: право «Интерактивное удаление» и «Установка пометки удаления» давайте ограниченному кругу ролей. Для документов, участвующих в учёте, право отмены проведения тоже стоит выдавать точечно — массовые отмены проведения частый источник расхождений в данных.

Обновление конфигурации базы данных и проверка

После завершения настроек нажмите F7 или «Конфигурация → Обновить конфигурацию базы данных». Платформа покажет окно реструктуризации со списком изменений — для нового объекта это создание таблиц. Примите изменения и дождитесь окончания. В больших базах реструктуризация может занять заметное время, не прерывайте процесс.

Откройте базу в режиме Предприятия под учётной записью с полными правами, затем под обычным пользователем. Проверьте: документ виден в нужном разделе, создаётся, заполняется, проводится, номер присваивается автоматически, список открывается без ошибок. Если использовалось расширение, убедитесь, что оно подключено и активно («Администрирование → Печатные формы, отчёты и обработки → Расширения»).

Контрольные точки

Как проверить результат

Видимость в интерфейсе

Норма

Документ есть в разделе подсистемы у пользователя с нужной ролью

Тревожный признак

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

Создание и проведение

Норма

Документ записывается, нумеруется и проводится без ошибок

Тревожный признак

Ошибка при записи — проверяйте обязательные реквизиты и модуль проведения

Нумерация

Норма

Номера присваиваются последовательно в заданном периоде

Тревожный признак

Номера дублируются или сбрасываются — проверьте периодичность и контроль уникальности

Альтернативы: расширение, дополнительные реквизиты, операции

Не каждая задача требует нового вида документа. Если нужно добавить к существующему документу пару полей (например, «Водитель» и «Номер ТТН» к реализации), используйте механизм дополнительных реквизитов и сведений — он работает в пользовательском режиме без изменения конфигурации. Если нужно различать сценарии одного документа, добавьте реквизит «Вид операции» с перечислением.

Если документ нужен в типовой конфигурации, создайте расширение: «Конфигурация → Расширения конфигурации → Создать». В расширении добавьте собственный документ — платформа поддерживает создание новых объектов метаданных в расширениях. Такой документ сохранится при обновлении типовой конфигурации и не нарушит поддержку.

Сравнение вариантов

Изменение основной конфигурации

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

Расширение конфигурации

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

Дополнительные реквизиты

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

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

Можно ли добавить вид документа без конфигуратора?

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

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

Две основные причины: не выданы права в ролях и документ не включён ни в одну подсистему. Проверьте права на чтение и просмотр для ролей пользователя, а также закладку «Подсистемы» у документа. В конфигурациях на БСП дополнительно посмотрите профили групп доступа.

Что будет с доработкой при обновлении типовой конфигурации?

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

Как сделать, чтобы новый документ попал в журнал вместе с другими?

Откройте нужный журнал документов в конфигураторе и на закладке «Данные» отметьте новый вид документа. При необходимости добавьте графы журнала, связанные с реквизитами документа. Либо на закладке «Журналы» самого документа отметьте нужные журналы — результат одинаков.

Нужно ли программировать проведение для нового документа?

Если документ должен изменять учётные данные (остатки, расчёты), да: в модуле объекта создаётся обработчик «ОбработкаПроведения» с формированием движений по регистрам. Если документ чисто печатный или справочный, проведение можно отключить в свойствах — тогда программировать ничего не нужно.

Можно ли удалить созданный вид документа, если он уже использовался?

Технически да, но сначала нужно удалить или пометить на удаление все экземпляры документа в базе, иначе останутся битые ссылки в местах, где документ использовался. Перед удалением объекта выполните поиск ссылок на объект («Правый клик → Поиск ссылок») и оцените последствия.