Формулы
Раздел «Формулы» в модуле «Отчёты» позволяет создавать пользовательские формулы для их последующего использования в параметрах шаблонов. Использование формул сокращает время разработки шаблонов с типовыми расчётами и позволяет централизованно управлять их логикой. Изменение одной формулы автоматически применяется ко всем параметрам шаблонов, где она используется, что избавляет от множественного копирования и правки. Все пользовательские формулы, созданные в этом разделе, можно использовать в расчётных параметрах шаблона отчёта наравне со встроенными функциями системы.
Создание формулы
- Для добавления новой формулы:
- В главном боковом меню перейдите к модулю «Отчёты».
- В подменю выберите раздел «Формулы».
- Нажмите кнопку «Добавить».
- В области редактирования формулы будет отображена сама формула
return a + b;. Редактирование формулы выполняется аналогично расчётному параметру шаблона отчёта. - Укажите «Тип возвращаемого значения», который должна возвращать формула.
- Отредактируйте название формулы для удобства её идентификации при дальнейшем использовании в расчётных параметрах.
- При необходимости укажите дополнительные «Параметры» формулы, отредактируйте их наименование и измените «Тип значения аргумента».
- Проверьте корректность формулы, нажав кнопку «Проверить».
- Сохраните изменения.
Пример использования
В примере создаётся формула АктивнаяМощность. Она рассчитывает активную мощность в трёхфазной электрической сети по напряжению, току и коэффициенту мощности и используется в нескольких расчётных параметрах шаблона отчёта.
Создание формулы
Используя формулу для расчёта активной мощности в трёхфазной сети:
P = √3 * U * I * cos(φ)
перейдите в раздел создания и редактирования формул модуля «Отчёты» и добавьте новую формулу с названием АктивнаяМощность.
В поле для ввода формулы укажите:
Math.Sqrt(3) * Напряжение * Ток * КоэфМощн
далее в правой части окна в блоке «Параметры» задайте соответствующие аргументы.
Использование пробелов в названиях формул и параметров не допускается.
Проверьте правильность составления формулы и сохраните изменения.
Использование формулы в расчётных параметрах
- Перейдите в нужный шаблон отчёта и создайте новый расчётный параметр.
- Очистите рабочую область ввода кода и добавьте новую формулу, созданную на предыдущем этапе. Для выбора формулы воспользуйтесь кнопкой «Вставка формулы». Из списка формул выберите нужную и нажмите кнопку «Применить».
- Замените нужные параметры для формулы, которые используются в качестве источника данных. Параметры шаблона, к которым должна обращаться формула, должны иметь тот же тип данных, что и параметры формулы.
- Укажите наименование этого параметра и сохраните изменения.
Далее можно создать n-ое количество копий созданного параметра, скорректировать ссылки в формулах и перенести расчётные параметры нахождения мощности в разметку отчёта.
При необходимости изменить алгоритм (например, привести единицы измерения мощности из Вт в кВт), редактирование одной лишь формулы позволяет избежать массовых правок во всех расчётных параметрах.
Отредактируйте формулу, указав нужный коэффициент преобразования, и сохраните изменения:
Math.Sqrt(3) * Напряжение * Ток * КоэфМощн / 1000
При переформировании отчётов все значения параметров, в которых была использована формула расчёта АктивнаяМощность, будут пересчитаны.
