Другое · 7 мин
Как добавить документ в расширение 1С
Пошаговая инструкция по добавлению документа в расширение конфигурации 1С: подготовка, объекты, формы, модули и проверка результата.
Добавление документа в расширение конфигурации 1С позволяет расширить функциональность системы без изменения базовой конфигурации. Такой подход сохраняет возможность обновления типовой конфигурации и упрощает поддержку изменений. Расширение изолирует новые объекты, реквизиты, формы и модули от основного состава конфигурации.
Перед началом работы важно убедиться, что текущая конфигурация поддерживает создание расширений, а у пользователя есть необходимые права на изменение конфигурации. Если конфигурация находится в режиме без поддержки или закрыта для редактирования, прямое добавление объектов может быть недоступно или привести к потере изменений при обновлении.
В расширение можно добавить не только сам документ, но и связанные с ним реквизиты, табличные части, формы, команды и модули. После добавления объектов конфигурацию необходимо обновить, чтобы изменения стали доступны в режиме предприятия. Ниже описан порядок действий и моменты, на которые стоит обратить внимание.
Что такое расширение и зачем добавлять документ через него
Расширение конфигурации — это отдельный слой, в котором описываются дополнения к базовой конфигурации. Документ, добавленный в расширение, не вносит изменений в типовую поставку, что особенно важно при использовании поддерживаемых типовых решений. При выходе новых релизов базовой конфигурации изменения в расширении сохраняются, если не возникают конфликты объектов.
Добавление документа напрямую в базовую конфигурацию может заблокировать обновление или создать сложности при слиянии версий. Через расширение проще переносить изменения между базами, выгружать и загружать пакет обновления, а также разграничивать права доступа к новым объектам.
Подготовка конфигурации и создание расширения
Перед добавлением документа откройте конфигурацию в режиме конструктора и проверьте состояние режима поддержки. Если конфигурация не поддерживает расширения, создание нового расширения может быть ограничено. В таком случае целесообразно использовать копию конфигурации или обратиться к администратору информационной базы.
Создайте новое расширение через меню конфигурации, укажите имя и описание, а затем активируйте его. После активации в дереве конфигурации появится раздел расширения, куда можно переносить или создавать объекты. Не забудьте сохранить настройки расширения перед переходом к добавлению документа.
- 1Создать или открыть расширение конфигурации
- 2Добавить объект документа в расширение
- 3Настроить реквизиты, табличные части и формы
- 4Написать модули заполнения и проведения
- 5Обновить конфигурацию и проверить документ в режиме предприятия
Добавление объекта документа в расширение
В дереве конфигурации раздела расширения выберите пункт «Документы» и создайте новый документ. Укажите имя объекта, синоним и другие общие свойства. Имя документа должно соответствовать правилам именования и не дублировать существующие объекты базовой конфигурации.
После создания документа система предложит сгенерировать стандартные реквизиты, такие как номер, дата и комментарий. Их можно оставить или дополнить собственными реквизитами в зависимости от бизнес-задачи. Для документов с повторяющимися строками добавьте табличную часть и укажите её составные реквизиты.
Сценарий: документ с табличной частью
Если документ содержит строки с товарами, услугами или другими позициями, создайте табличную часть и добавьте в неё необходимые поля. Связь табличной части с документом настраивается автоматически при создании объекта в конструкторе. Проверьте, что имя табличной части не совпадает с именами других объектов расширения.
Настройка реквизитов, табличных частей и форм
Добавьте реквизиты документа, которые необходимы для учёта: контрагент, договор, сумма, статус и другие поля в зависимости от задачи. Для каждого реквизита укажите тип данных, длину, точность и обязательность заполнения. Настройте представление реквизита, чтобы оно отображалось корректно в интерфейсе.
Создайте форму документа для ввода данных и форму списка для работы с документами в режиме предприятия. На форме документа разместите реквизиты, табличную часть, команды и элементы управления. Проверьте порядок обхода элементов и доступность полей для редактирования.
Модули документа и логика заполнения и проведения
Напишите модуль объекта документа, в котором опишите процедуры заполнения, проверки заполнения и проведения. В модуле формы реализуйте обработку команд, открытие форм и взаимодействие с пользователем. Логика проведения должна формировать проводки или другие движения в зависимости от вида документа.
Если документ использует регистры накопления, бухгалтерии или другие регистры, опишите движения в модуле проведения. Проверьте корректность отбора данных и обработку ошибок при проведении. Неправильно настроенные движения могут привести к несоответствиям в учёте.
Как проверить результат
Объект виден в конструкторе расширения
Объект отсутствует или подсвечен ошибкой
Форма открывается без ошибок
Ошибка при открытии или отсутствие прав
Обновление конфигурации и проверка результата
После завершения настройки обновите конфигурацию базы данных, чтобы новые объекты стали доступны пользователям. В процессе обновления система проверит наличие ошибок в объектах расширения и сообщит о проблемах, если они есть. Не завершайте работу, пока обновление не пройдёт без критических ошибок.
Откройте режим предприятия и создайте новый документ добавленного типа. Проверьте, что документ появляется в списке, форма открывается, реквизиты заполняются, а проведение выполняется без ошибок. Убедитесь, что права доступа настроены и нужные пользователи видят документ.
Ограничения, риски и частые ошибки
Не все объекты базовой конфигурации можно свободно расширять. Некоторые типыовые решения накладывают ограничения на изменение документов, их реквизитов или форм. Перед началом работы изучите условия лицензирования и правила поддержки используемой конфигурации.
Рискованно вносить изменения в действующую базу без резервной копии. Перед добавлением документа создайте копию информационной базы или выгрузите конфигурацию. Это позволит откатиться к рабочему состоянию при ошибке в модуле или некорректном обновлении.
Что важно запомнить
Документ добавляется в расширение, настраиваются реквизиты и формы, затем конфигурация обновляется и результат проверяется в режиме предприятия.
Нужно ли права администратора для добавления документа в расширение?
Да, обычно требуются права на изменение конфигурации и создание расширений. Если права ограничены, обратитесь к администратору информационной базы.
Можно ли добавить документ в расширение без остановки работы пользователей?
Разработка и настройка проводятся в режиме конфигуратора, а обновление конфигурации может требовать завершения сеансов пользователей. Планируйте изменения на время с минимальной нагрузкой.
Что делать, если после обновления документ не открывается?
Проверьте ошибки в модуле объекта и формы, наличие прав доступа и корректность обновления конфигурации. При необходимости восстановите базу из резервной копии перед повторными попытками.
Влияет ли добавление документа в расширение на обновление базовой конфигурации?
Изменения в расширении отделены от базовой конфигурации, что упрощает обновление. Однако возможны конфликты, если базовая конфигурация изменит объекты, затрагиваемые расширением.