К статье
Практический материал

Другое · 7 мин

Добавление документа в расширение конфигурации 1С

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

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

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

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

Что понимать под добавлением документа в расширение

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

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

Когда расширение подходит, а когда нужно править базу

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

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

Порядок добавления нового документа в расширение

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

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

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

Порядок действий
  1. 1
    Открыть конфигурацию в режиме расширения
  2. 2
    Создать документ в дереве объектов расширения или открыть расширение существующего документа
  3. 3
    Добавить реквизиты, формы, команды и модуль
  4. 4
    Сохранить расширение и обновить конфигурацию базы
  5. 5
    Проверить документ на копии базы

Как расширить существующий документ через расширение

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

Добавление реквизита или табличной части

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

Добавление формы или команды

Новая форма списка или объекта добавляется в расширение документа и связывается с документом через свойства формы. Команда появляется в интерфейсе, если для неё настроено отображение и права. Проверьте, что форма открывается из списка документов и из карточки документа.

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

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

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

Документ открывается, новые реквизиты сохраняются

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

Ошибка при открытии, отсутствие реквизита или блокировка записи

Работа связанных отчетов и регистров
Норма

Данные отображаются корректно

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

Ошибки выполнения или несоответствие данных

Проверка результата и ограничения

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

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

Типичные ошибки
01
Копирование стандартного документа в расширение вместо создания нового или расширения существующего
02
Изменение рабочей базы без копии и резервной копии
03
Игнорирование защиты конфигурации и режима поддержки

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

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

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

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

Новый документ в расширении

Подходит, когда документ должен существовать отдельно от базового и не заменять существующие ссылки

Расширение существующего документа

Подходит для добавления реквизитов, форм и команд без замены базового объекта

Правка базовой конфигурации

Требуется для глубоких изменений, но ломает поддержку и обновления

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

Альтернативы и выбор подхода

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

Итог

Что важно запомнить

Расширение дополняет или создает документ, но не импортирует весь стандартный документ как копию. Работайте на копии базы, делайте резервные копии и проверяйте результат после обновления конфигурации.

Можно ли скопировать стандартный документ в расширение целиком?

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

Нужно ли обновлять базу данных после сохранения расширения?

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

Что делать, если документ заблокирован поставкой?

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

Как проверить, что реквизит добавлен правильно?

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

Переносятся ли ссылки на документ при создании нового документа в расширении?

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