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

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

Многие пользователи сталкиваются с проблемой: стандартные документы (например, Заказ клиента в УТ 11 или Акт выполненных работ в БП 3.0) не содержат нужных полей. Вместо того чтобы дорабатывать конфигурацию (что чревато проблемами при обновлениях), можно использовать механизм дополнительных листов. Это безопаснее, чем изменение метаданных, и гибче, чем внешние обработки.

В этой статье разберём 5 рабочих способов создания доплистов — от простейших (через пользовательский интерфейс) до программных (с использованием 1С:EnterpriseScript). Особый акцент сделаем на типичные ошибки, из-за которых листы "исчезают" после обновлений или не сохраняют данные.

1. Что такое дополнительный лист в 1С и зачем он нужен

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

Основные сценарии использования:

• 📄 Добавление нестандартных реквизитов к документам (например, поле "Комментарий логиста" к заказу клиента).
• 📊 Хранение вспомогательных данных, которые не предусмотрены типовыми конфигурациями (например, фотографии товара в карточке номенклатуры).
• 🔄 Интеграция с внешними системами, когда нужно временно сохранить данные из API (например, трек-номера доставки из транспортной компании).
• 📈 Расширение отчетов без модификации СКД (например, добавление колонки "Прибыльность" в отчет "Продажи").

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

2. Способ 1: Создание доплиста через пользовательский интерфейс (без программирования)

Самый простой метод — использовать встроенный функционал 1С:Предприятия 8.3. Он доступен в большинстве типовых конфигураций (УТ, БП, ЗУП, ERP) и не требует прав администратора.

Пошаговая инструкция:

1. Откройте документ или справочник, к которому нужно добавить доплист (например, Документы → Заказы клиентов).
2. В форме документа найдите кнопку Ещё → Дополнительные листы (в некоторых конфигурациях она может называться Расширения или Доп. реквизиты).
3. Нажмите Создать новый лист и заполните поля:
   • 📌 Название листа — например, "Логистика" или "Данные для ОЗОН".
   • 📝 Тип данных — выберите, будет это простой реквизит, табличная часть или даже целый документ.
   • 🔒 Права доступа — укажите, кто может просматривать/редактировать лист (по умолчанию — все пользователи).

После этого в карточке документа появится новая вкладка с вашим доплистом. Туда можно добавлять реквизиты через контекстное меню (Добавить реквизит).

⚠️ Внимание: В некоторых конфигурациях (например, 1С:Розница 2.3) интерфейс создания доплистов может отличаться. Если кнопки Дополнительные листы нет — проверьте, включена ли соответствующая функциональность в настройках программы (Администрирование → Настройки программы → Дополнительные возможности).

3. Способ 2: Дополнительные реквизиты и сведения (альтернатива доплистам)

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

Отличия от доплистов:

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

1. Перейдите в Администрирование → Дополнительные реквизиты и сведения.
2. Выберите объект (например, Документы.ЗаказКлиента).
3. Нажмите Создать и заполните:
   • 🏷️ Название — например, "Номер трек-кода".
   • 📏 Тип значения — строка, число, дата и т.д.
   • 🔍 Где отображать — в форме списка, форме элемента или в обоих.

4. Способ 3: Программное создание доплиста (для разработчиков)

Если вам нужно автоматизировать создание доплистов (например, для массового развертывания на нескольких базах), можно использовать встроенный язык 1С:EnterpriseScript. Этот метод требует прав на изменение конфигурации, но даёт максимальную гибкость.

Пример кода для создания доплиста к документу ЗаказКлиента:

// Получаем ссылку на метаданные доплистов
ДопЛисты = Метаданные.ДополнительныеЛисты;

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

// Добавляем реквизиты в доплист
Реквизиты = НовыйДопЛист.Реквизиты;
НовыйРеквизит1 = Реквизиты.Добавить();
НовыйРеквизит1.Наименование = "НомерТрекКода";
НовыйРеквизит1.Тип = Тип("Строка");
НовыйРеквизит1.Длина = 50;

НовыйРеквизит2 = Реквизиты.Добавить();
НовыйРеквизит2.Наименование = "ДатаОтгрузки";
НовыйРеквизит2.Тип = Тип("Дата");

// Сохраняем изменения
НовыйДопЛист.Записать();

Этот код создаст доплист с двумя реквизитами: строковым полем для трек-номера и полем даты. Чтобы выполнить его:

1. Откройте 1С:Предприятие в режиме Конфигуратор.
2. Перейдите в Файл → Новый → Обработка.
3. Вставьте код в модуль обработки и выполните его (F5).

⚠️ Внимание: При программном создании доплистов убедитесь, что у вас есть резервная копия базы. Ошибки в коде могут привести к повреждению метаданных, особенно если вы работаете с системными объектами (например, ПланВидовХарактеристик).

5. Способ 4: Использование расширений конфигурации

Если вы работаете в 1С:Предприятие 8.3.14+, самый безопасный способ добавить доплист — использовать расширения конфигурации. Это позволяет модифицировать типовую конфигурацию без её изменения, что критично для обновляемости.

Алгоритм действий:

1. Откройте конфигуратор и перейдите в Конфигурация → Расширения.
2. Создайте новое расширение (Добавить → Новое расширение) и дайте ему имя (например, "ДопЛистыДляЗаказов").
3. В дереве расширения найдите раздел ДополнительныеЛисты и добавьте новый элемент.
4. Настройте параметры доплиста (аналогично способу 1, но в визуальном редакторе).
5. Сохраните расширение и обновите конфигурацию базы данных (Конфигурация → Обновить конфигурацию базы данных).

