## Описание Плагин производит расчет выражений и присваивает результат указанному параметру. Расчет осуществляется для типов элементов. Команды плагина: `ITEM 🠒 Расчет параметров 🠒 Расчет параметров: Редактирование выражений` ![[Плагин Калькулятор параметров 12.png]] `ITEM 🠒 Расчет параметров 🠒 Расчет параметров: Выбрать и расчитать` ![[Плагин Калькулятор параметров 13.png]] ## Требования для работы 1. Добавьте параметры для всех категорий, используемых в вашем проекте. | Имя параметра | Типа/Экземпляра | Тип данных | | ----------------------------- | :-------------: | :-----------------: | | СЭ_Формулы расчета параметров | Тип | Многострочный текст | | СЭ_Отчет расчета параметров | Тип | Многострочный текст | ## Использование 1. Для добавления формулы выделите один элемент и нажмите `Расчет параметров: Редактирование выражений`. Появится главное меню: ![[Плагин Калькулятор параметров 1.png]] 1 - позволяет создать формулы для расчета параметра. После создания первой формулы можно заново нажать "Создать" и сделать следующую. После добавления формул окно будет выглядеть так: ![[Плагин Калькулятор параметров 2.png]] 2 - сохраняет все изменения (создание, удаление, изменение порядка). Данные изменения отражаются многострочном текстовом параметре СЭ_Формулы расчета параметров. 2. После нажатия на кнопку "Создать" откроется окно Редактор формул: ![[09. Плагины и приложения/Описание плагинов ITEMIKA/Resources/Плагин Калькулятор параметров 3.png]] 1 - выберите параметр, в который будет записываться итоговое значение. 2 - двойным щелчком или кнопкой ⊕ добавьте параметры из блока Параметры для расчетов в поле формулы. > [!info] > в блок "Параметры для расчетов" попадают параметры типа и экземпляра из проекта и семейства. 3 - блок "Вставка текста" позволяет добавить в формулу напечатанный вами текст, а также добавить текстовые единицы измерения, выбрав их из выпадающего списка. Для добавления нажмите кнопку ⊕. 4 - блок "Логические операции" позволяет добавлять готовые шаблоны Условия, Округления и Округления вверх, а также формировать свои условия. ![[Плагин Калькулятор параметров 4.png]] > [!info] > При наведении на кнопку готового шаблона появится всплывающая подсказка. 5 - в строке отображается промежуточный результат, получающийся в ходе расчета вашей формулы. > [!attention] > После составления формулы необходимо проверить ее корректность по строке Промежуточный результат. > Примеры: > ![[Плагин Калькулятор параметров 5.png]] > 3. После создания формулы нужно обязательно нажать Сохранить в окне Редактора формул и в окне Главного меню. После этого созданная(ые) формула(ы) запишутся в параметр типа СЭ_Формулы расчета параметров и можно будет запустить расчет. > [!info] > Калькулятор может не только вычислять, но и складывать текстовые значения с текстом и числами, записывать новые значения в выбранный параметр и переносить значения из одного параметра в другой. > Примеры некоторых типов формул: Формула переноса значений параметра > `ДСК1_ИОС_Система = [ИмяСистемы]` Формула с условием для распределения элементов > `ITEM_Число = If([ДСК1_Секция] = '01', 1, If([ДСК1_Секция] = '02', 2, 0))` > Формула с округлением до десятых > `ITEM_Количество = Round([Длина]*1.2/1000,1)` > Формула сложения числа и текста > `ADSK_Марка = [ADSK_Марка]+7725` (результат вычисления 🠒 ГОСТ Р 70349-20227725) > 4. Формулы, созданные с помощью плагина можно копировать из типа в тип с помощью спецификации, редактировать и менять местами в окне "Редактирование текста" ![[Плагин Калькулятор параметров 7.png]]По параметру СЭ_Формулы расчета параметров можно отсортировать спецификацию так же, как по любому другому. > [!attention] > Необходимо следить за порядком добавления формул! > Плагин читает их сверху вниз. > Пример: > ![[Плагин Калькулятор параметров 8.png]] > `ДСК1_Количество_ДЕ использует значение параметра ITEM_Количество, но так как формула ITEM_Количество рассчитывается после ДСК1_Количество_ДЕ в ДСК1_Количество_ДЕ запишется ПУСТОТА.` > Располагайте формулы последовательно: > ![[Плагин Калькулятор параметров 9.png]] Рекомендуется сохранять порядок для ПОВТОРЯЮЩЕГОСЯ набора формул, если это не нарушает логику вычислений. Сохранение порядка обеспечивает правильную сортировку спецификации по параметру СЭ_Формулы расчета параметров. ![[Плагин Калькулятор параметров 10.png]] Вы сможете легко понять где и какой набор формул уже добавлен. 5. Команда `Расчет параметров: Выбрать и расчитать` позволяет запустить расчет формул во всем проекте, в выбранных элементах или всех элементах видимых на **активном** виде(или в спецификации). Выберите подходящую функцию в окне и нажмите ОК. ![[Плагин Калькулятор параметров 6.png]] > [!warning] >Плагин не сможет обработать элементы занятые другими пользователями! > Перед запуском сценария "все элементы в проекте" нужно убедиться что ВСЕ элементы свободны! Попросите своих коллег засинхронизироваться и подождать пока отработает плагин. Засинхронизируйтесь сами и запустите расчет. > > [!attention] > Перед любым запуском расчета рекомендуется синхронизироваться или сохранять изменения в локальной копии. 5. Результат расчета отобразится в параметре СЭ_Отчет расчета параметров Этот параметр так же можно вывести в спецификацию и отсортировать ее по результатам расчета. Результат записывается последовательно для каждой формулы забитой с тип элемента. ![[Плагин Калькулятор параметров 11.png]]