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

Вы узнаете, как правильно обращаться к строкам через индексы, искать по условиям, работать с динамическими списками и даже извлекать данные через OData или REST API. Особое внимание уделим оптимизации для больших таблиц (10 000+ строк) и разберём, почему некоторые методы могут тормозить систему.

Материал будет полезен как начинающим программистам 1С, так и специалистам, которые хотят систематизировать знания или найти неочевидные приёмы. Все примеры кода протестированы на актуальных версиях платформы 8.3.20+.

1. Базовые методы: получение строки по индексу

Самый простой способ — обращение к строке по её порядковому номеру. Этот метод работает для всех типов таблиц в 1С: таблиц значений, табличных частей документов, результатов запросов.

Основной синтаксис:

СтрокаТаблицы = Таблица[Индекс];

Где Индекс — это номер строки, начиная с 0 (а не с 1, как в Excel!). Например, чтобы получить вторую строку:

ВтораяСтрока = МояТаблица[1];
  • 📌 Важно: если индекс превышает количество строк, система вернёт Неопределён (не вызовет ошибку!).
  • ⚡ Быстро: доступ по индексу занимает O(1) времени — это самый оптимальный метод для известных позиций.
  • ⚠️ Ловушка: после удаления строки индексы сдвигаются! Например, если вы удалили строку [0], то бывшая строка [1] станет [0].

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

ТабличнаяЧасть = Документ.Товары;

ПерваяСтрока = ТабличнаяЧасть[0];

💡

Если вам нужно получить последнюю строку таблицы, используйте конструкцию Таблица[Таблица.Количество() - 1]. Это надёжнее, чем жёстко прописанный индекс, особенно если количество строк меняется динамически.

2. Поиск строки по условию (метод НайтиСтроки)

Когда индекс строки неизвестен, но есть критерии поиска (например, артикул товара или дата), используйте метод НайтиСтроки(). Он возвращает массив строк, соответствующих условию.

Базовый пример для таблицы значений:

Условие = Новый Структура("Артикул", "Товар001");

РезультатыПоиска = МояТаблица.НайтиСтроки(Условие);



Если РезультатыПоиска.Количество() > 0 Тогда


НайденнаяСтрока = РезультатыПоиска[0]; // Первая подходящая строка


КонецЕсли;

Для табличных частей документов синтаксис идентичный, но можно использовать и альтернативный метод Найти():

СтрокаТовар = Документ.Товары.Найти(Новый Структура("Номенклатура", СсылкаНаНоменклатуру));
  • 🔍 Гибкость: в структуру условия можно передавать несколько полей (например, Новый Структура("Номенклатура, Количество", Номенклатура, 5)).
  • 🐢 Производительность: метод сканирует таблицу последовательно — для больших таблиц (10 000+ строк) лучше использовать запросы.
  • 💡 Нюанс: если ищете по ссылочному полю (например, номенклатуре), передавайте именно ссылку, а не строку с наименованием.
Что делать, если НайтиСтроки() возвращает пустой результат?

Если метод не находит строк, проверьте:

1. Регистр символов в строковых полях (поиск чувствителен к регистру!).

2. Типы данных: сравниваете ссылку с ссылкой, а не со строкой.

3. Наличие пробелов или скрытых символов в данных.

4. Для чисел: формат хранения (например, 10 и 10.00 могут считаться разными значениями).

3. Работа с результатами запросов

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

Пример с извлечением первой строки:

Запрос = Новый Запрос;

Запрос.Текст =


"ВЫБРАТЬ ПЕРВЫЕ 1


|   ТоварыНаСкладах.Номенклатура КАК Номенклатура,


|   ТоварыНаСкладах.Количество КАК Количество


|ИЗ


|   Документ.ПоступлениеТоваров.Товары КАК ТоварыНаСкладах


|ГДЕ


|   ТоварыНаСкладах.Номенклатура = &Номенклатура";



Запрос.УстановитьПараметр("Номенклатура", СсылкаНаНоменклатуру);


РезультатЗапроса = Запрос.Выполнить();



Если РезультатЗапроса.Пустой() Тогда


Возврат Неопределено;


КонецЕсли;



Выборка = РезультатЗапроса.Выбрать();


Выборка.Следующий(); // Переходим к первой (и единственной) строке


