Как получить ключ регламентного задания в 1С

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

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

Что такое ключ регламентного задания и зачем он нужен

Регламентное задание в 1С имеет несколько идентифицирующих свойств: имя (задаётся в метаданных), уникальный идентификатор (генерируется платформой для каждого экземпляра) и ключ (произвольная строка, которую назначает разработчик). Имя одинаково у всех экземпляров одного задания, GUID неудобен для чтения, а вот ключ — единственное «человекочитаемое» поле, по которому можно различать экземпляры.

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

Как посмотреть ключ в конфигураторе

Самый простой способ — открыть свойства задания в дереве конфигурации. Для этого в конфигураторе перейдите в ветку «Общие» → «Регламентные задания», выберите нужное задание и откройте палитру свойств (правый клик → «Свойства» или Alt+Enter). Поле «Ключ» находится среди основных свойств рядом с «Наименованием», «Расписанием» и «Использованием».

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

Как получить ключ программно через встроенный язык

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

// Вариант 1: по уникальному идентификатору
Идентификатор = Новый УникальныйИдентификатор("a1b2c3d4-...");
Задание = РегламентныеЗадания.НайтиПоУникальномуИдентификатору(Идентификатор);
Если Задание <> Неопределено Тогда
Сообщить("Ключ задания: " + Задание.Ключ);
КонецЕсли;

// Вариант 2: отбор по имени метаданных
Отбор = Новый Структура("Метаданные", "ОбменДанными");
МассивЗаданий = РегламентныеЗадания.ПолучитьРегламентныеЗадания(Отбор);
Для Каждого Задание Из МассивЗаданий Цикл
Сообщить("GUID: " + Задание.УникальныйИдентификатор
+ ", Ключ: " + Задание.Ключ);
КонецЦикла;

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

Отбор = Новый Структура("Ключ", "Синхронизация_Узел_01");
Найденные = РегламентныеЗадания.ПолучитьРегламентныеЗадания(Отбор);
Если Найденные.Количество() > 0 Тогда
    Задание = Найденные[0];
КонецЕсли;

Как найти задание по известному ключу

Обратная задача встречается чаще: ключ известен (например, он содержит идентификатор узла обмена), а нужно получить само задание, чтобы изменить расписание или запустить его. Для этого используется тот же метод ПолучитьРегламентныеЗадания с отбором по ключу.

Критичный нюанс: платформа не гарантирует уникальность ключа. Если два задания имеют одинаковый ключ, отбор вернёт массив из нескольких элементов, и код, который без проверки берёт Найденные[0], может работать не с тем экземпляром. Всегда проверяйте количество найденных заданий и при необходимости дополняйте отбор именем метаданных.

1. 1
   Сформируйте структуру отбора с полем Ключ и, желательно, полем Метаданные
2. 2
   Вызовите РегламентныеЗадания.ПолучитьРегламентныеЗадания(Отбор)
3. 3
   Проверьте количество найденных элементов: 0 — задания нет, больше 1 — ключ не уникален
4. 4
   Обратитесь к нужному элементу массива и прочитайте или измените его свойства
5. 5
   Вызовите метод Записать() у объекта задания, если меняли свойства

Особенности клиент-серверного режима и прав доступа

Работа с регламентными заданиями требует права «Администрирование» у текущего пользователя. Под обычным пользователем вызов ПолучитьРегламентныеЗадания() вызовет исключение о нарушении прав доступа. Поэтому код чтения ключей размещают в серверных процедурах с установленным привилегированным режимом (УстановитьПривилегированныйРежим(Истина)) либо выполняют от имени администратора.

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

Типичные ошибки при работе с ключом

Чаще всего проблемы возникают не из-за самого чтения ключа, а из-за неверных предположений о его поведении. Разработчик ожидает, что ключ уникален, а платформа этого не контролирует; или код ищет задание по имени, хотя в базе существует несколько экземпляров с разными ключами, и захватывается не тот.

Как проверить результат

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

Итоговая логика проста: ключ — это строковое свойство объекта РегламентноеЗадание, читается через Задание.Ключ после получения объекта по GUID или отбором. Для надёжности всегда комбинируйте отбор по ключу с именем метаданных и контролируйте количество найденных заданий.

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