Урок 7. Поиск и исправление ошибок

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

Ошибки в спецификации бывают трёх видов: те, о которых Studio сообщает сразу; те, о которых она сообщает при проверке или сборке; и те, которые она пропускает молча. Третьи опаснее всего — в этом уроке вы научитесь их находить.

Цель урока#

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

• прочитать сообщение после «Применить без сборки» и понять, применился ли текст;
• отличить ошибку, которая блокирует сборку, от замечания, которое ей не мешает;
• найти строки, которые разбор пропустил без сообщения.

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

• Как применять текст и собирать файл — Быстрый старт.
• Конструкции из уроков Урок 1. Каркас: spec1c и report–Урок 5. Вывод: макет и Excel.
• Ошибок в самом редакторе (подчёркиваний) нет: Studio сообщает об ошибках только уведомлением при применении и сборке.

Объяснение#

Где появляются сообщения#

Пояснения:

• «нет блока data { }» — предупреждение, а не ошибка. Оно увеличивает счётчик «предупр.» в уведомлении.
• Число источников в уведомлении — это источники модели, а не текста. Если новый текст не содержит ни одного распознанного источника, в модели остаются прежние, и число не меняется. Сверяйтесь с вкладкой Intent → «Данные».
• «Проверить модель Spec1C» проверяет уже применённую модель, а не текст в редакторе. Сначала примените текст. Замечание «✗ Конфигурация не загружена — загрузите Conf в навигаторе (нужна для источников / запросов)» в облачной среде появляется всегда, когда есть источники, и сборке не мешает. Замечание «✗ У первого источника нет полей» — повод добавить fields:. Подробнее — Проверить модель.
• Имена объектов и полей конфигурации в облаке не проверяются никогда. Опечатка в Справочник.Контрагенты проявится только в 1С при выполнении запроса.

Что Studio пропускает без сообщения#

Удаление строк не очищает модель#

Если убрать из текста источники, соединения, поле периода, имя макета или вид формы, в модели остаются прежние значения. Чтобы изменить значение, укажите новое явно. Чтобы убрать отбор по периоду или запросы balance/turnovers, начните с нового файла (Создать новую обработку или отчёт).

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

Спецификация с четырьмя ошибками. Studio примет её без единого сообщения об ошибке:

spec1c {
  report sales
    title:  "Реализации и контрагенты"
    target: Ordinary

  data {
    реализации = Документ.РеализацияТоваровУслуг
      fields: Ссылка, Номер, Дата, Контрагент

    partners = Справочник.Контрагенты
      fields: ИНН

    |> left_join partners on partners.Ссылка = реализации.Контрагент
  }

  compute {
    Итого = Сумма
  }
}

Исправленный вариант:

spec1c {
  report sales
    title:  "Реализации и контрагенты"
    target: ordinary

  data {
    sales = Документ.РеализацияТоваровУслуг
      fields: Ссылка, Номер, Дата, Контрагент

    partners = Справочник.Контрагенты
      fields: ИНН

    |> left_join partners on partners.Ссылка == sales.Контрагент
  }
}

Имена объектов и полей — из типовой конфигурации; в вашей конфигурации они должны существовать, Studio в облаке их не проверяет.

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

С ошибочным вариантом сборка пройдёт, но запрос будет построен только по справочнику контрагентов. Именно поэтому после каждого применения сверяйте число источников и вкладку «Данные».

Два текста, которые разбор отклоняет с ошибкой:

spec1c {
  // здесь пока ничего нет
}

params {
  ВыгружатьXLSX : bool = true
}

Первый даст уведомление «Spec1C: пустой Spec1C» (комментарий вырезается, текст пуст). Второй — «Spec1C: не найден report и источники data»: в нём нет ни report, ни распознанного источника.

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

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

Все тексты сообщений — Сообщения об ошибках и предупреждения, уровни диагностики — Уровни диагностики, ограничения — Ограничения реализации.

Упражнение#

1. Вставьте ошибочный вариант в редактор и примените. Запишите, что показало уведомление.
2. Исправляйте ошибки по одной, применяя текст после каждой правки. Следите, как меняются число источников и вкладка «Данные».
3. Удалите закрывающую скобку } блока data и примените. Найдите в уведомлении «· 1 предупр.». Верните скобку.

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

Уроки закончены. Дальше — практика: Создать спецификацию с нуля для своей спецификации с нуля и Библиотека примеров с готовыми примерами.

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