Поиск по таблице значений 1с 8.2. Важно никогда не путать свойство объекта и метод объекта

Опубликовано 21 Сентябрь 2011

Таблица значений 1С – 3 часть. Метаданные. Перебор колонок таблицы значений

В этой статье я расскажу как работать с таблицей значений "неизвестной" структуры, как перебирать колонки таблицы значений, как извлекать данные из колонок и строк, не используя названия колонок. (Эта статья относится к циклу статей 1С с нуля; программирование 1с с нуля; таблица значений 1с)

Для объяснения материала и для того, чтобы можно было запустить наши примеры программного кода "в живую", нам необходимая некая тестовая таблица значений 1С . Часть наших примеров будет извлекать данные из таблицы значений, поэтому мы сделаем таблицу с тремя колонками "Фамилия", "Имя", "Отчество" и внесем в нее небольшое количество данных - аж целых 3 строки:)

Итак, создадим тестовую таблицу значений 1С и заполним ее:

МояТЗ = Новый ТаблицаЗначений; // создаем новую таблицу значений, хранящуюся в переменной "МояТЗ" МояТЗ.Колонки.Добавить("Фамилия"); // создаем колонку "Фамилия" МояТЗ.Колонки.Добавить("Имя"); // создаем колонку "Имя" МояТЗ.Колонки.Добавить("Отчество"); // создаем колонку "Отчество" // добавляем первую строку в нашу таблицу значений НоваяСтрока = МояТЗ.Добавить(); НоваяСтрока.Фамилия = "Чапаев"; НоваяСтрока.Имя = "Василий"; НоваяСтрока.Отчество = "Иванович"; // добавляем вторую строку НоваяСтрока = МояТЗ.Добавить(); НоваяСтрока.Фамилия = "Дзержинский"; НоваяСтрока.Имя = "Феликс"; НоваяСтрока.Отчество = "Эдмундович"; // добавляем третью строку НоваяСтрока = МояТЗ.Добавить(); НоваяСтрока.Фамилия = "Котовский"; НоваяСтрока.Имя = "Григорий"; НоваяСтрока.Отчество = "Иванович";

Наша тестовая таблица состоит из трех колонок: Имя, Фамилия, Отчество; и имеет три заполненных строки с фамилиями героев Гражданской войны.

Первый образец кода - перебор колонок таблицы значений 1С как коллекции.

// выводим названия всех колонок ТЗ Для Каждого Колонка Из МояТЗ.Колонки Цикл Сообщить("Имя колонки: " + Колонка.Имя); КонецЦикла;

Наш цикл выведет в окно сообщений 1С все имена колонок:

Имя колонки: Фамилия Имя колонки: Имя Имя колонки: Отчество

Мы видим, что для перебора колонок применяется специальный цикл перебора коллекции, похожий на цикл перебора строк (в прошлой статье). МояТЗ.Колонки - это коллекция колонок таблицы значений 1С "МояТЗ" . Коллекция содержит в себе объекты типа "КолонкаТаблицыЗначений" Каждый объект этого типа и является колонкой таблицы значений, и содержит свойства и методы. Обращаясь к этим свойствам и методам мы получаем нужные сведения об одной колонке или производим какие-то другие действия с ней.

Например, обращаясь к свойству "Имя" (Колонка.Имя ) мы получаем имя текущей колонки.

Хочу обратить ваше внимание на заголовок цикла: "Для Каждого Колонка Из МояТЗ.Колонки Цикл" Переменная с именем "Колонка" придумана нами. Необязательно использовать такое же имя. Можно назвать эту переменную как угодно, например "МояТекущаяКолонка" Тогда пример выше будет выглядеть таким образом:

// выводим названия всех колонок ТЗ Для Каждого МояТекущаяКолонка Из МояТЗ.Колонки Цикл Сообщить("Имя колонки: " + МояТекущаяКолонка.Имя); КонецЦикла;

Когда исполняющая подсистема 1С встречает цикл такого вида, при каждом проходе цикла она присваивает переменной с указанным именем один элемент из нашей коллекции, в данном случае - один элемент коллекции колонок таблицы значений МояТЗ.Колонки А далее мы обращаемся к переменной, которая содержит в себе текущую колонку, и используем свойство "Имя" .

Предлагаю рядом с именем колонки вывести еще и номер каждой колонки в коллекции колонок:

// выводим номер и названия всех колонок таблицы значений Для Каждого Колонка Из МояТЗ.Колонки Цикл НомерКолонки = МояТЗ.Колонки.Индекс(Колонка); // получаем номер колонки ИмяКолонки = Колонка.Имя; // получаем имя колонки Сообщить("Номер колонки:" + НомерКолонки + " Имя колонки: " + ИмяКолонки); КонецЦикла;

В окно сообщений 1С будет выведен текст:

Номер колонки:0 Имя колонки: Фамилия Номер колонки:1 Имя колонки: Имя Номер колонки:2 Имя колонки: Отчество

Обратим внимание на то, что колонки в таблице значений 1С нумеруются начиная с нуля, так же, как и строки таблицы значений.

Количество колонок в таблице значений 1С

Чтобы узнать количество колонок в таблице значений, мы используем метод "Количество()" у коллекции колонок.

КоличествоКолонок = МояТЗ.Колонки.Количество(); Сообщить(КоличествоКолонок);

На экране будет выведена цифра "3". Действительно, в нашей таблице три колонки: "Фамилия", "Имя", "Отчество"

Получение объекта- колонки по ее номеру (индексу) и перебор колонок при помощи индекса колонок

Сделаем цикл перебора всех колонок таблицы значений при помощи индексов колонок (номеров). Помним, что нумерация колонок начинается с нуля. Поэтому счетчик цикла "Сч" мы должны наращивать от нуля до числа, равного количеству колонок минус один.

