Другое · 7 мин
Как писать формулы в 1C: пошаговое руководство
Пишем формулы в 1C: синтаксис выражений, типы данных, условия, проверка результата, частые ошибки и безопасные правки без риска для данных и отчётов.
Формула в 1C — это выражение на языке платформы, которое вычисляет значение из полей справочников, документов, регистров, констант и встроенных функций. Такие выражения используются в вычисляемых полях отчётов, настройках компоновки данных, программных формах и обработках.
Главное требование — формула должна быть написана в правильном контексте: доступны только те объекты и поля, которые видны в текущем наборе данных или форме. Иначе система выдаст ошибку при компиляции или покажет пустой результат.
Ошибка в формуле редко ломает саму программу, но может привести к неверным расчётам, неправильным отчётам и ошибочным бизнес-решениям. Поэтому перед массовым использованием новую формулу нужно проверить на тестовых данных и сравнить с ожидаемым результатом.
Что такое формула в 1C и где она применяется
В 1C формула чаще всего означает вычисляемое выражение, а не математическую формулу из школы. Она может вычислять сумму, скидку, дату отгрузки, возраст контрагента или признак превышения лимита. Результат подставляется в колонку отчёта, поле формы или условие отбора.
Основные места применения: отчёты на основе компоновки данных, вычисляемые поля в табличных частях, условия доступности элементов формы, программные модули обработок и отчётов. У каждого места свой набор доступных объектов и правил обращения к данным.
Синтаксис и базовые правила записи
Выражение начинается с поля, константы, функции или скобок и заканчивается точкой с запятой только в программном коде. В настройках компоновки данных и вычисляемых полях точка с запятой обычно не ставится. Регистр значений имеет значение только там, где это предусмотрено типом данных.
Литералы и типы данных
Числа пишутся без разделителей тысяч, дробная часть отделяется точкой или запятой в зависимости от параметров сеанса. Даты оформляются как литералы даты, строки — в кавычках. Булевы значения выражаются через Истина и Ложь.
Пустое значение обозначается как Неопределено. Сравнение с Неопределено требует осторожности: прямое сравнение может работать иначе, чем ожидается, особенно при работе с реквизитами, которые не заполнены.
Операторы и функции
Доступны арифметические операторы +, -, *, /, операторы сравнения =, <>, >, <, >=, <=, логические И, ИЛИ, НЕ. Для строк применяется конкатенация через +, но только если оба операнда имеют строковый тип.
Встроенные функции зависят от контекста: в запросах это функции языка запросов, в формах — методы объектов и глобального контекста. Нельзя смешивать функции запроса и функции формы в одном выражении без понимания среды выполнения.
Условные выражения и работа с пустыми значениями
Для условий используется конструкция ВЫБОР КОГДА ... ТОГДА ... ИНАЧЕ ... КОНЕЦ в запросах и аналогичные логические выражения в программном коде. Она позволяет вернуть разное значение в зависимости от заполнения реквизита или значения суммы.
Перед использованием результата для дальнейших вычислений проверяйте, не является ли он Неопределено. Арифметика с пустым значением может вернуть неожиданный результат или привести к ошибке выполнения.
- 1Определите место применения: отчёт, компоновка данных, форма или обработка
- 2Убедитесь, что нужные поля и реквизиты доступны в текущем контексте
- 3Напишите выражение с учётом типов данных и условий
- 4Проверьте результат на тестовых данных с заполненными и пустыми полями
- 5Сравните вычисленное значение с ожидаемым вручную
Где проверять формулу: отчёт, компоновка, форма
В отчётах на базе компоновки данных формула настраивается в параметрах вычисляемого поля. Проверяйте предварительный просмотр: если колонка пуста или показывает одинаковое значение для всех строк, скорее всего, контекст данных не совпадает с полями формулы.
В программных формах выражение может быть частью процедуры при изменении данных или расчёта реквизита. Используйте режим отладки или вывод промежуточных значений в сообщение, чтобы убедиться, что формула срабатывает в нужный момент.
Частые ошибки и способы отладки
Частая ошибка — использование поля, которого нет в выбранном наборе данных. Система может подсветить ошибку при сохранении или показывать пустую колонку. Вторая ошибка — несоответствие типов, например попытка вычесть дату из числа или сравнить строку с датой без преобразования.
Третья ошибка — игнорирование пустых значений. Если реквизит не заполнен у части записей, формула может вернуть Неопределено и сломать итоговые суммы. Проверяйте выборку на записях с заполненными и пустыми реквизитами.
Ограничения и безопасные правки
Не меняйте формулы в отчётах и обработках, которые используются для закрытия периода, налоговой или бухгалтерской отчётности, без проверки на копии базы. Ошибка в таком выражении может повлиять на принятые решения и документы.
Если формула содержит сложную логику, несколько вложенных условий и обращается к регистрам накопления, лучше вносить правки вместе с разработчиком или методологом. Самостоятельно безопасно править простые вычисляемые поля в пользовательских отчётах без влияния на проводки.
Как проверить результат перед внедрением
Создайте тестовый набор данных с граничными значениями: нулевые суммы, пустые даты, не заполненные контрагенты, превышение лимитов. Запустите отчёт или формулу и убедитесь, что результат совпадает с расчётом вручную.
Если система выдаёт ошибку при сохранении, прочтите текст сообщения: обычно там указано имя поля или строки, где проблема. Не игнорируйте предупреждения о несовместимости типов — они часто проявляются только на части данных.
Как проверить результат
Значение совпадает с расчётом вручную
Пустая колонка, одинаковое значение или ошибка выполнения
Ожидаемый тип: число, дата или строка
Неопределено или несоответствие типа
Альтернативы сложным формулам
Если выражение становится слишком громоздким, вынесите расчёт в отдельный отчёт, обработку или регистр накопления с предварительными итогами. Это упрощает поддержку и снижает вероятность ошибки при изменении логики.
Для повторяющихся расчётов можно использовать общие модули или вычисляемые свойства объектов, если это предусмотрено конфигурацией. Выбирайте вариант в зависимости от того, кто будет поддерживать решение и где нужны данные.
Что важно запомнить
Пишите формулу в подходящем контексте, проверяйте типы и пустые значения, тестируйте на копии базы, сложную логику согласовывайте с разработчиком.
Можно ли использовать одну формулу в отчёте и в форме?
Не всегда. Отчёт и форма имеют разный контекст данных и набор доступных функций. Выражение нужно проверять отдельно для каждого места применения.
Что делать, если формула возвращает пустое значение?
Проверьте, есть ли ссылка на поле в текущем наборе данных, заполнен ли реквизит у тестовых записей и не является ли результат Неопределено из-за отсутствия условия ИНАЧЕ.
Безопасно ли править формулу в действующем отчёте?
Для простых пользовательских отчётов можно проверять на копии базы. Для отчётов, влияющих на бухгалтерскую или налоговую отчётность, изменения лучше согласовывать и тестировать отдельно.
Нужно ли программирование для написания формулы?
Простые вычисляемые поля настраиваются без кода через интерфейс компоновки данных. Сложная логика с несколькими условиями и вызовами функций может потребовать программного модуля.
Как понять, что формула работает правильно?
Сравните результат с расчётом вручную на нескольких записях, включая пустые и граничные значения. Если значения совпадают и ошибок нет, формула считается проверенной.