Синтаксис и применение <Имя табличной части> в платформе 1С:Предприятие. Описание и примеры кода.
Полное описание, параметры и ограничения
<Имя табличной части>
<Имя табличной части>
Тип: РезультатЗапроса.
Набор полей содержит табличные части задач. Имена полей соответствуют именам табличных частей задач, как они заданы в конфигураторе. Результат запроса к табличной части состоит из колонок "НомерСтроки", "Ссылка" и колонок с именами, соответствующими именам реквизитов табличной части задачи.
Методическая информация
Практические примеры
Прочитать подготовленное поле Детали в запросе
Динамическое имя появилось после создания конкретного реквизита или табличной части в учебных метаданных.
Где и как запускать
Серверная процедура ВыполнитьПример в общем модуле УчебныеПроцессы. Функция подготовки размещена отдельно в том же модуле.
Подготовка
Работайте в отдельной пустой учебной конфигурации. Создайте справочник УчебныеИсполнители и предопределённый элемент Демонстрационный с наименованием Учебный исполнитель.
Создайте задачу УчебныеСогласования: строковый номер длиной 12, автонумерация, наименование длиной 100. Добавьте реквизит адресации Исполнитель типа СправочникСсылка.УчебныеИсполнители и выберите его основным реквизитом адресации. Здесь используется прямая адресация; регистр ролевой адресации не нужен.
Создайте параметр сеанса УчебныйИсполнитель того же ссылочного типа. В свойстве задачи Текущий исполнитель выберите этот параметр. Запросы урока передают исполнителя явно и не зависят от начального значения параметра сеанса.
Создайте бизнес-процесс УчебноеСогласование со строковым номером длиной 12 и автонумерацией. В свойстве Задача выберите УчебныеСогласования. Карта маршрута: Старт (начало) → Согласовать (действие) → Завершение. В точке Согласовать задайте адресацию Исполнитель = Демонстрационный, Групповая = Ложь.
И у задачи, и у бизнес-процесса создайте обычные реквизиты КомментарийУчебный (Строка 100), Сумма (Число 12.2), Подтверждено (Булево), ЗапретУдаления (Булево). Добавьте табличную часть Детали с колонками Наименование (Строка 100) и Количество (Число 10.0).
Создайте общий реквизит УчебныйИсточник типа Строка 20, Разделение данных = Не использовать. Включите только учебную задачу и бизнес-процесс в его состав. Это не разделитель и не настройка рабочей конфигурации.
В модуле объекта бизнес-процесса разместите отдельный обработчик СогласоватьПриСозданииЗадач из дополнительного блока. В свойствах точки Согласовать назначьте его событию ПриСозданииЗадач. Платформа записывает сформированные задачи после обработчика; внутри него Записать не вызывается.
Обновите учебную базу. Создайте серверный общий модуль УчебныеПроцессы: поместите туда функцию ПодготовитьУчебныйПроцесс из отдельного блока и процедуру ВыполнитьПример() Экспорт. Основной код без заголовка вставляйте в тело этой процедуры и вызывайте её из серверной команды своей обработки.
Каждый запуск подготовки действительно создаёт новый учебный бизнес-процесс и его задачу. Не используйте рабочую базу. Табличные части и обычные реквизиты заполняются только у этих новых объектов; ничего не отправляется по сети.
Контекст = ПодготовитьУчебныйПроцесс();
Запрос = Новый Запрос;
Запрос.Текст = "ВЫБРАТЬ
| Данные.Детали.(Наименование КАК Наименование, Количество КАК Количество) КАК Детали
|ИЗ Задача.УчебныеСогласования.ЗадачиПоИсполнителю(&Исполнитель, Выполнена = ЛОЖЬ) КАК Данные
|ГДЕ Данные.Ссылка = &Ссылка";
Запрос.УстановитьПараметр("Ссылка", Контекст.Задача);
Запрос.УстановитьПараметр("Исполнитель", Справочники.УчебныеИсполнители.Демонстрационный);
Выборка = Запрос.Выполнить().Выбрать();
Пока Выборка.Следующий() Цикл
Детали = Выборка.Детали.Выбрать();
Пока Детали.Следующий() Цикл
Сообщить(Детали.Наименование + ": " + Строка(Детали.Количество));
КонецЦикла;
КонецЦикла;Серверный общий модуль УчебныеПроцессы: реальное создание процесса и задачи
Функция ПодготовитьУчебныйПроцесс(ЗапуститьМаршрут = Истина) Экспорт
Процесс = БизнесПроцессы.УчебноеСогласование.СоздатьБизнесПроцесс();
Процесс.Дата = Дата(2026, 10, 14, 10, 0, 0);
Процесс.КомментарийУчебный = "Согласовать учебную покупку";
Процесс.Сумма = 100;
Процесс.Подтверждено = Ложь;
Процесс.УчебныйИсточник = "ПРИМЕР";
Деталь = Процесс.Детали.Добавить();
Деталь.Наименование = "Книга";
Деталь.Количество = 2;
Процесс.Записать();
Если Не ЗапуститьМаршрут Тогда
Возврат Новый Структура("Процесс,Задача", Процесс.Ссылка, Задачи.УчебныеСогласования.ПустаяСсылка());
КонецЕсли;
Процесс.Старт();
Запрос = Новый Запрос;
Запрос.Текст = "ВЫБРАТЬ Ссылка ИЗ Задача.УчебныеСогласования ГДЕ БизнесПроцесс = &Процесс";
Запрос.УстановитьПараметр("Процесс", Процесс.Ссылка);
Выборка = Запрос.Выполнить().Выбрать();
Если Не Выборка.Следующий() Тогда
ВызватьИсключение "Маршрут не создал учебную задачу: проверьте подготовку";
КонецЕсли;
Возврат Новый Структура("Процесс,Задача", Процесс.Ссылка, Выборка.Ссылка);
КонецФункцииМодуль объекта бизнес-процесса: назначенный обработчик точки Согласовать
Процедура СогласоватьПриСозданииЗадач(ТочкаМаршрута, ФормируемыеЗадачи, Отказ)
Для Каждого НоваяЗадача Из ФормируемыеЗадачи Цикл
НоваяЗадача.КомментарийУчебный = "Проверить учебную покупку";
НоваяЗадача.Сумма = 100;
НоваяЗадача.УчебныйИсточник = "ПРИМЕР";
Деталь = НоваяЗадача.Детали.Добавить();
Деталь.Наименование = "Книга";
Деталь.Количество = 2;
КонецЦикла;
КонецПроцедурыРазбор по шагам
Поле Детали создано в метаданных и заполнено реальным учебным объектом.
Запрос отбирает собственную ссылку; значения не берутся из неизвестного входного объекта.
Для табличной части возвращается вложенный результат запроса, который обходится второй выборкой.
Как проверить результат
Для Детали показано Книга: 2; для комментария — учебное описание; для УчебныйИсточник — ПРИМЕР; для Исполнитель — ссылка на свой предопределённый элемент.
Переименование реквизита в Конфигураторе требует изменения поля в тексте запроса.
Ожидаемый результат
Показан результат для собственных подготовленных объектов учебного согласования.
На что обратить внимание
Все имена метаданных берутся из подготовки; в типовой конфигурации таких учебных объектов может не быть.
Каждый блок вставляется в указанный модуль отдельно. Не вызывайте процедуру события вручную вместо реального действия платформы.
Запись и старт относятся только к новым учебным объектам. Пример не выполняет обработку реальных согласований и не гарантирует правильность чужого маршрута.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.