Динамический список

Источником данных для таблиц большинства форм списков (списки справочников клиентов, контактных лиц и др.) является системный компонент ДинамическийСписок.

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

Тип: Таблица<ДинамическийСписок>
Имя: ТаблицаСписка
Источник:
    ОсновнаяТаблица:
        Таблица: Задачи
    Поля:
        -
            Тип: ПолеДинамическогоСписка
            Выражение: Код
        -
            Тип: ПолеДинамическогоСписка
            Выражение: Наименование
        -
            Тип: ПолеДинамическогоСписка
            Выражение: ДатаСоздания
        -
            Тип: ПолеДинамическогоСписка
            Выражение: Владелец.Клиент
            Псевдоним: Владелец_Клиент
            Представление: Клиент
            ОтображатьВНастройкахФильтров: Истина
            ОтображатьВПростыхФильтрах: Истина
    Сортировка:
        -
            Поле: ДатаСоздания
            НаправлениеСортировки: ПоУбыванию

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

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

Тип: Таблица<ДинамическийСписок>
ИспользованиеПоиска: Ложь
Имя: ТаблицаСписка
Источник:
    ОсновнаяТаблица:
        Таблица: Валюты
        Псевдоним: Валюты
    Поля:
        -
            Тип: ПолеДинамическогоСписка
            Выражение: Валюты.Ссылка
            Псевдоним: Валюты_Ссылка
        -
            Тип: ПолеДинамическогоСписка
            Выражение: Валюты.Наименование
            Псевдоним: Валюты_Наименование
        -
            Тип: ПолеДинамическогоСписка
            Выражение: Валюты.Код
            Псевдоним: Валюты_Код
        -
            Тип: ПолеДинамическогоСписка
            Выражение: КурсыСрезПоследних.Курс
            Псевдоним: КурсыСрезПоследних_Курс
        -
            Тип: ПолеДинамическогоСписка
            Выражение: КурсыСрезПоследних.Кратность
            Псевдоним: КурсыСрезПоследних_Кратность
        -
            Тип: ПолеДинамическогоСписка
            Выражение: КурсыСрезПоследних.Период
            Псевдоним: КурсыСрезПоследних_Период
     ПрисоединенныеТаблицы:
        -
            Таблица: КурсыВалют.СрезПоследних
            Псевдоним: КурсыСрезПоследних
            Фильтр:
                Элементы:
                    -
                        Тип: ЭлементФильтраВыражение
                        Выражение: Валюты.Ссылка == КурсыСрезПоследних.Валюта

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

Параметры и аргументы

Условие запроса можно указать непосредственно в описании динамического списка или одной из его таблиц, как значение свойства. Это позволяет:

• передавать условия запроса во время исполнения программы;
• упрощать написание и чтение длинных, сложных запросов;
• переиспользовать одно и то же условие, которое повторяется несколько раз в одном или нескольких запросах.

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

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

Тип: Таблица<ДинамическийСписок>
Имя: ТаблицаСПараметрами
Источник:
    ОсновнаяТаблица:
        Таблица: Срез
    Параметры:
        -
            Тип: ПараметрДинамическогоСписка
            Имя: Параметр1
            Значение:
                Тип: Число
                Значение: 110
        -
            Тип: ПараметрДинамическогоСписка
            Имя: Параметр2
            Значение: =УсловиеОтПользователя
    Фильтр:
        Элементы:
            -
                Тип: ЭлементФильтраВыражение
                Выражение: Срез.Курс == &Параметр2

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

Чтобы добавить аргумент, добавьте свойство Аргументы, после чего укажите для него одно или несколько свойств Значение. Например, для следующей выборки на языке запросов:

ВЫБРАТЬ
    Период,
    Курс,
    Валюта
ИЗ
    Курсы.СрезПоследних(Дата{2021-04-05})

Описание аргументов в файле YAML будет выглядеть следующим образом:

• для основной таблицы:

