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

Другое · 9 мин

Как написать обработку в 1С и запустить её в базе

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

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

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

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

Что такое обработка в 1С и когда она нужна

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

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

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

Как создать обработку в конфигураторе

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

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

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

Форма, команды и модуль обработки

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

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

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

Обработка нужнаРазовая или периодическая операция без постоянного журнала

Проверьте, нельзя ли решить задачу стандартным отчётом или документом

Обработка избыточнаНужны проводки, движения по складу или постоянное хранение

Рассмотрите документ, регистр или справочник вместо обработки

Готова к запускуЕсть форма, модуль, права и сохранённая конфигурация

Запустите на копии базы и проверьте результат

Запуск и вызов из других объектов

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

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

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

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

Проверка, права и перенос между базами

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

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

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

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

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

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

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

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

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

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

Итог

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

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

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

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

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

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

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

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

Безопасно ли изменять стандартную обработку?

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

Нужно ли выгружать обработку в файл?

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