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

В этой статье мы разберём все актуальные способы программного запуска обработок — от базового вызова через ОткрытьФорму() до продвинутых техник с использованием внешних обработок, фоновых задач и планировщика. Особое внимание уделим типичным ошибкам, которые возникают при работе с 1С 8.3 и 1С 8.2, а также нюансам передачи параметров и управления правами доступа. Если вы только начинаете осваивать программирование в 1С или хотите систематизировать свои знания — этот материал поможет закрыть пробелы и избежать распространённых подводных камней.

1. Базовые методы запуска обработок в 1С

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

Основной инструмент — метод глобального контекста ОткрытьФорму(). Он позволяет открыть форму обработки в интерактивном режиме (с отображением пользователю) или фоновом (без интерфейса). Синтаксис минимальной команды:

ОткрытьФорму("Обработка.ИмяОбработки");

Где ИмяОбработки — это символьный идентификатор обработки в дереве метаданных. Например, для стандартной обработки "Печать документов" в типовой конфигурации Управление торговлей 11 код будет таким:

ОткрытьФорму("Обработка.ПечатьДокументов");
  • 📌 Интерактивный режим — обработка открывается в отдельном окне, пользователь может взаимодействовать с её элементами. Подходит для диалоговых обработок (например, загрузки данных из Excel).
  • 🔄 Фоновый режим — обработка выполняется без показа формы. Используется для автоматизированных задач (например, ночного обмена данными). Для этого добавляется параметр РежимОткрытияОкна.Блокировать.
  • ⚙️ С параметрами — можно передавать значения в обработку через второй параметр метода. Пример: ОткрытьФорму("Обработка.ЗагрузкаДанных", , , , , , Новый Структура("Файл,Параметр1", "C:\data.xlsx", 100));

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

📊 Какой режим запуска обработок вы используете чаще?
Интерактивный (с формой)
Фоновый (без формы)
Оба варианта
Не знаю, что это

2. Запуск внешних обработок (.epf.erf)

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

Для работы с внешними обработками используется объект ВнешняяОбработка. Пример кода для загрузки и запуска:

ПутьКФайлу = "C:\Обработки\МояОбработка.epf";

ВнешняяОбработка = ВнешниеОбработки.Создать(ПутьКФайлу);


ВнешняяОбработка.Открыть();

Если обработка требует параметров, их можно передать через метод УстановитьПараметр() или непосредственно при открытии формы:

ВнешняяОбработка.УстановитьПараметр("ДатаНачала", ТекущаяДата());

ВнешняяОбработка.ОткрытьФормуМодально();

Ключевые нюансы работы с внешними обработками:

  • 📁 Путь к файлу должен быть доступен с сервера 1С (если используется файловый вариант) или с рабочей станции (для клиент-серверного варианта). Для сетевых путей используйте UNC-формат: \\Server\Share\Обработка.epf.
  • 🔒 Права доступа — пользователь, от имени которого выполняется код, должен иметь права на чтение файла и запуск внешних обработок (настраивается в ролях).
  • 🔄 Кэширование — 1С кэширует внешние обработки. Если вы изменили файл, но изменения не применяются, используйте ВнешниеОбработки.ОчиститьКэш().

Проверьте наличие файла по указанному пути|

Убедитесь, что у пользователя есть права на запуск внешних обработок|

Очистите кэш, если обработка обновлялась (ВнешниеОбработки.ОчиститьКэш())|

Передайте все необходимые параметры до открытия формы

-->

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

ВнешняяОбработка.Выполнить("ОсновнаяПроцедура", Параметр1, Параметр2);
💡

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

3. Передача параметров в обработку

Одной из самых распространённых задач при программном запуске обработок является передача параметров. Это позволяет динамически настраивать поведение обработки без изменения её кода. В 1С:Предприятие есть несколько способов передачи данных:

1. Через структуру параметров в методе ОткрытьФорму():

Параметры = Новый Структура;

Параметры.Вставить("ДатаНачала", НачалоДня(ТекущаяДата()));


Параметры.Вставить("СписокДокументов", МассивДокументов);


ОткрытьФорму("Обработка.МояОбработка", , , , , , Параметры);

2. Через свойства формы после открытия:

Форма = ОткрытьФорму("Обработка.МояОбработка");

Форма.Параметры.ДатаНачала = ТекущаяДата();


Форма.ОбновлениеОтображения();

3. Для внешних обработок — через метод УстановитьПараметр():

ВнешняяОбработка.УстановитьПараметр("ИмяПараметра", Значение);

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

Пример корректного получения параметров в модуле формы обработки:

Процедура ПриСозданииНаСервере(Отказ, СтандартнаяОбработка)

Если ЗначениеЗаполнено(Параметры.ДатаНачала) Тогда


ДатаНачалаКонтрола = Параметры.ДатаНачала;


КонецЕсли;


КонецПроцедуры

Способ передачи Когда использовать Ограничения
Структура в ОткрытьФорму() Для встроенных обработок, когда параметры известны заранее Не работает для динамического изменения параметров после открытия
Свойства формы Для динамического изменения параметров после открытия формы Требует явного вызова ОбновлениеОтображения()
УстановитьПараметр() для внешних обработок Для внешних файлов (.epf.erf) Параметры должны быть объявлены в модуле обработки
Что делать, если параметры не передаются?