Тип: Таблица<ДинамическийСписок>
Источник:
    ОсновнаяТаблица:
        Таблица: КурсыВалют.СрезПоследних
        Псевдоним: Срез
        Аргументы:
            -
                Тип: АргументТаблицы
                Значение:
                    Тип: Дата
                    Значение: 2021-04-05
    Поля:
        - 
            Тип: ПолеДинамическогоСписка
            Выражение: Срез.Период
        - 
            Тип: ПолеДинамическогоСписка
            Выражение: Срез.Валюта

• для присоединенной таблицы:

ПрисоединенныеТаблицы:
    - 
        Тип: ПрисоединеннаяТаблица
        Таблица: КурсыВалют.СрезПоследних
        Аргументы:
            -
                Тип: АргументТаблицы
                Значение:
                    Тип: Дата
                    Значение: 2021-04-05

Пример использования выражения как аргумента таблицы:

Тип: Таблица<ДинамическийСписок>
ИспользованиеПоиска: Ложь
Источник:
    ОсновнаяТаблица:
        Таблица: КурсыВалют.СрезПоследних
        Псевдоним: Срез
        Аргументы:
            -
                Тип: АргументТаблицыВыражение
                Выражение: =ПараметрДата
    Параметры:
        - 
            Тип: ПараметрДинамическогоСписка
            Имя: ПараметрДата
            Значение:
                Тип: Дата
                Значение: 10.10.2021
    Поля:
        - 
            Тип: ПолеДинамическогоСписка
            Выражение: Срез.Период
        - 
            Тип: ПолеДинамическогоСписка
            Выражение: Срез.Валюта               
    Фильтр:
        Элементы:
            -
                Тип: ЭлементФильтраВыражение
                Выражение: Срез.Курс == &Параметр2

Общий пример использования различных типов значений параметров и аргументов в различных частях динамического списка:

ВидЭлемента: КомпонентИнтерфейса
ОбластьВидимости: ВПодсистеме
Ид: 157b069e-baa1-4a28-ab9e-5162f4b66688
Имя: МояТаблица
Свойства:
    -
        Имя: СвойствоФормат
        Тип: Строка
Наследует:
    Тип: Таблица<ДинамическийСписок>
    ИспользованиеПоиска: Ложь
    Источник:
        ОсновнаяТаблица:
            Таблица: КурсыВалют.СрезПоследних
            Псевдоним: Срез
            Аргументы:
                -
                    Тип: АргументТаблицы
                    Значение:
                        Тип: Дата
                        Значение: 10.10.2021
        Поля:
            - 
                Тип: ПолеДинамическогоСписка
                Выражение: Период
            - 
                Тип: ПолеДинамическогоСписка
                Выражение: Валюта   
            - 
                Тип: ПолеДинамическогоСписка
                # Используем параметр в полях. Задаем формат курса валют
                Выражение: Курс.Представление(&ПараметрСтрока)
                Псевдоним: ФорматированныйКурс                 
        Параметры:
            - 
                Тип: ПараметрДинамическогоСписка
                Имя: ПараметрЧисло
                Значение:
                    Тип: Число
                    Значение: 110
            - 
                Тип: ПараметрДинамическогоСписка
                Имя: ПараметрБулево
                Значение:
                    Тип: Булево
                    Значение: Истина
            - 
                Тип: ПараметрДинамическогоСписка
                Имя: ПараметрСтрока
                Значение:
                    Тип: Строка
                    Значение: 0_11;DG=_ # Применяем данный формат к числу 1234567. Получаем: 001_234_567
            - 
                # Берем строку формата из свойства компонента. 
                # Устанавливаем параметр динамического списка через ссылку на объект
                Тип: ПараметрДинамическогоСписка
                Имя: ПараметрФормат
                Значение: =СвойствоФормат 
        Фильтр:
            Элементы:
                - # Используем параметр в ЭлементФильтраВыражение
                    Тип: ЭлементФильтраВыражение
                    Выражение: Срез.Курс == &ПараметрЧисло # КурсыВалют.СрезПоследних(10.10.2021).Курс == 110
                -
                    Тип: ЭлементФильтраВыражение
                    Выражение: '&ПараметрБулево'
                -
                    Тип: ЭлементФильтраВыражение
                    Выражение: Срез.Курс.Представление(&ПараметрСтрока).Содержит("110")
        Сортировка:
            - 
                Тип: ЭлементСортировки
                Поле: Валюта

