Что такое свойство в 1С:Предприятие и как с ним работать

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

Представьте любой объект конфигурации, будь то справочник «Номенклатура» или документ «Реализация товаров». У каждого из них есть набор фиксированных параметров: код, наименование, дата создания, автор. Именно эти параметры и называются свойствами. Они отличаются от методов тем, что свойства хранят данные, а методы выполняют действия над этими данными. Понимание этой разницы критически важно для написания эффективного кода на встроенном языке платформы.

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

Природа свойств в объектной модели 1С

Объектная модель платформы 1С:Предприятие построена на строгой иерархии, где каждый элемент обладает своим набором характеристик. Свойства в этом контексте делятся на две большие группы: системные (предопределенные) и пользовательские (реквизиты). Системные свойства присутствуют у объектов определенного типа всегда, независимо от желания разработчика. Например, у любого документа есть свойство Дата и свойство Номер.

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

⚠️ Внимание: Не путайте свойства объекта метаданных со свойствами формы. Свойство объекта данных (например, СправочникОбъект.Наименование) хранится в базе данных, а свойство элемента формы (ЭлементФормы.Видимость) существует только в памяти клиента во время сеанса и не сохраняется в таблице базы данных напрямую.

Важно понимать, что тип значения свойства определяется его объявлением. Если свойство объявлено как Число, вы не сможете записать в него строку без явного преобразования типов, что вызовет ошибку выполнения. Платформа строго следит за типизацией данных, что обеспечивает целостность информации в базе.

Синтаксис доступа и чтение значений

Основной механизм взаимодействия со свойствами в коде 1С — это точечная нотация. Вы обращаетесь к объекту, ставите точку и указываете имя свойства. Это наиболее читаемый и рекомендуемый способ работы. Рассмотрим пример получения данных из объекта справочника.

Предположим, у нас есть ссылка на элемент справочника «Контрагенты». Чтобы получить его наименование, мы используем следующее выражение:

НаименованиеКонтрагента = СсылкаНаКонтрагента.Наименование;

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

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

• 📌 Точечная нотация (Объект.Свойство) является основным и предпочтительным способом чтения данных.
• 📌 Чтение свойства не изменяет состояние объекта и не требует фиксации изменений.
• 📌 Тип возвращаемого значения должен соответствовать типу, объявленному в метаданных.

Если вы попытаетесь обратиться к несуществующему свойству, система выдаст ошибку «Свойство объекта не обнаружено». Это часто случается при опечатках в именах реквизитов или при попытке обратиться к свойству, доступному только для определенных видов объектов (например, свойство Цена есть у позиции документа, но нет у самого заголовка документа).

Запись данных и модификация свойств

Процесс записи значения в свойство выглядит синтаксически аналогично чтению, но имеет критические отличия в последствиях. Присваивание нового значения свойству меняет состояние объекта в оперативной памяти, но не сохраняет изменения в базе данных мгновенно. Для (сохранения) данных необходимо вызвать метод Записать.

Рассмотрим классический пример изменения реквизита документа:

ДокументОбъект = Документ.РеализацияТоваровУслуг.СоздатьДокумент;
ДокументОбъект.Комментарий ="Срочная отгрузка по запросу клиента";
ДокументОбъект.Записать;

Здесь мы создали новый объект, изменили значение свойства Комментарий и только затем зафиксировали изменения. Если бы строка с методом Записать отсутствовала, все изменения были бы утеряны после завершения процедуры или выхода из системы.

⚠️ Внимание: Некоторые свойства являются только для чтения (Read-only). Попытка записать в них значение вызовет ошибку выполнения. К таким свойствам относятся, например, Ссылка у большинства объектов или ЭтоНовый перед записью объекта. Всегда проверяйте доступность свойства на запись в синтаксическом помощнике.

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

Системные свойства против Реквизитов

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

Ниже приведена таблица, сравнивающая ключевые аспекты этих двух видов свойств:

