Изменить заголовок, параметры и поля

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

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

Когда это нужно#

• Нужно переименовать отчёт в спецификации.
• В запрос нужно добавить поле или убрать лишнее.
• Нужно переключить вид генерируемого кода между ordinary и managed.
• Нужно изменить значение параметра true / false.

Перед началом#

• Откройте этап Spec1C. Если вы ещё не знаете, что значит каждая строка, начните с Прочитать готовую спецификацию.
• Текст спецификации сохраняется в проекте автоматически, через секунду после правки. Отдельной кнопки сохранения нет, Ctrl+S не назначена. Но в модель отчёта правка попадает только после применения.

Шаги#

1. Заголовок. Измените текст в кавычках в строке title: "…".
2. Вид кода. В строке target: укажите ordinary или managed. Для нового файла из Studio надёжнее ordinary — см. report.
3. Параметры. В блоке params { … } поменяйте true на false или наоборот у нужной строки. Учитываются только известные имена — см. params.
4. Поля. В строке fields: под нужным источником добавьте или удалите имена полей через запятую. Имена пишутся так, как в конфигурации.
5. Нажмите «Ещё» → «Применить без сборки». Появится уведомление «Spec1C → модель · источников N». В заголовке редактора пропадёт отметка «есть изменения».
6. Чтобы получить файл с новым запросом, нажмите «Собрать .epf» (или «Собрать .erf») — см. Собрать файл по спецификации.

Пример: было два поля, стало три, заголовок изменён.

spec1c {
  report contracts
    title:  "Договоры с датой"
    target: ordinary

  data {
    contracts = Справочник.КлиентскиеДоговора
      fields: Ссылка, Код, ДатаДоговора
  }
}

Что меняется в модели и в коде#

Убрать строку — не то же, что изменить#

Применение меняет в модели только то, что написано в тексте. Если строку удалить, прежнее значение в модели останется:

• удалили title: — останется старый заголовок;
• удалили target: — останется прежний вид кода;
• удалили параметр — останется прежнее значение.

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

Если удалить строку fields: целиком, у источника не останется полей. «Проверить модель Spec1C» покажет замечание «У первого источника нет полей».

Результат#

• После применения в модели новый заголовок, вид кода, значения параметров и список полей.
• После сборки в модуле формы собранного файла — запрос с новым списком полей. Исходники проекта на этапе Source не меняются: сгенерированный код попадает только в собранный файл.
• Studio не проверяет, что поля существуют в вашей конфигурации: опечатка обнаружится только в 1С. Проверьте файл по шагам Проверить результат в 1С.

Если не получилось#

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