Для Сч = 0 По МояТЗ.Колонки.Количество() - 1 Цикл ТекущаяКолонка = МояТЗ.Колонки[Сч]; Сообщить(ТекущаяКолонка.Имя); КонецЦикла;

На экране мы получим следующее

Фамилия Имя Отчество

Думаю, что этот пример был понятен. Мы обратились к методу Количество() коллекции колонок "МояТЗ.Колонки.Количество() ", получили количество колонок, и запустили цикл со счетчиком от нуля до количество колонок минус один . Внутри цикла мы получаем каждую колонку из коллекции колонок и присваиваем текущий объект-колонку в переменную ТекущаяКолонка Далее, у переменной ТекущаяКолонка мы обращаемся к свойству Имя и выводим значение этого свойства на экран: Сообщить(ТекущаяКолонка.Имя);

Важно никогда не путать свойство объекта и метод объекта.

Свойство - это некая статическая величина и обращение к нему пишется без скобок, например ТекущаяКолонка.Имя . А метод - это по сути, процедура или функция объекта, а вызовы процедур и функций всегда пишутся со скобками (даже если нет входных параметров). Например: МояТЗ.Колонки.Количество()

Если мы обратимся к методу, забыв написать скобки - интерпретатор 1С выдаст нам сообщение об ошибке и не запустит код на выполнение. Так как интерпретатор будет считать, что мы обращаемся не к методу, а к свойству - потому что нет скобок. А свойства с таким именем найти не сможет (потому что с таким именем имеется только метод) - о чем и будет сказано в сообщении об ошибке.

Вот что напишет интерпретатор, если я забуду поставит скобки в вызове метода таким неправильным способом МояТЗ.Колонки.Количество (без скобок после "Количество()"):

Поле объекта не обнаружено (Количество)

В данном случае "поле" и "свойство" следует понимать как синонимы, или неточность терминологии разработчиков 1С. Они используют оба этих слова для обозначения одного и того же понятия. Хотя в других языках программирования эти термины могут означать разные понятия.

Получение данных из таблицы значений 1С при помощи номеров колонок

Предлагаю вам, для начала, простой пример получения данных из первой строки нашей таблицы. Обратите внимание, что мы используем заранее заполненную таблицу из начала статьи. Мы точно знаем, что в таблице есть первая строка, и есть хотя бы одна колонка. Если мы применим этот пример к незаполненной таблице, то произойдет ошибка. Итак:

ПерваяСтрока = МояТЗ; // получаем первую строку (нумерация с нуля) ЗначениеПервойКолонки = ПерваяСтрока; // получаем значение первой колонки (нумерация колонок тоже с нуля) Сообщить(ЗначениеПервойКолонки); // выводим на экран значение первого столбца в первой строке таблицы

На экран будет выведено:

Чапаев

Сначала мы получили объект-строку таблицы значений, обратившись к таблице значений при помощи оператора [...]. (если забыли, как это делается, можно посмотреть предыдущие статьи) Внутрь оператора мы передали аргумент "0". Это индекс первой строки таблицы значений. ПерваяСтрока = МояТЗ;

Далее, к объекту-строке мы тоже имеем право обратиться при помощи оператора [...]. Внутрь этого операторы мы передали номер столбца таблицы значений, в данном случае тоже "0". И, таким образом, мы получили значение столбца с номером "0" для текущей строки таблицы под номером "0". Это значение мы вывели на экран и оно представляет собой строку "Чапаев".

Немного усложним наш пример:

ПерваяСтрока = МояТЗ; // получаем первую строку (нумерация с нуля) Сообщить(ПерваяСтрока); // выводим на экран значение первого столбца в первой строке таблицы Сообщить(ПерваяСтрока); // выводим на экран значение второго столбца в первой строке таблицы Сообщить(ПерваяСтрока); // выводим на экран значение третьего столбца в первой строке таблицы

Теперь мы вывели на экран значения из всех трех столбцов первой строки нашей таблицы значений:

Чапаев Василий Иванович

Теперь я еще модифицирую этот пример, чтобы нам обойтись без переменной "ПерваяСтрока"

Сообщить(МояТЗ); // выводим на экран значение первого столбца в первой строке таблицы Сообщить(МояТЗ); // выводим на экран значение второго столбца в первой строке таблицы Сообщить(МояТЗ); // выводим на экран значение третьего столбца в первой строке таблицы

На экране будет тоже самое

Чапаев Василий Иванович

Мы увидели в примере выше, что для обращения к значению, находящемуся в конкретной строке и конкретном столбце таблицы значений мы можем использовать последовательный вызов двух операторов [...] в такой форме: ТаблицаЗначений[ИндексСтроки][ИндексКолонки]

Значит, мы готовы к тому, чтобы создать цикл перебора и получить данные всех строк и всех столбцов при помощи индексов строк и столбцов:

Для СчетчикСтрок = 0 По МояТЗ.Количество() - 1 Цикл // цикл перебора строк Для СчетчикКолонок = 0 По МояТЗ.Колонки.Количество() - 1 Цикл // вложенный цикл перебора столбцов // получаем значение ячейки (из текущей строки и текущей колонки) ЗначениеЯчейки = МояТЗ[СчетчикСтрок][СчетчикКолонок]; // выводим на экран номер строки, номер колонки и значение ячейки Сообщить("Строка №" + СчетчикСтрок + " столбец №" + СчетчикКолонок + " = " + ЗначениеЯчейки); КонецЦикла; КонецЦикла;

На экран будет выведено следующее:

Строка №0 столбец №0 = Чапаев Строка №0 столбец №1 = Василий Строка №0 столбец №2 = Иванович Строка №1 столбец №0 = Дзержинский Строка №1 столбец №1 = Феликс Строка №1 столбец №2 = Эдмундович Строка №2 столбец №0 = Котовский Строка №2 столбец №1 = Григорий Строка №2 столбец №2 = Иванович

