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