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

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

В этой статье разберём программные методы заполнения дополнительных реквизитов для различных объектов 1С: справочников, документов, регистров сведений и наборов записей. Особое внимание уделим нюансам работы с динамическими списками, массовым операциям и обменом данными через REST API и COM-соединение. Приведём готовые примеры кода на встроенном языке и покажем, как избежать типичных ошибок при работе с метаданными.

Материал будет полезен как начинающим разработчикам 1С, так и опытным специалистам, которые хотят оптимизировать процессы заполнения дополнительных данных в крупных базах. Все примеры протестированы на платформе 1С:Предприятие 8.3 (актуальные релизы), но применимы и к более ранним версиям с учётом синтаксических особенностей.

1. Основы работы с дополнительными реквизитами в 1С

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

Ключевые особенности дополнительных реквизитов:

• 🔹 Гибкость: можно создавать реквизиты любых типов (строка, число, дата, ссылка, булево и др.).
• 🔹 Многоуровневость: поддерживаются как простые реквизиты, так и сложные (составные типы, перечисления).
• 🔹 Наследование: реквизиты могут наследоваться в иерархических справочниках.
• 🔹 Контроль доступа: права на чтение/запись настраиваются через ролевой механизм.

Чтобы программно работать с дополнительными реквизитами, необходимо понимать их структуру в метаданных. Например, для справочника Номенклатура дополнительные реквизиты хранятся в объекте Справочник.Номенклатура.ДополнительныеРеквизиты, который является коллекцией пар "имя-значение". Доступ к ним осуществляется через методы Получить() и Установить().

2. Заполнение дополнительных реквизитов для справочников

Справочники — наиболее распространённый объект для хранения дополнительных реквизитов. Рассмотрим два основных сценария: заполнение для одиночного элемента и массовое обновление через запрос.

Для заполнения реквизита у конкретного элемента справочника используйте следующий код:

ЭлементСправочника = Справочники.Номенклатура.НайтиПоНаименованию("Ноутбук Dell XPS 15");
Если Не ЭлементСправочника.Пустая() Тогда
ДопРеквизиты = ЭлементСправочника.ДополнительныеРеквизиты;
ДопРеквизиты.Установить("ГарантийныйСрок", 36); // Число (месяцев)
ДопРеквизиты.Установить("СерийныйНомер", "XPS15-2023-ABC123"); // Строка
ЭлементСправочника.Записать();
КонецЕсли;

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

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

РезультатЗапроса = Запрос.Выполнить();
Выборка = РезультатЗапроса.Выбрать();

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

Создать резервную копию базы|Проверить права доступа|Ограничить выборку по условиям|Тестировать на копии данных|Отслеживать прогресс выполнения-->

Важно! При массовых операциях всегда используйте НачатьТранзакцию() и ЗафиксироватьТранзакцию(), чтобы избежать блокировок:

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

⚠️ Внимание: При работе с большими справочниками (100 000+ элементов) массовое обновление через объектную модель может занять часы. В таких случаях рассмотрите вариант выгрузки данных в Excel через ЗаписьXML, редактирования и обратной загрузки.

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

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

Пример заполнения реквизита в шапке документа РеализацияТоваровУслуг:

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

Для работы с табличной частью (например, Товары) потребуется цикл по строкам:

Документ = Документы.РеализацияТоваровУслуг.НайтиПоНомеру("РТ-000123");
Для Каждого СтрокаТоваров Из Документ.Товары Цикл
ДопРеквизитыСтроки = СтрокаТоваров.ДополнительныеРеквизиты;
ДопРеквизитыСтроки.Установить("ПроцентСкидки", 10);
КонецЦикла;
Документ.Записать();

Особенности работы с документами:

• 📌 Дополнительные реквизиты в табличных частях не индексируются — это может замедлить отчёты, использующие эти данные.
• 📌 При проведении документа реквизиты табличных частей не копируются в регистры накопления автоматически.
• 📌 Для хранения сложных данных (например, JSON-структур) используйте реквизит типа Строка с неограниченной длиной.

