Свойства в 1С: что это и как их использовать в программировании

В мире 1С:Предприятие термин "свойство" встречается повсеместно — от работы с объектами конфигурации до динамического управления формами. Но что на самом деле скрывается за этим понятием? Если вы только начинаете осваивать встроенный язык 1С или хотите систематизировать знания, эта статья поможет разложить всё по полочкам.

Свойства в 1С — это не просто переменные или поля объектов. Они представляют собой мощный механизм, который позволяет гибко управлять данными, настройками и поведением элементов системы. От понимания их природы зависит, насколько эффективно вы сможете работать с платформой, создавать расширения и модифицировать типовые решения.

Мы рассмотрим не только базовые определения, но и скрытые нюансы работы со свойствами, которые редко упоминаются в стандартной документации. Вы узнаете, как свойства взаимодействуют с метаданными, почему иногда они ведут себя "непредсказуемо" и как избежать типичных ошибок при их использовании.

Что такое свойство в 1С: основные понятия

В контексте 1С:Предприятие свойство — это именованная характеристика объекта, которая определяет его состояние, поведение или внешний вид. Свойства могут принадлежать:

📌 Объектам конфигурации (справочникам, документам, регистрам)
🖥️ Элементам управления (полям ввода, кнопкам, таблицам на формах)
🔧 Встроенным объектам платформы (например, Сообщение, Файл)
📊 Динамически создаваемым объектам в коде

Важно понимать, что свойства в 1С — это не то же самое, что свойства в классическом ООП. Здесь они тесно интегрированы с системой метаданных и имеют уникальные особенности. Например, свойство справочника Наименование физически хранится в базе данных, тогда как свойство ЦветФона элемента формы существует только в памяти во время работы приложения.

Каждое свойство имеет:

🏷️ Имя (уникальный идентификатор в рамках объекта)
🔢 Тип значения (строка, число, дата, ссылка и т.д.)
🔒 Уровень доступа (читаемое, записываемое, скрытое)
📝 Источник данных (хранится в БД, вычисляется динамически и пр.)

Типы свойств в 1С: классификация и примеры

Все свойства в системе 1С:Предприятие можно условно разделить на несколько категорий. Эта классификация поможет лучше ориентироваться в возможностях платформы и выбирать правильные подходы к работе с данными.

Тип свойства	Примеры	Особенности
Стандартные свойства объектов	`Ссылка`, `Наименование`, `ПометкаУдаления`	Определяются конфигурацией, хранятся в БД
Динамические свойства	`ДобавитьРеквизит()`	Создаются в коде, не хранятся в БД
Свойства элементов формы	`Видимость`, `ЦветФона`, `ТолькоПросмотр`	Управляют интерфейсом, существуют только во время сеанса
Системные свойства	`ЭтоГруппа`, `ПолноеИмя`, `УникальныйИдентификатор`	Доступны для большинства объектов, часто используются в отборах
Вычисляемые свойства	`КоличествоСтрок` (для таблицы), `ТекущаяДата`	Значения рассчитываются динамически

Особый интерес представляют динамические свойства, которые позволяют расширять функциональность объектов без изменения конфигурации. Например, вы можете добавить временное свойство к документу прямо в коде:

Документ.ДобавитьРеквизит("ВременнаяСкидка", Новый ОписаниеТипов("Число"));
Документ.ВременнаяСкидка = 15;

Такие свойства существуют только в памяти и идеально подходят для промежуточных расчетов или передачи данных между процедурами.

💡

Используйте динамические свойства для временных данных, но помните — они не сохраняются в базе и будут утеряны после завершения сеанса.

Как работать со свойствами: синтаксис и приемы

Базовый синтаксис обращения к свойствам в 1С интуитивно понятен, но имеет ряд нюансов. Рассмотрим основные способы работы с ними.

1. Чтение и запись свойств

Для доступа к свойству используется оператор точки:

// Чтение свойства Перем ТекущееНаименование = Справочник.Наименование; // Запись свойства

Справочник.Комментарий = "Обновлено автоматически";

Например, системное свойство Ссылка можно только читать.

2. Проверка существования свойства

Перед работой со свойством рекомендуется проверять его наличие, особенно при работе с динамическими объектами:

Если ЗначениеЗаполнено(Объект.Свойства.НужноеСвойство) Тогда // Работаем со свойством

КонецЕсли;

