К статье
Практический материал

Другое · 8 мин

Как запустить функцию в 1С: инструкция для пользователя и разработчика

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

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

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

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

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

Чем функция отличается от процедуры

Процедура выполняет действия, но не возвращает значение, тогда как функция обязательно возвращает результат. Объявление функции начинается со слова Функция, затем указывается имя, список параметров и блок кода. В конце функции ставится оператор Возврат со значением, которое получит вызывающий код.

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

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

Запуск функции из формы или команды

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

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

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

Порядок запуска из формы
  1. 1
    Откройте нужный документ, справочник или отчет в 1С
  2. 2
    Найдите команду или кнопку, связанную с интересующей функцией
  3. 3
    Выполните команду и дождитесь сообщения или изменения формы
  4. 4
    Проверьте заполнение полей и отсутствие ошибок

Вызов серверной функции

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

Обычно с клиента вызывается клиентская процедура, которая внутри вызывает серверную процедуру или функцию. Серверный код выполняет основную работу и возвращает результат клиенту. Это разделение нужно для производительности и безопасности: тяжелые запросы не тормозят интерфейс пользователя.

Когда функция выполняется на сервере

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

Функция из общего модуля

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

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

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

Типичные ошибки
01
Вызов неэкспортируемой функции из другого модуля приводит к ошибке доступа
02
Запуск серверной функции с клиента без обертки вызывает ошибку контекста
03
Забывание оператора Возврат делает результат функции неопределенным

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

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

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

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

Контрольные точки

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

Возвращаемое значение функции
Норма

Значение соответствует ожидаемому типу и не пустое

Тревожный признак

Значение неопределено, пустое или имеет неверный тип

Измененные данные в базе
Норма

Документы и регистры обновлены корректно

Тревожный признак

Данные не изменились или изменились некорректно

Сообщения системы
Норма

Ошибок и предупреждений нет

Тревожный признак

Появилось сообщение об ошибке выполнения

Ограничения и безопасная самостоятельная работа

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

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

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

Другие способы запуска функции

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

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

Итог

Что важно запомнить

Функция возвращает значение через Возврат, должна быть видимой и вызываться в подходящем контексте; перед запуском на рабочей базе проверьте действие на тесте.

Часто задаваемые вопросы

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

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

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

Проверьте, объявлен ли код как функция и есть ли в ней оператор Возврат. Если возврата нет, это процедура, а не функция, и использовать её как источник значения нельзя.

Нужно ли права администратора для запуска любой функции?

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

Безопасно ли запускать незнакомую функцию на основной базе?

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

Как понять, где находится нужная функция?

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