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

Другое · 8 мин

Как обратиться к динамическому списку в 1С

Как в конфигурации 1С обратиться к динамическому списку на форме, получить выбранную строку и работать с данными в клиентском и серверном контексте без потери контекста и проверки результата.

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

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

Как найти элемент и обратиться к нему по имени

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

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

Элемент найденЭлементы.Имя <> Неопределено

Проверьте имя элемента и открыта ли форма

Список пустКоличество строк равно нулю

Нет данных для выбора, выделение отсутствует

Есть выделениеТекущиеДанные заполнено

Можно читать поля выбранной строки

Как получить выбранную строку и её данные

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

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

Клиентский и серверный контекст доступа

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

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

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

Заполнение и обновление динамического списка

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

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

Ограничения и частые ошибки

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

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

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

Как проверить, что обращение сработало

Самый надёжный способ проверки — использовать отладчик и посмотреть значение ТекущиеДанные в момент остановки на строке обращения к списку. Если свойство заполнено и содержит ожидаемые поля, обращение выполнено корректно. Если значение Неопределено, либо список пуст, либо элемент не найден, либо форма не активна.

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

Контрольные точки

Как проверить результат

ТекущиеДанные после выбора
Норма

Содержит объект строки с полями

Тревожный признак

Равно Неопределено

Имя элемента в Элементы
Норма

Элемент найден

Тревожный признак

Ошибка при обращении по имени

Результат записи на сервере
Норма

Данные сохранены без ошибок

Тревожный признак

Отказ в записи или частичное сохранение

Альтернативы и когда динамический список не подходит

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

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

Итог

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

Обращайтесь к динамическому списку через Элементы.Имя, читайте выделение через ТекущиеДанные или ВыбраннуюСтроку, проверяйте наличие выделения и выполняйте запись данных на сервере.

Нужно ли открывать форму перед обращением к списку?

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

Чем отличаются ТекущиеДанные и ВыбраннаяСтрока?

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

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

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

Что делать, если список пуст или не находится по имени?

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

Когда лучше не использовать динамический список?

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