Как правильно указать код выполняемой функции в 1С: инструкция с примерами

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

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

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

Что такое код выполняемой функции в 1С и зачем он нужен

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

• 🔹 Управления доступом: ограничения прав пользователей на выполнение конкретных действий (например, только менеджеры могут запускать функцию СоздатьЗаказПокупателя).
• 🔹 Интеграции: вызова функций из внешних систем через HTTP-сервисы или COM-соединение.
• 🔹 Логирования: отслеживания, какие операции выполнялись в системе (полезно для аудита).
• 🔹 Автоматизации: связывания действий в бизнес-процессах (например, после сохранения документа автоматически запускается функция расчёта скидок).

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

В типовой конфигурации 1С:ERP или 1С:УТ 11 коды функций часто формируются по шаблону: Префикс_Объект_Действие. Например, Док_ЗаказПокупателя_Печать или Спр_Номенклатура_ИмпортИзExcel. Это упрощает поддержку кода и снижает риск конфликтов при обновлениях.

Где в 1С указывается код выполняемой функции

Расположение поля для кода функции зависит от типа объекта, к которому относится команда или процедура. Рассмотрим основные сценарии:

1. Команды в управляемых формах

В управляемых формах (используются в 1С 8.3 и новее) код функции указывается в свойствах команды:

1. Откройте конфигуратор и найдите нужную форму (например, форму документа ЗаказПокупателя).
2. Перейдите на вкладку Команды.
3. Выделите нужную команду (например, ПровестиИЗакрыть) и в панели свойств найдите поле Имя — это и есть код функции.

2. Процедуры и функции в модулях

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

Процедура ПечатьЧека(Параметры) Экспорт
// Код функции здесь не указывается явно,
// но она может вызываться по имени извне
КонецПроцедуры

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

3. Обработчики событий

Для обработчиков событий (например, ПриЗаписи или ПередУдалением) код функции формируется автоматически на основе имени события. Однако в некоторых случаях (например, при работе с БСП — Библиотекой Стандартных Подсистем) может потребоваться явное указание кода в свойствах объекта.

Как найти все используемые коды функций в конфигурации?

Используйте глобальный поиск по конфигуратору (Ctrl+Shift+F) с фильтром по ключевому слову"Экспорт". Это поможет найти все процедуры и функции, доступные для внешнего вызова.

Стандартные префиксы и правила именования

Чтобы избежать конфликтов и упростить поддержку кода, в 1С принято следовать определённым правилам именования функций. Вот основные рекомендации:

Тип объекта	Префикс	Пример кода функции
Документ	Док_	Док_ЗаказПокупателя_Провести
Справочник	Спр_	Спр_Номенклатура_ОбновитьЦены
Отчёт	Отч_	Отч_ОстаткиТоваров_Сформировать
Обработка	Обр_	Обр_ЗагрузкаДанных_ИмпортИзExcel
Общий модуль	Общ_	Общ_РаботаСФайлами_СохранитьВPDF

Соблюдение этих правил особенно важно в распределённых информационных базах или при работе с обменами данными, где конфликты имён могут привести к ошибкам синхронизации.

В типовой конфигурации"1С:Зарплата и Управление Персоналом 3.1" коды функций для обработки кадровых документов часто начинаются с префикса Кадр_, например, Кадр_ПриказОПриеме_ПечатьТК2. Это помогает быстро идентифицировать назначение функции.

Как указать код функции в коде 1С (примеры)

Рассмотрим практические примеры задания кодов функций в разных сценариях.

1. Создание команды в управляемой форме

Допустим, вам нужно добавить команду"Экспорт в Excel" для справочника Номенклатура. Вот как это сделать:

1. Откройте форму справочника Номенклатура в конфигураторе.
2. На вкладке Команды добавьте новую команду.
3. В свойствах команды укажите:
   • Имя: Спр_Номенклатура_ЭкспортВExcel
   • Заголовок: Экспорт в Excel
   • Действие: ЭкспортВExcelНаСервере (имя процедуры в модуле формы)

2. Экспортная функция в модуле объекта

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