1. Проверьте, что имя параметра в коде запуска и в обработке совпадают (регистр важен!).

2. Убедитесь, что параметр передаётся до вызова метода Открыть() или ОткрытьФормуМодально().

3. Для внешних обработок проверьте, что параметр объявлен в модуле с атрибутом &НаСервере или &НаКлиенте в зависимости от контекста.

4. Если используете фоновый режим, параметры могут быть недоступны — в этом случае передавайте их через глобальные переменные или временные хранилища.

4. Запуск обработок в фоновом режиме

Фоновый запуск обработок используется для выполнения длительных операций без блокировки интерфейса пользователя. Это актуально для задач типа:

  • 📊 Обмен данными с внешними системами (1С:EDT, веб-сервисы, FTP).
  • 📈 Массовая обработка документов (перепроведение, перерасчёт).
  • 🗃️ Архивация или очистка данных.

Основные методы фонового запуска:

1. Использование режима Блокировать в ОткрытьФорму():

ОткрытьФорму("Обработка.МояОбработка", , , , , РежимОткрытияОкна.Блокировать);

2. Вызов экспортной процедуры через Выполнить():

Обработка = Обработки.МояОбработка.Создать();

Обработка.Выполнить("ОсновнаяПроцедура", Параметр1, Параметр2);

3. Фоновые задания (для 1С 8.3.6+):

ФоновоеЗадание = ФоновыеЗадания.СоздатьВыполнение(

"Обработка.МояОбработка.ОсновнаяПроцедура",


Новый Структура("Параметр1,Параметр2", Значение1, Значение2)


);


ФоновоеЗадание.Выполнить();

Фоновые задания имеют ряд преимуществ:

  • ⏳ Отслеживание статуса — можно проверять, завершено ли задание, через ФоновоеЗадание.Статус.
  • 📋 Логирование — ошибки и результаты выполнения сохраняются в журнале фоновых заданий.
  • 🔄 Повторный запуск — поддерживается механизм повторных попыток при сбоях.
💡

Фоновые задания — самый надёжный способ для длительных операций, так как они не прерываются при закрытии сеанса пользователя и поддерживают откат транзакций при ошибках.

Для отладки фоновых обработок используйте журнал регистрации (Администрирование → Журнал регистрации) или настройте вывод лога в файл:

ЗаписьЖурналаРегистрации("ФоноваяОбработка", УровеньЖурналаРегистрации.Информация,, "Начало выполнения");

5. Запуск обработок по расписанию (планировщик)

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

Настройка планировщика выполняется в два этапа:

1. Создание регламентного задания в конфигураторе:

  1. Откройте конфигуратор и перейдите в Общие → Регламентные задания.
  2. Создайте новое задание, укажите имя (например, "ЕжедневныйОбменДанными").
  3. В свойстве "Процедура" укажите путь к экспортной процедуре обработки: Обработка.ИмяОбработки.ИмяПроцедуры.
  4. Настройте расписание (ежедневно, еженедельно, в определённое время).

2. Программный запуск регламентного задания:

РегламентноеЗадание = РегламентныеЗадания.ЕжедневныйОбменДанными;

РегламентноеЗадание.Выполнить();

Для динамического управления расписанием (например, изменение времени выполнения) используйте свойства объекта РегламентноеЗадание:

РегламентноеЗадание.Расписание.УстановитьВремяВыполнения(Час(2), Минута(30)); // Запуск в 02:30

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

💡

Чтобы протестировать регламентное задание без ожидания запланированного времени, используйте метод Выполнить() в отладчике или создайте временное задание с интервалом в 1 минуту.

Для мониторинга выполнения регламентных заданий используйте журнал регистрации или специализированный отчёт (Администрирование → Регламентные и фоновые задания).

6. Типичные ошибки и их решение

При программном запуске обработок разработчики часто сталкиваются с типичными проблемами. Рассмотрим самые распространённые из них и способы их устранения.

1. Ошибка "Обработка не найдена"

⚠️ Внимание: Если вы получаете сообщение "Обработка не найдена", проверьте:
  • 🔍 Правильность имени обработки (регистр имеет значение!). Используйте Метаданные.Обработки.НайтиПоИмени("Имя") для проверки.
  • 📁 Для внешних обработок — корректность пути к файлу. В клиент-серверном варианте путь должен быть доступен на сервере.
  • 🔒 Права пользователя на запуск обработок (проверьте роли в конфигураторе).

2. Параметры не передаются в обработку

  • 📌 Убедитесь, что параметры передаются в правильном формате (например, Структура, а не Массив).
  • 🔄 Проверьте, что в модуле обработки параметры извлекаются из Форма.Параметры, а не из глобальных переменных.
  • 📋 Для внешних обработок используйте УстановитьПараметр() до вызова Открыть().