4. Программное заполнение через обмен данными (REST API, COM)

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

1. REST API (для облачных и локальных решений с published-веб-сервисами).
2. COM-соединение (для интеграции с Excel, Python, другими Windows-приложениями).
3. Файловый обмен (через XML, JSON, CSV).

Пример заполнения дополнительных реквизитов через REST API (на стороне клиента):

// JavaScript (fetch API)
const response = await fetch("http://1c-server/hs/exchange/nom", {
method: "POST",
headers: { "Content-Type": "application/json" },
body: JSON.stringify({
"ref": "7a3b1c2d-...", // Ссылка на элемент справочника
"customFields": {
"Цвет": "Чёрный",
"Вес": 1.25
}
})
});

На стороне 1С обработчик веб-сервиса может выглядеть так:

Процедура ОбработатьЗапрос(Запрос) Экспорт
Данные = JSON.Прочитать(Запрос.ТекстПотока);
Ссылка = Данные.ref;
Элемент = Ссылка.ПолучитьОбъект();

Для Каждого Ключ Из Данные.customFields Цикл
Элемент.ДополнительныеРеквизиты.Установить(Ключ.Ключ, Ключ.Значение);
КонецЦикла;

Элемент.Записать();
КонецПроцедуры

Для COM-соединения (например, из Python) используйте библиотеку pywin32:

import win32com.client
v8 = win32com.client.Dispatch("V83.ComConnector")
conn = v8.Connect("File=ib_path;Usr=admin;Pwd=123")
nom = conn.Sправочники.Номенклатура.НайтиПоНаименованию("Монитор Samsung")[0]
nom.ДополнительныеРеквизиты.Установить("Гарантия", 24)
nom.Записать()

⚠️ Внимание: При обмене данными через COM или REST всегда проверяйте права доступа пользователя, от имени которого выполняется соединение. Недостаточные права могут привести к молчаливым ошибкам без записи данных.

5. Использование дополнительных сведений (регистр сведений)

Дополнительные сведения — это расширение механизма дополнительных реквизитов, позволяющее хранить данные в регистре сведений. Они полезны, когда нужно:

• 📊 Хранить историю изменений реквизитов (например, предыдущие значения).
• 📊 Организовать сложные выборки по дополнительным данным.
• 📊 Интегрироваться с механизмом ПланыВидовХарактеристик.

Пример программного заполнения дополнительных сведений:

// Создаём запись в регистре сведений "ДополнительныеСведения"
Запись = РегистрыСведений.ДополнительныеСведения.СоздатьМенеджерЗаписи();
Запись.Объект = Справочники.Номенклатура.НайтиПоНаименованию("Клавиатура Logitech");
Запись.Характеристика = ПланыВидовХарактеристик.ДополнительныеРеквизитыИСведения.Цвет;
Запись.Значение = "Чёрный";
Запись.Период = ТекущаяДата();
Запись.Записать();

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

НаборЗаписей = РегистрыСведений.ДополнительныеСведения.СоздатьНаборЗаписей();
НаборЗаписей.Отбор.Объект.Установить(Справочники.Номенклатура.НайтиПоНаименованию("Мышь Razer"));
НаборЗаписей.Отбор.Характеристика.Установить(ПланыВидовХарактеристик.ДополнительныеРеквизитыИСведения.Вес);
НаборЗаписей.Прочитать();

Если НаборЗаписей.Количество() > 0 Тогда
Запись = НаборЗаписей[0];
Запись.Значение = 0.15; // Обновляем вес
НаборЗаписей.Записать();
КонецЕсли;

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

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

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

1. Ошибка "Реквизит не найден"

Причина: попытка установить значение для несуществующего реквизита. Всегда проверяйте наличие реквизита в плане видов характеристик:

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

2. Блокировки при массовых операциях

Решение: используйте пакетную запись с транзакциями и ограничивайте размер пакета (например, 1000 записей за транзакцию).

3. Потеря данных при обновлении конфигурации

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

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

Пример: попытка записать строку в реквизит типа Число. Используйте явное приведение типов:

