include list

Команда include list описывает динамический список объекта на форме; она попадает только в модель Studio, в собранный файл список не выводится.

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

report Справочник

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

Назначение
Синтаксис
Элементы
Пример
Что принимает разбор
Что попадает в модель
Что проверяется
Что генерируется в BSL
Работа в 1С
Ограничения
Связанные конструкции

include list описывает динамический список объекта конфигурации на форме. Команда разбирается и попадает только в модель Studio: в собранный файл .epf/.erf список не добавляется.

Назначение#

Команда фиксирует в спецификации намерение: «на такой форме нужен список таких объектов под таким именем». Studio учитывает его в своей модели формы и показывает в инспекторе. Создать список в собранном файле команда не может — это нужно сделать в Конфигураторе.

Синтаксис#

Spec1C

include list <Вид>.<ИмяОбъекта> in form <ИмяФормы> as <ИмяСписка>

Части можно переносить на следующие строки.

Элементы#

Элемент	Обязателен	Что означает
`include list`	да	команда
`<Вид>.<ИмяОбъекта>`	да	объект, записи которого показывает список; виды — как в `data`
`in form <ИмяФормы>`	да	имя формы; можно с точками (`Обработка.Х.Форма.Ф`)
`as <ИмяСписка>`	да	имя реквизита-списка; кириллица допустима

Пример#

Spec1C

spec1c {
  report contracts
    title:  "Договоры"
    target: ordinary

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

  include list Справочник.КлиентскиеДоговора
    in form Форма
    as СписокДоговоров
}

Что принимает разбор#

Все четыре части обязательны. Без as <Имя> команда пропускается без сообщения.
Путь к объекту — только с одним из восьми видов, как в data (Ссылки на метаданные).
Команда может быть единственной в спецификации: тогда нет ошибки, только предупреждение «нет блока data { }».
Несколько команд include list — все попадают в модель.

Что попадает в модель#

Для каждой команды: путь к объекту, имя формы и имя списка. После «Применить без сборки» (по исходному коду Studio):

уведомление дополняется счётчиком «· include list N»;
в модели формы Studio появляется реквизит с этим именем и типом ДинамическийСписок;
инспектор показывает блок «include list (N)» со строками «Список <имя> · ДинамическийСписок» и «на форме раздела <форма> (не вкладка главной)», когда в дереве навигатора не выбран объект.

Если удалить команду, список из модели не исчезает: модель не очищается, когда в новом тексте нет ни одной команды include list.

Что проверяется#

Ничего: Studio не проверяет, что объект и форма существуют. Конфигурация в облачной среде не загружается.

Что генерируется в BSL#

Ничего. По исходному коду генератора и сервиса сборки (живой сборкой не проверялось):

в модуль формы код для списка не генерируется;
описание формы собранного файла облачная сборка не меняет, поэтому реквизит ДинамическийСписок и элемент формы в файл не попадают.

Спецификация, в которой есть только include list и нет источников данных, генерацию кода при сборке не запускает.

Работа в 1С#

В собранном файле списка нет. Чтобы он появился, после скачивания файла добавьте список объектов на форму в Конфигураторе. Учтите, что новая обработка из Studio создаётся с обычной формой — выбирайте элемент, доступный для вашего вида формы.

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

Список не попадает в собранный файл.
Удаление команды не очищает модель.
Неполная запись пропускается без сообщения.
Это не язык описания формы: расположение, колонки и отборы списка задать нельзя.

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

Связанные конструкции#

show — show, другая команда только для Studio.
Ссылки на метаданные — пути к объектам конфигурации.

См. также

show Справочник
Ссылки на метаданные Справочник
Соответствие конструкций и BSL Справочник
Ограничения реализации Справочник

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