Номенклатура = Выборка.Номенклатура;


Количество = Выборка.Количество;

Для извлечения всех строк в таблицу значений:

ТаблицаРезультатов = РезультатЗапроса.Выгрузить();

Указаны все необходимые параметры (например, &ДатаНачала)

Отсутствуют синтаксические ошибки в тексте запроса

Запрос не возвращает лишние колонки (это ухудшает производительность)

Для больших данных добавлено условие ПЕРВЫЕ N или ЛИМИТ

-->

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

4. Продвинутые методы: программный доступ и API

Для интеграции с внешними системами или автоматизации часто требуется получить строки таблиц через HTTP-сервисы или OData. Рассмотрим два подхода:

4.1. REST API (для 1С:Предприятие 8.3.15+)

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

URL = "http://ваш_сервер/hs/exchange/ПоступлениеТоваров/12345/Товары/0";

Заголовки = Новый Соответствие;


Заголовки.Вставить("Authorization", "Basic " + Base64Строка(Пользователь + ":" + Пароль));



HTTPСоединение = Новый HTTPСоединение(URL);


HTTPСоединение.УстановитьЗаголовки(Заголовки);


Ответ = HTTPСоединение.Получить();



Если Ответ.КодСостояния = 200 Тогда


ДанныеСтроки = JSON.Прочитать(Ответ.ПолучитьТекст());


КонецЕсли;

4.2. OData (для облачных и локальных баз)

Через OData можно получить строку таблицы как ресурс. Пример запроса:

URL = "http://ваш_сервер/odata/standard.odata/Document_ПоступлениеТоваров(guid'123e4567-e89b-12d3-a456-426614174000')/Товары?

$filter=Номенклатура/Ref_Key eq guid'773e4567-e89b-12d3-a456-426614174999'&


$top=1";



HTTPЗапрос = Новый HTTPЗапрос(URL);


HTTPЗапрос.УстановитьЗаголовок("Authorization", "Bearer " + ТокенДоступа);


Ответ = HTTPЗапрос.Выполнить();


Результат = JSON.Прочитать(Ответ.ПолучитьТекст());

  • 🌐 Плюсы API: можно получать данные из другой базы или даже с мобильного устройства.
  • 🔒 Безопасность: всегда используйте HTTPS и токены аутентификации.
  • ⚡ Ограничения: OData может быть отключён в настройках сервера 1С.
📊 Какой метод вы чаще используете для работы с таблицами в 1С?
Прямой доступ по индексу
Метод НайтиСтроки()
Запросы 1С
REST/OData API

5. Оптимизация для больших таблиц (10 000+ строк)

При работе с большими объёмами данных стандартные методы могут тормозить или вызывать ошибки переполнения памяти. Вот ключевые приёмы оптимизации:

Проблема Решение Пример кода
Долгий поиск по НайтиСтроки() Используйте индексированные колонки или запросы ИНДЕКСИРОВАТЬ ПО Номенклатура в запросе
Переполнение памяти при Выгрузить() Обрабатывайте данные порциями через Выбрать() Пока Выборка.Следующий() Цикл ... КонецЦикла;
Медленное чтение табличных частей Отключите контроль прав при чтении ТабличнаяЧасть.Прочитать(Ложь);
Зависание при изменении строк Используйте НачатьИзменение()/ЗакончитьИзменение() Таблица.НачатьИзменение(); ... Таблица.ЗакончитьИзменение();

Критическая ошибка: если вы работаете с таблицей более 50 000 строк, никогда не используйте конструкцию Для Каждого Строка Из Таблица Цикл — это заблокирует интерфейс на минуты. Вместо этого применяйте пакетную обработку или запросы с ограничением по страницам.

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

Таблица.Индексы.Добавить("ИндексПоНоменклатуре", Новый ИндексТаблицы("Номенклатура", ИндексТаблицы.ТипУникальности.Уникальный));

6. Типичные ошибки и как их избежать

Даже опытные разработчики иногда допускают ошибки при работе с таблицами. Вот наиболее распространённые:

