Типы и значения

Какие типы и значения понимает Spec1C, какие имена параметров попадают в модель и что происходит с остальными.

Перед чтением

Лексическая структура Справочник

На этой странице

Назначение
Типы параметров
Известные имена параметров
Значения
Значение Path
Ограничения

В Spec1C нет развитой системы типов. Типы встречаются только в объявлениях параметров блока params, а значения — в свойствах title, section, layout и в параметрах.

Назначение#

Страница отвечает на вопросы: какие типы параметров поддерживаются, какие значения допустимы и какие объявления действительно что-то меняют. Синтаксис блока параметров — params.

Типы параметров#

Тип в тексте	Разбор	Попадает в модель	Влияет на код
`bool`	да, если строка вида `Имя : bool = true` или `false`	только для известных имён (см. ниже)	нет
`Path`	да, только для `КаталогВыгрузки : Path = "…"`	да	нет
`Period`, `Date`, `string`, `number` и любые другие	нет	нет	нет

Объявления с неизвестными типами не вызывают ни ошибки, ни предупреждения: строка просто пропускается. Например, строку ПериодT : Period, которую Studio сама пишет в построенный из модели текст, разбор не учитывает.

Известные имена параметров#

В модель попадают только параметры, имя которых содержит один из образцов:

Образец в имени	Тип	Что сохраняется в модели
`ТолькоДействующ…`	`bool`	признак «только действующие»
`ВыводитьВсеДоп…` или `allAmend…`	`bool`	признак «выводить все дополнительные соглашения»
`ВыгружатьXLSX` или `exportXlsx`	`bool`	признак выгрузки в Excel
`КаталогВыгрузки`	`Path`	каталог выгрузки

Остальные параметры типа bool разбираются и теряются.

Spec1C

report demo
params {
  ТолькоДействующиеНаКонец : bool = true    // попадёт в модель
  ВыгружатьXLSX            : bool = false   // попадёт в модель
  ПоказыватьИтоги          : bool = true    // имя неизвестно — потеряется
  ПериодT                  : Period         // тип не поддерживается — потеряется
}
data {
  main = Справочник.Номенклатура
    fields: Ссылка
}

Ни один параметр не влияет на сгенерированный код: признаки хранятся в модели, но генерация их не использует. В облачной сборке выгрузка в Excel не генерируется, даже при ВыгружатьXLSX : bool = true. Каталог выгрузки в генерацию тоже не передаётся.

Значения#

Значение	Где	Правила
`true`, `false`	параметры `bool`	только строчными; `TRUE` или `True` распознаются, но сохраняются как «ложь»
Строка `"…"`	`title`, `layout: maket`, `Path`	прямые кавычки; без экранирования и переносов; без `//` внутри
Целое число	`section`	только цифры без кавычек; `0` допустим
`ordinary`, `managed`	`target`	только эти два значения, строчными
`xlsx`	`format`	единственное значение
Путь метаданных	`data`, `show`, `include list`, `balance`, `turnovers`	см. Ссылки на метаданные

Значение Path#

Значение КаталогВыгрузки — строка в кавычках. В ней не должно быть фигурной скобки }: она завершит блок params, и сам каталог, а также все параметры ниже, будут потеряны. Обратная косая черта записывается как есть; удвоенная \\ сохраняется в модели удвоенной.

Ограничения#

Поддерживаемые типы параметров — bool и Path (только для КаталогВыгрузки).
Параметры с неизвестными именами или типами молча теряются.
Параметры не влияют на генерируемый код.
TRUE и True дают «ложь».
Полный список ограничений — Ограничения реализации.

См. также

params Справочник
Лексическая структура Справочник
Ссылки на метаданные Справочник
Матрица поддержки конструкций Справочник

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