// Модуль документа"ЗаказПокупателя"
Процедура РассчитатьСуммуСоСкидкой(ДокументОбъект) Экспорт
СуммаСоСкидкой = ДокументОбъект.СуммаДокумента * (1 - ДокументОбъект.ПроцентСкидки/100);
Возврат СуммаСоСкидкой;
КонецПроцедуры

Теперь эту функцию можно вызвать из другого модуля:

Сумма = Документы.ЗаказПокупателя.РассчитатьСуммуСоСкидкой(ТекущийДокумент);

3. Обработчик события с явным указанием кода

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

Процедура ПередЗаписью(Отказ, РежимЗаписи) Экспорт
Если НЕ ЗначениеЗаполнено(Объект.ИНН) Тогда
Сообщить("ИНН должен быть заполнен!");
Отказ = Истина;
КонецЕсли;
КонецПроцедуры

В свойствах справочника в поле ОбработчикиСобытий.ПередЗаписью укажите имя процедуры: Спр_Контрагенты_ПроверкаИНН.

Явно указан префикс (Док_, Спр_ и т.д.)|Код уникален в рамках конфигурации|Функция объявлена с ключевым словом"Экспорт" (если нужно)|Код документирован в реестре функций-->

Типичные ошибки и как их избежать

Даже опытные разработчики иногда допускают ошибки при работе с кодами функций. Вот самые распространённые из них и способы их решения:

• 🚨 Дублирование кодов: Если два объекта имеют одинаковый код функции, это приведёт к конфликту при вызове. Всегда проверяйте уникальность кода через глобальный поиск (Ctrl+Shift+F).
• 🚨 Несоблюдение регистра: Коды Док_Заказ_Провести и док_заказ_провести в 1С считаются разными! Придерживайтесь одного стиля (обычно PascalCase или snake_case).
• 🚨 Отсутствие префикса: Без префикса сложно определить, к какому объекту относится функция. Это усложняет поддержку кода.
• 🚨 Использование кириллицы в кодах: Хотя 1С поддерживает кириллицу в именах, для кодов функций лучше использовать латиницу. Это упрощает интеграцию с внешними системами.

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

1. Создайте новую функцию с новым кодом.
2. Перенаправьте вызов старой функции на новую (с логгированием для отслеживания использования).
3. Удалите старую функцию только после полной миграции всех вызовов.

// Функция расчёта скидки для заказа покупателя. Используется в модулях:

// - Документ.ЗаказПокупателя (ПередЗаписью)

// - Обработка.МассовоеПрайсирование

// Параметры: ДокументОбъект - ссылка на документ ЗаказПокупателя-->

Продвинутые техники: динамическое формирование кодов

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

1. Использование строковых литералов

Если вам нужно вызвать функцию по имени, которое хранится в переменной, используйте конструкцию Выполнить:

ИмяФункции ="Док_ЗаказПокупателя_РассчитатьСумму";
Результат = Выполнить(ИмяФункции +"(ТекущийДокумент)");

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

Если Метаданные.Документы.ЗаказПокупателя.Модуль.НайтиМетод(ИмяФункции) <> Неопределено Тогда
Результат = Выполнить(ИмяФункции +"(ТекущийДокумент)");
Иначе
Сообщить("Функция" + ИмяФункции +" не найдена!");
КонецЕсли;

2. Генерация кодов на основе метаданных

Для автоматизации можно генерировать коды функций на основе имён объектов метаданных. Например:

Функция СгенерироватьКодФункции(ТипОбъекта, ИмяОбъекта, Действие)
Префикс ="";
Если ТипОбъекта = Тип("ДокументОбъект.ЗаказПокупателя") Тогда
Префикс ="Док_";
ИначеЕсли ТипОбъекта = Тип("СправочникОбъект.Номенклатура") Тогда
Префикс ="Спр_";
КонецЕсли;

Возврат Префикс + ИмяОбъекта +"_" + Действие;
КонецФункции

3. Работа с кодами в расширениях конфигурации

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

// В расширении для УТ 11
Процедура МоеРасширение_Док_ЗаказПокупателя_ПечатьДопЧека(ДокументОбъект) Экспорт
// Логика печати дополнительного чека
КонецПроцедуры

Диагностика проблем с кодами функций