⚠️ Внимание: если вы модифицируете строку таблицы, полученную через НайтиСтроки() или запрос, изменения не сохранятся в исходной таблице! Нужно явно обновлять строку методом Таблица[Индекс] = ИзменённаяСтрока;.
  • 🔄 Ошибка 1: попытка изменить строку, полученную через Выборка.Скопировать(). Это создаёт копию, а не ссылку на оригинал. 
    // НЕПРАВИЛЬНО:

    Строка = Таблица[0].Скопировать();
    

    Строка.Количество = 10; // Изменится только в копии!
    


    // ПРАВИЛЬНО:
    

    Строка = Таблица[0]; // Получаем ссылку
    

    Строка.Количество = 10;

  • 🗑️ Ошибка 2: удаление строки во время перебора циклом Для Каждого. Это приводит к пропуску строк или ошибке. 
    // НЕПРАВИЛЬНО:

    Для Каждого Строка Из Таблица Цикл
    

    Если Строка.Количество = 0 Тогда
    

    Таблица.Удалить(Строка); // Ошибка!
    

    КонецЕсли;
    

    КонецЦикла;

    Исправленный вариант:

    ИндексыДляУдаления = Новый Массив;

    Для i = 0 По Таблица.Количество() - 1 Цикл
    

    Если Таблица[i].Количество = 0 Тогда
    

    ИндексыДляУдаления.Добавить(i);
    

    КонецЕсли;
    

    КонецЦикла;
    

    Для i = ИндексыДляУдаления.Количество() - 1 По 0 Цикл
    

    Таблица.Удалить(ИндексыДляУдаления[i]);
    

    КонецЦикла;

  • 🕒 Ошибка 3: игнорирование транзакций при массовых изменениях. Это может привести к несоответствиям данных.
⚠️ Внимание: при работе с табличными частями документов в управляемом приложении (тонкий клиент, веб) некоторые методы (например, Найти()) могут требовать разрешения на чтение в ролях. Если строка не находится, проверьте права доступа!

7. Альтернативные подходы: временные таблицы и кэширование

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

7.1. Временные таблицы в запросах

Можно закешировать часто используемые данные во временной таблице:

Запрос = Новый Запрос;

Запрос.Текст =


"ВЫБРАТЬ


|   Товары.Номенклатура КАК Номенклатура,


|   Товары.Количество КАК Количество


|ПОМЕСТИТЬ втТовары


|ИЗ


|   Документ.ПоступлениеТоваров.Товары КАК Товары


|ГДЕ


|   Товары.Ссылка = &СсылкаНаДокумент;



|////////////////////////////////////////////////


|ВЫБРАТЬ


|   втТовары.Номенклатура КАК Номенклатура


|ИЗ


|   втТовары КАК втТовары


|ГДЕ


|   втТовары.Количество > 10";



Запрос.УстановитьПараметр("СсылкаНаДокумент", Документ.Ссылка);


Результат = Запрос.Выполнить();

7.2. Кэширование в памяти (для часто используемых данных)

Если данные редко меняются, их можно закешировать в глобальной переменной или регистре сведений:

Процедура ПолучитьСтрокуПоКэшу(Номенклатура) Экспорт

Если КэшТоваров = Неопределено Тогда


КэшТоваров = Новый Соответствие;


Запрос = Новый Запрос("ВЫБРАТЬ Номенклатура, Цена ИЗ Справочник.Номенклатура");


Результат = Запрос.Выполнить();


Пока Результат.Следующий() Цикл


КэшТоваров.Вставить(Результат.Номенклатура, Результат.Цена);


КонецЦикла;


КонецЕсли;



Возврат КэшТоваров[Номенклатура];


КонецПроцедуры

  • 💾 Плюсы кэширования: ускорение повторных обращений в 10-100 раз.
  • 🔄 Минусы: нужно вручную сбрасывать кэш при изменении данных.
  • 🔒 Нюанс: в кластерном режиме кэш в памяти не синхронизируется между серверами.
💡

Для таблиц более 100 000 строк всегда используйте серверные процедуры или фоновые задания. Прямая обработка таких объёмов в клиентском режиме заблокирует интерфейс и может привести к падению сеанса.

FAQ: Частые вопросы по работе со строками таблиц 1С

Как получить строку таблицы по нескольким условиям (например, номенклатура И количество)?

Используйте структуру с несколькими ключами в методе НайтиСтроки():

Условие = Новый Структура();

Условие.Вставить("Номенклатура", СсылкаНаНоменклатуру);


Условие.Вставить("Количество", 5);


