Как перебрать реквизиты документа в 1С: от базовых методов до сложных сценариев

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

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

Материал будет полезен не только программистам 1С, но и аналитикам, которые хотят понять логику работы с метаданными, а также администраторам, настраивающим обмены данными между системами. Все примеры кода протестированы на актуальных версиях платформы 8.3.20+ и адаптированы для типовых конфигураций (Бухгалтерия 3.0, УТ 11, ЗУП 3.1).

1. Визуальный обход реквизитов: инструменты для пользователей

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

Самый простой способ — использовать конфигуратор в режиме "1С:Предприятие". Откройте любой документ (например, РеализацияТоваровУслуг) и вызовите контекстное меню правой кнопкой мыши. Выберите пункт "Все действия" → "Изменить форму". В открывшемся окне редактора формы вы увидите дерево реквизитов, сгруппированных по вкладкам. Здесь можно:

• 📌 Просмотреть полный список реквизитов шапки и табличных частей
• 🔍 Увидеть типы данных (строка, число, справочник и т.д.)
• 📝 Скопировать имена реквизитов для дальнейшего использования в коде
• 🔄 Сравнить структуру с другими документами (через "Сравнить с...")

Для более глубокого анализа подходит отчет "Структура метаданных" (доступен в конфигураторе через Отчеты → Стандартные отчеты). Он позволяет экспортировать в Excel полный перечень реквизитов с их свойствами, что удобно для документации или аудита конфигурации. Обратите внимание: в типовых решениях некоторые реквизиты могут быть скрыты условиями видимости — их не будет видно в интерфейсе, но они присутствуют в метаданных.

2. Перебор реквизитов шапки документа программно

Когда визуальных инструментов недостаточно, на помощь приходит встроенный язык 1С. Для обхода реквизитов шапки документа используйте метод Метаданные() или коллекцию Реквизиты. Рассмотрим оба подхода на примере документа ПоступлениеТоваровУслуг.

Способ 1. Через коллекцию Реквизиты (простой, но ограниченный):

Док = Документы.ПоступлениеТоваровУслуг.СоздатьДокумент();
Для Каждого Реквизит Из Док.Реквизиты Цикл
Сообщить(Реквизит.Имя + " (" + ТипЗнч(Реквизит.Значение) + ")");
КонецЦикла;

Этот код выведет имена всех реквизитов шапки и их текущие типы. Однако у метода есть ограничение: он не показывает реквизиты, которые не заполнены (их значения равны Неопределено). Для полного обхода лучше использовать метаданные.

Способ 2. Через Метаданные() (полный обход):

МетаДанные = Документы.ПоступлениеТоваровУслуг.Метаданные();
Для Каждого Реквизит Из МетаДанные.Реквизиты Цикл
Сообщить(Реквизит.Имя + " (Тип: " + Реквизит.Тип.ИмяТипа + ")");
КонецЦикла;

Этот вариант гарантированно покажет все реквизиты шапки, включая скрытые и необязательные, независимо от их заполненности. Обратите внимание на свойство ИмяТипа — оно возвращает строковое представление типа данных ("СправочникСсылка.Контрагенты", "Число" и т.д.), что полезно для динамической обработки.

3. Работа с реквизитами табличных частей

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

Пример кода для обхода табличной части Товары в документе РеализацияТоваровУслуг:

Док = Документы.РеализацияТоваровУслуг.НайтиПоНомеру("РТ-000123");
ТаблицаТоваров = Док.Товары;

Для Каждого СтрокаТоваров Из ТаблицаТоваров Цикл
Для Каждого Реквизит Из СтрокаТоваров.Реквизиты Цикл
Сообщить("Строка " + СтрокаТоваров.НомерСтроки +
": " + Реквизит.Имя + " = " + Реквизит.Значение);
КонецЦикла;
КонецЦикла;

Ключевые моменты:

• 🔹 Табличные части — это коллекции объектов типа ДокументСтрока.<ИмяТаблицы>
• 🔹 Каждая строка имеет свой набор реквизитов (например, Номенклатура, Количество, Цена)
• 🔹 Для доступа к метаданным табличной части используйте: Док.Метаданные().ТабличныеЧасти.Товары.Реквизиты
• 🔹 В больших документах (1000+ строк) такой обход может тормозить — оптимизируйте через выборки

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

