Язык Spec1C: обзор

Spec1C — текстовый язык спецификаций Smart1Spec Studio. На нём коротко описывают данные внешней обработки или отчёта: какие объекты конфигурации читать, какие поля выбрать, как соединить источники, по какому полю отбирать период. Studio разбирает этот текст, записывает результат в модель проекта и при сборке генерирует по ней код запроса в модуле формы.

Где Spec1C в цикле изменения#

Spec1C — второй этап на панели этапов: «Intent Задача» → «Spec1C Спецификация» → «Source Исходники» → «Artifact Готовый файл». Описание задачи на этапе Intent и текст спецификации — два представления одной модели. Исходники (модули BSL) остаются основой сборки: сгенерированный по спецификации код попадает в собранный файл. Подробнее о цикле — Цикл изменения: Intent, Spec1C, Source, Artifact, о связи Intent и Spec1C — Связь Intent и Spec1C.

Что Spec1C делает и чего не делает#

У каждой конструкции различайте пять уровней: текст принят разбором → значение попало в модель → значение проверено → по нему сгенерирован код BSL → код работает в 1С. Первые четыре уровня обеспечивает Studio, пятый проверяете только вы в 1С. Например, inner_join принимается и сохраняется в модели, но в коде всегда получается левое соединение. Полная картина — Матрица поддержки конструкций.

С чего начать#

1. Прочитайте, зачем нужен язык и чем он отличается от описания задачи и от BSL, — Естественный язык, Spec1C и BSL.
2. Пройдите Быстрый старт: минимальная спецификация, применение, сборка и скачивание файла.
3. Изучите уроки по порядку — от каркаса до поиска ошибок.

Разделы#

Обучение#

• Быстрый старт
• Урок 1. Каркас: spec1c и report — spec1c, report, title, target, section, комментарии.
• Урок 2. Источники данных и поля — data, источники и fields.
• Урок 3. Параметры — params.
• Урок 4. Соединения и период — соединения, where и filter period.
• Урок 5. Вывод: макет и Excel — layout, format, view.
• Урок 7. Поиск и исправление ошибок — сообщения и типичные ошибки.

Руководства#

• Чтение и правка: Прочитать готовую спецификацию, Изменить заголовок, параметры и поля, Добавить или удалить источник данных, Добавить соединение и отбор по периоду, Настроить вывод.
• Создание: Создать спецификацию с нуля.
• Применение и сборка: Применить спецификацию без сборки, Проверить модель, Собрать файл по спецификации, Отменить изменения спецификации, Скачать спецификацию в файл, Выбрать: Spec1C или правка BSL.

Понятия#

Естественный язык, Spec1C и BSL, Как Studio обрабатывает спецификацию, Модель отчёта, Связь Intent и Spec1C, Генерация BSL и зоны генерации, Уровни диагностики.

Справочник языка#

Начните с Обзор справочника и совместимость. Конструкции: spec1c (корень), report, params, data, fields, Соединения: left_join, inner_join, right_join, rows, where и filter period, layout и format, view. Поддержка и диагностика: Соответствие конструкций и BSL, Матрица поддержки конструкций, Сообщения об ошибках и предупреждения, Ограничения реализации, Неподдерживаемые конструкции, Указатель ключевых слов.

Примеры#

Библиотека примеров — готовые спецификации с задачей и результатом проверки.

Справка Spec1C в Studio#

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