Значение = "12.5";
ДопРеквизиты.Установить("Вес", Число(Значение)); // Явное преобразование

7. Оптимизация производительности

При работе с большими объёмами данных (десятки тысяч записей) стандартные методы объекта ДополнительныеРеквизиты могут работать медленно. Рассмотрим способы ускорения:

1. Прямые SQL-запросы

Для SQL-версии 1С можно использовать прямые запросы к таблицам _1Sacc (для дополнительных реквизитов) и _1SJOURN (для сведений). Пример:

Запрос = Новый Запрос;
Запрос.Текст =
"ВЫБРАТЬ
|   ДополнительныеРеквизитыОбъектов.Ссылка КАК Ссылка,
|   ДополнительныеРеквизитыОбъектов.Значение КАК Значение
|ИЗ
|   РегистрСведений.ДополнительныеРеквизитыОбъектов КАК ДополнительныеРеквизитыОбъектов
|ГДЕ
|   ДополнительныеРеквизитыОбъектов.Реквизит = &Реквизит";
Запрос.УстановитьПараметр("Реквизит", Справочники.ДополнительныеРеквизиты.НайтиПоНаименованию("Цвет"));

2. Выгрузка/загрузка через XML

Для файловой базы оптимально выгрузить данные в XML, обработать внешней утилитой и загрузить обратно:

// Выгрузка
ЗаписьXML = Новый ЗаписьXML;
ЗаписьXML.ОткрытьФайл("C:\temp\доп_реквизиты.xml");
XMLСериализатор = Новый XMLСериализатор();
XMLСериализатор.ЗаписатьXML(ЗаписьXML, ЭлементСправочника.ДополнительныеРеквизиты);
ЗаписьXML.Закрыть();

// Загрузка
ЧтениеXML = Новый ЧтениеXML;
ЧтениеXML.ОткрытьФайл("C:\temp\доп_реквизиты_обновл.xml");
Данные = XMLСериализатор.ПрочитатьXML(ЧтениеXML);
ЭлементСправочника.ДополнительныеРеквизиты.Загрузить(Данные);

3. Использование фоновых заданий

Для длительных операций (например, обновление 100 000 элементов) используйте ФоновоеЗадание:

ФоновоеЗадание = ФоновыеЗадания.СоздатьФоновоеЗадание(
"ОбновлениеДопРеквизитов",
Новый Структура("Параметр1, Параметр2"),
Истина // Высокий приоритет
);

FAQ: Частые вопросы по заполнению дополнительных реквизитов

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

НовыйРеквизит = ПланыВидовХарактеристик.ДополнительныеРеквизитыИСведения.СоздатьРеквизит();
НовыйРеквизит.Наименование = "НовыйРеквизит";
НовыйРеквизит.ТипЗначения = Новый ОписаниеТипов("Строка", Новый КвалификаторыСтроки(255));
НовыйРеквизит.Записать();

Таблица = Новый ТаблицаЗначений;
Таблица.Колонки.Добавить("Наименование");
Таблица.Колонки.Добавить("Цвет");

Выборка = Справочники.Номенклатура.Выбрать();
Пока Выборка.Следующий() Цикл
Строка = Таблица.Добавить();
Строка.Наименование = Выборка.Наименование;
Строка.Цвет = Выборка.ДополнительныеРеквизиты.Получить("Цвет");
КонецЦикла;

OneScriptExcel.ЭкспортироватьТаблицуВExcel(Таблица, "C:\temp\реквизиты.xlsx");

Запрос = Новый Запрос;
Запрос.Текст =
"ВЫБРАТЬ
|   ДополнительныеРеквизитыОбъектов.Ссылка КАК Ссылка
|ИЗ
|   РегистрСведений.ДополнительныеРеквизитыОбъектов КАК ДополнительныеРеквизитыОбъектов
|ГДЕ
|   ДополнительныеРеквизитыОбъектов.Реквизит = &Реквизит";

Результат = Запрос.Выполнить();
Выборка = Результат.Выбрать();

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