Глобальные переменные
Обновлено:
Глобальные переменные — один из самых мощных инструментов PlanPlace. Они позволяют управлять поведением сразу всех модулей из одного места, без программирования. Изменили одно значение — и обновились все элементы, которые его используют. В этой статье разберём, что это такое и как с ними работать.
Что такое переменная простыми словами
Заголовок раздела «Что такое переменная простыми словами»Переменная — это «настройка», которую задаёт технолог. Она не является встроенным свойством материала или фасада, а создаётся вручную, чтобы управлять конструкцией.
Пример: вы создаёте переменную «Высота парящих баз» со значением 100 мм. Все модули, которые её используют, встанут на высоту 100 мм. Захотели поднять все парящие базы до 120 мм — поменяли одно число, и вся база обновилась автоматически. Без переменной пришлось бы открывать каждый модуль вручную.
Глобальные и локальные переменные
Заголовок раздела «Глобальные и локальные переменные»- Глобальная переменная живёт в разделе «Глобальные переменные» и действует на весь каталог. Меняете значение — меняется везде.
- Локальная переменная существует только внутри одного модуля. Нужна, когда настройка касается лишь конкретного изделия. Локальные переменные настраиваются в конфигураторе элемента.
Встроенные (системные) переменные
Заголовок раздела «Встроенные (системные) переменные»Помимо тех переменных, что вы создаёте сами, в системе есть встроенные переменные — они подмешиваются автоматически и управляют стандартными элементами конструкции. Например:
- Цоколь: включён ли цоколь, тип цоколя (Плитный материал / ПВХ), высота и толщина цоколя, верхний цоколь;
- Карниз: включён ли карниз;
- Столешница: наличие и высота столешницы, глубина;
- Фасад: толщина фасада;
- Плинтус.
Такие переменные защищены: их значения настраиваются в соответствующих разделах меню (например, высота цоколя — в настройках цоколя), а ключ и тип у них менять нельзя, и удалить их тоже нельзя. В списке переменных они отображаются вместе с вашими, но без действий «удалить».
«Тип цоколя» — под усиленной защитой. У этой переменной, кроме ключа и типа, нельзя менять и сами значения «Плитный материал» / «ПВХ» (и удалять эти строки) — на них завязана логика переключения типа цоколя. Разрешено только переименовать подписи и включить/выключить вывод в меню. Значение подставляется автоматически из выбранной карточки цоколя, поэтому вручную его менять и не нужно.
Наборы переменных
Заголовок раздела «Наборы переменных»Глобальные переменные можно объединять в наборы — несколько комплектов значений с выбором текущего набора и набора по умолчанию. Это нужно, когда один и тот же каталог должен работать с разными «профилями» настроек. В большинстве кабинетов управление наборами скрыто, и вы работаете с одним набором — но важно знать, что такая возможность есть.
Типы переменных
Заголовок раздела «Типы переменных»Переменные бывают трёх типов:
- Переключатель (Да/Нет) — логическое значение. Например, «Есть задняя стенка»: да или нет.
- Число — числовой параметр, можно ограничить диапазон. Например, «Высота парящих баз»: минимум 0, максимум 200 мм. Часто задают и шаг изменения.
- Выбор из списка — набор готовых вариантов, и у каждого есть числовой идентификатор. Например, «Тип задней стенки»: вариант 0, 1, 2, 3. В формулах используется именно числовое значение варианта — это очень важная деталь (см. «Математические вычисления»).
Ключ и название — в чём разница
Заголовок раздела «Ключ и название — в чём разница»У каждой переменной есть две «надписи», и их нельзя путать:
- Ключ — уникальный технический идентификатор. Он используется в коде модулей. Ключ нельзя менять после создания — иначе сломается логика во всех модулях, где переменная задействована.
- Название — человекочитаемая подпись. Его можно менять в любой момент без последствий.
Запомните. Ключ — навсегда, название — как угодно. Если нужно «переименовать» переменную для понятности, меняйте название, а ключ оставляйте.
Видимость для пользователя
Заголовок раздела «Видимость для пользователя»Переменную можно показать или скрыть для пользователя на сцене. Например, технолог видит и меняет «Тип задней стенки», а дизайнеру эту опцию показывать не нужно — он её не увидит. Так вы даёте дизайнеру ровно те настройки, которые ему положены, и прячете служебные.
Скрывать на сцене можно и встроенные (вшитые) глобальные переменные — те, что заложены в систему по умолчанию. Раньше они всегда были видны; теперь их отображение тоже управляется, чтобы не показывать пользователю лишние служебные параметры.
Где применяются переменные
Заголовок раздела «Где применяются переменные»Через переменные удобно управлять:
- размерами и отступами;
- видимостью секций и деталей;
- наличием опций (есть/нет цоколь, задняя стенка, парящая база);
- глубиной профиля, типом задней стенки и т. п.;
- доступностью настроек в интерфейсе дизайнера.
Главное правило безопасности
Заголовок раздела «Главное правило безопасности»Не удаляйте существующие переменные. Удаление переменной может привести к потере настроек и ошибкам в базе — ведь на неё могут ссылаться формулы и условия в десятках модулей. Если переменная больше не нужна, лучше скройте её или перестаньте использовать, но не удаляйте.
Переопределение переменных
Заголовок раздела «Переопределение переменных»Значения переменных можно переопределять для вложенных модулей и элементов — настройки распространяются каскадно, сверху вниз. Это позволяет, например, задать всем вложенным ящикам одно поведение из родительского модуля. Подробнее эта механика разобрана в статье «Переменные модуля».
Где менять значение на сцене
Заголовок раздела «Где менять значение на сцене»Одна и та же настройка может быть доступна в двух местах, но область изменения отличается:
- левое меню сцены меняет глобальное значение для проекта и передаёт его всем модулям, которые используют эту переменную;
- правое меню выбранного модуля меняет значение только для выбранного изделия и его связанной вложенной структуры.
Если вложенная переменная помечена как локальная, общее изменение родителя её не заменяет. Такой вариант используют, когда один ящик, секция или другой вложенный элемент должен отличаться от соседних.
После изменения параметра справа PlanPlace сохраняет выбранное значение в модуле. Поэтому перестроение изделия или повторный выбор объекта не должны возвращать старое значение.
Как создать глобальную переменную
Заголовок раздела «Как создать глобальную переменную»- Откройте меню кабинета → «Глобальные переменные» и внизу страницы нажмите «Добавить переменную».
- Задайте Ключ (идентификатор: латиница, цифры и знак подчёркивания, без пробелов и спецсимволов, например
tip_zadney_stenki) и Название (например, «Тип задней стенки»). Поле ключа само отфильтрует недопустимые символы. - Выберите тип: Число, Выбор из списка (у каждого варианта — текстовое имя и числовое значение для формул) или Да/Нет.
- При необходимости включите «Выводить в меню» (показывать дизайнеру), задайте Порядок и Группу (например, «Корпус», «Ящики»). Для числа дополнительно укажите Мин., Макс. и Шаг.
- Укажите значение по умолчанию и нажмите «Сохранить».

