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