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

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

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

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

Подготовка окружения и создание расширения

Прежде чем добавлять новые объекты, необходимо убедиться, что у вас открыта база данных в режиме Конфигуратор. Если расширение еще не создано, его нужно инициировать. Для этого в дереве метаданных выберите ветку"Расширения", нажмите правую кнопку мыши и выберите пункт"Добавить". Система предложит выбрать имя расширения и конфигурацию-источник.

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

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

💡

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

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

Алгоритм добавления внешней обработки

Самый распространенный способ — это добавление уже существующего файла внешней обработки .epf или создание новой с нуля внутри расширения. В дереве метаданных найдите ветку вашего расширения, затем раздел"Внешние обработки". Нажмите правой кнопкой мыши и выберите"Добавить". Откроется окно выбора файла или создания нового объекта.

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

В свойствах новой обработки обратите внимание на поле"Синоним". Именно это название будет видеть пользователь в интерфейсе. Также важно настроить видимость обработки. Если она предназначена только для администраторов, нужно ограничить через права доступа, а не скрывать программно.

☑️ Контрольный список добавления обработки

Создать ветку расширения в конфигуратореВыбрать раздел"Внешние обработки"Добавить новый объект или импортировать.epfЗадать понятный Синоним и ИмяНастроить права доступаСохранить конфигурацию и обновить базу

Выполнено: 0 / 6

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

Настройка свойств и параметров обработки

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

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

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

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

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

Что такое привилегированный режим?

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

Интеграция обработки в интерфейс пользователя

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

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

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

📂 Разместите команду в общем разделе навигации для глобального доступа.
📄 Добавьте кнопку в форму документа для контекстного вызова.
⚙️ Используйте командный интерфейс для вызова через меню"Все функции".

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

💡

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

Программный вызов и работа с кодом

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

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

ИмяОбработки ="МояВнешняяОбработка";
Обработка = Обработки[ИмяОбработки].Создать;
Обработка.Открыть;

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

⚠️ Внимание: При программном вызове убедитесь, что имя обработки в коде точно совпадает с именем объекта в метаданных. Регистр символов имеет значение. Ошибка в названии приведет к исключению"Объект не найден".

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

Особенности публикации и обновления

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

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

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

⚠️ Внимание: Интерфейс и возможности работы с расширениями могут изменяться в новых релизах платформы 1С. Всегда сверяйтесь с официальным руководством разработчика для вашей версии платформы перед внедрением сложных архитектурных решений.

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

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

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

Почему обработка не видна в режиме предприятия после добавления?

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

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

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

Влияет ли расширение на скорость работы базы 1С?

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

Как добавить обработку в расширение 1С