Rivalry2

HTML Diff

0 added 0 removed

Original 2026-01-01

Modified 2026-02-21

1 <a>#статьи</a>

2 <ul><li>17 окт 2025</li>

3 <li>0</li>

4 </ul>Процедурно функционируем в 1С.

5 Иллюстрация: Оля Ежак для Skillbox Media

6 Программист, консультант, специалист по документированию. Легко и доступно рассказывает о сложных вещах в программировании и дизайне.

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

8 Содержание

9 <ul><li><a>Что такое процедуры и функции</a></li>

10 <li><a>Какие параметры есть у процедур и функций</a></li>

11 <li><a>Как работать с параметрами</a></li>

12 <li><a>Как использовать процедуры и функции в конфигурациях "1С: Предприятия"</a></li>

13 </ul>Процедура в 1С - это блок кода, который выполняет действия, но не возвращает результат. Процедуры используют, когда нужно выполнить действие: записать данные в справочник, изменить объект, вывести сообщение пользователю. Они действуют как команда "сделай что-то".

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

15 Например, процедура может оформить документ продажи и внести его в базу, а функция - посчитать итоговую сумму по документу и вернуть её.

16 В языке 1С процедуры и функции пишутся по-разному, но структура у них похожая.

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

18 Процедуры и функции делают код проще для чтения. Легче понять, что происходит, особенно если их имена объясняют, что они делают. Это облегчает поддержку программы.

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

20 Процедура НазваниеПроцедуры(Параметр1, Параметр2) // Здесь выполняются действия КонецПроцедурыВызов процедуры выглядит так:

21 НазваниеПроцедуры(10, 20);Процедура выполняет код внутри, но ничего не возвращает.

22 Например:

23 Процедура ПоказатьСообщение() Сообщить("Привет, мир!"); КонецПроцедуры ПоказатьСообщение();Функция объявляется аналогично, только ключевое слово - Функция. В теле функции выполняются вычисления, а результат возвращается с помощью оператора Возврат. Если оператор отсутствует, функция вернёт Неопределено. Функции можно использовать в выражениях и присваиваниях.

24 Функция НазваниеФункции(Параметр1, Параметр2) // Здесь выполняются вычисления Возврат РезультатВыполнения; КонецФункцииФункцию вызывают так:

25 Результат = НазваниеФункции(10, 20);Например:

26 Функция Умножить(Число1, Число2) Возврат Число1 * Число2; КонецФункции // Вызов функции: Результат = Умножить(5, 7);Порядок следования процедур и функций в модуле "1С: Предприятие 8" значения не имеет. Из любой процедуры (функции) модуля можно вызывать любую другую процедуру или функцию данного модуля, даже если она расположена после вызывающей.

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

28 После описания процедуры или функции точка с запятой не нужна. Правда, её можно поставить после последней процедуры или функции в модуле, и это не будет ошибкой. Но, если позже вы добавите в модуль новые процедуры (функции), будет выдаваться сообщение об ошибке.

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

30 В описании можно указать, какое значение будет использоваться по умолчанию. Для этого справа от имени параметра через знак = задаётся значение. Если при вызове оно не указано, система подставит значение по умолчанию.

31 Процедура СоздатьПользователя(Имя, Пароль = "", Роль = "Пользователь") Сообщить("Создан пользователь: " + Имя); Сообщить("Роль: " + Роль); КонецПроцедуры // Вызовы СоздатьПользователя("Иван"); // Пароль = "" , Роль = "Пользователь" СоздатьПользователя("Мария", "12345"); // Пароль = "12345", Роль = "Пользователь" СоздатьПользователя("Админ", "qwerty", "Администратор"); // Все параметры заданыПараметры по умолчанию называются необязательными, а параметры, для которых не указано значение по умолчанию, называются обязательными. Их нужно передавать при вызове, иначе система выдаст ошибку или в параметр попадёт Неопределено, что обычно приводит к неправильной работе кода.

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

33 Пример с процедурой:

34 Процедура УвеличитьНаОдин(Число) Число = Число + 1; КонецПроцедуры МоёЧисло = 10; УвеличитьНаОдин(МоёЧисло); Сообщить(МоёЧисло); // Выведет 11Здесь переменная МоёЧисло изменилась, потому что параметр был передан по ссылке.

35 Пример с функцией:

36 Функция Увеличить(Число) Число = Число + 10; Возврат Число; КонецФункции МоёЧисло = 5; НовыйРезультат = Увеличить(МоёЧисло); Сообщить(МоёЧисло); // Выведет: 15 Сообщить(НовыйРезультат); // Выведет: 15Функция здесь не только возвращает НовыйРезультат через Возврат, но и напрямую изменяет исходную переменную МоёЧисло, так как параметр был передан по ссылке.

37 Чтобы передать параметр по значению, нужно явно указать ключевое слово Знач перед именем параметра в объявлении процедуры или функции. В этом случае в процедуру попадёт копия значения, а исходная переменная останется без изменений.

38 Пример с процедурой:

39 Процедура Увеличить(Знач Число) Число = Число + 1; КонецПроцедуры МоёЧисло = 5; Увеличить(МоёЧисло); Сообщить(МоёЧисло); // Выведет 5Теперь переменная МоёЧисло осталась прежней, потому что внутри процедуры менялась только копия.

