Атрибут структуры в 1С: что это и как с ним работать

Структура в 1С — это универсальная коллекция пар «ключ–значение», которая используется для передачи наборов данных между процедурами, хранения параметров и описания объектов без создания отдельного типа. Каждый элемент такой коллекции и называется атрибутом структуры: у него есть имя (ключ) и связанное с ним значение произвольного типа — число, строка, дата, ссылка на объект базы или даже другая структура.

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

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

Что такое структура и её атрибут простыми словами

Структура создаётся конструктором Новый Структура и представляет собой именованный список значений. Если провести аналогию, структура похожа на карточку с полями: название поля — это ключ (имя атрибута), а содержимое поля — значение атрибута. Например, структура «ПараметрыОтбора» может содержать атрибуты «Организация», «Период» и «Склад».

Ключ атрибута — это всегда строка, и она должна удовлетворять правилам именования переменных встроенного языка: начинаться с буквы или знака подчёркивания, не содержать пробелов и специальных символов. Значение же может быть любым: примитивный тип, ссылка, таблица значений, массив, другая структура.

Как создать структуру и задать атрибуты

Есть два основных способа задать атрибуты. Первый — перечислить их прямо в конструкторе: Новый Структура("Организация, Склад, Период"). В этом случае атрибуты создаются со значением Неопределено, а заполнить их можно позже через обращение по имени: Параметры.Склад = СкладОтгрузки;.

Второй способ — добавить атрибут в уже существующую структуру методом Вставить("ИмяАтрибута", Значение). Если атрибут с таким именем уже есть, метод просто заменит его значение — ошибки не возникнет. Это удобно, но одновременно опасно: опечатка в имени при вызове Вставить молча создаст новый атрибут, а старый останется незаполненным.

Параметры = Новый Структура("Организация, Склад");
Параметры.Организация = ТекущаяОрганизация;
Параметры.Склад = ОсновнойСклад;
Параметры.Вставить("Комментарий", "Срочная отгрузка");
Если Параметры.Свойство("Склад") Тогда
    // атрибут существует, можно работать со значением
КонецЕсли;

Как проверить наличие атрибута и прочитать его значение

Прямое обращение Структура.ИмяАтрибута работает только если атрибут гарантированно существует. Если его нет, выполнение кода прервётся с ошибкой «Поле объекта не обнаружено». Поэтому перед обращением к атрибуту, который мог не быть добавлен, используйте метод Свойство("Имя", Значение) — он вернёт Истина, если атрибут найден, и поместит значение во второй параметр.

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

1. 1
   Объявите переменную для значения, например ЗначениеСклада
2. 2
   Вызовите Параметры.Свойство("Склад", ЗначениеСклада)
3. 3
   Проверьте результат: если вернулось Ложь — атрибута нет, используйте значение по умолчанию
4. 4
   Если вернулось Истина — работайте с ЗначениеСклада, дополнительно проверив заполненность через ЗначениеЗаполнено()

Чем структура отличается от соответствия

Частый вопрос — когда использовать структуру, а когда соответствие. Ключевое различие в ключах: у структуры ключ — только строка-идентификатор с ограничениями на символы, у соответствия ключом может быть значение любого типа, включая ссылки и произвольные строки с пробелами. Зато к атрибутам структуры удобнее обращаться через точку, и структура лучше подходит для моделирования «объекта с полями».

Ограничения и особенности, о которых нужно помнить

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

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

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

Самая распространённая ошибка — опечатка в имени атрибута. Поскольку Вставить молча создаёт новый ключ, а обращение через точку падает только при чтении, такая ошибка может долго оставаться незамеченной. Вторая частая проблема — сравнение значения атрибута без проверки его существования и типа: например, сравнение Неопределено со строкой.

Как проверить результат работы кода

После формирования структуры полезно убедиться, что набор атрибутов соответствует ожиданиям. В отладчике структура раскрывается как список ключей и значений — сверьте имена и типы. Программно можно перебрать структуру циклом Для Каждого КлючИЗначение Из Структура Цикл и вывести или проверить каждый атрибут.

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