3. Массовая работа со свойствами

Для перебора всех свойств объекта можно использовать коллекцию Свойства:

Для Каждого Св Из Объект.Свойства Цикл
Сообщить(Св.Имя + ": " + Св.Значение);
КонецЦикла;

Особенности работы с коллекцией Свойства

Коллекция Свойства возвращает только те свойства, которые доступны для чтения в текущем контексте. Системные и скрытые свойства могут не отображаться.

4. Работа с вложенными свойствами

Некоторые свойства сами являются объектами и имеют собственные свойства. Например, свойство Реквизиты справочника:

ЗначениеКода = Справочник.Реквизиты.Код.Значение;

В таких случаях важно следить за цепочкой обращений, чтобы избежать ошибок вида "Свойство не обнаружено".

☑️ Проверка перед работой со свойствами

Убедиться что объект существуетПроверить доступность свойства для чтения/записиУчесть контекст выполнения (тонкий клиент, сервер и т.д.)Обработать возможные исключения

Выполнено: 0 / 4

Свойства vs Реквизиты: в чем разница?

Многие начинающие разработчики путают понятия "свойство" и "реквизит". Хотя оба термина относятся к характеристикам объектов, между ними есть принципиальные различия:

Характеристика	Свойство	Реквизит
Определение	Любая характеристика объекта, включая системные	Пользовательское поле, определенное в конфигураторе
Хранение	Может храниться в БД или существовать только в памяти	Всегда хранится в БД
Создание	Может создаваться динамически в коде	Создается только в конфигураторе
Примеры	`Видимость`, `ЦветФона`, `ЭтоГруппа`	`Код`, `Наименование`, `Комментарий`

Важный нюанс: все реквизиты являются свойствами, но не все свойства являются реквизитами. Например, Наименование справочника — это и реквизит, и свойство одновременно, а Видимость элемента формы — только свойство.

При работе с динамическими списками это различие становится особенно важным. Реквизиты можно использовать в отборах и группировках, тогда как произвольные свойства — нет.

💡

Реквизиты всегда являются свойствами объекта, но свойства могут не быть реквизитами. Это ключевое отличие при проектировании структуры данных.

Практические примеры использования свойств

Рассмотрим несколько реальных сценариев, где понимание работы со свойствами помогает решать типовые задачи.

1. Динамическое изменение интерфейса

Свойства элементов формы позволяют гибко настраивать интерфейс в зависимости от условий:

Если ТекущийПользователь.Роль = "Администратор" Тогда ЭлементыФормы.КнопкаНастроек.Видимость = Истина; ЭлементыФормы.КнопкаНастроек.ЦветФона = ВебЦвета.Красный; Иначе ЭлементыФормы.КнопкаНастроек.Видимость = Ложь;

КонецЕсли;

2. Работа с динамическими свойствами

Добавим временное свойство к документу для хранения промежуточных данных:

Процедура ПриСозданииНаСервере(Отказ, СтандартнаяОбработка)
Объект.ДобавитьРеквизит("ВременнаяСумма", Новый ОписаниеТипов("Число"));
Объект.ВременнаяСумма = 0;
КонецПроцедуры

3. Использование системных свойств в отчетах

Системные свойства помогают гибко настраивать отчеты без изменения их структуры:

Запрос.Текст =
"ВЫБРАТЬ
|  Справочник.Номенклатура.Ссылка КАК Ссылка,
|  Справочник.Номенклатура.Наименование КАК Наименование
|ИЗ
|  Справочник.Номенклатура КАК Справочник
|ГДЕ
|  Справочник.ПометкаУдаления = &ПоказыватьУдаленные";

Запрос.УстановитьПараметр("ПоказыватьУдаленные", Ложь);
Результат = Запрос.Выполнить();

4. Управление видимостью колонок в таблицах

Скрытие ненужных колонок в динамическом списке:

Для Каждого Колонка Из ЭлементыФормы.СписокНоменклатуры.Колонки Цикл Если Колонка.Имя = "Артикул" Тогда Колонка.Видимость = (ТекущийПользователь.ВидетьАртикулы = Истина); КонецЕсли;

КонецЦикла;

💡

Для оптимизации производительности избегайте частого изменения свойств элементов формы в циклах. Лучше группировать изменения и применять их пакетно.

Типичные ошибки при работе со свойствами

