Как выполнить макрос в 1С: способы запуска кода и обработок

Пользователи, переходящие с Excel, часто ищут в 1С кнопку «выполнить макрос» — и не находят её. Причина проста: архитектура 1С устроена иначе. Вместо макросов на VBA здесь применяются внешние обработки и отчёты (файлы с расширением .epf и .erf), встроенный язык 1С, выполняемый через консоль кода, а также регламентные и фоновые задания для автоматического запуска.

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

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

Что в 1С заменяет макросы

Термин «макрос» в контексте 1С обычно означает одно из трёх. Первое — внешняя обработка, файл с готовым алгоритмом, который открывается как обычный документ. Второе — фрагмент кода на встроенном языке, выполняемый вручную через консоль. Третье — подключённый механизм автозапуска, когда код срабатывает по расписанию или по событию.

В отличие от макросов Excel, код 1С выполняется в контексте прав конкретного пользователя. Если у учётной записи нет прав на изменение справочника, обработка не сможет его изменить — платформа заблокирует действие. Это встроенная защита, но она не спасает от ошибок в логике самого кода: обработка, запущенная под полными правами, способна испортить любые данные, до которых дотянется.

Запуск внешней обработки через меню «Файл»

Самый простой способ выполнить «макрос» в 1С — открыть готовую обработку. Порядок действий одинаков для большинства конфигураций на управляемых формах (Управление торговлей, Бухгалтерия предприятия, ЗУП и другие).

1. 1
   Сделайте резервную копию базы или выгрузку .dt, если обработка меняет данные
2. 2
   Откройте меню: кнопка с тремя полосками слева вверху → Файл → Открыть
3. 3
   Укажите файл обработки с расширением .epf
4. 4
   Подтвердите открытие, если платформа покажет предупреждение безопасности
5. 5
   Заполните параметры в форме обработки и нажмите её кнопку выполнения
6. 6
   Проверьте результат на нескольких объектах до массового применения

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

После выполнения обязательно проверьте результат выборочно: откройте несколько изменённых документов или элементов справочника и убедитесь, что данные корректны. Массовые операции откатить сложно — единственный надёжный «откат» это восстановление из резервной копии.

Подключение обработки через «Дополнительные отчеты и обработки»

Если обработку нужно запускать регулярно и разным пользователям, открывать её каждый раз через «Файл → Открыть» неудобно. В типовых конфигурациях на Библиотеке стандартных подсистем есть механизм дополнительных отчётов и обработок: файл регистрируется внутри базы и вызывается из штатного интерфейса.

Для подключения перейдите в раздел «Администрирование» → «Печатные формы, отчёты и обработки» и включите флажок «Дополнительные отчёты и обработки». Затем откройте одноимённый список, создайте новый элемент и укажите файл .epf. После записи обработка появится в разделах, которые вы назначили, — например, в «Закупках» или «Сервисе».

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

Выполнение произвольного кода через консоль

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

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

Запрос = Новый Запрос("ВЫБРАТЬ Ссылка ИЗ Справочник.Номенклатура ГДЕ ПометкаУдаления");
Выборка = Запрос.Выполнить().Выбрать();
Пока Выборка.Следующий() Цикл
    Сообщить(Выборка.Ссылка);
КонецЦикла;

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

Автоматический запуск: регламентные и фоновые задания

Если задача должна выполняться регулярно без участия человека — например, ежедневная выгрузка остатков или синхронизация с сайтом — используются регламентные задания. Они настраиваются в конфигураторе: разработчик создаёт объект метаданных «Регламентное задание», привязывает к нему процедуру из общего модуля и задаёт расписание.

В клиент-серверном режиме задания выполняет сервер 1С, в файловом — фоновый процесс, который запускается при работе пользователей или отдельным сеансом. Посмотреть текущие задания и ошибки их выполнения можно в разделе «Администрирование» → «Обслуживание» → «Регламентные и фоновые задания» (в типовых конфигурациях) или через консоль заданий в конфигураторе.

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

Типовые инструменты, которые закрывают задачи «макросов»

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

Обработка «Групповое изменение реквизитов» в типовых конфигурациях находится в разделе «Администрирование» → «Обслуживание» → «Корректировка данных». Она позволяет отобрать объекты по условиям и массово установить значения реквизитов — это закрывает большинство бытовых сценариев, ради которых обычно ищут макрос.

Безопасность и права доступа

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

Механизм защиты от опасных действий в платформе по умолчанию предупреждает при открытии внешних файлов. Не отключайте эту защиту глобально ради удобства. Если предупреждение мешает при регулярной работе с доверенной обработкой, правильное решение — подключить её через «Дополнительные отчёты и обработки», а не снимать защиту на уровне всей базы.

Частые вопросы