Реквизиты-коллекции

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

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

Тип: Таблица<ДинамическийСписок>
Имя: Таблица
Источник:
    Тип: ДинамическийСписок
    ОсновнаяТаблица:
        Таблица: СправочникСотрудники
    Поля:
        -
            Тип: ПолеДинамическогоСписка
            ОтображатьВНастройкахФильтров: Истина
            ОтображатьВПростыхФильтрах: Истина
            Выражение: Код
        -
            Тип: ПолеКоллекцияДинамическогоСписка
            ОтображатьВНастройкахФильтров: Истина
            ОтображатьВПростыхФильтрах: Истина
            Выражение: НомераТелефонов
    Колонки:
        -
            Тип: СтандартнаяКолонкаТаблицы<СтрокаДинамическогоСписка>
            Заголовок: Код
            ПолеЗначения: Код
        -
            Тип: СтандартнаяКолонкаТаблицы<СтрокаДинамическогоСписка>
            ПолеЗначения: НомераТелефонов
            Заголовок: Номера телефонов

Для фильтрации строк по полю с реквизитом-коллекцией используется перечисление ВидСравненияПоляКоллекция. Оно содержит следующие элементы:

• Пусто — условие истинно, если множественное поле не содержит ни одного значения (поле фильтра «Значение» игнорируется);
• СодержитЛюбой — условие истинно, если хотя бы одно значение фильтра присутствует в значении множественного поля;
• СодержитВсе — условие истинно, если каждое значение фильтра присутствует в значении множественного поля;
• СодержитТолько — условие истинно, если все значения множественного поля совпадают с заданными значениями фильтра;
• НеСодержит — условие истинно, если ни одно значение фильтра не совпадает со значениями множественного поля.

Пример фильтрации по полю с реквизитом-коллекцией в среде разработки:

Тип: Таблица<ДинамическийСписок>
Имя: Таблица
Источник:
    Тип: ДинамическийСписок
    ОсновнаяТаблица:
        Таблица: СправочникСотрудники
    Поля:
        -
            Тип: ПолеДинамическогоСписка
            ОтображатьВНастройкахФильтров: Истина
            ОтображатьВПростыхФильтрах: Истина
            Выражение: Код
        -
            Тип: ПолеКоллекцияДинамическогоСписка
            ОтображатьВНастройкахФильтров: Истина
            ОтображатьВПростыхФильтрах: Истина
            Выражение: ПройденныеКурсы
    Колонки:
        -
            Тип: СтандартнаяКолонкаТаблицы<СтрокаДинамическогоСписка>
            Заголовок: Код
            ПолеЗначения: Код
        -
            Тип: СтандартнаяКолонкаТаблицы<СтрокаДинамическогоСписка>
            ПолеЗначения: ПройденныеКурсы
            Заголовок: Пройденные курсы
    Фильтр:
        Элементы:
            - 
                Тип: ЭлементФильтраПоляКоллекция
                Поле: ПройденныеКурсы
                ВидСравненияПоляКоллекция: СодержитЛюбой
                Значение:
                    Тип: Строка
                    Значение: Курс по программированию

Пример фильтрации по полю с реквизитом-коллекцией в пользовательском интерфейсе:

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

• В открывшемся окне выберите Продвинутые и нажмите Применить:

• После этого снова откройте фильтр и нажмите + Добавить фильтр. В открывшемся окне укажите необходимый столбец с реквизитом-коллекцией, задайте условие отбора, а также отметьте все необходимые значения в выпадающем списке поля Значение. Нажмите Сохранить:

Встроенный язык

Информация для работы с динамическим списком и его свойствами во встроенном языке описана в разделе «Динамический список» стандартной библиотеки.

См. также

• Таблица
• Стандартный список