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

Другое · 7 мин

Как писать формулы в 1C: пошаговое руководство

Пишем формулы в 1C: синтаксис выражений, типы данных, условия, проверка результата, частые ошибки и безопасные правки без риска для данных и отчётов.

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

Главное требование — формула должна быть написана в правильном контексте: доступны только те объекты и поля, которые видны в текущем наборе данных или форме. Иначе система выдаст ошибку при компиляции или покажет пустой результат.

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

Что такое формула в 1C и где она применяется

В 1C формула чаще всего означает вычисляемое выражение, а не математическую формулу из школы. Она может вычислять сумму, скидку, дату отгрузки, возраст контрагента или признак превышения лимита. Результат подставляется в колонку отчёта, поле формы или условие отбора.

Основные места применения: отчёты на основе компоновки данных, вычисляемые поля в табличных частях, условия доступности элементов формы, программные модули обработок и отчётов. У каждого места свой набор доступных объектов и правил обращения к данным.

Синтаксис и базовые правила записи

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

Литералы и типы данных

Числа пишутся без разделителей тысяч, дробная часть отделяется точкой или запятой в зависимости от параметров сеанса. Даты оформляются как литералы даты, строки — в кавычках. Булевы значения выражаются через Истина и Ложь.

Пустое значение обозначается как Неопределено. Сравнение с Неопределено требует осторожности: прямое сравнение может работать иначе, чем ожидается, особенно при работе с реквизитами, которые не заполнены.

Операторы и функции

Доступны арифметические операторы +, -, *, /, операторы сравнения =, <>, >, <, >=, <=, логические И, ИЛИ, НЕ. Для строк применяется конкатенация через +, но только если оба операнда имеют строковый тип.

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

Условные выражения и работа с пустыми значениями

Для условий используется конструкция ВЫБОР КОГДА ... ТОГДА ... ИНАЧЕ ... КОНЕЦ в запросах и аналогичные логические выражения в программном коде. Она позволяет вернуть разное значение в зависимости от заполнения реквизита или значения суммы.

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

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

Где проверять формулу: отчёт, компоновка, форма

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

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

Типичные ошибки при написании формул
01
Ссылка на отсутствующее поле в текущем наборе данных приводит к пустому результату или ошибке
02
Смешивание несовместимых типов: даты, числа и строки в одном выражении
03
Игнорирование Неопределено при расчёте итогов и условий отбора

Частые ошибки и способы отладки

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

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

Ограничения и безопасные правки

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

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

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

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

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

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

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

Результат на заполненных и пустых реквизитах
Норма

Значение совпадает с расчётом вручную

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

Пустая колонка, одинаковое значение или ошибка выполнения

Тип данных результата
Норма

Ожидаемый тип: число, дата или строка

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

Неопределено или несоответствие типа

Альтернативы сложным формулам

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

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

Итог

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

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

Можно ли использовать одну формулу в отчёте и в форме?

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

Что делать, если формула возвращает пустое значение?

Проверьте, есть ли ссылка на поле в текущем наборе данных, заполнен ли реквизит у тестовых записей и не является ли результат Неопределено из-за отсутствия условия ИНАЧЕ.

Безопасно ли править формулу в действующем отчёте?

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

Нужно ли программирование для написания формулы?

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

Как понять, что формула работает правильно?

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