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