40 Пример с функцией:

41 Функция Увеличить(Знач Число) Число = Число + 10; Возврат Число; КонецФункции МоёЧисло = 5; НовыйРезультат = Увеличить(МоёЧисло); Сообщить(МоёЧисло); // Выведет: 5 Сообщить(НовыйРезультат); // Выведет: 15В некоторых процедурах-обработчиках в параметры передаётся специальная переменная Отказ. Её значение по умолчанию - Ложь. Если внутри обработчика присвоить ей Истина, выполнение процедуры будет прервано.

42 Пример:

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

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

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

46 Неправильно:

47 Процедура РассчитатьСуммуДокумента(ИмяПоляСумма, ДокументОбъект, СуммаВключаетНДС = Истина) Процедура ИзменитьЦветПоляФормы(Цвет, ИмяПоля, Форма)Правильно:

48 Процедура РасчитатьСумму Документа(ДокументОбъект, ИмяПоляСумма, СуммаВключаетНДС = Истина) Процедура ИзменитьЦветПоляФормы(Форма, ИмяПоля, Цвет)Необязательные параметры должны располагаться после обязательных.

49 Пример:

50 Функция РассчитатьСкидку(СуммаПокупки, ПроцентСкидки = 5) Возврат СуммаПокупки * (1 - ПроцентСкидки / 100); КонецФункции // Вызовы: РассчитатьСкидку(1000); // ПроцентСкидки = 5 (по умолчанию) РассчитатьСкидку(1000, 10); // ПроцентСкидки = 10Не нужно перегружать функцию большим количеством параметров. Рекомендуется не более семи параметров, из них не более трёх - со значением по умолчанию, иначе вызовы становятся громоздкими и трудночитаемыми.

51 Вместо длинных списков параметров лучше сгруппировать их в структуры или пересмотреть логику функции.

52 Плохой пример: слишком много параметров:

53 // Добавляет новый товар в документ Процедура ДобавитьТоварВДокумент(ДокументОбъект, КодТовара, Наименование, Количество, Цена, СтавкаНДС = 20, Скидка = 0, Валюта = "RUB", ЕдиницаИзмерения = "шт") // Громоздкий код КонецПроцедуры // Вызов функции выглядит запутанно: ДобавитьТоварВДокумент(Документ, "A123", "Монитор", 2, 15000, 20, 5, "USD", "шт");Здесь девять параметров, причём четыре из них необязательные. При вызове легко запутаться.

54 Хороший пример: параметры сгруппированы в структуру

55 // Добавляет новый товар в документ Процедура ДобавитьТоварВДокумент(ДокументОбъект, ПараметрыТовара) // Работаем с переданной структурой КонецПроцедуры // Вызов: Параметры = Новый Структура; Параметры.Вставить("КодТовара", "A123"); Параметры.Вставить("Наименование", "Монитор"); Параметры.Вставить("Количество", 2); Параметры.Вставить("Цена", 15000); Параметры.Вставить("СтавкаНДС", 20); Параметры.Вставить("Скидка", 5); Параметры.Вставить("Валюта", "USD"); Параметры.Вставить("ЕдиницаИзмерения", "шт"); ДобавитьТоварВДокумент(Документ, Параметры);В этом примере код читается лучше: видно, какой параметр чему соответствует, и порядок свойств не имеет значения. Если добавить новые параметры, код вызова почти не меняется.

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

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

58 Например:

59 Процедура ПровестиДокумент() ПроверитьДанные(); ЗаписатьПроводки(); Сообщить("Документ проведён успешно!"); КонецПроцедурыФункции используются, когда нужно вычислить и вернуть результат (сумму, количество, дату, строку) или оформить часть логики в отдельный модуль для повторного использования.

60 Функция РассчитатьСуммуСоСкидкой(Сумма, Скидка) Возврат Сумма * (100 - Скидка) / 100; КонецФункцииВ модулях объектов (Документ, Справочник, Регистр):

61 <ul><li>проведение документов;</li>

62 <li>проверка данных при записи;</li>

63 <li>расчёт регламентных показателей.</li>

64 </ul>В модулях форм:

65 <ul><li>обработка событий интерфейса (нажатие кнопки, изменение реквизита);</li>

66 <li>вызов серверных процедур для работы с базой;</li>

67 <li>заполнение табличных частей и управляемых элементов.</li>

68 </ul>В общих модулях:

69 <ul><li>хранение универсальных функций, доступных разным объектам (например, функция округления сумм, работа с датами).</li>

70 </ul>Чтобы просмотреть список процедур и функций текущего модуля, нужно нажать на кнопку с изображением лупы и подписью Proc или использовать сочетание клавишCtrl + Alt + P. Откроется окно навигации, в котором можно выбрать нужную процедуру или функцию и перейти к её коду.

71 Скриншот: "1С: Предприятие" / Skillbox MediaПо умолчанию элементы отображаются так, как они расположены в модуле. Список можно отсортировать по алфавиту, установив флажок Сортировка.

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

73 <a>Бесплатный курс по Python ➞Мини-курс для новичков и для опытных кодеров. 4 крутых проекта в портфолио, живое общение со спикером. Кликните и узнайте, чему можно научиться на курсе. Смотреть программу</a>