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

Другое · 7 мин

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

Пошаговая инструкция по добавлению документа в расширение конфигурации 1С: подготовка, объекты, формы, модули и проверка результата.

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

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

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

Что такое расширение и зачем добавлять документ через него

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

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

Подготовка конфигурации и создание расширения

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

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

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

Добавление объекта документа в расширение

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

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

Сценарий: документ с табличной частью

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

Типичные ошибки
01
Добавление документа напрямую в базовую конфигурацию вместо расширения
02
Забывчивость обновить конфигурацию после добавления объекта
03
Отсутствие прав доступа к форме документа для пользователей

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

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

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

Модули документа и логика заполнения и проведения

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

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

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

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

Документ появился в списке объектов расширения
Норма

Объект виден в конструкторе расширения

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

Объект отсутствует или подсвечен ошибкой

Форма документа открывается в режиме предприятия
Норма

Форма открывается без ошибок

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

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

Обновление конфигурации и проверка результата

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

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

Ограничения, риски и частые ошибки

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

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

Итог

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

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

Нужно ли права администратора для добавления документа в расширение?

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

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

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

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

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

Влияет ли добавление документа в расширение на обновление базовой конфигурации?

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