Как добавить пользовательские поля в отчет 1С: пошаговое руководство с примерами

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

В этой статье мы разберем три основных способа добавления пользовательских полей — через конфигуратор, с помощью расширений и программно (1C:Enterprise Script). Особое внимание уделим типичным ошибкам, например, когда поле видно в настройках отчета, но не выводится в результатах, или когда данные дублируются после изменения структуры. Также приведём актуальные примеры кода для 1С 8.3 (включая управляемые формы) и укажем на ключевые отличия от 1С 8.2.

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

1. Подготовка: какие данные можно вывести в отчет?

Прежде чем добавлять поля, определитесь с источником данных. В 1С пользовательские поля могут pullsя из:

• 📄 Реквизитов объектов — дополнительные атрибуты справочников, документов или регистров (например, поле "Комментарий менеджера" в документе "Заказ клиента").
• 🔄 Регистров сведений/накопления — данные из виртуальных таблиц (остатки, обороты, ресурсы).
• 🖥️ Внешних источников — SQL-запросы, HTTP-сервисы или файлы (требует дополнительной обработки).
• ⚙️ Вычисляемых полей — результаты формул или скриптов (например, "Сумма с НДС = Сумма * 1.2").

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

⚠️ Внимание: Поля с типом ХранилищеЗначения или ДвоичныеДанные не поддерживаются большинством стандартных отчетов 1С без доработок. Для их вывода потребуется создать пользовательскую обработку.

Также учитывайте права доступа. Если поле содержит конфиденциальные данные (например, зарплаты сотрудников), настройте роли так, чтобы оно было видно только уполномоченным пользователям. В противном случае информация может "просочиться" в общие отчеты.

2. Способ 1: Добавление полей через конфигуратор

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

Шаг 1. Открытие конфигуратора

Запустите 1С:Предприятие в режиме Конфигуратор (через меню запуска или командой 1cv8 /Config). Откройте нужный объект (например, справочник "Номенклатура" или документ "РеализацияТоваровУслуг").

Шаг 2. Создание реквизита

В дереве метаданных найдите раздел Реквизиты и добавьте новый элемент. Заполните свойства:

• 🏷️ Имя — латиницей, без пробелов (например, CustomField1).
• 📝 Синоним — отображаемое имя на русском (например, "Дополнительный комментарий").
• 🔢 Тип — выберите из списка (строка, число, дата, справочник и т.д.).
• 🔒 Длина/Точность — для строк и чисел (например, длина 100 символов для текста).

Пример для поля "Вес брутто" в справочнике "Номенклатура":

Имя: GrossWeight
Синоним: Вес брутто (кг)
Тип: Число
Длина: 10, Точность: 2

Шаг 3. Обновление конфигурации

После добавления реквизита сохраните конфигурацию (Ctrl+S) и обновите базу данных (Конфигурация → Обновить конфигурацию базы данных). Это создаст физическое поле в таблицах SQL.

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

Шаг 4. Добавление поля в отчет

Откройте нужный отчет в режиме 1С:Предприятие, перейдите в Настройки → Изменить вариант и добавьте новое поле в список выводимых колонок. Если поле не появляется в списке, проверьте:

• Правильно ли указан источник данных (например, таблица документов или справочника).
• Есть ли у пользователя права на чтение этого реквизита.
• Обновлена ли конфигурация базы данных.

Создан резервный файл конфигурации (.cf)

Поля добавлены в нужные объекты (не перепутаны справочники/документы)

Указаны корректные типы данных (например, не "Строка" вместо "Число")

Права доступа настроены для ролей пользователей-->

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

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

Шаг 1. Создание расширения

В режиме Конфигуратор выберите Файл → Новое расширение. Укажите имя (например, ДополнительныеПоляОтчетов) и сохраните.

Шаг 2. Добавление реквизита в расширение

В дереве расширения найдите раздел Объекты → Добавляемые реквизиты. Выберите целевой объект (например, документ "ПоступлениеТоваров") и добавьте новый реквизит, как в способе 1.

Особенность: в расширениях нельзя изменять системные реквизиты (например, Ссылка или ПометкаУдаления). Также некоторые отчеты могут игнорировать поля из расширений — это зависит от логики их построения.

Шаг 3. Подключение расширения

