Как установить внешнюю компоненту из макета внешней обработки

← На главную

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

Проблема прямого обращения к макету

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

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

Способ 1. Использование временного файла (универсальный метод)

Проанализируем наиболее надежный алгоритм: извлечение компоненты из макета во временный файл и последующая установка из этого файла. Этот метод работает вне зависимости от того, как запущена обработка — просто открыта через "Файл - Открыть" или добавлена в справочник "Дополнительные отчеты и обработки".

Рассмотрим пошагово реализацию этого процесса:

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

Посмотрим на пример кода, реализующий эту логику:


// Получаем объект обработки
ИмяФайлаКомпоненты = ПолучитьИмяВременногоФайла("zip"); // Обычно компоненты хранятся в архиве
ДвоичныеДанныеКомпоненты = ЭтотОбъект.ПолучитьМакет("ИмяМакетаСКомпонентой");

// Записываем данные во временный файл
ДвоичныеДанныеКомпоненты.Записать(ИмяФайлаКомпоненты);

// Устанавливаем компоненту из файла
РезультатУстановки = УстановитьВнешнююКомпоненту(ИмяФайлаКомпоненты);

Если РезультатУстановки Тогда
    // Подключаем установленную компоненту
    // При установке из файла 1С копирует ее в локальное хранилище, 
    // поэтому далее можно подключать по идентификатору
    ПодключитьВнешнююКомпоненту("AddIn.ИмяКомпонентыИзМанифеста", "МояКомпонента", ТипВнешнейКомпоненты.Native);
КонецЕсли;

// Удаляем временный файл после установки
УдалитьФайлы(ИмяФайлаКомпоненты);

Способ 2. Работа через справочник Дополнительные отчеты и обработки

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

Проанализируем ситуацию: в справочнике сама обработка хранится как ДвоичныеДанные. Чтобы добраться до её макета, нам нужно сначала "создать" объект обработки в памяти. Выясним, как это сделать программно:


// СсылкаНаОбъект - это ссылка на элемент справочника ДополнительныеОтчетыИОбработки
ИмяФайла = ПолучитьИмяВременногоФайла("epf");
ДвоичныеДанныеОбработки = СсылкаНаОбъект.ХранилищеВнешнейОбработки.Получить();
ДвоичныеДанныеОбработки.Записать(ИмяФайла);

// Создаем объект внешней обработки программно
ВнешняяОбработкаОбъект = ВнешниеОбработки.Создать(ИмяФайла, Ложь);

// Теперь мы можем получить макет так же, как в обычном объекте
МакетКомпоненты = ВнешняяОбработкаОбъект.ПолучитьМакет("ИмяМакета");
// Далее следуем алгоритму из Способа 1

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

Современный подход: Асинхронные вызовы

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

Вместо УстановитьВнешнююКомпоненту() следует использовать НачатьУстановкуВнешнейКомпоненты(). Это требует описания процедуры обратного вызова.

Разберем пример асинхронного подключения:


&НаКлиенте
Процедура УстановитьИПодключитьКомпоненту()
    
    Оповещение = Новый ОписаниеОповещения("ПослеУстановкиКомпоненты", ЭтотОбъект);
    
    // Путь к макету, если обработка встроена, или путь к временному файлу
    ПутьККомпоненте = "ВнешняяОбработка.Работа.Макет.SkypeExtension"; 
    
    НачатьУстановкуВнешнейКомпоненты(Оповещение, ПутьККомпоненте);
    
КонецПроцедуры

&НаКлиенте
Процедура ПослеУстановкиКомпоненты(Результат, ДополнительныеПараметры) Экспорт
    
    Если Результат Тогда
        // Если установка прошла успешно, пробуем подключить
        ОповещениеПодключения = Новый ОписаниеОповещения("ПослеПодключенияКомпоненты", ЭтотОбъект);
        НачатьПодключениеВнешнейКомпоненты(ОповещениеПодключения, "AddIn.SkypeExtension", "SkypeLib", ТипВнешнейКомпоненты.Native);
    Иначе
        Сообщить("Не удалось установить компоненту!");
    КонецЕсли;
    
КонецПроцедуры

Проверка перед установкой

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

Попытаться выполнить ПодключитьВнешнююКомпоненту() по идентификатору (например, AddIn.MyComponent).
Если возвращено Ложь, значит компонента не установлена в системе.
Выполнить процедуру извлечения из макета и УстановитьВнешнююКомпоненту().
Повторить подключение.

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

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