К статье
Практический материал

Другое · 7 мин

Получение выделенной строки табличной части в 1С

Разберём способы получения выделенной строки табличной части в 1С: через ТекущиеДанные, выборку, события и проверку результата с учётом ограничений.

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

Визуальное выделение строки в интерфейсе не всегда совпадает с программной понятием «текущая строка». Перед чтением нужно убедиться, что строка действительно текущая, а код имеет доступ к элементу формы. Иначе результат может быть пустым, а действия коснутся не той строки.

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

Что считать выделенной строкой табличной части

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

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

Получение через свойство ТекущиеДанные

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

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

Порядок действий
  1. 1
    Определите имя элемента табличной части в форме
  2. 2
    На клиенте обратитесь к свойству текущих данных этого элемента
  3. 3
    Проверьте, что результат не пустой
  4. 4
    Обращайтесь к нужным реквизитам полученной строки
  5. 5
    Проверьте результат на тестовой копии базы

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

Получение строки по выборке или индексу

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

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

Обработка события выбора строки

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

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

Проверка результата и ограничения

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

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

Частые ошибки и альтернативы

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

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

Типичные ошибки
01
Путаница между визуальным выделением и программной текущей строкой
02
Попытка получить текущую строку на сервере без клиентского контекста
03
Опора на порядковый номер после сортировки или фильтрации

Границы безопасной самостоятельной работы

Получение текущей строки для чтения обычно безопасно, если не выполняется запись без проверки. Изменение реквизитов табличной части и запись документа лучше выполнять после проверки прав доступа, состояния объекта и наличия резервной копии. Если конфигурация закрыта или изменения затрагивают учётные регистры, обратитесь к разработчику или администратору системы.

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

Итог

Что важно запомнить

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

Можно ли получить номер выделенной строки?

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

Что делать если ТекущиеДанные пустое?

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

Работает ли получение выделенной строки на сервере?

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

В чём отличие выделения и текущей строки?

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

Можно ли редактировать полученную строку?

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