Обзор справочника и совместимость

Как устроен справочник языка Spec1C, по какому правилу текст считается совместимым с текущей версией Studio и что такое файл .spec1c.

Справочник языка Spec1C описывает только то, что принимает и обрабатывает текущая версия Smart1Spec Studio. Если Studio открыла эту страницу по ссылке «Справочник R1» на этапе Spec1C — это и есть справочник: так в интерфейсе подписана ссылка на него.

Назначение#

Справочник нужен, когда вы уже знаете основы языка (Быстрый старт) и хотите точно узнать, как работает конкретная конструкция: что принимает разбор, что сохраняется, что проверяется и какой код получается. Учебные уроки и руководства объясняют то же самое на задачах; справочник — по конструкциям.

Как устроен справочник#

Пять уровней поддержки#

Для каждой конструкции справочник отдельно отвечает на пять вопросов. Ответы могут различаться:

1. Принимает разбор — текст распознан без ошибки.
2. Попадает в модель — значение сохранилось и видно в Studio.
3. Проверяется — Studio сообщит, если значение неверно.
4. Генерируется в BSL — по конструкции появляется код в модуле формы собранного файла.
5. Работает в 1С — это проверяет только 1С; для учебных примеров не проверялось.

Например, rows = … разбирается и сохраняется, но не влияет на код; inner_join разбирается и сохраняется, а в коде всегда получается левое соединение. Сводная таблица — Матрица поддержки конструкций.

Правило совместимости#

Отдельного номера версии у языка нет: справочник описывает язык, который понимает текущая Studio. Текст совместим с ней, если:

1. «Применить без сборки» проходит без ошибки разбора — уведомление начинается с «Spec1C → модель», а не с «Spec1C: …»;
2. в тексте нет команд balance и turnovers — их проверка измерений требует сведений о конфигурации, которых в облачной среде нет, и сборка останавливается.

Минимальный совместимый текст:

spec1c {
  report demo
    title:  "Номенклатура"
    target: ordinary
  data {
    main = Справочник.Номенклатура
      fields: Ссылка, Код
  }
}

Совместимость означает только то, что Studio примет текст и соберёт файл. Она не гарантирует, что каждая строка на что-то повлияла: неподдерживаемые конструкции пропускаются без сообщения (Неподдерживаемые конструкции).

Корень и файл .spec1c#

• Текст может быть обёрнут в корень spec1c { … }; корень необязателен (spec1c (корень)).
• Спецификация хранится в проекте Studio. «Ещё» → «Скачать Spec1C» сохраняет её в файл <имя файла>.spec1c через браузер.
• Загрузить файл .spec1c обратно в Studio нельзя: чтобы перенести спецификацию, скопируйте текст в редактор этапа Spec1C.
• Файл .spec1c — описание для Studio; платформа 1С его не открывает.

Ссылки из Studio#

На этапе Spec1C над редактором есть ссылки «Справка Spec1C · Синтаксис · Примеры · Ошибки · Руководство · Справочник R1». Они ведут в этот раздел портала: «Синтаксис» — на Грамматика, «Ошибки» — на Сообщения об ошибках и предупреждения, «Справочник R1» — на эту страницу.

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

• Справочник не описывает расширенный черновик языка: всё, чего нет в Грамматика, текущая Studio не поддерживает.
• Номера версии языка нет: справочник описывает поведение Studio на дату в строке «Сверено с продуктом» на каждой странице.
• Остатки и обороты регистров в облачной среде собрать нельзя.
• Импорта файла .spec1c нет.

Полный список — Ограничения реализации.

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