В основной конфигурации откройте Расширения и подключите созданный файл. После этого обновите базу данных и перезапустите 1С.

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

Критическая особенность: Если вы используете 1С:ERP или 1С:КА 2, проверьте совместимость расширений с механизмом "Функциональные опции". Некоторые поля могут не отображаться, если соответствующая опция отключена в настройках системы.

4. Способ 3: Программное добавление полей (1C:Enterprise Script)

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

Пример 1: Добавление вычисляемого поля в отчет

Предположим, вам нужно вывести в отчете "Ведомость по товарам" поле "Прибыльность" (разница между ценой продажи и себестоимостью). Для этого модифицируйте модуль отчета:

Процедура ПриКомпоновкеДанных(ДанныеКомпоновки, Отчет, КомпоновщикНастроек)
// Добавляем новое поле в набор данных
Поле = ДанныеКомпоновки.НаборыДанных.Элементы[0].Поля.Добавить();
Поле.Имя = "Прибыльность";
Поле.Заголовок = "Прибыльность (%)";
Поле.ТипЗначения = Новый Тип("Число");

// Заполняем поле данными
Для Каждого Строка Из ДанныеКомпоновки.Выборка() Цикл
Себестоимость = ПолучитьСебестоимость(Строка.Номенклатура);
Прибыльность = (Строка.Цена - Себестоимость) / Себестоимость * 100;
Строка.Прибыльность = Окр(Прибыльность, 2);
КонецЦикла;
КонецПроцедуры

Пример 2: Подключение внешнего источника данных

Если нужно вывести данные из SQL или HTTP, используйте Запрос или HTTPСоединение. Например, для подгрузки курса валют из ЦБ:

Функция ПолучитьКурсВалюты(КодВалюты)
URL = "https://www.cbr.ru/scripts/XML_daily.asp";
HTTP = Новый HTTPСоединение(URL);
Ответ = HTTP.Получить();
// Парсинг XML и возвращение курса
Возврат Курс; // Например, 90.5 для USD
КонецФункции

В отчете добавьте поле "КурсВалюты" и заполните его через обработчик ПриКомпоновкеДанных.

⚠️ Внимание: При работе с внешними источниками учитывайте тайм-ауты и ошибки сети. Добавьте обработку исключений, чтобы отчет не "падал" при отсутствии интернета:

Попытка
Курс = ПолучитьКурсВалюты("USD");
Исключение
Курс = 0;
ЗаписатьВЛог(ОписаниеОшибки());
КонецПопытки;

Типичные ошибки при программном добавлении

• 🐞 Поле не отображается — проверьте регистр имен (в 1С чувствителен к регистру).
• 🔄 Данные не обновляются — очистите кэш отчета (Сервис → Очистить кэш).
• 📉 Медленная работа — оптимизируйте запросы, избегайте вложенных циклов.

5. Настройка отображения и форматирования полей

Добавленное поле может отображаться некорректно: например, числа выводятся без разделителей, даты — в неудобном формате, или текст обрезается. Исправляем это в настройках отчета.

Форматирование чисел и дат

В режиме настройки отчета (Изменить вариант) выберите поле и настройте:

• 📊 Формат числа — количество десятичных знаков, разделитель тысяч.
• 📅 Формат даты — ДФ="dd.MM.yyyy" или ДЛФ="DD MMMM YYYY".
• 🖼️ Условное оформление — цвет фона или шрифта в зависимости от значения.

Пример формата для денежных сумм:

Число.Формат(Сумма, "ЧДЦ=2; ЧР= ; ЧН=не разбивать");

Группировка и сортировка

Чтобы поле участвовало в группировке, перетащите его в область "Строки" или "Колонки" в настройках компоновки. Для сортировки используйте кнопку Сортировка в заголовке колонки.

Если поле содержит справочник, настройте отображение его представления (название вместо кода). Для этого в свойствах поля укажите:

Поле.Представление = Новый ПредставлениеСправочника(Справочники.Номенклатура);

Скрытие пустых значений

Чтобы не выводить строки с пустыми пользовательскими полями, добавьте в запрос отчета условие:

ГДЕ НЕ CustomField1 = ЗНАЧЕНИЕ(Справочник.Номенклатура.ПустаяСсылка())

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

Используйте индексы для полей, по которым идет фильтрация или сортировка.