Характеристика	Системное свойство	Реквизит (Пользовательское)
Наличие	Гарантировано платформой	Зависит от конфигурации
Имя	Фиксированное (напр. Дата, Проведен)	Задается разработчиком
Изменение типа	Невозможно	Возможно в конфигураторе
Удаление	Невозможно	Возможно (с потерей данных)

Системные свойства часто управляют жизненным циклом объекта. Например, свойство ПометкаУдаления указывает на то, что объект помечен на удаление, но еще не удален физически. Свойство Записан говорит о том, был ли объект сохранен в базу данных хотя бы один раз.

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

Можно ли переопределить системное свойство?

Нет, системные свойства защищены от переопределения. Однако вы можете создать реквизит с таким же именем (если платформа позволяет), но обращаясь к нему, вы будете работать именно с вашим реквизитом, а не с системным свойством, что может привести к путанице. Не рекомендуется дублировать имена системных свойств.

Работа со свойствами в запросах

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

Синтаксис обращения к свойствам в запросе немного отличается. Мы указываем имя таблицы (источника данных) и через точку имя свойства. Например:

ВЫБРАТЬ
Номенклатура.Ссылка,
Номенклатура.Наименование,
Номенклатура.Родитель
ИЗ
Справочник.Номенклатура КАК Номенклатура

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

• 🔍 В запросах свойства используются для формирования полей результата выборки.
• 🔍 Условия отбора (ГДЕ) также строятся на сравнении значений свойств.
• 🔍 Группировка и упорядочивание (ГРУППИРОВАТЬ ПО, УПОРЯДОЧИТЬ ПО) выполняются по свойствам.

Существует нюанс с составными типами. Если свойство имеет составной тип (например, СправочникСсылка.Контрагенты ИЛИ СправочникСсылка.ФизическиеЛица), в запросе могут потребоваться специальные конструкции для корректной обработки или приведения типов, особенно при использовании соединений (СОЕДИНЕНИЕ).

Динамический доступ и метапрограммирование

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

Основным инструментом здесь является функция Свойство. Она принимает объект и имя свойства в виде строки, возвращая значение этого свойства. Пример использования:

ИмяРеквизита ="Артикул";
Если Объект.Свойство(ИмяРеквизита, ЗначениеРеквизита) Тогда
Сообщить("Артикул:" + ЗначениеРеквизита);
КонецЕсли;

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

⚠️ Внимание: При использовании динамического доступа вы теряете поддержку синтаксического помощника и автоподстановку в редакторе кода. Ошибки в написании имен свойств будут обнаружены только при запуске программы, а не на этапе компиляции модуля.

Также для анализа структуры объекта можно использовать коллекцию Свойства, которая возвращает список всех доступных свойств объекта. Это полезно для отладки или для создания универсальных механизмов копирования данных между объектами схожей структуры.

Часто задаваемые вопросы (FAQ)

В чем разница между свойством и параметром в 1С?

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

Можно ли сделать свойство недоступным для записи программно?

Напрямую изменить флаг «Только чтение» для свойства в рантайме нельзя, это настройка метаданных. Однако вы можете контролировать запись через права доступа (роли) или логически проверять условия перед присваиванием значения в коде. Для элементов форм свойство Доступность можно менять динамически.

Что будет, если обратиться к свойству неинициализированного объекта?

Если вы создали объект через СоздатьДокумент или СоздатьЭлемент, все его свойства инициализируются значениями по умолчанию (пустая строка, ноль, пустая дата). Ошибки не возникнет. Ошибка возникнет только если вы пытаетесь обратиться к свойству объекта, который не был создан или равен Неопределено.

Как узнать тип значения свойства в момент выполнения?

Для этого используется встроенная функция ТипЗнч. Пример: ТипЗнч(ДокументОбъект.Сумма) вернет тип Число. Это полезно при работе с реквизитами типа «Любой» или при динамическом анализе объектов.

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

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