3. Ошибки при фоновом выполнении

  • ⏳ Убедитесь, что в обработке нет интерактивных методов (например, ПоказатьВопрос() или Предупреждение()).
  • 🔒 Проверьте права на выполнение фоновых задач (настраивается в ролях).
  • 📊 Используйте ЖурналРегистрации для отладки — фоновые задачи не показывают окна с ошибками.

4. Зависание при открытии формы

  • 🔄 Проверьте, нет ли в обработке бесконечных циклов или длительных операций в событии ПриОткрытии.
  • 📋 Отключите временно все обработчики событий формы для выявления проблемы.
  • 🛠️ Используйте Прервать в начале процедуры для пошаговой отладки.

Если ошибка сохраняется, проверьте журнал регистрации (Администрирование → Журнал регистрации) — там часто содержатся подробности, которых нет в сообщении об ошибке.

7. Продвинутые техники: динамический запуск и интеграция

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

1. Динамический вызов обработки по имени:

ИмяОбработки = "Обработка." + ПолучитьИмяОбработкиИзБазы(); // Например, "Обработка.ОбменССайтом"

Если Метаданные.Обработки.НайтиПоИмени(Сред(ИмяОбработки, 10)) <> Неопределено Тогда


ОткрытьФорму(ИмяОбработки);


Иначе


Сообщить("Обработка не найдена!");


КонецЕсли;

2. Запуск обработки из другой базы:

Для интеграции между базами 1С можно использовать COM-соединение или HTTP-сервисы. Пример через COM:

Подключение = Новый COMОбъект("V83.ComConnector");

Соединение = Подключение.Connect("File=""C:\Bases\Trade"";Usr=""Администратор"";");


Обработка = Соединение.Обработки.МояОбработка;


Обработка.Выполнить();

3. Запуск обработки с передачей сложных объектов:

Иногда требуется передать в обработку не примитивные значения (числа, строки), а сложные объекты — например, ДокументОбъект или ТаблицаЗначений. Для этого используйте сериализацию в JSON или XML:

Таблица = Новый ТаблицаЗначений;

Таблица.Колонки.Добавить("Наименование");


Таблица.Добавить();


Таблица[0].Наименование = "Тест";



Параметры = Новый Структура;


Параметры.Вставить("Данные", ЗаписатьJSON(Таблица));



ОткрытьФорму("Обработка.МояОбработка", , , , , , Параметры);

В обработке данные десериализуются:

Таблица = ПрочитатьJSON(Параметры.Данные);

4. Использование временных хранилищ:

Если обработка запускается в другом сеансе (например, через планировщик), для передачи данных удобно использовать ВременныеХранилища:

// В основном коде:

Хранилище = Новый ВременноеХранилищеДанных;


Адрес = Хранилище.Поместить(ТаблицаДанных);



// В обработке:


Таблица = ВременныеХранилищаДанных.Получить(Адрес);

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

FAQ: Частые вопросы по запуску обработок в 1С

Как запустить обработку из модуля объекта (например, документа)?

Используйте тот же метод ОткрытьФорму(), но убедитесь, что у вас есть права на запуск обработок из текущего контекста. Пример:

Процедура Печать(Кнопка)

ОткрытьФорму("Обработка.ПечатьДокументов", , , , , , Новый Структура("Документ", Ссылка));


КонецПроцедуры

Если обработка требует данных документа, передавайте их через параметры.

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

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

Обработка = Обработки.МояОбработка.Создать();

Обработка.Выполнить("ОсновнаяПроцедура");

Убедитесь, что процедура, которую вы вызываете, объявлена как экспортная (Процедура ОсновнаяПроцедура(Параметр) Экспорт).

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

Чаще всего это связано с:

  • Отсутствием прав у пользователя на выполнение операций в обработке.
  • Ошибками в коде обработки (проверьте журнал регистрации).
  • Непереданными параметрами (если обработка ожидает входные данные).
  • Блокировками данных (например, документ, с которым работает обработка, заблокирован другим пользователем).

Включите отладку и проверьте, доходит ли выполнение до нужной процедуры.

Как отладить обработку, запускаемую программно?

Есть несколько способов:

  1. Добавьте в начало процедуры обработки строку Прервать; — это позволит подключиться отладчиком при запуске.
  2. Используйте ЗаписьЖурналаРегистрации() для логирования ключевых шагов.
  3. Для фоновых задач настройте вывод лога в файл:
Текст = Новый ЗаписьТекста;

Текст.Открыть("C:\Logs\МояОбработка.log");


Текст.ЗаписатьСтроку("Начало выполнения: " + ТекущаяДата());


//.. ваш код..


Текст.Закрыть();

Как запустить обработку из веб-клиента или мобильного приложения?

В веб-клиенте и мобильном приложении 1С:Предприятие поддерживает те же методы запуска обработок, но с ограничениями:

  • Фоновые задания работают только в толстом клиенте или на сервере.
  • Для веб-клиента используйте ОткрытьФорму() с указанием параметра РежимОткрытияОкна.Авто.
  • В мобильном приложении избегайте длительных операций — они могут привести к тайм-ауту.

Пример для веб-клиента:

ОткрытьФорму("Обработка.МояОбработка", , , , , РежимОткрытияОкна.Авто);