МетаТаблица = Док.Метаданные().ТабличныеЧасти.Товары;
Для Каждого Колонка Из МетаТаблица.Колонки Цикл
Сообщить(Колонка.Имя + " (" + Колонка.Тип.ИмяТипа + ")");
КонецЦикла;

4. Динамическое чтение и запись реквизитов по имени

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

Пример динамического чтения:

ИмяРеквизита = "Контрагент";
Если Док.Свойство(ИмяРеквизита, Тип("Неопределено")) <> Неопределено Тогда
Значение = Док[ИмяРеквизита]; // Альтернативный синтаксис: Док.Получить(ИмяРеквизита)
Сообщить(ИмяРеквизита + " = " + Значение);
КонецЕсли;

Для записи используйте оператор присваивания или метод Установить():

Док.Контрагент = Новый СправочникСсылка.Контрагенты(СсылкаНаКонтрагента);
// Или динамически:
Док.Установить("Контрагент", СсылкаНаКонтрагента);

Важные нюансы динамической работы:

5. Оптимизация перебора для больших объемов данных

При обработке тысяч документов или реквизитов стандартные циклы Для Каждого становятся узким местом. В таких случаях используйте альтернативные подходы, которые сокращают время выполнения в 5-10 раз.

Оптимизация 1. Замена циклов на запросы:

Если вам нужно проанализировать реквизиты по множеству документов, формируйте временные таблицы через запрос:

Запрос = Новый Запрос;
Запрос.Текст =
"ВЫБРАТЬ
|   РеализацияТоваровУслуг.Ссылка КАК Ссылка,
|   РеализацияТоваровУслуг.Контрагент КАК Контрагент,
|   РеализацияТоваровУслуг.Дата КАК Дата
|ИЗ
|   Документ.РеализацияТоваровУслуг КАК РеализацияТоваровУслуг";
Результат = Запрос.Выполнить();

Оптимизация 2. Кэширование метаданных:

Если вам нужно многократно обращаться к структуре документа, сохраните метаданные в переменную:

МетаДанныеДока = Документы.РеализацияТоваровУслуг.Метаданные();
// Далее используем МетаДанныеДока вместо повторных обращений

Оптимизация 3. Пакетная обработка:

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

НачатьТранзакцию();
Попытка
Для Каждого Док Из МассивДокументов Цикл
Док.Контрагент = НовыйКонтрагент;
Док.Записать();
КонецЦикла;
ЗафиксироватьТранзакцию();
Исключение
ОтменитьТранзакцию();
Сообщить(ОписаниеОшибки());
КонецПопытки;

Использовать запросы вместо циклов по документам|Кэшировать метаданные в переменные|Обрабатывать данные пакетами по 100-500 документов|Отключать проверку прав при массовых операциях (осторожно!)|Использовать фоновые задания для длительных процессов-->

6. Типичные ошибки и как их избежать

Даже опытные разработчики сталкиваются с проблемами при работе с реквизитами документов. Вот наиболее распространенные ошибки и способы их предотвращения:

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

Ошибка 1. Путаница между реквизитами шапки и табличных частей

Ситуация: вы пытаетесь получить доступ к реквизиту табличной части как к реквизиту шапки.

// Неверно:
Цена = Док.Цена; // Ошибка, если "Цена" - колонка табличной части "Товары"

// Правильно:
Цена = Док.Товары[0].Цена;

Ошибка 2. Игнорирование типов данных

При динамической записи значения в реквизит 1С не преобразует типы автоматически:

Док.Установить("Дата", "2023-12-31"); // Ошибка: ожидается тип "Дата", передан "Строка"
// Правильно:
Док.Дата = Дата(2023, 12, 31);

Ошибка 3. Работа с удаленными реквизитами

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

Если НЕ Док.Метаданные().Реквизиты.Найти("СтарыйРеквизит") = Неопределено Тогда
// Реквизит существует
КонецЕсли;

