Создает таблицу значений и копирует в нее записи набора. Структура полученной таблицы совпадает со структурой набора записей.
Синтаксис
Выгрузить(<Строки>, <Колонки>)Полное описание, параметры и ограничения
ВнешнийИсточникДанныхКубНаборЗаписей.<Имя внешнего источника>.<Имя куба>.Выгрузить (ExternalDataSourceCubeRecordSet.<External source name>.<Cube name>.Unload)
ВнешнийИсточникДанныхКубНаборЗаписей.<Имя внешнего источника>.<Имя куба> (ExternalDataSourceCubeRecordSet.<External source name>.<Cube name>)
Выгрузить (Unload)
Доступен, начиная с версии 8.3.3.
Синтаксис:
Выгрузить(<Строки>, <Колонки>)
Параметры:
<Строки> (необязательный)
Тип: Массив.
Массив строк для выгрузки. Если не указан, выгружаются все строки набора записей.
<Колонки> (необязательный)
Тип: Строка.
Список колонок для выгрузки в формате: "Колонка1, Колонка2...". Если список не задан, то будут выгружены все колонки.
Возвращаемое значение:
Тип: ТаблицаЗначений.
Описание:
Создает таблицу значений и копирует в нее записи набора. Структура полученной таблицы совпадает со структурой набора записей.
Доступность:
Сервер, толстый клиент, внешнее соединение.
Использование в версии:
Доступен, начиная с версии 8.3.3.
Методическая информация
Практические примеры
Выгрузить данные куба в таблицу и массив
Полная выгрузка, выгрузка структуры колонок и выгрузка одной колонки решают разные задачи.
Где и как запускать
Синтаксический пример для толстого клиента: вставьте код в тело обработчика своей учебной формы. Настройте указанный внешний источник заранее. В тонкий клиент эти фрагменты переносить нельзя. Здесь код не запускался.
Подготовка
В учебной конфигурации настройте внешний источник Аналитика, куб Продажи и его таблицу измерения Товары. Имена в коде — имена этих метаданных, а не перевод названий из внешней системы.
В измерении Товары используйте строковый ключ BOOK и поле Код. В кубе задайте измерение и ключевое поле Товар, числовые поля Количество и Сумма. Для просмотра нужны доступные учебные данные и настроенное подключение.
Набор = ВнешниеИсточникиДанных.Аналитика.Кубы.Продажи.СоздатьНаборЗаписей();
Набор.Прочитать();
Данные = Набор.Выгрузить(, "Товар,Количество,Сумма");
СтруктураКолонок = Набор.ВыгрузитьКолонки("Товар,Количество,Сумма");
Количества = Набор.ВыгрузитьКолонку("Количество");
Сообщить("Строк данных: " + Строка(Данные.Количество()));
Сообщить("Строк в структуре: " + Строка(СтруктураКолонок.Количество()));
Для Каждого Количество Из Количества Цикл
Сообщить(Количество);
КонецЦикла;Разбор по шагам
Сначала прочитайте набор куба.
Выгрузите выбранные колонки в таблицу и отдельно получите такую же структуру без строк.
Обойдите массив значений колонки Количество.
Как проверить результат
Данные содержит прочитанные строки, а СтруктураКолонок — только колонки и ноль строк.
Количество элементов массива совпадает с числом записей набора.
Ожидаемый результат
Показан обычный синтаксис вызовов и способ использовать результат. Здесь пример не исполнялся; результат зависит от подготовленных метаданных и внешних учебных данных.
На что обратить внимание
ВыгрузитьКолонки не выгружает данные.
Имена колонок берутся из метаданных; пустой первый аргумент Выгрузить означает отсутствие ограничения по массиву строк.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.