Как получить данные текущей строки в 1С: 5 рабочих способов с примерами кода

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

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

Материал будет полезен:

• 👨‍💻 Разработчикам 1С — для оптимизации кода и обработки событий;
• 📊 Аналитикам — при создании отчётов с динамической фильтрацией;
• 📝 Пользователям, работающим с большими объёмами данных в табличных документах.

1. Получение данных текущей строки через контекстное меню (без кода)

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

Самый простой способ:

1. Выделите строку в табличной части документа или справочника.
2. Нажмите правую кнопку мыши и выберите Копировать (для переноса данных) или Показать данные (для просмотра деталей).
3. Для таблиц с большим количеством колонок используйте Настроить список → Отображать только выбранные поля, чтобы упростить навигацию.

Этот метод работает в большинстве стандартных конфигураций (Бухгалтерия 3.0, Управление торговлей 11, Зарплата и управление персоналом 3.1), но имеет ограничения:

• ❌ Не позволяет модифицировать данные программно;
• ❌ Не работает с динамическими списками в управляемых формах;
• ❌ Не подходит для массовой обработки строк.

⚠️ Внимание: В некоторых конфигурациях (например, 1С:ERP) пункты контекстного меню могут быть переопределены. Если стандартные команды отсутствуют, проверьте настройки ролей пользователя или обратитесь к администратору.

2. Использование функции "Текущие данные" в управляемых формах

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

Пример кода для обработчика события ПриИзменении в табличной части документа:

&НаКлиенте
Процедура ТабличнаяЧастьТоварыПриИзменении(Элемент)
ТекущаяСтрока = Элементы.Товары.ТекущиеДанные;

Сообщить("Артикул: " + ТекущаяСтрока.Артикул);
Сообщить("Количество: " + ТекущаяСтрока.Количество);
КонецПроцедуры

Ключевые особенности метода:

• ✅ Работает в тонком и веб-клиенте;
• ✅ Не требует обращения к серверу (код выполняется на клиенте);
• ✅ Поддерживает проверку изменений в реальном времени.

Однако есть нюансы:

• 🔹 ТекущиеДанные возвращает значения до применения изменений (если строка ещё не сохранена);
• 🔹 В динамических списках вместо ТекущиеДанные используется ВыбраннаяСтрока.

3. Работа с текущей строкой в табличной части на сервере

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

Пример серверной процедуры для проверки остатков при изменении количества товара:

&НаСервере
Процедура ПриИзмененииКоличества(Объект, ТекущаяСтрока)
Если ТекущаяСтрока.Количество > ТекущаяСтрока.Доступно Тогда
ВызватьИсключение "Превышен остаток товара: " + ТекущаяСтрока.Номенклатура;
КонецЕсли;

// Автоматическое заполнение суммы
ТекущаяСтрока.Сумма = ТекущаяСтрока.Количество * ТекущаяСтрока.Цена;
КонецПроцедуры

Важные детали:

• 📌 ТекущаяСтрока передаётся как параметр в обработчики событий (ПередЗаписью, ПриИзменении);
• 📌 Для доступа к строке по индексу используйте Объект.ТабличнаяЧасть[НомерСтроки];
• 📌 В 1С:Предприятие 8.2 синтаксис отличается — вместо ТекущаяСтрока может потребоваться ЭлементыФормы.ИмяТаблицы.ТекущаяСтрока.

⚠️ Внимание: При работе с большими табличными частями (10 000+ строк) избегайте циклов по всем строкам на сервере. Используйте Запрос или Объект.Выгрузить() для оптимизации производительности.

4. Получение данных из динамического списка

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

Пример кода для обработки выбора строки в списке номенклатуры:

&НаКлиенте
Процедура СписокНоменклатурыПриИзменении(Элемент)
Если Элемент.ВыбраннаяСтрока = Неопределено Тогда
Возврат;
КонецЕсли;

ВыбранныйТовар = Элемент.ВыбраннаяСтрока.Ссылка;
Сообщить("Выбран: " + ВыбранныйТовар.Наименование);
КонецПроцедуры

Частые ошибки при работе с динамическими списками:

