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

Другое · 6 мин

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

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

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

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

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

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

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

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

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

Среда разработки и выбор типа обработки

Обычные и управляемые формы

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

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

Создание обработки пошагово

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

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

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

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

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

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

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

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

Окно формы появляется, команда срабатывает

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

Ошибка компиляции, отсутствие прав или пустой результат

Данные после выполнения соответствуют ожиданиям
Норма

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

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

Неизменённые записи, дубли, неверные суммы

Логи и сообщения не содержат критических предупреждений
Норма

Информационные сообщения или отсутствие сообщений

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

Сообщения об ошибках доступа, блокировках или превышении лимитов

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

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

Права доступа, публикация и безопасность

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

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

Типичные ошибки и как их исправлять

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

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

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

Итог

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

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

Часто задаваемые вопросы

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

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

Чем отличается внешняя обработка от встроенной?

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

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

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

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

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

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

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