Урок 5. Вывод: макет и Excel

Как в Spec1C указать макет печати, выгрузку в Excel и блок view — и что из этого реально появляется в коде собранного файла.

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

Цель урока#

После урока вы сможете:

• записать layout и format так, чтобы они попали в модель;
• предсказать, что появится в коде при target: ordinary и target: managed;
• понять, что доделывать в Конфигураторе.

Что нужно знать#

• target и его влияние на код — Урок 1. Каркас: spec1c и report.
• Источники данных — Урок 2. Источники данных и поля: без источника код вывода не генерируется.

Объяснение#

Две строки вывода:

layout: maket "<ИмяМакета>"
format: xlsx

• layout: maket "Имя" — имя макета внутри обработки. Имя — в двойных кавычках.
• format: xlsx — пожелание выгрузки в Excel, строчными буквами.

Обе строки Studio ищет по всему тексту, поэтому их можно писать где угодно, в том числе внутри декоративного блока view { … }. Тело view не разбирается как структура: слова print, export и имена после них ни на что не влияют — view.

Что происходит в коде:

Полный пример#

spec1c {
  report items
    title:  "Список номенклатуры"
    target: managed

  data {
    items = Справочник.Номенклатура
      fields: Ссылка, Код, Наименование
  }

  view {
    print ПечатьСписка
      layout: maket "ПечатьСписка"
    export Выгрузка
      format: xlsx
  }
}

Справочник.Номенклатура — пример из типовой конфигурации. Объект должен существовать в вашей конфигурации; Studio в облаке его не проверяет. Макет ПечатьСписка с областями «Шапка» и «Строка» нужно создать в обработке самостоятельно.

Разбор примера#

Серверная часть сгенерированного кода (служебные комментарии убраны):

&НаСервере
Процедура СформироватьНаСервере()
	Запрос = Новый Запрос;
	Запрос.Текст =
	"ВЫБРАТЬ
	|	Номенклатура.Ссылка КАК Ссылка,
	|	Номенклатура.Код КАК Код,
	|	Номенклатура.Наименование КАК Наименование
	|ИЗ
	|	Справочник.Номенклатура КАК Номенклатура
	|";
	РезультатЗапроса = Запрос.Выполнить();

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

Табличный документ ТабДок заполняется, но никуда не выводится.

С target: ordinary тот же текст даёт только запрос и подсчёт строк:

report items
  target: ordinary
data {
  items = Справочник.Номенклатура
    fields: Ссылка, Код
}
layout: maket "ПечатьСписка"
format: xlsx

Ожидаемый результат#

После «Ещё» → «Применить без сборки» — уведомление «Spec1C → модель · источников 1». Отдельной строки про вывод в уведомлении нет.

Типичные ошибки#

Упражнение#

1. Примените полный пример с target: managed и соберите файл. В модуле формы найдите ПолучитьМакет("ПечатьСписка") и две подряд строки &НаКлиенте.
2. Замените managed на ordinary, примените и соберите. Убедитесь, что макет из кода исчез, а запрос остался.
3. Удалите строку format: xlsx, примените и соберите. Код не изменится: выгрузки в Excel не было и раньше.

Следующий урок#

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

Сверено с продуктом: 27.10.2026