К статье
Практический материал

Отчеты и Аналитика · 10 мин

1С СКД: как изменить заголовок колонки

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

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

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

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

Откуда СКД берет заголовок колонки по умолчанию

Когда вы добавляете поле в набор данных, СКД формирует заголовок автоматически. Для полей запроса заголовок совпадает с псевдонимом поля в запросе. Если псевдоним не задан, используется имя поля таблицы. Для полей, подтянутых из метаданных (например, через автозаполнение), платформа подставляет синоним реквизита объекта.

Важно понимать эту цепочку, потому что она объясняет большинство проблем: если вы поменяли заголовок на закладке «Настройки», но не трогали поле набора данных, при определенных условиях отчет может снова показать исходное имя. Правильная точка изменения зависит от того, где именно вы хотите зафиксировать заголовок — на уровне схемы или на уровне конкретного варианта настроек.

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

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

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

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

Порядок действий в конструкторе СКД
  1. 1
    Откройте отчет в конфигураторе и нажмите «Открыть схему компоновки данных»
  2. 2
    Перейдите на закладку «Наборы данных» и найдите поле в списке
  3. 3
    В колонке «Заголовок» введите новый текст, например «Сумма продаж» вместо «СуммаОборот»
  4. 4
    Сохраните схему, обновите конфигурацию при необходимости и сформируйте отчет
  5. 5
    Проверьте шапку таблицы в режиме предприятия

Способ 2: переопределить заголовок в настройках варианта отчета

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

Выделите нужное поле, вызовите контекстное меню и найдите пункт установки заголовка — в типовой форме настроек это «Установить заголовок...» или редактирование через свойства поля. Введенный текст будет действовать только в рамках текущего варианта настроек, не затрагивая другие варианты отчета.

Этот же механизм доступен пользователю в режиме предприятия: кнопка «Настройки» (или «Еще — Изменить вариант»), выбор поля и изменение заголовка. Это удобно, когда просят «просто переименовать колонку» без доработки конфигурации.

Способ 3: изменить заголовок программно

Программное изменение нужно, когда заголовок зависит от параметров: например, «Продажи за январь» или «Остатки на 01.03». Для этого в модуле отчета или формы отчета обращаются к настройкам компоновщика и меняют представление выбранного поля либо значение параметра, подставленное в заголовок.

Типовой прием — найти элемент выбранных полей по имени поля и установить свойство «Заголовок»:

Для Каждого Элемент Из КомпоновщикНастроек.Настройки.Выбор.Элементы Цикл

Если ТипЗнч(Элемент) = Тип("ВыбранноеПолеКомпоновкиДанных")

И Элемент.Поле = Новый ПолеКомпоновкиДанных("СуммаОборот") Тогда

Элемент.Заголовок = "Продажи за " + Формат(Период.ДатаНачала, "ДЛФ=D");

КонецЕсли;

КонецЦикла;

Для вложенных структур (группировок) перебор нужно делать рекурсивно, так как выбранные поля могут лежать внутри группировок, а не на верхнем уровне настроек. Альтернатива — использовать пользовательские поля с выражением представления, где заголовок задается один раз, а содержимое формируется формулой.

bsl
Элемент.Заголовок = "Себестоимость, руб.";

Особые случаи: ресурсы, группировки и итоги

Заголовки ресурсов в колонках группировок

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

Колонка «Итог» и объединенные шапки

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

Сравнение способов

Заголовок в наборе данных

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

Заголовок в настройках варианта

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

Программное изменение

Подходит для динамических заголовков с датами и параметрами. Ограничение: требует кода и аккуратного обхода группировок

Типичные ошибки и как их исправить

Чаще всего жалоба звучит так: «Поменял заголовок, а в отчете старое название». Причина почти всегда одна из трех: заголовок переопределен в настройках варианта, изменения сохранены в другой схеме (например, отчет использует основную схему, а правили внешнюю), либо пользовательский вариант отчета сохранен в базе и перекрывает изменения разработчика.

Вторая частая ситуация — заголовок меняется, но после перезапуска отчета возвращается. Это признак того, что в модуле формы есть программная установка настроек при открытии, которая затирает ручные правки. Проверьте обработчики ПриСозданииНаСервере и ПриЗагрузкеВариантаНаСервере.

Типичные ошибки
01
Менять псевдоним поля в запросе вместо заголовка — ломаются все ссылки на поле в настройках, вычисляемых полях и отборах
02
Править заголовок в наборе данных, когда он переопределен в варианте — в отчете ничего не меняется
03
Забыть про сохраненные пользовательские варианты — пользователи продолжают видеть старые шапки
04
Менять заголовок программно только на верхнем уровне выбранных полей — поля внутри группировок остаются со старыми названиями

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

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

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

Контрольные точки

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

Шапка отчета в основном варианте
Норма

Выводится новый заголовок колонки

Тревожный признак

Старое название — заголовок переопределен в настройках варианта

Другие варианты отчета
Норма

Заголовок соответствует ожиданиям для каждого варианта

Тревожный признак

В одном из вариантов старое название — правьте настройки этого варианта

Перезапуск отчета
Норма

Заголовок сохраняется после повторного открытия

Тревожный признак

Заголовок сбрасывается — ищите программную установку настроек в модуле формы

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

Можно ли изменить заголовок колонки без конфигуратора?

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

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

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

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

В свойстве заголовка можно использовать символ переноса строки. В конфигураторе перенос вводится через комбинацию Ctrl+Enter в многострочном поле ввода, программно — через Символы.ПС. Учтите, что высота строки шапки при этом увеличится, что влияет на внешний вид печатной формы.

Как изменить заголовок колонки, которая формируется группировкой по периодам?

Такие заголовки — это значения группировки, а не заголовки полей. Их меняют через формат поля периода на закладке «Наборы данных» (свойство оформления или выражение представления), либо через программную обработку при формировании. Свойство «Заголовок» поля здесь не сработает.

Ломается ли отчет, если переименовать псевдоним поля в запросе?

Да, это рискованная операция: псевдоним — это путь к данным, на который ссылаются настройки, отборы, вычисляемые поля и связи наборов. После переименования все эти ссылки нужно обновить вручную. Если цель — только поменять текст шапки, меняйте именно свойство «Заголовок», а не псевдоним.

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

Очистите свойство «Заголовок» у поля в настройках варианта или в наборе данных — платформа снова начнет использовать автоматически сформированное название (псевдоним поля или синоним метаданных). Для пользовательского варианта можно также воспользоваться сбросом настроек к стандартным.

Итог

Что важно запомнить

Заголовок колонки в СКД задается в свойстве «Заголовок» поля набора данных или переопределяется в настройках варианта, причем настройки имеют приоритет. Для динамических заголовков используется программная установка в модуле отчета. Не переименовывайте псевдоним поля ради смены шапки — это ломает ссылки на поле. После правок проверяйте все варианты отчета и сохраненные пользовательские настройки.