Перенесите сложные вычисления в виртуальные таблицы регистров.

Ограничьте период данных в настройках отчета (например, за последний месяц вместо "за все время").

Отключите ненужные поля в варианте отчета — это уменьшит объем выборки.

6. Типичные ошибки и их решения

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

Ошибка	Причина	Решение
Поле не появляется в списке доступных	Не обновлена конфигурация базы данных	Выполните Конфигурация → Обновить конфигурацию базы данных
Данные в поле не обновляются	Кэш отчета не очищен	Очистите кэш (Сервис → Очистить кэш) или перезапустите сеанс
Поле дублируется в отчете	Поле добавлено и в конфигураторе, и через расширение	Удалите дубликат в расширении или конфигурации
Ошибка "Поле не найдено"	Опечатка в имени поля или неверный регистр	Проверьте имя поля в метаданных и в коде отчета
Медленная работа отчета	Сложные вычисления в цикле ПриКомпоновкеДанных	Перенесите логику в запрос или используйте временные таблицы

Если поле добавлено корректно, но в отчете отображается #Неопределено, проверьте:

1. Есть ли данные в источнике (например, реквизит заполнен в документах).
2. Совпадают ли типы данных (например, не пытаетесь вывести число в поле типа строка).
3. Нет ли ошибок в коде заполнения поля (используйте Сообщить() для отладки).

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

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

Пользовательские поля могут значительно замедлить отчет, особенно если они:

• 🔄 Подгружают данные из внешних источников.
• 📊 Требуют сложных вычислений для каждой строки.
• 🗃️ Ссылаются на большие справочники или регистры.

Чтобы ускорить работу:

1. Используйте индексы для полей, по которым идет фильтрация или сортировка. В SQL-версии 1С индексы создаются автоматически для реквизитов с типом "Число", "Дата" и "Ссылка", но для строковых полей их нужно добавлять вручную:

ИНДЕКСИРОВАТЬ ПО CustomStringField

2. Переносите логику в запросы. Вместо вычислений в цикле ПриКомпоновкеДанных используйте конструкцию ВЫБРАТЬ ... ПОМЕСТИТЬ:

ВЫБРАТЬ
Товар,
(Цена - Себестоимость) / Себестоимость * 100 КАК Прибыльность
ПОМЕСТИТЬ ВТ_Прибыльность
ИЗ ...

3. Ограничивайте период данных. Например, вместо выборки за "все время" берите данные за последний год:

ГДЕ Дата МЕЖДУ &НачалоГода AND &КонецГода

Для отчетов с большим объемом данных (более 10 000 строк) рассмотрите возможность разбиения на части или использования фоновых заданий для формирования.

FAQ: Частые вопросы по пользовательским полям в 1С

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

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

Почему поле видно в настройках отчета, но не выводится в результатах?

Вероятные причины:

1. Поле не заполнено в источниках данных (проверьте заполненность реквизитов).
2. Неверно указан тип поля в настройках компоновки (например, строка вместо числа).
3. Отсутствуют права на чтение этого поля у текущего пользователя.

Проверьте также, не скрыто ли поле условием отображения в настройках отчета.

Как добавить поле с изображением в отчет?

Прямой вывод изображений в стандартные отчеты 1С не поддерживается. Альтернативные варианты:

• Выводите ссылку на файл (поле типа "Строка").
• Используйте внешнюю обработку с элементом "ПолеHTMLДокумента".
• Экспортируйте данные в Excel и вставляйте изображения там.

Для управляемых форм можно создать отдельную форму отчета с элементом "ПолеКартинки".

Как сделать поле доступным только для определенных ролей?

Настройте права в конфигураторе:

1. Откройте роль (например, "Администратор").
2. В разделе "Права на реквизиты" добавьте ваше поле и установите права (чтение/изменение).
3. Для других ролей оставьте права пустыми или запретите доступ.

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

Можно ли добавить пользовательское поле в отчет "Анализ субконто"?

Отчет "Анализ субконто" использует данные из планов счетов и регистров бухгалтерии, поэтому напрямую добавить поле нельзя. Альтернативы:

• Создайте собственный отчет на основе данных субконто с нужными полями.
• Используйте расширение для добавления реквизитов в план видов характеристик (ПВХ), если поле относится к субконто.
• Экспортируйте данные в Excel и доработайте там.