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

Другое · 6 мин

Добавление дополнительной обработки в 1С: пошаговая инструкция

Как добавить дополнительную обработку в 1С: порядок вставки модуля, настройка команд, проверка результата и типичные ошибки самостоятельной настройки.

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

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

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

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

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

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

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

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

Порядок действий
  1. 1
    Создайте объект «Обработка» в конфигураторе
  2. 2
    Настройте форму и модуль объекта
  3. 3
    Добавьте команду интерфейса для вызова
  4. 4
    Проверьте права доступа и результат работы

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

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

Подключение внешней обработки

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

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

Настройка команды и вызова из интерфейса

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

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

Проверка результата и права доступа

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

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

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

Открытие формы обработки
Норма

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

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

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

Выполнение основного действия
Норма

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

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

Изменены посторонние документы или остатки

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

Ограничения и риски самостоятельной доработки

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

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

Типичные ошибки
01
Отсутствие проверки обязательных полей перед запуском алгоритма
02
Размещение кода в типовых модулях без понимания последствий

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

Документируйте изменения: опишите назначение обработки, список изменённых объектов и порядок тестирования. Без описания поддержка кода через несколько месяцев становится существенно сложнее.

Итог

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

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

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

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

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

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

Что произойдёт с обработкой при обновлении 1С?

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

Можно ли использовать обработку в веб-клиенте?

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