При помощи двух циклов, один из которых вложен в другой, мы вывели на экран значения всех колонок из всех строк таблицы значений 1С. При этом мы не использовали имена колонок, а обращались к колонкам и строкам по их индексам. Для большего понимания обратите внимание на комментарии внутри примера.

Предлагаю, в заключение, немного изменить наш пример, чтобы он вместо номеров колонок выводил на экран их названия. И дополнительно сделаю более презентабельное оформление выдачи содержимого на экран.

Для СчетчикСтрок = 0 По МояТЗ.Количество() - 1 Цикл // цикл перебора строк Сообщить(" ======= Строка № " + СчетчикСтрок + " ======="); Сообщить(" "); // перевод строки (вставка пустой строки) Для СчетчикКолонок = 0 По МояТЗ.Колонки.Количество() - 1 Цикл // вложенный цикл перебора столбцов // получаем значение ячейки (из текущей строки и текущей колонки) ЗначениеЯчейки = МояТЗ[СчетчикСтрок][СчетчикКолонок]; // получаем имя колонки ИмяКолонки = МояТЗ.Колонки[СчетчикКолонок].Имя; // выводим на экран имя колонки и значение ячейки Сообщить(ИмяКолонки + ": " + ЗначениеЯчейки); КонецЦикла; Сообщить(" "); // перевод строки (вставка пустой строки) КонецЦикла;

Сейчас, на нашем экране информация стала выглядеть более представительно:

Строка № 0 ======= Фамилия: Чапаев Имя: Василий Отчество: Иванович ======= Строка № 1 ======= Фамилия: Дзержинский Имя: Феликс Отчество: Эдмундович ======= Строка № 2 ======= Фамилия: Котовский Имя: Григорий Отчество: Иванович

Да, чуть не забыл. При использовании подряд двух операторов [...][...], мы можем вместо индекса колонки передавать имя этой колонки: ТаблицаЗначений[ИндексСтроки][ИмяКолонки]

Для СчетчикСтрок = 0 По МояТЗ.Количество() - 1 Цикл // цикл перебора строк Сообщить(" ======= Строка № " + СчетчикСтрок + " ======="); Сообщить(" "); // перевод строки (вставка пустой строки) Для СчетчикКолонок = 0 По МояТЗ.Колонки.Количество() - 1 Цикл // вложенный цикл перебора столбцов ИмяКолонки = МояТЗ.Колонки[СчетчикКолонок].Имя; // получаем имя колонки ЗначениеЯчейки = МояТЗ[СчетчикСтрок][ИмяКолонки]; //

Обратите внимание на строку, отмеченную стрелочкой ". В этой строке мы вместо индекса текущей колонки передаем имя текущей колонки в аргумент в квадратных скобках [...] Результат будет тот же самый.

А сейчас, последнее в этой статье.

ПРАВИЛЬНОЕ получение всех данных таблицы значений 1С, при помощи циклов перебора коллекции строк и коллекции колонок

Для Каждого ТекущаяСтрока Из МояТЗ Цикл // цикл перебора коллекции строк Сообщить(" ======= Строка № " + МояТЗ.Индекс(ТекущаяСтрока) + " ======="); Сообщить(" "); Для Каждого ТекущаяКолонка Из МояТЗ.Колонки Цикл // вложенный цикл перебора коллекции столбцов ИмяКолонки = ТекущаяКолонка.Имя; // получаем имя колонки ЗначениеЯчейки = ТекущаяСтрока[ИмяКолонки]; // получаем значение ячейки ПО ИМЕНИ колонки Сообщить(ИмяКолонки + ": " + ЗначениеЯчейки); // выводим на экран имя колонки и значение ячейки КонецЦикла; Сообщить(" "); КонецЦикла;

В примере было использовано два цикла. Цикл перебора коллекции колонок вложен внутрь цикла перебора строк. Если вы разбирались с примерами выше, и читали предыдущие статьи, то у вас не будет затруднений в понимании работы этого примера.

Напоследок, я максимально сокращу количество строк кода нашего последнего примера, исключив использование промежуточных переменных. Мы получим образец "промышленного кода", который используется в реальных задачах.

Это следует делать только тогда, когда вы хорошо понимаете то, что делаете. Если же код очень сложен, то допустимо оставлять промежуточные переменные, чтобы облегчить понимание собственного кода впоследствии. Так же любой код необходимо хотя бы минимально комментировать, чтобы спустя какое-то время было легче разобраться с текстами программы.

Для Каждого ТекущаяСтрока Из МояТЗ Цикл // перебор строк Сообщить(" ======= Строка № " + МояТЗ.Индекс(ТекущаяСтрока) + " =======" + Символы.ПС); Для Каждого ТекущаяКолонка Из МояТЗ.Колонки Цикл // перебор столбцов Сообщить(ТекущаяКолонка.Имя + ": " + ТекущаяСтрока[ТекущаяКолонка.Имя]); КонецЦикла; Сообщить(" "); КонецЦикла;

Вывод на экран не изменился, остался такой же, как в прошлом примере:

2-НЕДЕЛЬНЫЙ КУРС

"ПРОГРАММИРОВАНИЕ в 1С ДЛЯ НОВИЧКОВ"

Курс придет на электронную почту. Стань программистом, выполняя пошаговые задания.

Для участия нужен только компьютер и интернет

Бесплатный доступ на курс:

Sp-force-hide { display: none;}.sp-form { display: block; background: #eff2f4; padding: 5px; width: 270px; max-width: 100%; border-radius: 0px; -moz-border-radius: 0px; -webkit-border-radius: 0px; font-family: Arial, "Helvetica Neue", sans-serif; background-repeat: no-repeat; background-position: center; background-size: auto;}.sp-form input { display: inline-block; opacity: 1; visibility: visible;}.sp-form .sp-form-fields-wrapper { margin: 0 auto; width: 260px;}.sp-form .sp-form-control { background: #ffffff; border-color: #cccccc; border-style: solid; border-width: 1px; font-size: 15px; padding-left: 8.75px; padding-right: 8.75px; border-radius: 4px; -moz-border-radius: 4px; -webkit-border-radius: 4px; height: 35px; width: 100%;}.sp-form .sp-field label { color: #444444; font-size: 13px; font-style: normal; font-weight: bold;}.sp-form .sp-button { border-radius: 4px; -moz-border-radius: 4px; -webkit-border-radius: 4px; background-color: #f4394c; color: #ffffff; width: 100%; font-weight: 700; font-style: normal; font-family: Arial, "Helvetica Neue", sans-serif; box-shadow: none; -moz-box-shadow: none; -webkit-box-shadow: none; background: linear-gradient(to top, #e30d22 , #f77380);}.sp-form .sp-button-container { text-align: center; width: auto;}

(Эта статья относится к циклу статей 1С с нуля; программирование 1с с нуля; таблица значений 1с)

Виртуальная структура-хранилище данных в табличной форме - вот что такое

Таблица значений не является постоянным объектом базы данных 1С, и не сохраняется между сеансами запуска.

Таблица значений 1С (ТЗ) создается "на лету" при помощи программного кода,и далее работа с ней осуществляется так же, с любым другим программным объектом языка программирования 1С. С помощью вызовов методов и обращений к свойствам таблицы-объекта.

Другими словами, программист создает таблицу в памяти, наполняет ее данными, работает с ней, сортирует, группирует, вычисляет итоги и так далее. Получает нужные данные для дальнейшего использования.

Создадим таблицу значений и заполним ее чем-нибудь. Нужно помнить, что таблицу значений 1С можно создать не только вручную, вызовом оператора

Новый ТаблицаЗначений;

Таблица значений часто является результатом вызова метода другого объекта, например результат выполнения запроса может быть выгружен в таблицу значений, и так далее.

Сразу приведу простой пример.

// МояТЗ = Новый ТаблицаЗначений; // создаем новую таблицу значений, хранящуюся в переменной "МояТЗ" МояТЗ. Колонки. Добавить("Фамилия" ) ; // создаем колонку "Фамилия" МояТЗ. Колонки. Добавить("Имя" ) ; // создаем колонку "Имя" Сообщить (МояТЗ) ; // вывести значение переменной МояТЗ //

Я создал таблицу значений 1С, с двумя колонками: "Фамилия", "Имя". Процедура Сообщить(МояТЗ) выведет в окно сообщений тип переменной МояТЗ : ТаблицаЗначений

Наша таблица значений пока пустая. Добавим в нее пару строк, с именами и фамилиями.

// заполняем таблицу значений // добавляем первую строку в нашу таблицу значений НоваяСтрока = МояТЗ. Добавить() ; НоваяСтрока. Фамилия = "Сидоров" ; НоваяСтрока. Имя = "Вася" ; // добавляем вторую строку в нашу таблицу значений НоваяСтрока = МояТЗ. Добавить() ; НоваяСтрока. Фамилия = "Иванов" ; НоваяСтрока. Имя = "Петя" ;

Мы получили таблица такого вида:

Нужно запомнить: номера строк в таблице значений начинаются с нуля

Для чего нам вообще нужны номера строк? А для того, чтобы мы могли обратиться к отдельной строке таблицы значений, например, взять и вывести эту строку на экран.

// *** выводим значений нулевой строки на экран *** (в быту мы обычно нумеруем вещи с единицы, а здесь - с нуля) // получаем нулевую строку нашей таблицы при помощи индекса строки в квадратных скобках НашаНулеваяСтрока = МояТЗ[ 0] ; // теперь вся нулевая строка содержится в переменной "НашаПерваяСтрока" Сообщить (НашаНулеваяСтрока. Фамилия) ; // выводим на экран значение столбца "Фамилия", хранящееся в нулевой строке Сообщить (НашаНулеваяСтрока. Имя) ; // выводим на экран значение столбца "Имя", из этой же строки

В результате на экран будет выведено:

Сидоров Вася

Теперь для очень умных и лаконичных покажу пример, который позволяет обратиться к значению колонки в ой-то строке (Значений колонки в такой-то строке - это ячейка таблицы значений. Неофициальный термин, зато удобный). Но без использования промежуточной переменной, наподобие "НашаНулеваяСтрока".

Чтобы вывести значение ячеек из второй строки (не забываем, что строка вторая, но индекс этой строки равен единица, так нумерация начинается с нуля)

Наконец, заключительный момент в этой статье. Я показал вам пример обращения к отдельной строке таблицы значений по индексу (номеру строки). Универсальная форма для чтения или присвоения содержимого ячейки такова: "МояТаблицыЗначений[НомерСтроки].ИмяКолонки"

Теперь приведу для вас сразу, цикл полного вывода содержимого таблицы значений. Без подробных объяснений, чтобы вы тоже могли поломать голову:)

// // цикл перебора и вывода всех строк нашей таблицы значений // Для НомерСтроки = 0 По МояТЗ. Количество() - 1 Цикл Сообщить (МояТЗ[ НомерСтроки] . Фамилия) ; // выводим на экран значение столбца "Фамилия" Сообщить (МояТЗ[ НомерСтроки] . Имя) ; // выводим на экран значение столбца "Имя" КонецЦикла ;

В результате запуска этого цикла на экран будет выведено:

Сидоров Вася Иванов Петя

Здесь я рассказал самые азы в работе с таблицей значений 1С. Эти сведения применимы к 1С 8.0, 8.1, 8.2 На этом интересные подробности о объекте "таблица значений 1с" не заканчиваются. Этот объект обладает огромными возможностями для удобной работы с данными. Я расскажу об этом с следующих статьях.

Дегтярев Роман.

Как научиться программировать в 1С с нуля?

Как работать программистом 1С и получать до 150 000 рублей в месяц?