Если код функции указан неверно или конфликтует с другими функциями, вы можете столкнуться с следующими ошибками:

• 🛑 Метод объекта не обнаружен (РассчитатьСумму) — функция не объявлена или не экспортирована.
• 🛑 Неоднозначный вызов метода — в конфигурации есть несколько функций с одинаковым именем.
• 🛑 Ошибка при вызове метода контекста (Выполнить) — неправильно сформирован строковый вызов функции.
• 🛑 Нет прав на выполнение операции — код функции не включён в роль пользователя.

Для диагностики используйте следующие инструменты:

Проблема	Инструмент диагностики	Действие
Функция не найдена	Глобальный поиск (Ctrl+Shift+F)	Проверьте, что функция объявлена с ключевым словом Экспорт.
Конфликт имён	Журнал регистрации (Администрирование → Журнал регистрации)	Найдите записи об ошибках вызова методов.
Ошибка прав доступа	Настройка ролей (Администрирование → Пользователи и права)	Проверьте, что код функции включён в роль пользователя.
Неправильный строковый вызов	Отладчик (F5 в конфигураторе)	Пошагово выполните код, чтобы увидеть, где происходит ошибка.

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

Попытка
Результат = Выполнить(ИмяФункции +"(Параметры)");
Исключение
Сообщить("Ошибка при вызове функции:" + ОписаниеОшибки);
КонецПопытки;

-->

FAQ: Частые вопросы по кодам функций в 1С

Можно ли использовать кириллицу в кодах функций?

Технически да, 1С:Предприятие поддерживает кириллицу в именах процедур и функций. Однако это не рекомендуется по нескольким причинам:

• Сложности при интеграции с внешними системами (многие API ожидают латиницу).
• Проблемы с кодировкой при обмене данными (например, в JSON или XML).
• Неудобство при ручном вводе кода (например, при отладке через REST или SOAP).

Если вам необходимо использовать кириллицу (например, для совместимости с унаследованным кодом), транслитерируйте имена: РассчитатьСумму → RasschitatSummu.

Как найти все функции с одинаковым кодом в конфигурации?

Используйте глобальный поиск в конфигураторе (Ctrl+Shift+F) с следующими настройками:

1. В поле"Текст" введите имя функции (например, ПровестиДокумент).
2. Установите флаги"Искать в модулях" и"Искать в метаданных".
3. Нажмите"Найти все".

Система покажет все места, где используется данный код. Обратите внимание на столбец"Контекст" — он поможет определить, к какому объекту относится каждая функция.

Что делать, если после обновления конфигурации перестали работать функции?

Эта проблемана для типовой конфигурации, где функции могли быть переименованы или удалены в новой версии. Алгоритм действий:

1. Сравните текущую и новую версию конфигурации с помощью Конфигуратор → Конфигурация → Сравнить конфигурации.
2. Найдите изменения в модулях, где были объявлены ваши функции.
3. Если функция удалена, восстановите её в расширении конфигурации.
4. Обновите все вызовы функции в коде (используйте глобальный поиск).

Если функция была переименована в типовой конфигурации, адаптируйте свой код под новое имя.

Как ограничить доступ к функции по коду?

Чтобы ограничить выполнение функции для определённых ролей:

1. Откройте Конфигуратор → Общие → Роли.
2. Выберите роль, для которой нужно настроить доступ (например, МенеджерПоПродажам).
3. На вкладке Права найдите объект, к которому относится функция (например, документ ЗаказПокупателя).
4. В дереве прав отметьте галочкой нужную функцию (она будет отображаться по её коду).

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

Можно ли изменить код функции в работающей базе без последствий?

Изменение кода функции в рабочей базе чревато ошибками, если:

• Функция вызывается из других модулей (все вызовы придётся обновить).
• Функция используется в обменах данными или интеграциях.
• Функция привязана к ролям или бизнес-процессам.

Безопасный алгоритм:

1. Создайте новую функцию с новым кодом.
2. Перенаправьте все вызовы старой функции на новую (с логгированием).
3. Протестируйте работу системы.
4. Удалите старую функцию через 1–2 месяца (после подтверждения, что она не используется).