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