Как добавить новый вид документа в 1С: полное руководство с примерами

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

В отличие от простого добавления реквизитов в существующие формы, создание нового вида документа затрагивает сразу несколько уровней системы: от визуального интерфейса до механизмов проведения и хранения данных. Ошибки на этом этапе могут привести к нарушению целостности базы или конфликтам с типовыми механизмами. В этом руководстве мы разберем процесс от А до Я — от подготовки конфигурации до тестирования готового решения, — с учетом актуальных требований платформы 1С:Предприятие 8.3.

Подготовка к созданию нового вида документа

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

Начните с ответов на ключевые вопросы:

• 📌 Для чего нужен документ? (учет новых операций, замена устаревшего механизма, интеграция с внешними системами)
• 🔄 Как он будет взаимодействовать с другими объектами? (проводки, регистры, отчеты)
• 👥 Кто будет работать с документом? (бухгалтеры, менеджеры, администраторы)
• 📊 Какие данные он должен хранить? (реквизиты, табличные части, вложенные объекты)

Особое внимание уделите анализу существующих документов в конфигурации. Часто требуемую функциональность можно реализовать через доработку типовых объектов (например, добавив новые реквизиты в "Реализацию товаров") вместо создания отдельного вида. Это упростит поддержку и обновление системы.

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

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

1. 🛠️ Откройте конфигурацию в режиме редактирования (Файл → Открыть конфигурацию).
2. 📄 В дереве метаданных найдите ветку Документы и выберите Добавить.
3. ⚙️ Задайте основные параметры:
   • 🔤 Имя (латинские символы, например CustomOrder)
   • 📝 Синоним (отображаемое имя, например "Заказ клиента (кастомный)")
   • 📅 Периодичность (в пределах дня, месяца и т.д.)
   • 🔢 Нумерация (автоматическая или ручная)
4. 💾 Сохраните изменения (Ctrl+S).

После создания базового объекта система автоматически сгенерирует:

• 📋 Форму списка документов
• 📄 Форму самого документа
• 📊 Модуль объекта (для программной логики)
• 🔄 Модуль менеджера (для обработки событий)

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

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

Для добавления реквизитов:

1. В окне редактирования документа перейдите на вкладку Реквизиты.
2. Нажмите Добавить и укажите:
   • 🔤 Имя (например, CustomerID)
   • 🏷️ Синоним ("Клиент")
   • 📏 Тип (ссылка на справочник, число, строка и т.д.)
   • ⚖️ Длина (для строковых полей)

Для табличных частей:

1. Перейдите на вкладку Табличные части и добавьте новую.
2. Настройте колонки аналогично реквизитам, но с учетом особенностей:
   • 🔄 Можно задавать периодичность для строк
   • 🔒 Указывать условия отбора данных
   • 📊 Настраивать иерархию (для древовидных структур)
Особенности типов данных в 1С

Тип "Ссылка" позволяет связывать документы с другими объектами (справочниками, планами видов характеристик). Для хранения больших текстов лучше использовать тип "ХранилищеЗначения". Числовые поля поддерживают разные форматы (количество, цена, процент) с автоматическим округлением.

Тип реквизита	Пример использования	Особенности
Строка	Номер телефона, email	Можно ограничить длину и формат
Число	Количество, сумма	Поддерживает дробные значения
Дата	Срок действия, дата оплаты	Автоматическая валидация
Ссылка	Связь с клиентом или номенклатурой	Требует указания целевого объекта
Булево	Флаги ("Оплачено", "Доставлено")	Отображается как чекбокс

Программная логика: модули и обработчики событий

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

• 📝 Модуль объекта — обработчики для конкретного документа
• 🔄 Модуль менеджера — общие процедуры для всех документов этого типа
• 📋 Модуль формы — логика интерфейса

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

Процедура ОбработкаЗаполнения(Отказ)
Если Новый Тогда
Номер = Строка(ТипЗнч(Метаданные().Имя)) + "_" +
Формат(ТекущаяДата(), "ДФ=yyyyMMdd") + "_" +
Формат(ПолучитьНовыйНомер(), "ЧГ=0");
КонецЕсли;
КонецПроцедуры

Типичные задачи, решаемые программно:

• 🔄 Автозаполнение полей при создании документа
• 📊 Проверка корректности введенных данных
• 💰 Формирование проводок при проведении
• 📤 Интеграция с внешними системами через API
💡

Для отладки кода используйте точку останова (F9) и пошаговое выполнение (F10). Это поможет быстро найти ошибки в логике обработчиков.

Настройка прав доступа и ролей

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

Чтобы настроить доступ:

1. Откройте ветку Роли в дереве метаданных.
2. Выберите роль, которую нужно изменить (например, Бухгалтер), или создайте новую.
3. На вкладке Права найдите ваш документ и установите разрешения:
   • 📖 Чтение — просмотр документов
   • ✏️ Добавление/Изменение — редактирование
   • 🗑️ Удаление — удаление документов
   • 🔒 Просмотр чужих — доступ к документам других пользователей
4. Для тонкой настройки используйте ограничения по реквизитам (например, скрыть поле "Себестоимость" для менеджеров).
💡

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

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

Тестирование и отладка нового документа

Даже идеально спроектированный документ может содержать ошибки. Тестирование должно покрывать все сценарии использования:

• 🧪 Создание нового документа с разными наборами данных
• 🔄 Редактирование и сохранение изменений
• 🗑️ Удаление (проверка каскадного удаления связанных объектов)
• 📊 Проводка и формирование движений по регистрам
• 🔍 Поиск документа через стандартные механизмы
• 📄 Печать формы документа

Для комплексного тестирования используйте:

• 🛠️ Режим отладки (Сервис → Отладка)
• 📊 Журнал регистрации для отслеживания ошибок
• 🔍 Контроль целостности (Администрирование → Тестирование и исправление)
💡

Создайте тестовый сценарий с крайними значениями (пустые поля, максимальные числа, некорректные даты). Это поможет выявить уязвимости в валидации данных.

⚠️ Внимание: При тестировании документов, формирующих проводки, всегда проверяйте баланс дебет/кредит после проведения. Несбалансированные проводки могут привести к ошибкам при закрытии периода.

Типичные ошибки и способы их решения

Даже опытные разработчики сталкиваются с проблемами при создании новых документов. Вот наиболее распространенные ошибки и пути их исправления:

Ошибка	Причина	Решение
Документ не сохраняется без ошибок	Отсутствуют обязательные реквизиты или нарушена структура данных	Проверьте свойства реквизитов на вкладке "Дополнительно" (флаг "Обязательный")
Не формируются движения по регистрам	Не прописана процедура ОбработкаПроведения или ошибки в запросах	Отладьте модуль объекта, проверьте корректность регистраторов
Документ не виден в журналах	Не настроены права или не добавлен в состав журнала документов	Проверьте настройки журнала (Все функции → Журналы документов)
Ошибка "Недостаточно прав"	Не хватает прав на связанные объекты (регистры, справочники)	Настройте роли для всех задействованных метаданных

Для диагностики сложных ошибок используйте:

• 📋 Журнал регистрации (Администрирование → Журнал регистрации)
• 🔍 Отладчик с пошаговым выполнением кода
• 📊 Тестовый клиент для проверки сетевого взаимодействия

⚠️ Внимание: Если документ должен интегрироваться с внешними системами через REST API или COM-соединение, тестируйте обмен данными на отдельном стенде. Ошибки в форматах данных (JSON/XML) могут блокировать работу всей системы.

FAQ: Частые вопросы по работе с документами в 1С

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

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

Как сделать документ периодическим с интервалом в неделю?

В свойствах документа на вкладке "Основные" установите периодичность "В пределах недели". Система автоматически будет контролировать уникальность номеров в рамках недели. Для более сложных интервалов (например, 10 дней) потребуется программная доработка процедуры нумерации.

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

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

1. Совместимость версий платформы и конфигурации
2. Целостность ссылок на регистры в модуле проведения
3. Наличие прав у пользователя на новые объекты метаданных

Часто помогает полное пересоздание документа с переносом данных через обработку.

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

Используйте обработчик события ПередЗаписью в модуле объекта:

Процедура ПередЗаписью(Отказ, Проводить)
Если Проведен И ЭтоНовыйОбъект() = Ложь Тогда
Сообщить("Редактирование проведенного документа запрещено!");
Отказ = Истина;
КонецЕсли;
КонецПроцедуры

Для гибкого управления добавьте реквизит "РазрешитьРедактирование" с проверкой прав пользователя.

Можно ли перенести документ из одной конфигурации в другую?

Да, но это требует осторожности. Используйте механизмы:

• 📤 Выгрузка/загрузка через cf-файл (для идентичных платформ)
• 🔄 Обмен данными через XML или JSON (универсальный способ)
• 🛠️ Ручное воспроизведение структуры с переносом данных через обработку

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