Переименование колонок в отчёте на СКД: где задать заголовок и что он перебивает

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

Если заголовок вы не задавали вообще, СКД сам сделает его из имени поля. Для СуммаДокумента получится «Сумма документа»: платформа разбивает имя по заглавным буквам. Для большинства отчётов этого хватает, пока имя в запросе осмысленное.

Откуда берётся заголовок колонки

Приоритет сверху вниз. Выигрывает тот уровень, который стоит выше:

Это объясняет типичную ситуацию: вы исправили заголовок в наборе данных, открыли отчёт, а там старое название. Значит, в сохранённом варианте у выбранного поля заголовок уже переопределён.

Заголовок в наборе данных: меняем один раз для всех вариантов

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

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

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

• Поле — имя, под которым оно известно внутри схемы. Меняется редко.
• Путь — путь к данным, по нему на поле ссылаются условия, отборы и выражения.
• Заголовок — то, что видит пользователь над колонкой.
• Выражение представления — как значение показывать в ячейке. К заголовку отношения не имеет, но его часто путают.

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

Алиас в запросе или заголовок в схеме

Можно переименовать колонку прямо в запросе через КАК:

ВЫБРАТЬ
    Номенклатура.Наименование КАК Товар,
    Продажи.СуммаОборот КАК Выручка

Тогда имя поля станет Товар, а автозаголовок — «Товар». Это быстро, но меняет имя поля. Если на него уже ссылаются настройки или код, они сломаются. Заголовок в схеме безопаснее: имя остаётся прежним, меняется только подпись.

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

Переименование в варианте отчёта: только для одного варианта

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

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

Заголовок попадёт только в этот вариант. Другие варианты того же отчёта останутся со старыми названиями.

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

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

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

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

Чтобы вернуть заголовок схемы, очистите поле «Заголовок» у выбранного поля в варианте.

Выбор программными средствами

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

Поле = КомпоновщикНастроек.Настройки.Выбор.Элементы.Добавить(
    Тип("ВыбранноеПолеКомпоновкиДанных"));
Поле.Поле = Новый ПолеКомпоновкиДанных("Выручка");
Поле.Заголовок = "Выручка за " + Формат(НачалоПериода, "ДФ='MMMM yyyy'");
Поле.Использование = Истина;

Что здесь важно:

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

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

Куда идти за правкой

Заголовки вычисляемых полей и ресурсов

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

Пример. Нужна колонка «Маржа, %» из выручки и себестоимости:

Без заголовка пользователь увидел бы «Маржа процент». Для внутренней колонки терпимо, для отчёта, который уходит руководителю, уже нет.

Ресурсы и итоги

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

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

Расшифровка: как она связана с заголовком

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

Как отключить расшифровку по ячейкам

Единой галочки «отключить расшифровку» в схеме нет. Способы зависят от того, где вы работаете:

1. В форме отчёта. В обработчике ОбработкаРасшифровки поля табличного документа выставьте СтандартнаяОбработка = Ложь. После этого двойной щелчок по ячейке ничего не откроет.
2. При формировании результата. Если вы выводите результат программно через процессор вывода, не передавайте ему данные расшифровки, и ячейки останутся без неё.

Параметры вывода: заголовок отчёта и подписи

Не путайте подпись колонки с заголовком всего отчёта. Это разные вещи.

• Заголовок отчёта — строка над таблицей. Он задаётся в параметрах вывода варианта и включается отдельным флагом показа заголовка.
• Подпись колонки — заголовок поля, о нём вся статья.

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

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

Частые ошибки и их причины

Пять сценариев ниже встречаются у тех, кто впервые меняет подписи.

Правка схемы не действует

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

В колонке появилось «Поле1» или техническое имя

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

Заголовок слишком длинный и колонка раздулась

Это вопрос оформления. Сократите подпись или перенесите единицу измерения в скобки в самом конце: «Выручка, руб.». Ширину задают в оформлении или настройками таблицы, а не заголовком.

Одинаковые подписи у разных колонок

Бывает, когда в отчёте два набора данных с похожими полями, например план и факт. Задавайте разные заголовки на уровне набора данных: «Сумма (план)» и «Сумма (факт)».

Заголовок пропал после обновления конфигурации

Если вы правили вариант типового отчёта, при обновлении платформа может подставить новую версию варианта. Сохраняйте собственный вариант под другим именем.

Как называть колонки, чтобы потом не переделывать

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

Несколько правил, которые экономят время при поддержке:

• Короткие подписи. До трёх-четырёх слов. Остальное уходит в подсказку или описание отчёта.
• Единицы измерения в конце, после запятой: «Остаток, шт.», «Сумма, руб.».
• Без служебных слов. Не нужно «Колонка выручки»: пользователь и так видит, что это колонка.
• Одинаковые термины. Если в одном отчёте «Контрагент», в другом не пишите «Клиент» для той же сущности.
• Стабильные имена полей. Имя поля и путь не меняйте, красоту наводите заголовком.
• Один источник правды. Правьте заголовок на уровне набора данных, а вариант трогайте, когда нужна именно локальная подпись.

Частые вопросы