Даже опытные разработчики иногда сталкиваются с проблемами при работе со свойствами. Рассмотрим наиболее распространенные ошибки и способы их избежать.

⚠️ Внимание: При работе с динамическими свойствами в управляемых формах помните, что они не синхронизируются автоматически между клиентом и сервером. Их значения нужно передавать явно через параметры методов.

1. Ошибка "Свойство не обнаружено"

Чаще всего возникает при:

🔍 Опечатках в имени свойства
🔒 Попытке доступа к несуществующему динамическому свойству
📱 Работе в неподходящем контексте (например, обращение к серверному свойству из клиентского кода)

Решение: всегда проверяйте существование свойства перед обращением:

Если Объект.Свойство("НужноеСвойство") <> Неопределено Тогда
Значение = Объект.НужноеСвойство;
КонецЕсли;

2. Проблемы с типами данных

Попытка присвоить значение неверного типа приводит к ошибкам:

// Ошибка: нельзя присвоить строку числовому свойству

Объект.ЧисловоеСвойство = "Не число";

Решение: используйте приведение типов:

Объект.ЧисловоеСвойство = Число("123.45");

3. Неучет контекста выполнения

Некоторые свойства доступны только на сервере или только на клиенте. Например:

// Эта строка вызовет ошибку в тонком клиенте

ТекущаяДата = ТекущаяДатаСеанса(); // Только на сервере!

4. Утечки памяти при работе с динамическими свойствами

Чрезмерное использование динамических свойств может приводить к утечкам памяти, особенно в длительных сеансах.

⚠️ Внимание: В версиях платформы 1С:Предприятие 8.3.20 и выше механизм работы с динамическими свойствами был оптимизирован, но в старых версиях их рекомендуется удалять явно после использования: Объект.УдалитьРеквизит("ВременноеСвойство").

Расширенные возможности: свойства в запросах и отчетах

Свойства играют ключевую роль при построении сложных отчетов и работе с системой компоновки данных.

1. Использование свойств в языке запросов

В запросах можно обращаться к свойствам объектов через точку:

ВЫБРАТЬ Документ.Ссылка КАК Ссылка, Документ.Дата КАК Дата, Документ.Номер КАК Номер, Документ.Проводен КАК Проводен ИЗ Документ.ЗаказПокупателя КАК Документ ГДЕ

Документ.ПометкаУдаления = ЛОЖЬ

Особенно полезно использование системных свойств в отборах:

ГДЕ Справочник.ЭтоГруппа = ИСТИНА

И Справочник.ПолноеИмя ПОДОБНО "Группы%"

2. Свойства в системе компоновки данных

При настройке отчетов свойства используются для:

📊 Определения доступных полей
🔍 Настройки отборов
📈 Построения группировок
🎨 Оформления результатов

Пример настройки отчета с использованием свойств:

СхемаКомпоновкиДанных = Новый СхемаКомпоновкиДанных; Настройки = СхемаКомпоновкиДанных.НастройкиПоУмолчанию; // Добавляем поле по свойству объекта Поле = Настройки.Поля.Добавить("Наименование"); Поле.ПутьКДанным = "Справочник.Наименование"; // Настраиваем отбор по системному свойству ЭлементОтбора = Настройки.Отбор.Элементы.Добавить(Тип("ОтборКомпоновкиДанных")); ЭлементОтбора.ЛевоеЗначение = Новый ПолеКомпоновкиДанных("ПометкаУдаления"); ЭлементОтбора.ВидСравнения = ВидСравненияКомпоновкиДанных.Равно;

ЭлементОтбора.ПравоеЗначение = Ложь;

3. Динамическое формирование структуры отчета

Свойства позволяют гибко настраивать структуру отчета в зависимости от прав пользователя или других условий:

Если Пользователь.ИмеетРоль("Руководитель") Тогда
СхемаКомпоновкиДанных.Настройки.Поля.Добавить("Себестоимость").Видимость = Истина;
Иначе
СхемаКомпоновкиДанных.Настройки.Поля.НайтиПоИмени("Себестоимость").Видимость = Ложь;
КонецЕсли;

Оптимизация работы со свойствами

Эффективная работа со свойствами требует не только понимания их природы, но и знания приемов оптимизации.

1. Кэширование часто используемых свойств

Если свойство читается многократно, имеет смысл сохранить его значение в переменной:

