Таблица значений предназначена для хранения значений в табличном виде. Все основные операции с таблицей производятся именно через этот объект. Он позволяет манипулировать строками таблицы значений и предоставляет доступ к коллекции колонок. Колонки могут быть различных типов (в том числе множественных).
Примеры платформы
ТаблицаЗначений = Новый ТаблицаЗначений;
ТаблицаЗначений.Колонки.Добавить("Отдел",,"Отдел");
ТаблицаЗначений.Колонки.Добавить("Сотрудник",,"Фамилия сотрудника");
ТаблицаЗначений.Колонки.Добавить("Оклад",,"Оклад");
Стр=ТаблицаЗначений.Добавить();
Стр.Отдел="Отдел 1";
Стр.Сотрудник="Иванов";
Стр.Оклад=5600;
ТаблицаЗначений.Колонки.Добавить("Стаж",,"Стаж работы");
ТекСтр = ТаблицаЗначений.Добавить();
ТекСтр.Отдел = "Отдел 2"; ТекСтр.Сотрудник = "Петров";
ТекСтр.Оклад = 6700; ТекСтр.Стаж = 22;Полное описание, параметры и ограничения
ТаблицаЗначений (ValueTable)
ТаблицаЗначений (ValueTable)
Доступен, начиная с версии 8.0.
Элементы коллекции:
СтрокаТаблицыЗначений
Для объекта доступен обход коллекции посредством оператора Для каждого … Из … Цикл. При обходе выбираются элементы коллекции.
Возможно обращение к элементу коллекции посредством оператора [...]. В качестве аргумента передается индекс строки (нумерация с 0).
Свойства:
Индексы (Indexes)
Колонки (Columns)
Методы:
Вставить (Insert)
ВыбратьСтроку (ChooseRow)
ВыгрузитьКолонку (UnloadColumn)
Добавить (Add)
ЗагрузитьКолонку (LoadColumn)
ЗаполнитьЗначения (FillValues)
Индекс (IndexOf)
Итог (Total)
Количество (Count)
Найти (Find)
НайтиСтроки (FindRows)
Очистить (Clear)
Получить (Get)
Свернуть (GroupBy)
Сдвинуть (Move)
Скопировать (Copy)
СкопироватьКолонки (CopyColumns)
Сортировать (Sort)
Удалить (Delete)
Конструкторы:
По умолчанию
Описание:
Таблица значений предназначена для хранения значений в табличном виде. Все основные операции с таблицей производятся именно через этот объект. Он позволяет манипулировать строками таблицы значений и предоставляет доступ к коллекции колонок. Колонки могут быть различных типов (в том числе множественных).
Доступность:
Сервер, толстый клиент, внешнее соединение, мобильное приложение (сервер), мобильный автономный сервер.
Возможен обмен с сервером. Сериализуется. Данный объект может быть сериализован в/из XDTO. Тип XDTO, соответствующий данному объекту, определяется в пространстве имен {http://v8.1c.ru/8.1/data/core}. Имя типа XDTO: ValueTable.
Пример:
// Создание таблицы значений
ТаблицаЗначений = Новый ТаблицаЗначений;
// добавим в таблицу значений три колонки
ТаблицаЗначений.Колонки.Добавить("Отдел",,"Отдел");
ТаблицаЗначений.Колонки.Добавить("Сотрудник",,"Фамилия сотрудника");
ТаблицаЗначений.Колонки.Добавить("Оклад",,"Оклад");
// добавим строку
Стр=ТаблицаЗначений.Добавить();
Стр.Отдел="Отдел 1";
Стр.Сотрудник="Иванов";
Стр.Оклад=5600;
// добавим новую колонку
ТаблицаЗначений.Колонки.Добавить("Стаж",,"Стаж работы");
// ввод новой строки и данных по строке
ТекСтр = ТаблицаЗначений.Добавить();
ТекСтр.Отдел = "Отдел 2"; ТекСтр.Сотрудник = "Петров";
ТекСтр.Оклад = 6700; ТекСтр.Стаж = 22;
Использование в версии:
Доступен, начиная с версии 8.0.
Методическая информация
Практические примеры
Вставить срочный товар и передвинуть строку в начало
Показываем разницу между добавлением в конец, вставкой в заданную позицию и перемещением существующей строки.
Где и как запускать
Учебная база: создайте серверный общий модуль УчебныеЗадачи (флаг Сервер). Код без директив вставьте в тело процедуры ВыполнитьПример() Экспорт. Вызовите её из серверного обработчика команды учебной обработки. Не запускайте в рабочей базе.
Подготовка
Выполняйте на сервере, данные только в памяти.
Смещение -1 применяется к строке, которая находится в позиции 1.
Товары = Новый ТаблицаЗначений;
Товары.Колонки.Добавить("Название");
Товары.Добавить().Название = "Книга";
Товары.Добавить().Название = "Ручка";
Срочный = Товары.Вставить(1);
Срочный.Название = "Тетрадь";
Товары.Сдвинуть(Срочный, -1);
Для Каждого СтрокаТовара Из Товары Цикл
Сообщить(СтрокаТовара.Название);
КонецЦикла;
Копия = Товары.Скопировать();
Копия.Получить(0).Название = "Изменено в копии";
Сообщить(Товары.Получить(0).Название);
Копия.Удалить(0);
Сообщить(Копия.Количество());
Копия.Очистить();
Сообщить(Копия.Количество());
Сообщить(Копия.Колонки.Количество());Разбор по шагам
Добавить создаёт книгу и ручку в конце таблицы.
Вставить(1) создаёт новую строку между ними; Сдвинуть перемещает эту строку в начало.
Скопировать создаёт отдельные строки; изменение имени в копии не меняет исходную ячейку.
Удалить удаляет одну строку, Очистить удаляет все строки копии и оставляет её колонки.
Как проверить результат
Порядок вывода: Тетрадь, Книга, Ручка; исходное первое название после редактирования копии — Тетрадь.
После удаления в копии 2 строки, после очистки 0 строк и 1 колонка.
Ожидаемый результат
Исходная таблица остаётся с тремя товарами; копия очищена.
На что обратить внимание
Вставить создаёт новую строку; не используйте его для перемещения уже существующей.
Копирование значения-объекта в ячейке не гарантирует глубокую копию вложенного объекта; здесь ячейки содержат строки.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.
Найти все строки нужного товара и посчитать количество
Учимся отличать поиск первой строки от отбора нескольких совпадений.
Где и как запускать
Учебная база: создайте серверный общий модуль УчебныеЗадачи (флаг Сервер). Код без директив вставьте в тело процедуры ВыполнитьПример() Экспорт. Вызовите её из серверного обработчика команды учебной обработки. Не запускайте в рабочей базе.
Подготовка
Таблица создаётся на сервере.
В данных намеренно две строки с одинаковым кодом.
Товары = Новый ТаблицаЗначений;
Товары.Колонки.Добавить("Код");
Товары.Колонки.Добавить("Количество");
СтрокаТовара = Товары.Добавить();
СтрокаТовара.Код = "A-01";
СтрокаТовара.Количество = 2;
СтрокаТовара = Товары.Добавить();
СтрокаТовара.Код = "A-01";
СтрокаТовара.Количество = 3;
СтрокаТовара = Товары.Добавить();
СтрокаТовара.Код = "B-02";
СтрокаТовара.Количество = 4;
Отбор = Новый Структура("Код", "A-01");
СтрокиТовара = Товары.НайтиСтроки(Отбор);
Итого = 0;
Для Каждого СтрокаТовара Из СтрокиТовара Цикл
Итого = Итого + СтрокаТовара.Количество;
КонецЦикла;
Сообщить(СтрокиТовара.Количество());
Сообщить(Итого);
ПерваяСтрока = Товары.Найти("A-01", "Код");
Если ПерваяСтрока <> Неопределено Тогда
Сообщить(Товары.Индекс(ПерваяСтрока));
КонецЕсли;Разбор по шагам
НайтиСтроки принимает структуру условий и возвращает массив строк.
Суммируем значения только найденных строк.
Найти возвращает первое совпадение; Индекс определяет его позицию с нуля.
Как проверить результат
Количество найденных строк 2, сумма 5, индекс первой 0.
Замените код отбора на X: количество и сумма должны быть 0.
Ожидаемый результат
2; 5; 0.
На что обратить внимание
Найденные строки принадлежат исходной таблице: изменение строки меняет её данные.
Проверяйте Неопределено перед использованием результата Найти.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.