Преимущества этого метода:

• 🔄 Совместимость с обновлениями — расширения не блокируют установку новых версий конфигурации.
• 🛡️ Безопасность — ошибки в расширении не ломают основную конфигурацию.
• 🔧 Гибкость — можно отключить расширение в любой момент без потери данных.
Что делать, если расширение конфликтует с обновлением?

Если после обновления конфигурации расширение перестало работать, проверьте журнал конфликтов (Конфигурация → Поддержка → Журнал изменений). Чаще всего проблема решается повторной публикацией расширения или небольшой корректировкой кода.

6. Способ 5: Внешние обработки для работы с доплистами

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

• 📥 Импортировать данные в доплисты из Excel, JSON или XML.
• 📤 Экспортировать данные из доплистов в отчеты.
• 🔄 Синхронизировать доплисты с другими системами (например, с Bitrix24 или МойСклад).

Пример обработки для заполнения доплиста данными из файла Excel:

// Подключаем библиотеку для работы с Excel
ПодключитьВнешнююКомпоненту("C:\Program Files\1Cv8\bin\V8Excel.dll");
Excel = Новый COMОбъект("Excel.Application");

// Открываем файл
Книга = Excel.Workbooks.Open("C:\Temp\ТрекНомера.xlsx");
Лист = Книга.Worksheets(1);

// Получаем данные из первого столбца
Данные = Лист.UsedRange.Value;

// Подключаемся к доплисту документа
ДопЛист = Документы.ЗаказКлиента.ДополнительныеЛисты.НайтиПоНаименованию("ЛогистическаяИнформация");

// Заполняем реквизиты доплиста
Для Каждого Строка Из Данные Цикл
Если Строка[1] <> Неопределено Тогда
НовыйЗаказ = Документы.ЗаказКлиента.СоздатьДокумент();
НовыйЗаказ.Номер = Строка[1];
НовыйЗаказ.ДопЛист.НомерТрекКода = Строка[2];
НовыйЗаказ.Записать();
КонецЕсли;
КонецЦикла;

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

• 📁 На Инфостарт (раздел "Обработки для 1С").
• 📁 В каталоге 1С:ИТС (требуется подписка).
• 📁 В сообществах разработчиков (например, на GitHub по запросу "1C additional sheets").

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

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

Ещё одна частая проблема — дублирование доплистов. Это происходит, если один и тот же лист создаётся несколько раз (например, при повторном запуске обработки). Чтобы избежать дублей, перед созданием доплиста проверяйте его существование:

Если НЕ ДопЛисты.НайтиПоНаименованию("ЛогистическаяИнформация") Тогда
// Код создания доплиста
КонецЕсли;

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

8. Как перенести доплисты между базами

Если вам нужно скопировать доплисты из одной базы 1С в другую (например, с тестового сервера на рабочий), есть несколько способов:

Способ 1: Через выгрузку/загрузку конфигурации

1. В исходной базе откройте конфигуратор и выгрузите конфигурацию (Файл → Выгрузить конфигурацию).
2. В целевой базе загрузите конфигурацию (Файл → Загрузить конфигурацию) и выберите опцию Объединить с существующей.
3. В окне сравнения отметьте только доплисты и нажмите Выполнить.

Способ 2: Через XML-файл (для расширений)

Если доплисты созданы в расширении:

1. В исходной базе экспортируйте расширение (Конфигурация → Расширения → Экспортировать).
2. В целевой базе импортируйте файл расширения (Конфигурация → Расширения → Импортировать).
3. Опубликуйте расширение и обновите конфигурацию.

Способ 3: Через обработку переноса

Для массового переноса данных доплистов (не только структуры, но и содержимого) можно использовать обработку типа "ВыгрузкаЗагрузкаДанныхXML":

// Пример кода для выгрузки доплистов в XML
ПроцессорXDTO = Новый ПроцессорXDTO;
СериализаторXDTO = Новый СериализаторXDTO(ПроцессорXDTO);
ЗаписьXML = Новый ЗаписьXML;
ЗаписьXML.ОткрытьФайл("C:\Temp\ДопЛисты.xml");

Для Каждого ДопЛист Из Метаданные.ДополнительныеЛисты Цикл
СериализаторXDTO.ЗаписатьXML(ЗаписьXML, ДопЛист);
КонецЦикла;

Для загрузки используйте обратный процесс с ЧтениеXML и ДесериализаторXDTO.

FAQ: Частые вопросы о доплистах в 1С

Процедура ПередЗаписью(Отказ, РежимЗаписи)
Если НЕ ЗначениеЗаполнено(ДопЛисты.ЛогистическаяИнформация.НомерТрекКода) Тогда
Сообщить("Не заполнен номер трек-кода!", СтатусСообщения.Важное);
Отказ = Истина;
КонецЕсли;
КонецПроцедуры

Файл = Новый Файл(ПутьКФайлу);
ДанныеФайла = Новый ДвоичныеДанные(Файл.Прочитать());
ДопЛист.ФайлСкана = Новый ХранилищеЗначения(ДанныеФайла);

Данные = ДопЛист.ФайлСкана.Получить();
Данные.Записать("C:\Temp\Скан.docx");