// Вместо многократного обращения ТекущееНаименование = Объект.Наименование; // используем кэшированное значение Сообщить(ТекущееНаименование);

Сообщить(ТекущееНаименование); // Без повторного обращения к свойству

2. Массовое изменение свойств

При изменении нескольких свойств одного объекта лучше группировать операции:

Элемент = ЭлементыФормы.МояКнопка;
Элемент.Видимость = Истина;
Элемент.ЦветФона = ВебЦвета.Зеленый;
Элемент.ТолькоПросмотр = Ложь;

Это уменьшает количество обращений к объекту и улучшает производительность.

3. Использование коллекций свойств

Для сложных объектов удобно работать с коллекцией Свойства:

СвойстваОбъекта = Объект.Свойства; Для Каждого Св Из СвойстваОбъекта Цикл Если Св.Имя = "НужноеСвойство" Тогда // Обработка КонецЕсли;

КонецЦикла;

4. Оптимизация работы с динамическими свойствами

При интенсивной работе с динамическими свойствами:

🧹 Удаляйте ненужные свойства после использования
🔄 Избегайте частого создания/удаления свойств в циклах
📦 Группируйте операции с динамическими свойствами

⚠️ Внимание: В тонком клиенте и веб-клиенте работа с динамическими свойствами может быть менее эффективна, чем на толстом клиенте или сервере. Для критичных по производительности операций рассматривайте альтернативные подходы.

FAQ: Частые вопросы о свойствах в 1С

Можно ли создать свойство, которое будет автоматически рассчитываться?

Да, для этого есть несколько подходов:

Использовать вычисляемые поля в запросах
Создать виртуальные таблицы с расчетными колонками
Реализовать обработчик события (например, ПриИзменении) для динамического расчета
Использовать механизм подчиненных объектов для сложных расчетов

Пример с обработчиком:

Процедура ПриИзмененииЦены(Элемент) ЭлементыФормы.Сумма.Значение = ЭлементыФормы.Цена.Значение * ЭлементыФормы.Количество.Значение;

КонецПроцедуры

Как получить список всех свойств объекта, включая скрытые?

Для получения полного списка свойств, включая системные, можно использовать механизм рефлексии:

Процедура ПоказатьВсеСвойства(Объект)
Для Каждого ИмяСвойства Из Объект.Метаданные().Свойства Цикл
Попытка
Сообщить(ИмяСвойства.Имя + ": " + Объект[ИмяСвойства.Имя]);
Исключение
Сообщить(ИмяСвойства.Имя + ": [недоступно для чтения]");
КонецПопытки;
КонецЦикла;
КонецПроцедуры

Обратите внимание, что доступ к некоторым системным свойствам может быть ограничен.

Почему при изменении свойства на форме изменения не применяются?

Это типичная проблема при работе с управляемыми формами. Причины могут быть следующими:

🔄 Изменения сделаны на клиенте, но не синхронизированы с сервером
🔒 Свойство заблокировано для изменения в текущем контексте
📥 Изменения сделаны в неверном потоке (например, из фонового задания)
🖥️ Форма работает в режиме "только просмотр"

Решение: используйте явную синхронизацию или проверяйте контекст выполнения.

Можно ли сделать свойство "только для чтения" программно?

Да, для этого есть несколько способов:

Использовать обработчик записи:

Процедура ПриЗаписи(Отказ)
Если Изменено("ЗащищенноеСвойство") Тогда
Отказ = Истина;
Сообщить("Изменение этого свойства запрещено!");
КонецЕсли;
КонецПроцедуры

Для элементов формы установить ТолькоПросмотр = Истина
Использовать роли и права доступа на уровне конфигурации

Как передать свойство объекта в другой модуль?

Есть несколько подходов в зависимости от контекста:

📤 Через параметры метода (наиболее безопасный способ):

Процедура ОбработатьДанные(ЗначениеСвойства) // Код обработки КонецПроцедуры // Вызов

ОбработатьДанные(Объект.НужноеСвойство);

🔄 Через глобальные переменные (не рекомендуется для сложных объектов)

📋 Через структуру параметров:

Параметры = Новый Структура;
Параметры.Вставить("Свойство1", Объект.Свойство1);
Параметры.Вставить("Свойство2", Объект.Свойство2);
ОбработатьДанные(Параметры);

Для передачи между клиентом и сервером используйте параметры методов с явным указанием направления.

Свойства в 1С: полное руководство для программистов