Внешние отчёты и обработки — подключение через БСП, версия, безопасный режим

Директивный

v8std#std669 диагностикаDisableSafeMode диагностикаUsingExternalCodeTools

Правило

Любой внешний файл (обработка, отчёт, печатная форма), который работает в боевой базе:

Подключается через подсистему БСП «Дополнительные отчёты и обработки» — не через «Файл → Открыть» у пользователя и не через ВнешниеОбработки.Создать() с путём к файлу в коде.
Экспортирует СведенияОВнешнейОбработке() в модуле объекта с заполненными полями: вид, наименование, версия, назначение (для печатных форм и заполнения), информация «что делает».
Версия увеличивается при каждом изменении. Иначе на вопрос «какая версия стоит у заказчика?» ответа нет, и одинаковые по имени файлы с разным поведением расползаются по базам.
Безопасный режим включён (БезопасныйРежим = Истина). Отключение — только с письменным обоснованием в карточке обработки: какое именно действие требует привилегий и почему без него нельзя.
Исходник хранится в git (выгрузка в файлы), а не только собранный .epf/.erf в задаче или у разработчика на диске.

Зачем

Внешняя обработка — это произвольный код, который выполняется в боевой базе в обход хранилища и ревью конфигурации (#std669 требует ограничивать выполнение внешнего кода). Подключение через БСП даёт единственную точку контроля: реестр того, что вообще запускается в базе, у кого какие права на запуск, какая версия активна. Обработка, открытая «с диска», не оставляет следов: после инцидента невозможно установить, что именно выполнялось. А выключенный безопасный режим превращает файл из задачи в потенциальный бэкдор с полными правами.

// Регистрации нет: файл шлют друг другу почтой и открывают «Файл → Открыть».
// Версии нет: в трёх филиалах три разных «ЗагрузкаПрайса.epf».
// БезопасныйРежим = Ложь «чтобы точно работало».
Функция СведенияОВнешнейОбработке() Экспорт
    Параметры = Новый Структура;
    Параметры.Вставить("Наименование", "Загрузка прайса");
    Параметры.Вставить("БезопасныйРежим", Ложь);
    Возврат Параметры;
КонецФункции

Функция СведенияОВнешнейОбработке() Экспорт

    Параметры = Новый Структура;
    Параметры.Вставить("Вид", "ДополнительнаяОбработка");
    Параметры.Вставить("Наименование", НСтр("ru='Загрузка прайса поставщика'"));
    Параметры.Вставить("Версия", "1.3");   // увеличена в этой задаче
    Параметры.Вставить("БезопасныйРежим", Истина);
    Параметры.Вставить("Информация", НСтр(
        "ru='Загружает прайс из XLSX в регистр ЦеныНоменклатуры.
           |Изменения: 1.3 — добавлена колонка «Кратность упаковки».'"));

    ТаблицаКоманд = Новый ТаблицаЗначений;
    // ... команды с идентификаторами по шаблону БСП

    Параметры.Вставить("Команды", ТаблицаКоманд);
    Возврат Параметры;

КонецФункции

Когда не применять

Разовый инструмент разработчика/администратора (диагностика, одноразовая выгрузка), который запускается лично автором на копии или под контролем — можно без регистрации в БСП, но безопасный режим и след в ЖР остаются обязательными.
Конфигурации без БСП (самописные, урезанные) — правило про регистрацию заменяется локальным реестром внешних файлов; версия, безопасный режим и git действуют без изменений.

Внешние отчёты и обработки — подключение через БСП, версия, безопасный режим

Правило

Зачем

Когда не применять

См. также