• 🚫 Попытка получить ВыбраннаяСтрока до того, как пользователь кликнет на строку (вернёт Неопределено);
• 🚫 Использование ТекущиеДанные вместо ВыбраннаяСтрока;
• 🚫 Забывают проверить, включён ли режим выбора (РежимВыбора).

5. Альтернативные способы: через запрос и временные таблицы

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

Пример запроса для получения детальной информации по текущей строке заказа:

&НаСервере
Функция ПолучитьДанныеТекущейСтроки(СсылкаНаДокумент, ИндексСтроки)
Запрос = Новый Запрос;
Запрос.Текст =
"ВЫБРАТЬ
|   ТоварыСписок.Номенклатура КАК Номенклатура,
|   ТоварыСписок.Количество КАК Количество,
|   Номенклатура.Артикул КАК Артикул
|ИЗ
|   Документ.ЗаказПокупателя.Товары КАК ТоварыСписок
|       ЛЕВОЕ СОЕДИНЕНИЕ Справочник.Номенклатура КАК Номенклатура
|       ПО ТоварыСписок.Номенклатура = Номенклатура.Ссылка
|ГДЕ
|   ТоварыСписок.Ссылка = &Ссылка
|   И ТоварыСписок.НомерСтроки = &Индекс";

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

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

Преимущества метода:

• 🔧 Гибкость: можно получить данные из связанных таблиц;
• 📈 Производительность: оптимально для больших объёмов данных;
• 🔄 Универсальность: работает в любых конфигурациях.

Недостатки:

• ⚠️ Требует знания языка запросов 1С;
• ⚠️ Медленнее, чем прямое обращение к ТекущаяСтрока, для простых задач.

Убедитесь, что выполнены условия:

|Проверьте, что у вас есть права на чтение данных

|Определите точный индекс строки (или используйте НомерСтроки)

|Укажите корректную ссылку на документ или справочник

|Настройте параметры запроса для защиты от SQL-инъекций-->

6. Обработка текущей строки в отчётах и обработках

В отчётах и внешних обработках доступ к текущей строке организован иначе, чем в документах. Здесь часто используется событие ПриАктивизацииСтроки или работа с ОбластьЯчеек в табличных документах.

Пример для обработки табличного документа (например, в отчёте Анализ продаж):

&НаКлиенте
Процедура ТабличныйДокументПриАктивизацииСтроки(Элемент, Строка, Колонка)
// Получаем значение из ячейки
Значение = Элемент.ОбластьЯчеек.ПолучитьОбласть(Строка, Колонка).Текст;

// Пример: выделяем строки с нулевым количеством
Если Колонка.Имя = "Количество" И Значение = 0 Тогда
Элемент.ОбластьЯчеек.ЦветФона(Строка, Колонка) = ВебЦвета.Красный;
КонецЕсли;
КонецПроцедуры

Особенности работы с отчётами:

• 📌 Для динамических отчётов используйте ПолеВыбора и ВыбранныеСтроки;
• 📌 В СКД (система компоновки данных) текущая строка доступна через ЭлементыФормы.ИмяОтчёта.ВыбраннаяСтрока;
• 📌 Для экспорта данных в Excel используйте ЗаписатьТабличныйДокумент.

⚠️ Внимание: В отчётах на основе СКД (например, Универсальный отчёт) прямая работа с текущей строкой может быть ограничена. В таких случаях настройте ПараметрыВывода для передачи данных в обработчик.

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

Даже опытные разработчики сталкиваются с проблемами при работе с текущими строками. Вот самые распространённые ошибки и способы их решения:

Дополнительные рекомендации:

• 🔹 Всегда проверяйте, что строка существует, перед обращением к её полям;
• 🔹 Для отладки используйте Сообщить(ТекущаяСтрока.Ссылка);
• 🔹 В 1С:Предприятие 8.3.20+ для динамических списков доступен метод ПолучитьВыбранныеСтроки().

FAQ: Ответы на частые вопросы

&НаКлиенте
Процедура КопироватьТекущуюСтроку(Команда)
ТекущаяСтрока = Элементы.Товары.ТекущиеДанные;
ТекстДляКопирования = "Артикул: " + ТекущаяСтрока.Артикул + "; Количество: " + ТекущаяСтрока.Количество;
БуферОбмена.УстановитьТекст(ТекстДляКопирования);
Сообщить("Данные скопированы!");
КонецПроцедуры