Создает массив и копирует в него значения заданного поля записей набора.
Синтаксис
ВыгрузитьКолонку(<ИмяПоля>)Полное описание, параметры и ограничения
РегистрРасчетаНаборЗаписей.<Имя регистра расчета>.ВыгрузитьКолонку (CalculationRegisterRecordSet.<Calculation register name>.UnloadColumn)
РегистрРасчетаНаборЗаписей.<Имя регистра расчета> (CalculationRegisterRecordSet.<Calculation register name>)
ВыгрузитьКолонку (UnloadColumn)
Доступен, начиная с версии 8.0.
Синтаксис:
ВыгрузитьКолонку(<ИмяПоля>)
Параметры:
<ИмяПоля> (обязательный)
Тип: Строка.
Имя поля записей набора, из которого значения будут выгружены в массив.
Возвращаемое значение:
Тип: Массив.
Описание:
Создает массив и копирует в него значения заданного поля записей набора.
Доступность:
Сервер, толстый клиент, внешнее соединение.
Примечание:
Значения записей выгружаются в порядке индексов.
Использование в версии:
Доступен, начиная с версии 8.0.
Методическая информация
Практические примеры
Отличить структуру колонок от копии данных расчётного набора
ВыгрузитьКолонки возвращает пустую таблицу заданной структуры; Выгрузить копирует записи, а ВыгрузитьКолонку — только значения одного поля.
Где и как запускать
Полный серверный общий модуль собственной учебной конфигурации. Набор в памяти и собственная плановая ссылка; объект документа не создаётся. Без расчёта зарплаты; запуск в 1С не проверен.
Подготовка
Создайте новую пустую файловую базу с именем корня УчебныеНаборыРасчета85. Это отдельный учебный стенд, не ЗУП, КА2, УНФ, УТ или БП. Других документов, регистров и справочников в нём не должно быть.
Создайте план видов расчёта УчебныеВиды85: тип кода Строка, длина кода 10, наименования 100; использование периода действия выключено, зависимость от видов расчёта Не использовать. Реквизиты и табличные части не добавляйте.
В предопределённых видах плана создайте УчебноеНачисление с кодом DEMO и наименованием Учебная сумма. Не задавайте зависимости или вытесняющие виды. Это вид учебного расчёта, не формула зарплаты.
Создайте документ УчебныйРегистратор85 без реквизитов и табличных частей. Создайте регистр расчёта УчебныеСуммы85: периодичность Месяц, план УчебныеВиды85; период действия и базовый период выключены; график и перерасчёты не задавайте. На вкладке Движения собственного документа отметьте только этот регистр.
Добавьте в регистр измерение МеткаОперации: Строка(80), Проверка заполнения — Выдавать ошибку; единственный ресурс Сумма: Число(15,2). Других измерений, ресурсов и реквизитов не добавляйте. Обновите конфигурацию учебной базы, чтобы создать предопределённый вид.
Оставьте модули документа и набора пустыми, без подписок на события. Создайте серверный общий модуль УчебныеЗаписиРасчета с флагом Сервер, без Привилегированный. Вставьте полный модуль выбранного урока и вызовите ВыполнитьПример из своей серверной команды учебной обработки.
ПолучитьСсылку своего менеджера с новым UUID формирует непустое ссылочное значение собственного типа. Объект документа не создаётся и не записывается; непустая ссылка не доказывает существование документа. Наборы меняются только в памяти; вызовов Записать нет. Отдельный урок чтения ограничен своими новыми плановыми ссылками.
Код не вычисляет зарплату, налоги, базу или фактический период действия. Примеры сверены со справкой установленной платформы, но автоматически в 1С не исполнялись.
Процедура ВыполнитьПример() Экспорт
Набор = СоздатьСвойНабор();
СтруктураКолонок = Набор.ВыгрузитьКолонки("МеткаОперации,Сумма,ВидРасчета");
Сообщить(СтруктураКолонок.Количество() = 0);
Сообщить(СтруктураКолонок.Колонки.Количество() = 3);
Копия = Набор.Выгрузить(, "МеткаОперации,Сумма,ВидРасчета");
Сообщить(Копия.Количество() = 2 И Копия.Итог("Сумма") = 800);
СвоиСтроки = Новый Массив;
СвоиСтроки.Добавить(Набор.Получить(0));
ОднаСтрока = Набор.Выгрузить(СвоиСтроки, "МеткаОперации,Сумма");
Сообщить(ОднаСтрока.Количество() = 1 И ОднаСтрока.Получить(0).Сумма = 750);
Суммы = Набор.ВыгрузитьКолонку("Сумма");
Сообщить(Суммы.Количество() = 2 И Суммы[0] = 750 И Суммы[1] = 50);
Набор.Получить(0).Сумма = 1000;
Сообщить(Набор.Итог("Сумма") = 1050);
Сообщить(Копия.Итог("Сумма") = 800 И ОднаСтрока.Получить(0).Сумма = 750);
Сообщить(Суммы[0] = 750);
КонецПроцедуры
Процедура ПроверитьУчебнуюСхему()
Если Метаданные.Документы.Количество() <> 1 ИЛИ Метаданные.ПланыВидовРасчета.Количество() <> 1 ИЛИ Метаданные.РегистрыРасчета.Количество() <> 1 ИЛИ Метаданные.Справочники.Количество() <> 0 ИЛИ Метаданные.РегистрыСведений.Количество() <> 0 ИЛИ Метаданные.РегистрыНакопления.Количество() <> 0 ИЛИ Метаданные.РегистрыБухгалтерии.Количество() <> 0 Тогда
ВызватьИсключение "Нужна отдельная пустая учебная конфигурация УчебныеНаборыРасчета85";
КонецЕсли;
План = Метаданные.ПланыВидовРасчета.Найти("УчебныеВиды85");
Регистр = Метаданные.РегистрыРасчета.Найти("УчебныеСуммы85");
Документ = Метаданные.Документы.Найти("УчебныйРегистратор85");
Если План = Неопределено ИЛИ Регистр = Неопределено ИЛИ Документ = Неопределено Тогда
ВызватьИсключение "Не найдены три собственных объекта учебной схемы";
КонецЕсли;
Если План.ТипКода <> Метаданные.СвойстваОбъектов.ТипКодаПланаВидовРасчета.Строка
ИЛИ План.ДлинаКода <> 10 ИЛИ План.ДлинаНаименования <> 100
ИЛИ План.ИспользованиеПериодаДействия
ИЛИ План.ЗависимостьОтВидовРасчета <> Метаданные.СвойстваОбъектов.ИспользованиеБазыПланаВидовРасчета.НеИспользовать
ИЛИ План.Реквизиты.Количество() <> 0 ИЛИ План.ТабличныеЧасти.Количество() <> 0
ИЛИ Документ.Реквизиты.Количество() <> 0 ИЛИ Документ.ТабличныеЧасти.Количество() <> 0 Тогда
ВызватьИсключение "План видов или документ отличаются от подготовки";
КонецЕсли;
Если Регистр.Периодичность <> Метаданные.СвойстваОбъектов.ПериодичностьРегистраРасчета.Месяц
ИЛИ Регистр.ПериодДействия ИЛИ Регистр.БазовыйПериод
ИЛИ Регистр.ПланВидовРасчета <> План
ИЛИ Регистр.Измерения.Количество() <> 1 ИЛИ Регистр.Ресурсы.Количество() <> 1
ИЛИ Регистр.Реквизиты.Количество() <> 0 ИЛИ Регистр.Перерасчеты.Количество() <> 0 Тогда
ВызватьИсключение "Регистр должен быть помесячным, без периодов действия, базы и перерасчетов";
КонецЕсли;
Метка = Регистр.Измерения.Найти("МеткаОперации");
Сумма = Регистр.Ресурсы.Найти("Сумма");
Если Метка = Неопределено ИЛИ Сумма = Неопределено Тогда
ВызватьИсключение "Нужны собственные поля МеткаОперации и Сумма";
КонецЕсли;
Если Метка.Тип.Типы().Количество() <> 1 ИЛИ НЕ Метка.Тип.СодержитТип(Тип("Строка"))
ИЛИ Метка.Тип.КвалификаторыСтроки.Длина <> 80
ИЛИ Метка.ПроверкаЗаполнения <> ПроверкаЗаполнения.ВыдаватьОшибку
ИЛИ Сумма.Тип.Типы().Количество() <> 1 ИЛИ НЕ Сумма.Тип.СодержитТип(Тип("Число"))
ИЛИ Сумма.Тип.КвалификаторыЧисла.Разрядность <> 15
ИЛИ Сумма.Тип.КвалификаторыЧисла.РазрядностьДробнойЧасти <> 2 Тогда
ВызватьИсключение "Типы полей и проверка заполнения отличаются от подготовки";
КонецЕсли;
КонецПроцедуры
Функция СоздатьСвоюСсылкуРегистратора()
ПлановаяСсылка = Документы.УчебныйРегистратор85.ПолучитьСсылку(Новый УникальныйИдентификатор);
Если ТипЗнч(ПлановаяСсылка) <> Тип("ДокументСсылка.УчебныйРегистратор85") Или ПлановаяСсылка.Пустая() Тогда
ВызватьИсключение "Нужна собственная непустая плановая ссылка регистратора";
КонецЕсли;
Возврат ПлановаяСсылка;
КонецФункции
Процедура ЗаполнитьСвоюЗапись(Запись, СвояСсылка, Метка, Сумма)
Запись.Регистратор = СвояСсылка;
Запись.ПериодРегистрации = Дата(2026, 10, 3);
Запись.ВидРасчета = ПланыВидовРасчета.УчебныеВиды85.УчебноеНачисление;
Запись.Активность = Истина;
Запись.Сторно = Ложь;
Запись.МеткаОперации = Метка;
Запись.Сумма = Сумма;
КонецПроцедуры
Функция СоздатьСвойНабор()
ПроверитьУчебнуюСхему();
СвояСсылка = СоздатьСвоюСсылкуРегистратора();
Набор = РегистрыРасчета.УчебныеСуммы85.СоздатьНаборЗаписей();
Набор.Отбор.Регистратор.Установить(СвояСсылка);
ЗаполнитьСвоюЗапись(Набор.Добавить(), СвояСсылка, "Книга", 750);
ЗаполнитьСвоюЗапись(Набор.Добавить(), СвояСсылка, "Ручка", 50);
Возврат Набор;
КонецФункцииРазбор по шагам
Заказать структуру трёх существующих колонок: строк пока нет, но типы колонок сохранены.
В Выгрузить пропустить первый необязательный параметр и явно выбрать те же колонки; получить две строки.
Передать Массив собственных записей для выборочной выгрузки. Это не массив числовых индексов.
Выгрузить отдельно Сумма: порядок массива совпадает с порядком строк.
Изменить ресурс только в исходном наборе и проверить независимость таблиц и числового массива.
Как проверить результат
Восемь сообщений Истина: структура без строк, полная копия 800, выбранная строка 750, исходный изменённый набор 1050.
В памяти одновременно существуют набор записей, две таблицы и массив; чтения базы нет.
Ожидаемый результат
Реальная задача подготовки копии для своего отчёта без смешения структуры, данных и ссылок на строки.
На что обратить внимание
ВыгрузитьКолонки не выгружает данные: нулевой размер не означает пустой исходный набор.
ВыгрузитьКолонку возвращает массив значений, не записи расчётного регистра.
В собственный массив выборки помещайте записи именно этого набора; не строки другой таблицы.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.