Как использовать переменную в модуле
Заголовок раздела «Как использовать переменную в модуле»В конфигураторе элемента откройте вкладку «Переменные» и добавьте переменную одним из способов:
- правым кликом по заголовку «Переменные»;
- через меню «…» на заголовке → выбрать переменную из списка → «Добавить» (можно выбрать сразу несколько).
Глобальные переменные выделяются в списке жирным. Поиск по переменным — Ctrl+F в браузере.
Пример: «Тип задней стенки»
Заголовок раздела «Пример: «Тип задней стенки»»Одна переменная управляет задней стенкой сразу во всех модулях. Тип — список с числовыми значениями:
- В паз тонкая (0);
- В четверть тонкая (1);
- Накладная корпус (2);
- Вкладная корпус (3);
- Без задней стенки (4).
В конструкторе модуля от значения этой переменной зависит видимость деталей задней стенки. Например, для модулей под мойку переменную фиксируют на значении «Без задней стенки (4)».
Коротко
Заголовок раздела «Коротко»Глобальная переменная — это управляемая настройка, которая централизованно меняет поведение всех модулей. Бывает трёх типов: переключатель, число и список (у списка есть числовые значения для формул). Ключ переменной менять нельзя, название — можно. Переменные можно скрывать от дизайнера и нельзя бездумно удалять. Это главный инструмент гибкости каталога без программирования.






