1С: Как изменить строку таблицы значений

Работа с Таблицей Значений (ТЗ) является одной из самых распространенных задач при программировании в платформе 1С:Предприятие. Разработчики постоянно сталкиваются с необходимостью не просто создать новую структуру данных, но и оперативно внести правки в уже существующие записи. Изменение конкретной строки может потребоваться в тысячах сценариев: от пересчета итогов отчета до исправления пользовательского ввода перед записью в базу данных.

Однако, несмотря на кажущуюся простоту, процесс редактирования содержит множество подводных камней. Неправильный выбор метода поиска строки может привести к критическому снижению производительности на больших объемах данных, а попытка изменить значение в неизменяемом типе вызовет исключение в рантайме. В этой статье мы детально разберем все доступные способы модификации данных внутри ТЗ.

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

Прямое обращение по индексу строки

Самый быстрый и наименее ресурсоемкий способ изменить данные — это работа по числовому индексу. Если вы точно знаете порядковый номер строки, которую нужно отредактировать, платформа позволяет обратиться к ней мгновенно. Этот метод идеален для циклов, где счетчик цикла одновременно является индексом обрабатываемой строки.

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

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

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

Строка1 = ТЗ.Добавить;
Строка1.Номенклатура = Справочники.Номенклатура.НайтиПоНаименованию("Стул");
Строка1.Количество = 10;

// Изменяем вторую строку (индекс 1)
ТЗ.Строки[1].Количество = 15;

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

Поиск строки по уникальному значению

В реальных задачах программист редко знает точный индекс строки. Чаще всего необходимо найти запись, где, например, артикул товара равен определенному значению, и изменить её количество. Для таких случаев в объекте ТаблицаЗначений предусмотрен мощный метод НайтиСтроки.

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

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

• 🔍 Точность поиска: Метод чувствителен к регистру при поиску по строкам, если в свойствах колонки не указано иное.
• ⚡ Производительность: Поиск по одной колонке работает быстрее, чем по составному ключу из трех и более полей.
• 📋 Результат: Возвращаемый массив содержит объекты типа СтрокаТаблицыЗначений, готовые к редактированию.

⚠️ Внимание: Если метод НайтиСтроки не находит совпадений, он возвращает пустой массив, а не значение Неопределено. Всегда проверяйте количество элементов в результате перед попыткой изменения.

Для единичного поиска, когда гарантированно существует только одна нужная строка (например, поиск по уникальному идентификатору), удобнее использовать метод Найти. Он возвращает ссылку на первую найденную строку или Неопределено, если ничего не найдено. Это упрощает код, избавляя от необходимости работать с массивом из одного элемента.

Использование метода КопироватьСтроку

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

Этот метод принимает два аргумента: источник данных (строку другой таблицы или структуру) и индекс строки-приемника в текущей таблице. Он полностью заменяет значения во всех колонках строки-приемника на значения из источника. Колонки должны быть совместимы по именам и типам данных для корректного копирования.

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

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

// Копируем данные из первой строки источника во вторую строку целевой ТЗ
ТЗ.КопироватьСтроку(ИсточникТЗ.Строки[0], 1);

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

Редактирование через цикл"Для каждого"

Самый читаемый и безопасный способ изменения множества строк — использование цикла Для Каждого. В отличие от цикла Для i = 0 По ТЗ.ВRowCount - 1, этот конструктив автоматически предоставляет ссылку на текущую строку, которую можно сразу использовать для записи.

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

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

• 🔄 Автоматизация: Не нужно вручную управлять счетчиком цикла.
• 🛡️ Безопасность: Исключены ошибки выхода за границы индексов.
• 📉 Читаемость: Код становится более понятным для поддержки другими разработчиками.

Пример кода демонстрирует классический паттерн обработки: перебор всех строк, проверка условия и изменение значения. Это стандартная практика для расчетов скидок, начисления бонусов или пересчета налогов в печатных формах.

Для Каждого СтрокаТЗ Из ТЗ Цикл
Если СтрокаТЗ.Сумма > 10000 Тогда
СтрокаТЗ.СтавкаНДС = 0.20;
Иначе
СтрокаТЗ.СтавкаНДС = 0.10;
КонецЕсли;
КонецЦикла;

⚠️ Внимание: Не пытайтесь удалять строки из таблицы значений внутри цикла"Для Каждого" без использования специального метода удаления по ссылке, это может нарушить итерацию. Для изменения данных удаление не требуется.

Работа с типами данных и приведение

Одной из самых частых причин ошибок при изменении строк является несоответствие типов данных. Колонка в таблице значений может быть строго типизирована (например, только Число), а вы пытаетесь записать в неё строку или дату. Платформа 1С строго следит за типизацией.

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

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

Тип колонки в ТЗ	Допустимые значения для записи	Вызовет ошибку
Число	10, 10.5, -5	"10", Дата, Ссылка
Строка	"Текст",""	123, Истина
Булево	Истина, Ложь	1, 0,"Да"
Дата	ТекущаяДата,'20230101'	"01.01.2023" (строка)

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

Как разрешить Неопределено в колонке?

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

Изменение строк в запросах и СКД

Часто таблица значений формируется не вручную, а является результатом выполнения запроса или работы Системы Компоновки Данных (СКД). В таких случаях таблица может быть помечена как доступная только для чтения. Попытка изменить строку в такой таблице вызовет ошибку.

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

В контексте СКД, если вы пишете код в модуле объекта отчета или в обработке, убедитесь, что вы работаете с результатом компоновки, а не с исходными настройками. Иногда требуется использовать метод ПолучитьМакет и работать уже с полученной структурой данных.

⚠️ Внимание: Таблицы значений, полученные как результат выполнения запроса (Результат.ВыгрузитьТаблицуЗначений), обычно доступны для записи. Однако, если вы обращаетесь к данным напрямую через некоторые объекты метаданных в режиме только для чтения, изменения будут заблокированы.

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

Частые ошибки и отладка

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

Еще одна распространенная проблема — изменение данных в цикле, который перебирает копию коллекции. Всегда убедитесь, что цикл Для Каждого выполняется непосредственно по объекту ТаблицаЗначений, а не по его выгрузке в массив. Массив строк, полученный отдельно, может не иметь обратной связи с исходной таблицей в некоторых контекстах исполнения.

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

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

Можно ли изменить структуру таблицы (добавить колонку) после создания строк?

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

Что делать, если метод НайтиСтроки возвращает пустой массив?

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

Как изменить значение в колонке, если её имя динамически известно только вruntime?

Используйте обращение к ячейке по индексу колонки или используйте метод Получить и Установить для динамического доступа. Пример: СтрокаТЗ.Установить(ИмяКолонки, НовоеЗначение). Это позволяет работать с таблицей, структура которой формируется динамически.

Влияет ли изменение строки ТЗ на исходный запрос или регистр сведений?

Нет, не влияет. Таблица значений — это объект в оперативной памяти. Изменение её строк никак не меняет данные в базе данных, пока вы явно не выполните запись изменений обратно в регистры или документы с помощью соответствующих методов записи.

Можно ли использовать выражения 1С прямо при присваивании значения строке?

Да, вы можете использовать любые допустимые выражения языка 1С при присваивании. Например: СтрокаТЗ.Сумма = СтрокаТЗ.Количество * СтрокаТЗ.Цена. Вычисления производятся мгновенно в момент выполнения строки кода.