Другое · 8 мин
Получение выделенных строк динамического списка в 1С
Как получить выделенные строки динамического списка 1С: способы доступа к выделению, проверка результата, типичные ошибки и ограничения для разработчиков
Динамический список в 1С позволяет пользователю отмечать несколько строк одновременно, а затем выполнять с ними групповые действия: формировать отчет, заполнять документ, переносить данные в другой справочник или запускать обработку. Для программиста важно понимать, что выделение существует только в рамках открытой формы и текущего сеанса работы, оно не хранится в базе данных как постоянное состояние.
Основной способ получить отмеченные строки — обратиться к элементу формы динамического списка и получить коллекцию выделенных строк. В большинстве случаев достаточно проверить, что коллекция не пуста, пройти по ней в цикле и извлечь ссылки на объекты, которые соответствуют выделенным строкам. Полученные ссылки можно использовать для чтения реквизитов, записи в табличную часть или передачи в процедуру обработки.
Перед изменением конфигурации или добавлением кода работы с выделением рекомендуется создать резервную копию информационной базы и проверить изменения на отдельной тестовой копии. Ошибка в алгоритме обхода выделенных строк может привести к обработке не тех данных, дублированию записей или некорректному заполнению документов, поэтому проверка результата обязательна.
Выделение сбрасывается при переоткрытии формы, обновлении списка или изменении отбора, поэтому читать выбранные строки нужно сразу после действия пользователя, пока форма остается открытой. Не стоит полагаться на сохранение выделения между вызовами процедур или между сеансами работы пользователя.
Что представляет собой выделение в динамическом списке
Выделение строк динамического списка — это временная отметка, которую пользователь ставит мышью или клавиатурой в открытой форме. Она относится к представлению данных на форме, а не к записям в информационной базе. Поэтому выделенные строки не видны другим пользователям и не сохраняются после закрытия формы.
Разработчик может получить доступ к выделению из процедур формы, например из обработчика нажатия кнопки или команды. Для этого нужно знать имя элемента формы, который отображает динамический список, и использовать его свойства или методы для получения коллекции отмеченных строк.
Как программно получить выделенные строки
В типичной ситуации код находится в модуле формы и обращается к элементу динамического списка. Получив коллекцию выделенных строк, программа проверяет, что в коллекции есть хотя бы одна строка, затем перебирает элементы коллекции и извлекает из каждой строки ссылку на соответствующий объект справочника, документа или другого справочника.
Полученные ссылки используются для дальнейшей обработки: чтения реквизитов, формирования табличной части документа, передачи в отчет или вызова внешней обработки. Если выделение отсутствует, программа должна информировать пользователя и прервать выполнение, чтобы не обрабатывать пустой набор данных.
- 1Открыть форму динамического списка в конструкторе и найти элемент списка
- 2Написать обработчик события, в котором требуется получить выделение
- 3Обратиться к свойству или методу элемента для получения коллекции выделенных строк
- 4Проверить, что коллекция не пуста
- 5Пройти по коллекции в цикле и получить ссылки на объекты
- 6Использовать ссылки для нужной обработки и проверить результат
Если список содержит иерархические данные, выделение может касаться групповых строк и обычных строк по-разному. Перед обработкой стоит уточнить, нужны ли только конечные элементы или также группы, и соответствующим образом отфильтровать полученную коллекцию.
В клиент-серверном варианте работа с выделением обычно ведется на клиенте, поскольку элемент формы и его выделение находятся на стороне клиентского приложения. Передача выделенных строк на сервер выполняется через параметры процедуры или через значения таблицы значений, сформированной на клиенте.
Проверка результата и границы безопасной работы
После получения выделенных строк необходимо убедиться, что каждая ссылка ведет на существующий объект, а объект не был удален другим пользователем во время работы. Если ссылка битая, попытка чтения реквизитов может вызвать ошибку, поэтому целесообразно обрабатывать такие ситуации и пропускать недоступные строки.
Нельзя изменять список или его отбор внутри цикла обхода выделенных строк, так как это может привести к потере актуальности коллекции и некорректной работе. Все изменения данных лучше выполнять после сбора ссылок, а не во время их чтения.
Как проверить результат
В коллекции есть строки, каждая имеет корректную ссылку на объект
Коллекция пуста или ссылки ведут на удаленные объекты
Форма открыта, список не обновлялся после выделения
Форма закрыта, список перезагружен или отбор изменен
Документы или отчеты заполнены верно, ошибок нет
Обработаны не те строки или возникли ошибки записи
При работе с большим количеством выделенных строк стоит учитывать производительность: чтение реквизитов каждого объекта по отдельности может замедлить работу. Если требуется массовая обработка, целесообразно формировать таблицу значений с нужными реквизитами за один проход, а затем использовать её для дальнейших действий.
Типичные ошибки и ограничения
Одна из частых ошибок — попытка получить выделенные строки после того, как список уже обновлен или форма закрыта. В этом случае коллекция окажется пустой или недоступной, и код не обработает нужные данные. Другая ошибка — считать, что выделение сохраняется между вызовами разных обработчиков, что не так.
Также некорректно модифицировать элементы списка во время обхода выделения, полагаться на порядок строк в коллекции без проверки ссылок или игнорировать ситуацию, когда пользователь не выделил ни одной строки. Все эти случаи требуют явной проверки и информирования пользователя.
Ограничением является то, что выделение относится только к текущей форме. Если пользователь открывает несколько окон одного и того же списка, выделение в каждом окне независимо. Получить выделение из другого окна или из фонового задания напрямую нельзя, данные нужно передавать явно через параметры или промежуточное хранилище.
При самостоятельной работе с кодом формы не рекомендуется вносить изменения в конфигурацию без резервной копии и без тестирования на копии базы. Ошибка в обработке выделенных строк может затрагивать реальные документы и справочники, поэтому проверка на тестовых данных обязательна перед выкладкой в рабочую базу.
Альтернативные способы работы с данными списка
Вместо выделения строк иногда удобнее использовать отметку в табличной части, текущую строку или отдельный реквизит «Пометка» в объекте. Выбор зависит от задачи: выделение подходит для разовой групповой операции на форме, а постоянная пометка — для процессов, которые должны сохраняться между сеансами и быть видны другим пользователям.
Если пользователю нужно выбрать одну запись, достаточно работать с текущей строкой динамического списка. Для массовых операций, которые пользователь запускает по кнопке, подходит выделение нескольких строк. Если отбор должен быть доступен в отчетах и обработках после закрытия формы, лучше добавить реквизит пометки или использовать регистр сведений.
Что важно запомнить
Выделенные строки динамического списка получают через элемент формы, проверяют непустоту коллекции и обходят строки сразу, пока форма открыта. Выделение не сохраняется после закрытия или обновления списка, а изменения в конфигурации требуют резервной копии и тестирования.
Частые вопросы
Можно ли получить выделенные строки на сервере?
Обычно доступ к выделению элемента формы реализован на клиенте, так как выделение находится в клиентской части формы. На сервер выбранные строки передают через параметры процедуры или через заранее сформированную таблицу значений со ссылками на объекты.
Что делать, если выделение пропало после обновления списка?
После обновления или перезагрузки динамического списка выделение сбрасывается. Нужно собирать ссылки на строки до обновления или предлагать пользователю повторно отметить нужные строки после обновления.
Работает ли выделение в нескольких открытых окнах одного списка?
Каждое окно формы имеет свое собственное выделение, независимое от других окон. Получить выделение из одного окна в другом напрямую нельзя, данные передаются явно через параметры или общее хранилище.
Нужно ли создавать резервную копию перед изменением кода формы?
Да, перед правкой конфигурации или модуля формы рекомендуется сделать резервную копию информационной базы и проверить изменения на тестовой копии, чтобы не повредить рабочие документы и справочники.