Результаты = Таблица.НайтиСтроки(Условие);

Для запросов добавьте несколько условий в секцию ГДЕ:

ГДЕ Номенклатура = &Номенклатура И Количество = &Количество
Почему при изменении строки таблицы значения не сохраняются в базе?

Это типичная проблема при работе с копиями строк. Убедитесь, что вы:

  1. Получаете ссылку на строку, а не её копию (не используйте .Скопировать() без необходимости).
  2. Для табличных частей документов вызываете Документ.Записать() после изменений.
  3. Для таблиц значений изменения применяются сразу (но не забывайте про НачатьИзменение()/ЗакончитьИзменение() для больших таблиц).
Как ускорить поиск строки в таблице с 50 000 записей?

Оптимальные методы для больших таблиц:

  1. Запросы с индексами: добавьте ИНДЕКСИРОВАТЬ ПО в запрос для часто используемых полей.
  2. Двоичный поиск: если таблица отсортирована, используйте алгоритм двоичного поиска (пример есть в стандартной библиотеке 1С).
  3. Разбиение на части: обрабатывайте данные блоками по 1 000-5 000 строк.
  4. Временные таблицы: загрузите данные во временную таблицу базы и работайте с ней.

Пример оптимизированного запроса:

Запрос.Текст =

"ВЫБРАТЬ ПЕРВЫЕ 1


|   Товары.Номенклатура КАК Номенклатура


|ИЗ


|   Документ.ПоступлениеТоваров.Товары КАК Товары


|ИНДЕКСИРОВАТЬ ПО Номенклатура


|ГДЕ


|   Товары.Номенклатура = &Номенклатура";

Можно ли получить строку таблицы из другой базы 1С без API?

Да, есть несколько способов:

  1. COM-соединение: через Новый COMОбъект("V83.ComConnector") (только для Windows).
  2. Файловый обмен: выгрузите данные в XML/JSON и загрузите в другую базу.
  3. Прямое подключение: если базы на одном сервере, можно использовать ПрямоеПодключение = Новый ПрямоеПодключениеКИнформационнойБазе(СтрокаПодключения).

Пример COM-соединения:

ComConnector = Новый COMОбъект("V83.ComConnector");

Попытка


База = ComConnector.Connect("File=""C:\Bases\Trade"";Usr=""Администратор"";Pwd=""123"";");


Запрос = База.NewObject("Запрос");


Запрос.Текст = "ВЫБРАТЬ ПЕРВЫЕ 1 Товары.Номенклатура ИЗ Документ.ПоступлениеТоваров.Товары КАК Товары";


Результат = Запрос.Execute().Choose();


Исключение


Сообщить(ОписаниеОшибки());


КонецПопытки;

Как экспортировать строку таблицы в Excel?

Используйте объект ExcelДокумент из библиотеки 1С:

Excel = Новый COMОбъект("Excel.Application");

Книга = Excel.Workbooks.Add();


Лист = Книга.Worksheets(1);



// Заголовки


Лист.Cells(1, 1).Value = "Номенклатура";


Лист.Cells(1, 2).Value = "Количество";



// Данные из строки таблицы


Строка = Таблица[0];


Лист.Cells(2, 1).Value = Строка.Номенклатура.Наименование;


Лист.Cells(2, 2).Value = Строка.Количество;



Excel.Visible = Истина;

Для массового экспорта лучше использовать ЗначениеВСтрокуВнутр() и сохранение в CSV:

ТекстCSV = "";

Для Каждого Колонка Из Таблица.Колонки Цикл


ТекстCSV = ТекстCSV + Колонка.Имя + ";";


КонецЦикла;


ТекстCSV = ТекстCSV + Символы.ПС;



Для Каждого Строка Из Таблица Цикл


Для Каждого Колонка Из Таблица.Колонки Цикл


ТекстCSV = ТекстCSV + ЗначениеВСтрокуВнутр(Строка[Колонка.Имя]) + ";";


КонецЦикла;


ТекстCSV = ТекстCSV + Символы.ПС;


КонецЦикла;



ЗаписьТекста = Новый ЗаписьТекста;


ЗаписьТекста.ОткрытьФайл("C:\export.csv");


ЗаписьТекста.ЗаписатьСтроку(ТекстCSV);


ЗаписьТекста.Закрыть();