ЗАПИШИСЬ НА БЕСПЛАТНЫЙ

2-НЕДЕЛЬНЫЙ КУРС

"ПРОГРАММИРОВАНИЕ в 1С ДЛЯ НОВИЧКОВ"

Курс придет на электронную почту. Стань программистом, выполняя пошаговые задания.

Для участия нужен только компьютер и интернет

Бесплатный доступ на курс:

Sp-force-hide { display: none;}.sp-form { display: block; background: #eff2f4; padding: 5px; width: 270px; max-width: 100%; border-radius: 0px; -moz-border-radius: 0px; -webkit-border-radius: 0px; font-family: Arial, "Helvetica Neue", sans-serif; background-repeat: no-repeat; background-position: center; background-size: auto;}.sp-form input { display: inline-block; opacity: 1; visibility: visible;}.sp-form .sp-form-fields-wrapper { margin: 0 auto; width: 260px;}.sp-form .sp-form-control { background: #ffffff; border-color: #cccccc; border-style: solid; border-width: 1px; font-size: 15px; padding-left: 8.75px; padding-right: 8.75px; border-radius: 4px; -moz-border-radius: 4px; -webkit-border-radius: 4px; height: 35px; width: 100%;}.sp-form .sp-field label { color: #444444; font-size: 13px; font-style: normal; font-weight: bold;}.sp-form .sp-button { border-radius: 4px; -moz-border-radius: 4px; -webkit-border-radius: 4px; background-color: #f4394c; color: #ffffff; width: 100%; font-weight: 700; font-style: normal; font-family: Arial, "Helvetica Neue", sans-serif; box-shadow: none; -moz-box-shadow: none; -webkit-box-shadow: none; background: linear-gradient(to top, #e30d22 , #f77380);}.sp-form .sp-button-container { text-align: center; width: auto;}

Вот есть для начала небольшой фак - простые примеры работы с таблицей значений:

1. Создать таблицу значений

ТаблицаЗначений = Новый ТаблицаЗначений;


2. Создать колонки таблицы значений:

ТаблицаЗначений.Колонки.Добавить("Имя");
ТаблицаЗначений.Колонки.Добавить("Фамилия");


3. Добавить новые строки используя имена колонок:


НоваяСтрока.Имя = "Василий";
НоваяСтрока.Фамилия = "Пупкин";


4. Как искать значение в таблице значений:
Необходимо найти строку таблицы содержащую искомое значение.

НайденнаяСтрока = ТаблицаЗначений.Найти(ИскомоеЗначение);


5. Найти первое вхождение в определенных колонках таблицы значений

НайденнаяСтрока = ТаблицаЗначений.Найти(ИскомоеЗначение, "Поставщик, Покупатель");


6. Если надо найти все вхождения в таблице значений:
Используем структуру поиска.

СтруктураПоиска = Структура("Сотрудник", ИскомоеЗначение);
МассивНайденныхСтрок = ТаблицаЗначений.НайтиСтроки(СтруктураПоиска);


Создадим структуру поиска, каждый элемент которой будет содержать имя колонки в качестве ключа и искомое значение в этой колонке – в качестве значения. Передаем СтруктуруПоискав качестве параметра методу НайтиСтроки(). В результате получеем строк таблицы.
Если в структуру поиска добавить поиск нужного значения, например, еще и в колонке Ответственный, то в результате применения метода НайтиСтроки() получим все строки, где и Сотрудник, и Ответственный равны искомому значению.

7. Как перебрать таблицу значений в произвольном порядке

Для Каждого ТекущаяСтрока Из ТаблицаЗначений Цикл
Сообщить(ТекущаяСтрока.Имя);
КонецЦикла;

Тоже самое используя индексы:

СтаршийИндекс = ТаблицаЗначений.Количество() - 1;
Для Сч = 0 по СтаршийИндекс Цикл
Сообщить(ТаблицаЗначений[Сч].Имя);
КонецЦикла;


8. Удаление имеющейся строки таблицы значений

ТаблицаЗначений.Удалить(УдаляемаяСтрока);

по индексу

ТаблицаЗначений.Удалить(0);


9. Удаление имеющейся колонки таблицы значений

ТаблицаЗначений.Колонки.Удалить(УдаляемаяКолонка);


по индексу

ТаблицаЗначений.Колонки.Удалить(0);

Необходимо учитывать, что удаление строки (или колонки) «из середины» таблицы значений приведет к уменьшению на единицу индексов строк, стоявших «после» удаленной

10. Как заполнить таблицу значений, если имена колонок содержатся в переменных?

НоваяСтрока = ТаблицаЗначений.Добавить();
НоваяСтрока[ИмяКолонки] = Значение;


11. Как заполнить всю колонку таблицы значений нужным значением?
Колонку ФлагФискальногоУчета в таблице значений ТаблицаЗначений необходимо заполнить значением Ложь

ТаблицаЗначений.ЗаполнитьЗначения(Ложь, "ФлагФискальногоУчета");


Применяем для таблицы значений метод ЗаполнитьЗначения(). Первым параметром передаем заполняемое значение. Вторым параметром – имя заполняемой колонки.

12. Как таблицу значений «ТаблицаПолучатель» заполнить данными таблицы значений «ИсходнаяТаблица»?

Если ТаблицаПолучатель на момент выполнения операции еще не существует или ее предыдущие колонки сохранять не нужно, можно создать ее как полную копию исходной

ТаблицаПолучатель = ТаблицаИсходная.Скопировать();


Вариант второй: таблица ТаблицаПолучатель существует, и жалко терять ее колонки и ограничения на типы данных колонок. Но нужно заполнить данные по колонкам, имена которых совпадают с именами исходной таблицы.

Частичный перенос данных для колонок с совпадающими именами:

Для Каждого СтрокаИсходнойТаблицы Из ИсходнаяТаблица Цикл
ЗаполнитьЗначенияСвойств(НоваяСтрока, СтрокаИсходнойТаблицы);
КонецЦикла


Для каждой строки исходной таблицы добавляется новая строка в таблицу-получатель и выполняется заполнение значений в тех колонках новой таблицы, имена которых совпадают с именами колонок в исходной таблице

Если у таблиц не будет колонок с одинаковыми именами, таблица-получатель будет в результате содержать столько же строк с пустыми значениями, сколько строк было в таблице-источнике.
Если у каких-то одноименных колонок тип значения данных из таблицы-источника не попадет в массив разрешенных типов колонки таблицы-получателя, в таких полях получим пустые значения.
Рассмотрим третий случай. В случае одноименных колонок колонку таблицы-получателя нужно привести в полное соответствие колонке таблицы-источника.

Полное копирование данных для колонок с совпадающими именами

ОдноименныеКолонки = Новый Массив();

Для Каждого Колонка Из ИсходнаяТаблица.Колонки Цикл
СовпадающаяКолонка = ТаблицаПолучатель.Колонки.Найти(Колонка.Имя);

Если СовпадающаяКолонка <> Неопределено Тогда

// Получить свойства колонки.
Имя = Колонка.Имя;
ТипЗначения = Колонка.ТипЗначения;
Заголовок = Колонка.Заголовок;
Ширина = Колонка.Ширина;

// Заменить колонки в таблице-получателе.
Индекс = ТаблицаПолучатель.Колонки.Индекс(СовпадающаяКолонка);

ТаблицаПолучатель.Колонки.Удалить(Индекс);
ТаблицаПолучатель.Колонки.Вставить(Индекс, Имя, ТипЗначения, Заголовок, Ширина);

// Добавить очередное имя совпадающих колонок в массив.
ОдноименныеКолонки.Добавить(Колонка.Имя);

КонецЕсли;

КонецЦикла;

// Цикл перебора строк исходной таблицы.
Для каждого СтрокаИсходнойТаблицы Из ИсходнаяТаблица Цикл

// Добавить новую строку в таблицу-получатель.
НоваяСтрока = ТаблицаПолучатель.Добавить();

// Заполнить значения в совпадающих ячейках.
Для каждого ИмяКолонки Из ОдноименныеКолонки Цикл
НоваяСтрока[ИмяКолонки] = СтрокаИсходнойТаблицы[ИмяКолонки];

КонецЦикла;

КонецЦикла;


Нам придется заменить колонку в таблице-получателе на новую, чьи свойства полностью будут соответствовать колонке таблицы-источника.
Поэтому в случае обнаружения в таблице-получателе одноименной колонки собираем в переменных все свойства для новой колонки. Далее удаляем старую и создаем новую колонку. Затем выполняем цикл перебора строк исходной таблицы.
В цикле добавляем к таблице-получателю новую строку и открываем цикл перебора имен колонок в массиве совпадающих колонок.
Внутри этого вложенного цикла производим заполнение ячеек таблицы-получателя данными ячейки таблицы-источника.

13. Как добавить колонки к таблице значений «ТаблицаЗначений» с ограничениями по типу?

При добавлении колонки можно просто указать ее имя, а второй параметр метода Добавить() не трогать. В этом случае тип данных колонки – произвольный.

Добавление колонки без указания типа данных

// Добавить колонку без ограничений по типу.
ТаблицаЗначений.Колонки.Добавить("Объект");


Можно заполнить значение второго параметра. Туда необходимо передавать описание разрешенного для колонки типа. Само описание можно получить при помощи конструктора, передав последнему в качестве параметра строковое название типа (если много типов, то через запятую) или массив допустимых типов.

Добавление колонки с указанием типа данных

// Ограничения по типам данных колонки:
// Только элементы справочника "Контрагенты".
ТаблицаЗначений.Колонки.Добавить("Контрагент",Новый ОписаниеТипов("СправочникСсылка.Контрагенты"));


Если среди типов, разрешенных к заполнению данных колонки, есть строка, можно ограничить ее разрядность (длину), указать использование переменной или фиксированной длины. Все это обеспечивается созданием объекта при помощи конструктора КвалификаторыСтроки. Далее этот объект будет использован в качестве одного из параметров конструктора ОписаниеТипов.

Использование квалификаторов для уточнения типа данных колонки таблицы значений

// Подготовка и установка ограничений для данных типа Строка.
КвалификаторыСтроки = Новый КвалификаторыСтроки(20, ДопустимаяДлина.Переменная);
ДопустимыеТипы = Новый ОписаниеТипов("Строка", КвалификаторыСтроки);
ТаблицаЗначений.Колонки.Добавить("ПримечаниеСтроковоеКороткое", ДопустимыеТипы);


Аналогичные действия можно осуществлять в отношении квалификаторов числа и даты.
Обратите внимание: описание типов можно строить конструктором как «с нуля», так и использовать в качестве основы уже существующее описание типов

Использование существующих описаний типов для указания типа данных колонки таблицы значений

// Расширение уже использованного ранее описания типов.
КвалификаторыЧисла = Новый КвалификаторыЧисла(10, 2, ДопустимыйЗнак.Неотрицательный);
КвалификаторыДаты = Новый КвалификаторыДаты(ЧастиДаты.Дата);
РасширенныеДопустимыеТипы = Новый ОписаниеТипов(ДопустимыеТипы, "Число, Дата", КвалификаторыЧисла, КвалификаторыДаты);

ТаблицаЗначений.Колонки.Добавить("Примечание", РасширенныеДопустимыеТипы);

Для того, чтобы учитывать деньги и товары, в бизнесе широко используют разные таблицы. Почти каждый документ – это таблица.

В одной таблице перечислены товары к отгрузке со склада. В другой таблице – обязательства по оплате этих товаров.

Поэтому в 1С видное место занимает работа с таблицами.

Таблицы в 1С также называют «табличные части». Они есть у справочников, документов и других .

Запрос в результате своего выполнения возвращает таблицу, доступ к которой возможно получить двумя разными способами.

Первый – более быстрый – выборка, получение строк из нее возможен только по порядку. Второй – выгрузка результата запроса в таблицу значений и далее произвольный доступ к ней.

//Вариант 1 – последовательный доступ к результатам запроса

//получение таблицы
Выборка = Запрос.Выполнить().Выбрать();
//по порядку обходим все строки результата запроса
Пока Выборка.Следующий() Цикл
Сообщить(Выборка.Наименование);
КонецЦикла;

//Вариант 2 – выгрузка в таблицу значений
Запрос = Новый Запрос(«ВЫБРАТЬ Наименование ИЗ Справочник.Номенклатура»);
//получение таблицы
Таблица = Запрос.Выполнить().Выгрузить().
//далее можем также обойти все строки
Для каждого Строка из Таблица Цикл
Сообщить(Строка.Наименование);
КонецЦикла;
//или произвольно обращаться к строкам
Строка = Таблица.Найти(«Лопата», «Наименование»);

Важная особенность – в таблице, которая получена из результата запроса, все колонки будут строго типизированы. Это значит, что запросив поле Наименование из справочника Номенклатура, Вы получите колонку вида Строка с допустимой длиной не более N символов.

Таблица на форме (толстый клиент)

Пользователь работает с таблицей, когда она размещена на форме.

Базовые принципы работы с формами мы с Вами обсуждали в уроке по и в уроке по

Итак, разместим таблицу на форме. Для этого можно перетащить таблицу с панели элементов управления. Аналогично можно выбрать в меню Форма/Вставить элемент управления.

Данные могут храниться в конфигурации – тогда нужно выбрать существующую (ранее добавленную) табличную часть того объекта конфигурации, форму которого Вы редактируете.

Нажмите кнопку «…» в свойстве Данные. Для того, чтобы увидеть список табличных частей, нужно раскрыть ветку Объект.

При выборе табличной части 1С сама добавит колонки у таблицы на форме. Строки введенные пользователем в такую таблицу будут сохраняться автоматически вместе со справочником/документом.

В этом же свойстве Данные Вы можете ввести произвольное имя и выбрать тип ТаблицаЗначений.

Это значит, что выбрана произвольная таблица значений. Она не добавит автоматически колонки, не будет автоматически сохраняться, но и делать с ней можно все, что угодно.

Нажав правой кнопкой на таблице Вы можете добавить колонку. В свойствах колонки можно указать его имя (для обращения в коде 1С), заголовок колонки на форме, связь с реквизитом табличной части (последнее – если выбрана не произвольная таблица, а табличная часть).

В свойствах таблицы на форме Вы можете указать – доступно ли пользователю добавлять/удалять строки. Более продвинутая форма – галочка ТолькоПросмотр. Эти свойства удобно использовать для организации таблиц предназначенных для вывода информации, но не редактирования.

Чтобы управлять таблицей, нужно вывести на форму командную панель. Выберите пункт меню Форма/Вставить элемент управления/Командная панель.

В свойствах командной панели выберите галочку Автозаполнение, чтобы кнопки на панели появились автоматически.

Таблица на форме (тонкий/управляемый клиент)

На управляемой форме указанные действия выглядят немного по другому. Если Вам нужно разместить на форме табличную часть – раскройте ветку Объект и перетащите одну из табличных частей влево. И все!

Если нужно разместить таблицу значений, добавьте новый реквизит формы и в его свойствах укажите тип – таблица значений.

Чтобы добавить колонки, используйте меню по правой кнопке мыши на этом реквизите формы, пункт Добавить колонку реквизита.

После чего также перетащите таблицу влево.

Чтобы у таблицы появилась командная панель, в свойствах таблицы выберите значения в секции Использование – Положение командной панели.

Выгрузка таблицы в Excel

Любую таблицу 1С, расположенную на форме, можно распечатать или выгрузить в Excel.

Для этого щелкните правой кнопкой мыши на свободном месте в таблице и выберите пункт Вывести список.

В управляемом (тонком) клиент аналогичные действия можно выполнить с помощью пункта меню Все действия/Вывести список.

Вопрос Создание колонки таблицы значений различных типов в 1С v8
Ответ
При создании колонки таблицы значений в качестве типа можно передавать массив типов , и можно конкретный тип. Массив типов используется, когда нужно указать несколько различных типов для одной колонки.

Для указания типов используется «общий объект» — «Описание типов» . Поэтому сначала поясним, что такое «Описание типов» («Описание типов значений»).

«Описание типов значений» . Для описания допустимых типов значений свойств различных объектов в системе используется специальный объект «ОписаниеТипов» . При помощи данного объекта можно описывать допустимые типы значений, которые можно будет присваивать свойствам. Для дополнительного ограничения возможных значений примитивных типов Число, Строка и Дата предусмотрены квалификаторы . Квалификаторы описывают такие параметры, как длина строки или числа, допустимые части даты и т.п.

Синтаксис метода «Описание типов»

Новый ОписаниеТипов(<Исходное описание типов>, <Добавляемые типы>, <Вычитаемые типы>, <Квалификаторы числа>, <Квалификаторы строки>, <Квалификаторы даты>)
Параметры:
<Исходное описание типов> (необязательный)
Тип: ОписаниеТипов. Исходное описание типов, на основании которого будет строиться новое.
<Добавляемые типы> (необязательный)
Тип: Массив, Строка. Массив значений типа Тип, состоящий из типов, которые будут использованы в объекте, или строка содержащая имена типов разделенных запятыми.
<Вычитаемые типы> (необязательный)
Тип: Массив, Строка. Массив значений типа Тип (или строка, содержащая имена типов, разделенных запятыми), состоящий из типов, которые будут исключены из исходного описания, указанного в первом параметре.
<Квалификаторы числа> (необязательный)
Тип: КвалификаторыЧисла. Квалификаторы числа, описывающие допустимые значения числового типа.
<Квалификаторы строки> (необязательный)
Тип: КвалификаторыСтроки. Квалификаторы строки, описывающие допустимые значения строкового типа.
<Квалификаторы даты> (необязательный)
Тип: КвалификаторыДаты. Квалификаторы даты, описывающие допустимые значения типа Дата.
Описание:
Создает описание типов на основании другого описания типов, путем добавления одних и исключения других типов. Если новый квалификатор не указан, будут оставлены квалификаторы исходного описания типов.
Пример использования объекта «Описание типов»:

// расширим описание ДопустимыеТипы новыми типами Массив = Новый Массив; Массив. Добавить(Тип("СправочникСсылка.Методы" )); Массив. Добавить(Тип("Число" )); Знак = ДопустимыйЗнак. Неотрицательный; КвЧисла = Новый КвалификаторыЧисла(10 , 2 , Знак); ДопустимыеТипы = Новый ОписаниеТипов(ДопустимыеТипы, Массив, КвЧисла);
Теперь, собственно, примеры корректного создания в таблице значений колонок различных типов.

В общем случае достаточно определить типы колонок таким образом:

ТЗ. Колонки. Добавить("ИндексСортировки" , Новый ОписаниеТипов("Число" ) ) ; ТЗ. Колонки. Добавить("ИмяРаздела" , Новый ОписаниеТипов("Строка" ) ) ; ТЗ. Колонки. Добавить("ДатаКорр" , Новый ОписаниеТипов("Дата" ) ) ; ТЗ. Колонки. Добавить("БезусловноеУдаление" , Новый ОписаниеТипов("Булево" ) ) ; ТЗ. Колонки. Добавить("Номенклатура" , Новый ОписаниеТипов() ) ; ТЗ. Колонки. Добавить("ДанныеРаздела" , Новый ОписаниеТипов("Структура" ) ) ; // пример создания колонок "число" и "строка" с уточнением параметров: ТЗ. Колонки. Добавить("ПроцентВыполнения" , Новый ОписаниеТипов("Число" , Новый КвалификаторыЧисла(18 , 2 ) ) ) ; ТЗ. Колонки. Добавить("ИмяРаздела" , Новый ОписаниеТипов("Строка" , , Новый КвалификаторыСтроки(200 , ДопустимаяДлина. Переменная) ) ) ; ТЗ. Колонки. Добавить("ДатаСписаания" , Новый ОписаниеТипов("Дата" , , , Новый КвалификаторыДаты(ЧастиДаты. ДатаВремя) ) ) ;

Однако, в более общем случае, в качестве типа колонки передается массив. Массив используется в том случае, когда одной колонке нужно задать несколько типов. Тогда определение структуры будет примерно таким (приведены примеры для разных типов колонок, когда тип — массив, но состав массива для упрощения дан одного типа, чтобы не путаться)

////// формирование структуры ТЗ (создание колонок) //// определим квалификаторы для подстановки в полях квалификаторов ТЗ КЧ = Новый КвалификаторыЧисла(18 , 9 ) ; КС = Новый КвалификаторыСтроки(200 ) ; КД = Новый КвалификаторыДаты(ЧастиДаты. ДатаВремя) ; //// определим описания типов для будущих колонок ТЗ // Массив - это исходное описание типов, на основании которого будет строиться новое // Обратите внимание, что для колонок ТЗ исходное описание типов в этом примере - массив Массив = Новый Массив; Массив. Добавить(Тип("Строка" ) ) ; ОписаниеТиповСтрока = Новый ОписаниеТипов(Массив, , КС) ; Массив. Очистить() ; Массив. Добавить(Тип("Число" ) ) ; ОписаниеТиповЧисло = Новый ОписаниеТипов(Массив, , , КЧ) ; Массив. Очистить() ; Массив. Добавить(Тип("Дата" ) ) ; ОписаниеТиповДата = Новый ОписаниеТипов(Массив, , , , КД) ; Массив. Очистить() ; Массив. Добавить(Тип("СправочникСсылка.Номенклатура" ) ) ; ОписаниеТиповНоменклатура = Новый ОписаниеТипов(Массив) ; Массив. Очистить() ; Массив. Добавить(Тип("СправочникСсылка.СерииНоменклатуры" ) ) ; ОписаниеТиповСерия = Новый ОписаниеТипов(Массив) ; Массив. Очистить() ; Массив. Добавить(Тип("СправочникСсылка.Качество" ) ) ; ОписаниеТиповКачество = Новый ОписаниеТипов(Массив) ; Массив. Очистить() ; Массив. Добавить(Тип("Булево" ) ) ; ОписаниеТиповБулево = Новый ОписаниеТипов(Массив) ; // собственно добавление колонок в ТЗ (создание структуры будущей ТЗ) ТЗ. Колонки. Добавить("Номенклатура" , ОписаниеТиповНоменклатура) ; ТЗ. Колонки. Добавить("Код" , ОписаниеТиповСтрока) ; ТЗ. Колонки. Добавить("СерияНоменклатуры" , ОписаниеТиповСерия) ; ТЗ. Колонки. Добавить("КонтрагентКод" , ОписаниеТиповСтрока) ; ТЗ. Колонки. Добавить("ДатаДействия" , ОписаниеТиповДата) ; ТЗ. Колонки. Добавить("Качество" , ОписаниеТиповКачество) ; ТЗ. Колонки. Добавить("КоличествоУС" , ОписаниеТиповЧисло) ; ТЗ. Колонки. Добавить("Списывать" , ОписаниеТиповБулево) ; . . . //////// формирование структуры ТЗ (создание колонок) ////////////////////////////////////////////////////////

О добавлении строки в таблицу значений см.