ДинамическийСписок.УстановитьОбязательноеИспользование

Методы · SetRequiredUse

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

Синтаксис

УстановитьОбязательноеИспользование(<Поле>, <Использование>)
Полное описание, параметры и ограничения

ДинамическийСписок.УстановитьОбязательноеИспользование (DynamicList.SetRequiredUse)

ДинамическийСписок (DynamicList)

УстановитьОбязательноеИспользование (SetRequiredUse)

Доступен, начиная с версии 8.2.

Синтаксис:
УстановитьОбязательноеИспользование(<Поле>, <Использование>)
Параметры:

<Поле> (обязательный)
Тип: Строка.
Поле, значение которого требуется обязательно получать на клиенте.

<Использование> (обязательный)
Тип: Булево.
Указывает обязательность выбора поля.
Истина - поле обязательно для выборки.
Ложь - поле может не выбираться.
Описание:

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

Доступность:

Тонкий клиент, веб-клиент, мобильный клиент, сервер, толстый клиент, мобильное приложение (клиент), мобильное приложение (сервер), мобильный автономный сервер.

Использование в версии:

Доступен, начиная с версии 8.2.

Методическая информация

Практические примеры

Получить скрытую цену текущей строки на клиенте

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

Где и как запускать

Модуль собственной управляемой формы внешней обработки. Вставляйте готовые процедуры с директивами на уровне модуля; каждый урок — в отдельной копии формы.

Подготовка

  1. В учебной базе 8.5.1.1343 создайте новую внешнюю обработку УчебныйСписок85, пустую управляемую основную форму. Режим совместимости — 8.3.19 или выше. Не переделывайте список рабочей конфигурации.

  2. В реквизитах формы добавьте Список типа ДинамическийСписок. Создайте один элемент ТаблицаФормы с именем ТаблицаТоваров и путём к данным Список. Колонки вручную не добавляйте: их создаёт код. Это не ТаблицаЗначений и не коллекция строк для Добавить().

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

  4. При открытии код задаёт произвольный запрос из четырёх константных строк. Основная таблица не указана; таблицы базы, файлы и внешние сервисы не используются. Запись данных отсутствует.

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

  6. В Командах формы создайте РассчитатьВыбранное, назначьте действие РассчитатьВыбранное; перенесите команду на форму как кнопку. Код ниже уже содержит готовый клиентский обработчик.

&НаСервере
Процедура ПриСозданииНаСервере(Отказ, СтандартнаяОбработка)
    Список.ПроизвольныйЗапрос = Истина;
    Список.ОсновнаяТаблица = "";
    Список.ДинамическоеСчитываниеДанных = Ложь;
    Список.АвтоЗаполнениеДоступныхПолей = Истина;
    Список.АвтоматическоеСохранениеПользовательскихНастроек = Ложь;
    Список.ВидКлюча = ВидКлючаДинамическогоСписка.ЗначениеПоля;
    КлючевыеПоля = Новый Массив;
    КлючевыеПоля.Добавить("УчебныйНомер");

    Список.ПоляКлюча = Новый ФиксированныйМассив(КлючевыеПоля);
    Список.ТекстЗапроса = "ВЫБРАТЬ
|    1 КАК УчебныйНомер,
|    ""Книга"" КАК Наименование,
|    ""Канцелярия"" КАК Категория,
|    3 КАК Количество,
|    250 КАК Цена
|ОБЪЕДИНИТЬ ВСЕ
|ВЫБРАТЬ 2, ""Ручка"", ""Канцелярия"", 1, 30
|ОБЪЕДИНИТЬ ВСЕ
|ВЫБРАТЬ 3, ""Чай"", ""Продукты"", 2, 150
|ОБЪЕДИНИТЬ ВСЕ
|ВЫБРАТЬ 4, ""Вода"", ""Продукты"", 0, 70";
    Элементы.ТаблицаТоваров.ТолькоПросмотр = Истина;
    Список.УстановитьОбязательноеИспользование("Цена", Истина);
    Список.ПолучениеПредставленийДляНевидимыхПолей = Ложь;
    Сообщить(Список.ПолучитьОбязательноеИспользование("Цена"));

    Для Каждого ИмяПоля Из СтрРазделить("УчебныйНомер,Наименование,Категория,Количество", ",") Цикл
        Колонка = Элементы.Добавить("Товары" + ИмяПоля, Тип("ПолеФормы"), Элементы.ТаблицаТоваров);
        Колонка.Вид = ВидПоляФормы.ПолеВвода;
        Колонка.ПутьКДанным = "Список." + ИмяПоля;
        Колонка.Заголовок = ИмяПоля;
    КонецЦикла;
КонецПроцедуры

&НаКлиенте
Процедура РассчитатьВыбранное(Команда)
    Товар = Элементы.ТаблицаТоваров.ТекущиеДанные;
    Если Товар = Неопределено Тогда
        Сообщить("Выберите товар");
        Возврат;
    КонецЕсли;
    Сообщить(Товар.Наименование + ": сумма " + Строка(Товар.Количество * Товар.Цена));
КонецПроцедуры

Разбор по шагам

  1. Цена отсутствует среди создаваемых колонок, но УстановитьОбязательноеИспользование требует её выборку и передачу клиенту.

  2. Настройка получения представлений относится к ссылочным полям: здесь Цена — число. Она не заменяет обязательное использование и не запрещает чтение.

  3. Кнопка вызывает клиентский обработчик. ТекущиеДанные доступно на клиенте; Неопределено обрабатывается до чтения свойств.

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

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

  1. При открытии проверка обязательного использования даёт Истина; колонки Цена нет.

  2. Выберите Книгу, нажмите Рассчитать выбранное: сумма 750. Для Воды сумма 0.

  3. Если нет выбранной строки, получаете сообщение Выберите товар, а не ошибку чтения свойства.

Ожидаемый результат

Работа со скрытым числовым полем выбранной строки с корректным клиентским контекстом.

На что обратить внимание

  1. Не показывать колонку — не защита цены: значение явно передаётся клиенту.

  2. При группировке текущей может быть строка группы. Этот урок без группировки; перенос в сгруппированную форму требует отдельной проверки типа строки.

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

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

Не хотите разбираться сами?

Адаптируем это решение под вашу базу. Оценка бесплатно.

Оставить задачу

1С, 1С:Предприятие — товарные знаки ООО «1С». Сайт не является официальным представительством фирмы «1С» и не аффилирован с ней.