Как добавить функцию в 1С: пошаговое руководство

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

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

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

Выбор места размещения кода и область видимости

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

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

Для функций, которые должны быть доступны из разных мест конфигурации (например, расчет сложных показателей или форматирование строк), используется общий модуль. Здесь важно правильно настроить галочки в свойствах модуля, такие как «Клиент», «Сервер», «Внешнее соединение».

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

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

Синтаксис объявления функции в языке 1С

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

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

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

Функция РассчитатьСкидку(СуммаЗаказа, ТипКлиента) Экспорт
Если ТипКлиента ="Опт" Тогда
Возврат СуммаЗаказа * 0.9;
Иначе
Возврат СуммаЗаказа;
КонецЕсли;
КонецФункции

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

Практическая инструкция: создание функции в общем модуле

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

В дереве конфигурации найдите ветку Общие модули. Если нужного модуля нет, создайте новый, нажав правой кнопкой мыши и выбрав «Добавить». Дайте ему понятное имя, например, МоиОбщиеФункции. Откройте окно редактирования модуля.

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

После написания кода необходимо настроить свойства модуля. В палитре свойств убедитесь, что стоят галочки напротив тех контекстов, где планируется использование функции. Например, если функция вызывает работу с базой данных, галочка «Клиент» должна быть снята, иначе возникнет ошибка компиляции.

Свойство модуля	Описание	Рекомендация
Глобальный	Делает методы доступными как глобальные контексты	Ставить редко, только для очень частых утилит
Клиент	Разрешает вызов с тонкого клиента	Обязательно для функций интерфейса
Сервер	Разрешает выполнение на стороне сервера	Обязательно для работы с данными
Внешнее соединение	Доступ из COM или Web-сервисов	Только при необходимости интеграции

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

Вызов функции и передача параметров

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

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

⚠️ Внимание: Не передавайте в параметры функций большие массивы или выборки данных, если в этом нет острой необходимости. Это может существенно замедлить работу системы из-за копирования данных.

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

Особенности передачи неопределенных параметров

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

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

Результат = МоиОбщиеФункции.СформироватьОтчет(
ПериодНачало = НачалоМесяца(ТекущаяДата),
ПериодКонец = КонецМесяца(ТекущаяДата),
ВыводитьПечатнуюФорму = Истина
);

Обработка ошибок и отладка кода

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

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

• 🛡️ Всегда оборачивайте risky-операции (запись в файл, HTTP-запросы) в блок Попытка.
• 🛡️ В блоке Исключение используйте функцию ОписаниеОшибки для получения текста проблемы.
• 🛡️ Используйте Журнал регистрации для сохранения информации об ошибках на сервере.

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

Частой ошибкой новичков является игнорирование типов данных. Платформа 1С динамически типизирована, но это не значит, что можно складывать строки с числами без явного преобразования. Явное приведение типов повышает надежность кода.

Типичные ошибки при разработке функций

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

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

⚠️ Внимание: Интерфейс и возможности платформы 1С могут меняться с выходом новых релизов. Всегда сверяйтесь с официальным синтаксис-помощником при использовании новых функций или устаревших методов.

Также стоит упомянуть проблему именования. Использование транслита или, хуже того, сокращений вроде Func1, Proc2 делает код нечитаемым для коллег. Имена должны отражать суть действия: РассчитатьЗарплату вместо CalcZP.

Не забывайте про производительность. Циклы внутри циклов при работе с большими выборками данных могут «повесить» базу на несколько минут. Всегда стремитесь минимизировать количество обращений к базе данных внутри циклов.

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

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

В чем разница между Функцией и Процедурой в 1С?

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

Как сделать функцию доступной во всех формах без указания имени модуля?

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

Почему функция не видна в режиме предприятия?

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

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

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