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

Другое · 7 мин

Как создать свою обработку 1С

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

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

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

Что нужно решить перед созданием

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

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

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

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

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

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

Модуль объекта: команды и логика

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

Разные сценарии запуска

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

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

Проверка и запуск в 1С:Предприятие

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

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

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

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

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

Результат сохранен, данные корректны

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

Ошибка выполнения, частичные изменения или сообщение о правах

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

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

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

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

Безопасность и обновления

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

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

Итог

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

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

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

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

Может ли одна обработка работать в тонком и веб-клиенте?

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

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

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

Безопасно ли тестировать обработку в рабочей базе?

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

Нужно ли документировать собственную обработку?

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