Урок 3. Параметры

Блок params в Spec1C — какие имена параметров Studio распознаёт, какие теряются при разборе и почему в облачной сборке параметры не меняют код.

Блок params { } описывает флаги спецификации. Это самый «обманчивый» блок языка: почти любой текст в нём принимается без ошибок, но в модель попадают только несколько имён, а в облачной сборке код от параметров не меняется.

Цель урока#

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

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

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

• Каркас спецификации — Урок 1. Каркас: spec1c и report.
• Блок params пишется на верхнем уровне, рядом с report и data, а не внутри них.

Объяснение#

Каждый параметр — отдельная строка вида Имя : тип = значение:

params {
  <Имя> : bool = true
  КаталогВыгрузки : Path = "<путь>"
}

Studio распознаёт только такие имена:

Значение bool — только true или false. Строка Path — в двойных кавычках.

Все остальные строки блока принимаются без ошибки и теряются: параметр с другим именем, другой тип (Date, string, Period), значение да/нет. Ни ошибки, ни предупреждения не будет.

Что параметры дают в коде#

При облачной сборке ни один параметр не меняет сгенерированный код:

• флаги «только действующие» и «все дополнительные соглашения» в генерацию кода не передаются;
• КаталогВыгрузки остаётся только в модели;
• флаг ВыгружатьXLSX при облачной сборке не используется — кода выгрузки в Excel нет (см. также Урок 5. Вывод: макет и Excel).

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

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

spec1c {
  report items
    title:  "Номенклатура с флагами"
    target: ordinary

  params {
    ТолькоДействующиеНаКонец  : bool = true
    ВыгружатьXLSX             : bool = false
    КаталогВыгрузки           : Path = ""
    ПоказыватьАрхив           : bool = true
  }

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

Справочник.Номенклатура — пример из типовой конфигурации; используйте объект, который есть в вашей конфигурации. Studio в облаке имена не проверяет.

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

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

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

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

Полный список имён и правил — params, типы значений — Типы и значения.

Упражнение#

1. Примените полный пример. Убедитесь, что ошибок нет.
2. Замените true у ПоказыватьАрхив на да и снова примените. Ошибки тоже не будет — разбор не сообщает о потерянных параметрах. Это и есть главный риск блока params.
3. Соберите файл и сравните модуль формы со сборкой из Быстрый старт — там тот же источник и те же поля. Процедура Сформировать совпадёт: код не зависит от параметров.

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

Урок 4. Соединения и период — соединения источников и отбор по периоду.

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