Ошибка 4. Забывают про реквизиты с составными типами

Реквизиты типа "СправочникСсылка.Любой" или "ДокументСсылка.Любой" требуют явной проверки типа перед использованием:

Если ТипЗнч(Док.СсылкаНаОбъект) = Тип("СправочникСсылка.Номенклатура") Тогда
// Обработка для номенклатуры
ИначеЕсли ТипЗнч(Док.СсылкаНаОбъект) = Тип("ДокументСсылка.ЗаказПокупателя") Тогда
// Обработка для документа
КонецЕсли;

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

Рассмотрим реальную задачу: в базе 10 000 документов ЗаказПокупателя, и нужно во всех них обновить реквизит Менеджер на нового сотрудника. Как сделать это эффективно?

Решение 1. Через запрос (рекомендуется для больших объемов):

Запрос = Новый Запрос;
Запрос.Текст =
"ВЫБРАТЬ
|   ЗаказПокупателя.Ссылка КАК Ссылка
|ИЗ
|   Документ.ЗаказПокупателя КАК ЗаказПокупателя";

Результат = Запрос.Выполнить();
НовыйМенеджер = Справочники.Сотрудники.НайтиПоНаименованию("Иванов И.И.");

НачатьТранзакцию();
Попытка
Выборка = Результат.Выбрать();
Пока Выборка.Следующий() Цикл
Док = Выборка.Ссылка.ПолучитьОбъект();
Док.Менеджер = НовыйМенеджер;
Док.Записать();
КонецЦикла;
ЗафиксироватьТранзакцию();
Исключение
ОтменитьТранзакцию();
Сообщить("Ошибка: " + ОписаниеОшибки());
КонецПопытки;

Решение 2. Через обработку объектов (для сложной логики):

Процедура ОбновитьМенеджера()
Запрос = Новый Запрос("ВЫБРАТЬ Ссылка ИЗ Документ.ЗаказПокупателя");
Результат = Запрос.Выполнить();
НовыйМенеджер = Справочники.Сотрудники.НайтиПоНаименованию("Иванов И.И.");

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

Процедура ОбновитьМенеджераВДокументе(Док, Параметры) Экспорт
Док.Менеджер = Параметры.Менеджер;
КонецПроцедуры

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

FAQ: Ответы на частые вопросы

Процедура ПеребратьРеквизитыЛюбогоДокумента(Док)
Если ТипЗнч(Док) = Тип("ДокументОбъект.Любой") Тогда
Для Каждого Реквизит Из Док.Метаданные().Реквизиты Цикл
Сообщить(Реквизит.Имя + ": " + ?(Док.Свойство(Реквизит.Имя) <> Неопределено, Док[Реквизит.Имя], "не заполнен"));
КонецЦикла;
КонецЕсли;
КонецПроцедуры

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

Для Каждого Реквизит Из МетаДанные.Реквизиты Цикл
Строка = ТаблицаРезультат.Добавить();
Строка.ИмяРеквизита = Реквизит.Имя;
Строка.Тип = Реквизит.Тип.ИмяТипа;
Строка.Длина = ?(Реквизит.Тип.Длина > 0, Реквизит.Тип.Длина, "");
Строка.Обязательность = Реквизит.Обязательное;
КонецЦикла;

ЗаписьXML = Новый ЗаписьXML;
ЗаписьXML.ОткрытьФайл("C:\temp\СтруктураДокумента.xml");
ТаблицаРезультат.ЗаписатьXML(ЗаписьXML);
ЗаписьXML.Закрыть();

&НаСервере
Функция ПолучитьСтруктуруДокумента(ИмяДокумента)
Возврат Документы[ИмяДокумента].Метаданные().Реквизиты;
КонецФункции

&НаКлиенте
Процедура ПоказатьСтруктуру()
Структура = ВыполнитьНаСервере(Новый ОписаниеОперации("ПолучитьСтруктуруДокумента", ЭтотОбъект), "РеализацияТоваровУслуг");
Для Каждого Реквизит Из Структура Цикл
Сообщить(Реквизит.Имя);
КонецЦикла;
КонецПроцедуры