Как сделать из таблицы значений табличную часть
Обновлено: 07.07.2024
Таблица значений – это универсальная коллекция, объект встроенного языка, который используется для работы с данными в табличном виде. Этот объект не сохраняется в базе данных, а размещается в оперативной памяти. У таблицы значений в общем случае может быть произвольное количество колонок, при этом допускается как типизация колонок, так и размещение в колонках значений произвольных типов.
Таблица значений имеет свойства и методы для работы с колонками и строками, которые рассмотрены в ниже.
Создание таблицы значений
Добавление колонок
// Добавление колонок в таблицу значений без указания типа ТабЗнач.Колонки.Добавить ( “Сотрудник” ); ТабЗнач.Колонки.Добавить ( “Должность” ); ТабЗнач.Колонки.Добавить ( “Оклад” ); // Добавление колонки с явным указанием типа значения и заголовком ОписаниеПремия = Новый ОписаниеТипов ( “Число” , Новый КвалификаторыЧисла ( 10 , 2 )); ТабЗнач.Колонки.Добавить ( “ПроцентПремии” , ОписаниеПремия, “Процент премии” ); ТабЗнач.Колонки.Добавить ( “Премия” , ОписаниеПремия, “Премия” );
Добавление новой строки, заполнение реквизитов
// Добавление новой строки в таблицу значений СтрокаТЗ = ТабЗнач.Добавить (); // Заполнение строки по именам реквизитов СтрокаТЗ.Сотрудник = “Иванов Иван” ; СтрокаТЗ.Должность = “Программист 1С” ; СтрокаТЗ.Оклад = 100000 ; СтрокаТЗ = ТабЗнач.Добавить (); // Заполнение строки таблицы значений по индексам колонок СтрокаТЗ [ 0 ] = “Петров Петр” ; СтрокаТЗ [ 1 ] = “Тестировщик” ; СтрокаТЗ [ 2 ] = 80000 ;
Обращение к строке таблицы значений по индексу
ТабЗнач.Добавить (); // Обращение к строке таблицы значений по индексу ТабЗнач [ 2 ] .Сотрудник = “Федоров Василий” ; // Работа с таблицей как с двумерным массивом ТабЗнач [ 2 ][ 1 ] = “Программист 1С” ; // Обращение к строке таблицы значений при помощи метода Получить ТабЗнач.Получить ( 2 ) .Оклад = 90000 ;
Вставить новую строку в нужное место и заполнить значения этой строки
// Вставить новую строку в указанную позицию в таблицу значений ВставленнаяСтрока = ТабЗнач.Вставить ( 1 ); // Заполнить строку значениями // В качестве источника данных заполнения могут быть объекты с именованными свойствами // – Структура, строка таблицы значений, объект, и т.п. // метод производит сопоставление свойств по именам, // и заполняет значения у совпавших свойств приемника – в нашем случае строки таблицы значений ЗаполнитьЗначенияСвойств ( ВставленнаяСтрока, СтрокаТЗ ); ВставленнаяСтрока.Сотрудник = “Сидоров Александр” ;
Заполнить колонку таблицы одним значением для всех строк
// Заполнение колонки для всех строк таблицы значений ТабЗнач.ЗаполнитьЗначения ( 10.5, “ПроцентПремии” );
Перебор строк и колонок таблицы значений
// Коллекция строк и коллекция колонок по своему поведению похожи на массивы, // и работать с ними можно схожим образом // Перебрать все колонки таблицы значений и вывести заголовки, // а если не заполнен заголовок – то имя колонки Для Каждого Колонка из ТабЗнач.Колонки Цикл Сообщить ( ? ( ЗначениеЗаполнено ( Колонка.Заголовок ) ,Колонка.Заголовок, Колонка.Имя )); КонецЦикла ; // Перебрать все строки и произвести какие-то вычисления, // например, посчитать премию, как Оклад * процент премии /100 Для Каждого СтрокаТЗ из ТабЗнач Цикл СтрокаТЗ.Премия = СтрокаТЗ.Оклад * СтрокаТЗ.ПроцентПремии / 100 ; КонецЦикла ;
Копирование таблицы значений в 1С - примеры
Сортировка таблицы значений в 1С 8
// Сортировать таблицу значений по колонке в 1С 8 КопияТЗ.Сортировать ( “Оклад” ); // Сортировать таблицу значений по нескольким колонкам в 1С 8 КопияТЗ.Сортировать ( “Должность Убыв, Оклад Возр” );
Свернуть таблицу значений
// Просуммировать значения в одних колонках, свернув таблицу значений в разрезе других колонок // При использовании метода Свернуть, все не использованные в методе колонки удалятся! // Первым параметром идет список колонок через запятую, по которым мы хотим получить группировки // Вторым параметром идет список колонок, значения в которых нужно просуммировать // В этом примере в таблице значений КопияТЗ останутся только колонки Должность и Оклад КопияТЗ.Свернуть ( “Должность” , “Оклад” );
Удаление строк табличной части по условию. Обратный обход таблицы значений снизу вверх
Поиск строк в таблице значений 1С
// Найти одну строку в таблице значений по значению во всех колонках. // Метод целесообразно использовать для поиска уникальных значений НайденнаяСтрока = ТабЗнач.Найти ( “Федоров Василий” ); // Найти строку по значению с поиском по определенным колонкам // При поиске по неуникальным значениям следует учитывать, что метод вернет первую попавшуюся строку НайденнаяСтрока = ТабЗнач.Найти ( 10.5, “Премия, ПроцентПремии” );
Табличные части позволяют хранить неограниченное количество структурированной информации, принадлежащей одному объекту.
Рассмотрим некоторые приемы работы с табличными частями.
Как обойти табличную часть
Для обхода табличной части можно использовать цикл Для каждого
Для каждого Строка из ТабличнаяЧасть Цикл
Сообщить ( Строка . РеквизитТабличнойЧасти ) ;
На каждой итерации в переменную Строка передается очередная строка табличной части. Значения реквизитов строки можно получить выражением Строка.ИмяРеквизита.
Как получить и обойти выделенные строки табличной части
Для вывода информации из табличной части объекта служит элемент формы Табличное поле. Для включения возможности выделения нескольких строк на табличном поле нужно установить значение Множественный у его свойства Режим выделения.
Для получения перечня выделенных строк используется следующий код:
Для того чтобы обойти выделенные строки используется цикл Для каждого:
ВыделенныеСтроки = ЭлементыФормы . ИмяТабличногоПоля . ВыделенныеСтроки ;
Для каждого Строка из ВыделенныеСтроки Цикл
Как программно выделить строки табличной части (табличного поля) и снять выделение
Чтобы программно снять выделение строк табличного поля:
Чтобы программно выделить все строки табличного поля:
Для каждого ТекущаяСтрока Из ТабличнаяЧасть Цикл
ЭлементыФормы . ИмяТабличногоПоля . ВыделенныеСтроки . Добавить ( ТекущаяСтрока ) ;
КонецЦикла ;
Как очистить табличную часть
Как получить текущую строку табличной части
Текущая строка — это срока, в которой у пользователя в данный момент находится курсор. Чтобы ее получить, нужно обратиться к элементу управления на форме, который связан с табличной частью.
Для обычных форм код будет выглядеть так:
Для управляемых форм:
Как добавить новую строку в табличную часть
Добавление новой строки в конец табличной части:
Добавление новой строки в любое место табличной части (последующие строки будут сдвинуты):
НоваяСтрока = ТабличнаяЧасть . Вставить ( Индекс )
//Индекс - номер добавляемой строки. Нумерация строк начинается с нуля.
НоваяСтрока . Реквизит 1 = "Значение" ;
Как программно заполнить реквизиты строки табличной части
Если нужно программно заполнить реквизиты строки табличной части, которую добавляет пользователь, необходимо использовать обработчик события табличной части ПриНачалеРедактирования.
Создаваемая обработчиком процедура имеет три параметра:
- Элемент — содержит элемент управления ТабличноеПоле.
- НоваяСтрока — булево. Содержит значение Истина, если добавляется новая строка табличной части, и Ложь, если пользователь начал редактировать уже существующую строку.
- Копирование — булево. Содержит значение Истина, если пользователь копирует строку, и Ложь в остальных случаях.
Рассмотрим пример. Допустим, нам нужно заполнить реквизит табличной части СчетУчета, в случае, когда добавляется новая строка. При редактировании существующей строки изменять счет учета не нужно.
Процедура ТабличнаяЧастьПриНачалеРедактирования ( Элемент , НоваяСтрока , Копирование )
//Если пользователь редактирует существующую строку, то ничего не делаем
Если НЕ НоваяСтрока Тогда
Возврат ;
КонецЕсли ;
//Если же строка новая, устанавливаем счет учета
ТекСтрока = Элемент . ТекущиеДанные ; //Получили текущую строку табличной части
ТекСтрока . СчетУчета = ПланыСчетов . Хозрасчетый . НужныйСчетУчета ;
КонецПроцедуры
Работа с табличной частью объектов в 1С : 13 комментариев
Сделать это можно по-разному. Цикл Для каждого, на мой взгляд, не очень подходящий вариант, т.к. будет работать слишком долго. Да и надо еще где-то список документов брать.
Спасибо!
Буду пробовать.
А может это подойдет?
Табличная часть (Tabular section)
Итог (Total)
Синтаксис:
Тип: Число; Строка.
Индекс либо имя колонки, по которой подсчитывается итог.
Возвращаемое значение:
Тип: Число; Неопределено.
Суммирует значения всех строк в указанной колонке.
Если в колонке установлен тип и он единственный, то при суммировании будет предприниматься попытка преобразования значения к типу Число.
Если колонке не присвоены типы, то в процессе суммирования будут принимать участие только значения, имеющие тип Число, значения других типов будут игнорироваться.
Если в колонке несколько типов и среди них есть тип Число, то в процессе суммирования будут принимать участие только значения, имеющие тип Число, значения других типов будут игнорироваться.
Если в колонке несколько типов и среди них нет типа Число, то результатом будет значение Неопределено.
Сервер, толстый клиент, внешнее соединение.
Пример:
Это подошло бы, если бы нужно было суммировать колонку в одном документе. А Юрию нужно суммировать колонку Стоимость всех документов.
Добрый день!
Достаточно ли будет обратиться в модуле формы к текущей строке табличной части или в модуле менеджера тоже нужно будет что-то прописать?
Не совсем понял, о чем конкретно вопрос.
Если о том, как получать и работать с текущей строкой табличной части, то в модуле менеджера ничего писать не нужно.
Здравствуйте!
Опишу вкратце ситуацию:
Из документа вызывается команда печати штрихкодов и в обработку печати передается, как я понимаю, весь контекст документа и печатаются этикетки для всех строк документа. Возможно ли в обработке печати получить информацию только о выделенных строках из этого контекста ? Прилагаю код модуля команды ПечатьЭтикеток.
&НаКлиенте
Процедура ОбработкаКоманды(ПараметрКоманды, ПараметрыВыполненияКоманды)
ТабДокумент.АвтоМасштаб = истина ;
ТабДокумент.ОтображатьСетку = Ложь;
ТабДокумент.ТолькоПросмотр = Истина;
ТабДокумент.ОтображатьЗаголовки = Ложь;
ЧтоТо = Стр.СерийныйНомер;
ПервыйМодуль.ВывестиШтрихкодДокументаВОбластьМакета(ВнешняяКомпонента,ОбластьМакета,ЧтоТо) ;
Информацию о выделенных строках вы можете получить только в модуле формы документа, причем, если мне не изменяет память, это должна быть клиентская процедура. По ссылке на документ выделенные строки получить нельзя.
Значит я на клиенте должен сформировать таблицу выделенных строк и уже ее передавать в обработку печати ?
Да, логика такая. Только учтите, что таблица значений не передается с клиента на сервер.
Выделенный строки табличного поля на форме — это массив строк. Надо попробовать, передастся ли он. Если да, хорошо. Если нет — надо думать, как его передать.
Доброго времени суток!
Создаю обработку на обычных формах, в которой имеется несколько Табличных частей. Они в свою очередь находят отображение в Форме обработки. И если данные первых 3, меня после закрытия Формы, не интересуют, то данные последней хотелось-бы использовать в дальнейшем, пока открыта обработка. В настоящее время при закрытии Формы Табличные части очищаются. В дальнейшем, в новом сеансе работы с обработкой эти данные не нужны. Насколько я понимаю Функции сохранения Данных Табличной части обработки не существует. Табличную часть в обработке решил использовать из-за возможности сохранить структуру Данных. Как мне сохранить эти данные для использования в других окнах?
Может у Вас есть видео по данному вопросу?
Создание таблицы значений
Таблица значений — это двумерный массив в 1С, который предназначен для хранения и обработки промежуточных данных, возникающих в процессе работы программы. Таблица значений часто применяется при программировании на 1С, потому что имеет множество полезных возможностей и работает очень быстро. Таблица значений создается в памяти и не сохраняется в базе данных, т.е. это временный набор данных.
//можно указать тип данных каждой колонки
//если тип данных колонки не указан, то можно хранить данные любого типа
Синтаксис: НоваяКолонка( , , , , , , , )
Добавление строк в таблицу значений
Перебор строк таблицы значений
ТабЗнач.ВыбратьСтроки();
Пока ТабЗнач.ПолучитьСтроку()=1 Цикл
. Сообщить(ТабЗнач.Сотрудник);
КонецЦикла;
2-й способ.
Для НомерСтроки = 1 По ТабЗнач.КоличествоСтрок() Цикл
. ТабЗнач.ПолучитьСтрокуПоНомеру(НомерСтроки);
. Сообщить(ТабЗнач.Сотрудник);
КонецЦикла;
Сортировка таблицы значений
//сортировать по должности по возрастанию, а внутри должности по убыванию оклада
ТабЗнач.Сортировать(«Должность+,Оклад-«);
Поиск в таблице значений
Синтаксис: НайтиЗначение( , , )
Возвращает число: 0 — значение не найдено; 1 — значение найдено
Если указан параметр , то поиск производится только по заданной строке
Если указан параметр , то поиск производится только по заданной колонке
Итоги и группировка таблицы значений
//часто требуется группировать строки и подсчитывать итоги по группам,
//в этом случае применяется метод Свернуть
Удаление строк и колонок из таблицы значений
ТабЗнач.Очистить(); //очистить таблицу значений и удалить колонки
ТабЗнач.УдалитьСтроки(); //удаляет все строки (колонки сохраняются)
ТабЗнач.УдалитьСтроку(); //удаляет текущую строку
ТабЗнач.УдалитьСтроку(3); //удаляет 3-ю строку
ВНИМАНИЕ
Часто требуется удалить строки, удовлетворяющие определенному условию.
Так как при удалении строки из таблицы значений следующая строка становится текущей,
то указанная ниже программа может удалить НЕ ВСЕ необходимые строки.
//ЭТА ПРОГРАММА НЕПРАВИЛЬНАЯ .
ТабЗнач.ВыбратьСтроки();
Пока ТабЗнач.ПолучитьСтроку()=1 Цикл
. Если Тогда
. ТабЗнач.УдалитьСтроку(); //следующая строка стала текущей,
. КонецЕсли;
КонецЦикла;
В этом случае я рекомендую использовать следующий прием:
ТабЗнач.ВыбратьСтроки();
Пока ТабЗнач.ПолучитьСтроку()=1 Цикл
начало:
. Если Тогда
. ТабЗнач.УдалитьСтроку(); //следующая строка стала текущей
. Если ТабЗнач.НомерСтроки<>0 Тогда
. Перейти
начало;
. КонецЕсли;
. КонецЕсли;
КонецЦикла;
А вот еще один правильный алгоритм, предложенный Wlad:
ТабЗнач.выбратьстроки();
Пока ТабЗнач.ПолучитьСтроку()=1 Цикл
. Пока ( ) и (ТабЗнач.НомерСтроки<>0) Цикл
. ТабЗнач.УдалитьСтроку(); //следующая строка стала текущей
. КонецЦикла;
КонецЦикла;
Таблица значений как элемент диалога
Таблица значений может использоваться в экранных формах как элемент диалога с пользователем.
//установить курсор на указанную колонку или можно узнать, где находится курсор
ТабЗнач.ТекущаяКолонка(НоваяКолонка,ТекКолонка);
//установить курсор на указанную строку или можно узнать, где находится курсор.
ТекСтрока = ТабЗнач.ТекущаяСтрока(НовСтрока);
//можно зафиксировать верхние строки и левые колонки для удобства прокрутки таблицы значений в диалоге
ТабЗнач.Фиксировать(КолСтрок,КолКолонок);
Методы УстановитьЗначение и ПолучитьЗначение
Эти методы позволяют обращаться к данным в таблице значений для чтения и записи.
Они могут пригодиться в особых случаях при написании универсальных программ (мастеры отчетов и т.д.).
Синтаксис: УстановитьЗначение( , , )
Синтаксис: ПолучитьЗначение( , )
Выгрузка таблицы значений
1С работа с таблицей значений
Создадим структуру поиска, каждый элемент которой будет содержать имя колонки в качестве ключа и искомое значение в этой колонке – в качестве значения. Передаем СтруктуруПоискав качестве параметра методу НайтиСтроки(). В результате получеем массив строк таблицы.
Если в структуру поиска добавить поиск нужного значения, например, еще и в колонке Ответственный, то в результате применения метода НайтиСтроки() получим все строки, где и Сотрудник, и Ответственный равны искомому значению.
7. Как перебрать таблицу значений в произвольном порядке
10. Как заполнить таблицу значений, если имена колонок содержатся в переменных?
Применяем для таблицы значений метод ЗаполнитьЗначения(). Первым параметром передаем заполняемое значение. Вторым параметром – имя заполняемой колонки.
Если ТаблицаПолучатель на момент выполнения операции еще не существует или ее предыдущие колонки сохранять не нужно, можно создать ее как полную копию исходной
Вариант второй: таблица ТаблицаПолучатель существует, и жалко терять ее колонки и ограничения на типы данных колонок. Но нужно заполнить данные по колонкам, имена которых совпадают с именами исходной таблицы.
Частичный перенос данных для колонок с совпадающими именами:
Для каждой строки исходной таблицы добавляется новая строка в таблицу-получатель и выполняется заполнение значений в тех колонках новой таблицы, имена которых совпадают с именами колонок в исходной таблице
Если у таблиц не будет колонок с одинаковыми именами, таблица-получатель будет в результате содержать столько же строк с пустыми значениями, сколько строк было в таблице-источнике.
Если у каких-то одноименных колонок тип значения данных из таблицы-источника не попадет в массив разрешенных типов колонки таблицы-получателя, в таких полях получим пустые значения.
Рассмотрим третий случай. В случае одноименных колонок колонку таблицы-получателя нужно привести в полное соответствие колонке таблицы-источника.
Полное копирование данных для колонок с совпадающими именами
Нам придется заменить колонку в таблице-получателе на новую, чьи свойства полностью будут соответствовать колонке таблицы-источника.
Поэтому в случае обнаружения в таблице-получателе одноименной колонки собираем в переменных все свойства для новой колонки. Далее удаляем старую и создаем новую колонку. Затем выполняем цикл перебора строк исходной таблицы.
В цикле добавляем к таблице-получателю новую строку и открываем цикл перебора имен колонок в массиве совпадающих колонок.
Внутри этого вложенного цикла производим заполнение ячеек таблицы-получателя данными ячейки таблицы-источника.
При добавлении колонки можно просто указать ее имя, а второй параметр метода Добавить() не трогать. В этом случае тип данных колонки – произвольный .
Добавление колонки без указания типа данных
Можно заполнить значение второго параметра. Туда необходимо передавать описание разрешенного для колонки типа. Само описание можно получить при помощи конструктора, передав последнему в качестве параметра строковое название типа (если много типов, то через запятую) или массив допустимых типов.
Добавление колонки с указанием типа данных
Если среди типов, разрешенных к заполнению данных колонки, есть строка, можно ограничить ее разрядность (длину), указать использование переменной или фиксированной длины. Все это обеспечивается созданием объекта при помощи конструктора КвалификаторыСтроки. Далее этот объект будет использован в качестве одного из параметров конструктора ОписаниеТипов.
Использование квалификаторов для уточнения типа данных колонки таблицы значений
Использование существующих описаний типов для указания типа данных колонки таблицы значений
Работаем с таблицей значений программно
ТаблицаЗначений — это программный объект встроенного языка, позволяющий строить произвольные наборы данных в памяти компьютера, отображать их в табличном виде, а также программно и интерактивно манипулировать ими (добавлять, редактировать, удалять и сортировать).
Таблицы состоят из строк и колонок. Строки располагаются вниз по вертикали, а колонки — вправо по горизонтали. Строки имеют последовательную целочисленную нумерацию (начиная с 1). И строки, и колонки имеют индексы, по которым к ним можно обращаться напрямую (начинаются с 0). Кроме этого, к колонкам можно обращаться по идентификатору.
Пересечения строк и колонок образуют ячейки, в которых содержатся значения. Тип значения определяется типом значения колонки.
Таблица значений является полностью динамическим объектом, т.е. Вы можете манипулировать не только строками таблицы, добавляя и удаляя их, но и колонками.
Таблица значений может использоваться явно при создании в коде необходимого количества переменных типа ТаблицаЗначений , либо неявно: при добавлении элемента управления ТабличноеПоле на обычную форму, и ТаблицаФормы — на управляемую. Здесь мы рассмотрим только программную работу с таблицей значений.
Создание таблицы значений
Как и большинство объектов встроенного языка, новая таблица значений может быть создана с помощью оператора Новый :
Колонки таблицы значений
Прежде чем начать работу с таблицей значений, необходимо создать структуру колонок. Каждая колонка характеризуется следующими свойствами:
- Имя — идентификатор колонки (может содержать только алфавитные символы, цифры и знаки подчеркивания. Причем, начинаться имя колонки может только с буквы или символа подчеркивания);
- Заголовок — представление колонки в диалогах (может содержать произвольные символы);
- ТипЗначения — тип значения содержимого ячеек в этой колонке. Если тип не задан, в ячейке можно хранить значения произвольного типа;
- Ширина — ширина колонки в диалогах;
Доступ к колонкам производится через свойство Колонки объекта ТаблицаЗначений . Для добавления новой колонки используется метод Добавить():
Для того, чтобы определить наличие колонки с нужным именем используется метод Найти():
Перебор колонок выполняется следующим образом:
Для удаления колонки используется метод Удалить():
Свойства колонки таблицы значений
| Имя | Тип | Описание |
|---|---|---|
| Имя | Строка | символьный идентификатор колонки, по которому к ней можно обращаться из кода |
| Заголовок | Строка | строковое представление колонки на форме |
| ТипЗначения | ОписаниеТипов | свойство органичивает пространство доступных значений, которые можно указать в данной колонке |
| Ширина | Число | ширина колонки на форме (выражается в количестве символов) |
Методы коллекции колонок таблицы значений
| Вставить() | Вставляет новую колонку в указанную позицию коллекции |
| Добавить() | Добавляет новую колонку в конец коллекции |
| Количество() | Возвращает количество колонок в коллекции |
| Найти() | Ищет колонку в коллекции по имени |
| Очистить() | Удаляет все колонки из коллекции |
| Сдвинуть() | Сдвигает колонку влево или вправо |
| Удалить() | Удаляет колонку из коллекции |
Строки таблицы значений
С колонками разобрались. Давайте теперь разберемся со строками. Строки таблицы значений можно программно добавлять и удалять, перемещать и сортировать, а также выполнять операции поиска и отбора.
Добавление и удаление строк
Для добавления новой строки используется метод Добавить() объекта ТаблицаЗначений . Метод возвращает объект СтрокаТаблицыЗначений , с которым доступны дальнейшие манипуляции:
Для удаления строки используется метод Удалить() объекта ТаблицаЗначений . Строку можно удалить либо передав методу непосредственно строку, либо ее индекс:
Перебор строк таблицы значений
Для перебора строк удобнее всего использовать оператор цикла Для Каждого . В редких случаях оправдано применение цикла Для :
Поиск строк
Как работать с таблицей значений в 1С 8.2 – 8.3
Таблица значений — это не сохраняемый в базе данных объект, предназначенный для создания динамических наборов данных.
Таблица значений состоит из строк и колонок. В отличие от списка значений, таблица значений имеет структуру, которую определяет разработчик.
Объект ТаблицаЗначений имеет много полезных методов для обработки данных. Разработчик средствами встроенного языка может добавлять и удалять строки и колонки, перебирать строки, искать значение, сортировать по любым колонкам и выполнять другие операции.
При создании новой таблицы значений в нее обычно добавляются колонки:
У таблицы значений есть свойство Колонки, которое представляет собой коллекцию колонок и позволяет добавлять, удалять и менять их порядок.
По умолчанию в таблице значений могут храниться значения разных типов. Но в 1С:Предприятии 8.0 для колонки можно задать список возможных типов значений. Это делается следующим образом (для повышения наглядности нам понадобится вспомогательная функция СоздатьОписаниеТипов):
При работе со строками таблицы значений необходимо понимать, что строка — это объект типа СтрокаТаблицыЗначений. Поэтому добавление строк в таблицу значений производится следующим образом:
Чтобы удалить колонки из таблицы значений нужно применить метод Очистить для свойства-коллекции Колонки:
Допускается также обращение к строке по индексу, при этом так-же возвращается объект типа СтрокаТаблицыЗначений. При работе с индексами необходимо всегда помнить, что индексация строк таблицы значений начинается с 0.
Часто возникает необходимость найти значение в таблице значений. Для решения этой задачи предназначены методы Найти и НайтиСтроки. В метод Найти передается искомое значение и список колонок, которые нужно просматривать. Если значение найдено, то возвращается строка таблицы значений, иначе — значение Неопределено.
Метод НайтиСтроки позволяет найти сразу несколько строк таблицы значений, удовлетворяющих заданному условию. В параметрах этого метода передается структура, задающая условия отбора. Ключ структуры определяет имя колонки, а ее значение — искомое значение. Метод НайтиСтроки возвращает массив, содержащий ссылки на найденные строки таблицы значений:
Внимание! Массив, возвращаемый методом НайтиСтроки, содержит строки таблицы значений (не их копии, а сами строки).При изменении какой-либо строки в таблице значений это отразится в массиве, и наоборот.
Таблица значений позволяет упорядочить содержащиеся в ней данные, для чего предназначен метод Сортировать:
Таблица значений имеет очень полезную возможность группировки строк и подсчета итогов по группе, что реализуется методом Свернуть, имеющим следующие параметры:
Этот метод осуществляет свертку таблицы значений по указанным колонкам группировки. Строки, у которых совпадают значения в колонках, указанных в первом параметре, сворачиваются в одну строку. Значения по этим строкам, хранящиеся в колонках, указанных во втором параметре, суммируются.
Внимание! Списки колонок для метода Свернуть не должны пересекаться. Колонки, не вошедшие ни в один из списков колонок, после выполнения метода удаляются из таблицы значений. Например, у нас есть таблица значений со следующими данными.
В следующем примере эта таблица сворачивается по колонкам Сотрудник и Год с подсчетом суммы по колонке Доход:
Если исходная таблица значений вам понадобится в дальнейшем, то лучше сделать копию таблицы значений и сворачивать уже ее:
Таблица значений позволяет подсчитать итог по колонке числового типа, например:
И последнее, о чем хотелось рассказать, из таблицы значений можно выгрузить целую колонку в массив и загрузить ее из массива:
Руководство 1С
Таблица значений 1С – предназначена для хранения и обработки данных. Очень часто используется программистами для хранения временных (промежуточных) данных.
В таблицах значений существуют строки и колонки. У каждой строки есть индекс, он начинается с 0 (нуля). Таблицу значений можно создавать с различными колонками и добавлять в нее строки. По строкам в таблице можно делать выборку и поиск, устанавливать и получать значения, сортировать, группировать и удалять строки.
Далее постараюсь дам ответы на вопросы, касающиеся таблиц значений 1С.
Как можно создать новую таблицу значений?
Как добавить новую колонку с определенным типом и заголовком?
Как можно добавить новые строки?
ВыбНоменклатура = Справочники.Номенклатура.Выбрать();
Пока ВыбНоменклатура.Следующий() Цикл
НоваяСтрока = ТабЗначений.Добавить();
НоваяСтрока. КолКод = ВыбНоменклатура.Код;
НоваяСтрока. КолНоменклатура = ВыбНоменклатура.Ссылка;
НоваяСтрока. КолКоличество = 1;
КонецЦикла;
Функция делает выборку по номенклатуре и добавляет полученные данные в таблицу значений.
Как выгрузить результат запроса в таблицу значений?
Как сделать выборку строк в таблице значений?
Для Каждого СтрокаТаб Из ТабЗначений Цикл
Сообщить(СтрокаТаб.КолНоменклатура);
КонецЦикла;
// Узнаем количество строк в таблице, так как индекс начинается с нуля, уменьшаем количество строк на 1 (одну).
КоличествоСтрок = ТабЗначений.Количество() — 1;
// Выполняем цикл по количеству строк
Для Н = 0 по КоличествоСтрок Цикл
Сообщить(ТабЗначений [Н]. КолНоменклатура);
КонецЦикла;
Как сделать выборку строк в таблице значений с отбором?
// Создаем отбор
ОтборСтруктура = Новый Структура;
ОтборСтруктура.Вставить(«КолНоменклатура «, СсылкаНоменклатура);
// Используем отбор в поиске строк
ТабЗначенийСтроки = ТабЗначений.НайтиСтроки(ОтборСтруктура);
Для Каждого СтрокаТаб Из ТабЗначенийСтроки Цикл
Сообщить(СтрокаТаб.КолКоличество);
КонецЦикла;
Как сделать сортировку?
Как вычислить итоги по колонке?
Как сделать копию таблицы значений?
Как свернуть таблицу значений по колонке Номенклатура и суммировать по количеству?
Как найти строку в таблице значений по значению?
Функция делает поиск по таблице и возвращает строку если строка найдена.
Как удалить строку или полностью очистит таблицу значений?
ТабЗначений.Удалить(0); // Удалит первую строку по индексу
ТабЗначений.Очистить(); // Полностью очистить таблицу
Как установить и получить значение?
Функция получает строку из таблицы значений по индексу
Как вставить значение в таблицу?
НоваяСтрока = ТабЗначений.Вставить(1);
НоваяСтрока.КолНоменклатура = ТекНоменклатура;
НоваяСтрока.КолКоличество = 5;
Функция вставляет строку по индексу и устанавливает значения.
Дополнительные функции, которые упрощают работу с таблицей значений в 1С
Таблица значений 1С. Оптимизация скорости в 100 раз
Поговорим о некоторых особенностях таблицы значений 1С. Как сделать работу с ней быстрее в 100 раз.
таблица значений 1С
Таблица значений 1С используется для оперативного хранения данных и их обработки. При большом числе строк скорость поиска данных резко снижается. Многие программисты недооценивают важность применения индексов, при поиске информации в таблице значений. Я намерен показать вам, что применение индексов ускоряет работу с ТЗ (таблица значений 1С) до 100 раз.
Итак, для тестирования я создал небольшой код, который работает примерно так.
- Извлекается 20 тысяч строк из табличной части документа "Реализация" в таблицу значений. Называется она Т1.
- Сделал копию этой же таблицы значений, вторую таблицу, назвал ее Т2. Итак, получилось 2 таблицы значений, Т1 и Т2, в каждой по 20 тысяч строк.
- Далее в цикле от 1 до 5 мы делаем пять проходов. Проход заключается в следующем:
- В цикле (который вложен в цикл от 1 до 5) перебираются все строки таблицы значений Т1, все 20 тысяч строк.
- Для каждой текущей строки Т1 извлекаем из таблицы значений Т1 значение в колонке "Сумма" - это число.
- Ищем строку в таблице значений Т2, содержащую в колонке "Сумма" тоже самое число, которое которое извлекли на предыдущем шаге.
- Измеряем время каждого прохода в миллисекундах и выводим на экран.
Другими словами, перебирая все строки одной таблицы значений 1С и запоминая значение столбца "Сумма" , мы ищем в другой таблице значений строку с той же самой суммой. Используется метод таблицы значений "Найти". В одном проходе операция поиска выполняется 20 тысяч раз. Проходов всего пять. Они необходимы для усреднения результатов эксперимента.
Ниже вы видите таблицу результатов работы теста. Второй столбец отражает время выполнения каждого из пяти проходов в обычном, не оптимизированном варианте запуска, а под столбцом стоит суммарное время выполнения теста, равное 279641 миллисекунды, или примерно 279 секунд. В третьем столбце показано время выполнения того же теста, но с оптимизированным вариантом поиска, с использованием индекса в таблице значений. Для наглядности я добавил в табличку время, затрачиваемое на создание индекса (первая строчка под заголовком), оно очень мало, всего 0, 047 секунды. Суммарное время выполнения теста во втором варианте равно 2781 миллисекунды, или 2,78 секунды.
Итак, в первом варианте имеем - 279 секунд, во втором варианте - 2,78 секунд. Разница в 100 раз ! Причем, такое ускорение достигается добавлением всего ОДНОЙ СТРОЧКИ КОДА!
| Время выполнения, миллисекунды | ||
| № тестового запуска | 1 вариант, обычный | 2 вариант, оптимальный |
| время на создание индекса | - | 47 |
| 1 | 46531 | 563 |
| 2 | 55516 | 547 |
| 3 | 60969 | 531 |
| 4 | 58688 | 562 |
| 5 | 57937 | 531 |
| Итоговое время | 279641 | 2781 |
| Ускорение в раз: | 100,5541172 | |
Вот полный код примера:
Пример откомментирован, и должен быть понятен. Главное заключается в строчке Т2.Индексы.Добавить("Сумма"); Мы сообщаем 1С, что мы собираемся выполнять операцию поиска по колонке "Сумма", в таблице значений Т1 и требуем создать индекс по этой колонке. Система создает индекс, и далее при всех операциях поиска по колонке "Сумма" использует его автоматически. Следует отметить, что созданный индекс действует только для поиска по колонке "Сумма", так как создан для этой колонки. Если нам нужны другие колонки для поиска, следует создать соответствующие индексы, с указанием нужных имен колонок.
К одной таблице мы можем создать несколько индексов, если мы собираемся искать значения для разных столбцов. Индексы хранятся в коллекции индексов таблицы значений 1С, что следует из кода: ТЗ.Индексы.Добавить(ИмяКолонки)
Если нам нужен поиск по комбинации значений колонок, например, одновременно по колонкам "Количество" и "Сумма" - следует создать составной индекс: Т2.Индексы.Добавить("Количество, Сумма") Такой индекс будет задействован, когда мы ищем значение в таблице при помощи метода "НайтиСтроки()" Например:
Функции 1С, используемые в тексте примера.
С уважением, Дегтярев Роман.
Как научиться программировать в 1С с нуля?
Как работать программистом 1С и получать до 150 000 рублей в месяц?
ЗАПИШИСЬ НА БЕСПЛАТНЫЙ
"ПРОГРАММИРОВАНИЕ в 1С ДЛЯ НОВИЧКОВ"
Курс придет на электронную почту. Стань программистом, выполняя пошаговые задания.
Читайте также: