Тип: ФиксированныйМассив. Содержит фиксированный массив строк - путей ключевых полей. Если основная таблица указана, свойство не используется.
Полное описание, параметры и ограничения
ДинамическийСписок.ПоляКлюча (DynamicList.KeyFields)
ДинамическийСписок (DynamicList)
ПоляКлюча (KeyFields)
Доступен, начиная с версии 8.3.14.
Использование:
Чтение и запись.
Описание:
Тип: ФиксированныйМассив.
Содержит фиксированный массив строк - путей ключевых полей. Если основная таблица указана, свойство не используется.
Доступность:
Сервер.
Использование в версии:
Доступен, начиная с версии 8.3.14.
Методическая информация
Практические примеры
Рассчитать сумму Количество × Цена в списке
Вычисляемое поле принадлежит схеме списка. Для расчёта суммы не добавляем реквизит справочника и не записываем данные.
Где и как запускать
Модуль собственной управляемой формы внешней обработки. Вставляйте готовые процедуры с директивами на уровне модуля; каждый урок — в отдельной копии формы.
Подготовка
В учебной базе 8.5.1.1343 создайте новую внешнюю обработку УчебныйСписок85, пустую управляемую основную форму. Режим совместимости — 8.3.19 или выше. Не переделывайте список рабочей конфигурации.
В реквизитах формы добавьте Список типа ДинамическийСписок. Создайте один элемент ТаблицаФормы с именем ТаблицаТоваров и путём к данным Список. Колонки вручную не добавляйте: их создаёт код. Это не ТаблицаЗначений и не коллекция строк для Добавить().
В событиях формы назначьте ПриСозданииНаСервере одноимённой процедуре из примера. Не используйте одновременно другой обработчик заполнения этого списка.
При открытии код задаёт произвольный запрос из четырёх константных строк. Основная таблица не указана; таблицы базы, файлы и внешние сервисы не используются. Запись данных отсутствует.
Каждый раз открывайте отдельную копию формы. Автоматическое сохранение настроек отключено: старый пользовательский отбор не должен вмешиваться в упражнение.
&НаСервере
Процедура ПриСозданииНаСервере(Отказ, СтандартнаяОбработка)
Список.ПроизвольныйЗапрос = Истина;
Список.ОсновнаяТаблица = "";
Список.ДинамическоеСчитываниеДанных = Ложь;
Список.АвтоЗаполнениеДоступныхПолей = Истина;
Список.АвтоматическоеСохранениеПользовательскихНастроек = Ложь;
Список.ВидКлюча = ВидКлючаДинамическогоСписка.ЗначениеПоля;
КлючевыеПоля = Новый Массив;
КлючевыеПоля.Добавить("УчебныйНомер");
Список.ПоляКлюча = Новый ФиксированныйМассив(КлючевыеПоля);
Список.ТекстЗапроса = "ВЫБРАТЬ
| 1 КАК УчебныйНомер,
| ""Книга"" КАК Наименование,
| ""Канцелярия"" КАК Категория,
| 3 КАК Количество,
| 250 КАК Цена
|ОБЪЕДИНИТЬ ВСЕ
|ВЫБРАТЬ 2, ""Ручка"", ""Канцелярия"", 1, 30
|ОБЪЕДИНИТЬ ВСЕ
|ВЫБРАТЬ 3, ""Чай"", ""Продукты"", 2, 150
|ОБЪЕДИНИТЬ ВСЕ
|ВЫБРАТЬ 4, ""Вода"", ""Продукты"", 0, 70";
Элементы.ТаблицаТоваров.ТолькоПросмотр = Истина;
Сумма = Список.ВычисляемыеПоля.Добавить();
Сумма.ПутьКДанным = "УчебнаяСумма";
Сумма.Заголовок = "Сумма, руб.";
Сумма.Выражение = "Количество * Цена";
Сумма.ТипЗначения = Новый ОписаниеТипов("Число", Новый КвалификаторыЧисла(15, 2));
Сумма.Оформление.УстановитьЗначениеПараметра("Формат", "ЧДЦ=2; ЧН=0");
Сообщить(Список.ВычисляемыеПоля.Найти("УчебнаяСумма") = Сумма);
Сообщить(Список.ВычисляемыеПоля.Количество() = 1);
Контроль = Новый Запрос(Список.ТекстЗапроса);
Данные = Контроль.Выполнить().Выгрузить();
Сообщить(Данные.Найти(1, "УчебныйНомер").Количество * Данные.Найти(1, "УчебныйНомер").Цена = 750);
Для Каждого ИмяПоля Из СтрРазделить("УчебныйНомер,Наименование,Категория,Количество,Цена,УчебнаяСумма", ",") Цикл
Колонка = Элементы.Добавить("Товары" + ИмяПоля, Тип("ПолеФормы"), Элементы.ТаблицаТоваров);
Колонка.Вид = ВидПоляФормы.ПолеВвода;
Колонка.ПутьКДанным = "Список." + ИмяПоля;
Колонка.Заголовок = ИмяПоля;
КонецЦикла;
КонецПроцедуры
Разбор по шагам
У вычисляемого поля задаём уникальный путь УчебнаяСумма. Это имя понадобится в ПутьКДанным колонки формы.
Выражение использует поля запроса, не переменные модуля формы. Количество и Цена числовые в собственном запросе.
Формат меняет отображение, а не арифметику. Дополнительная проверка исходных данных подтверждает сумму Книги 750.
Как проверить результат
Три проверки дают Истина.
В новой колонке суммы: Книга 750,00; Ручка 30,00; Чай 300,00; Вода 0,00.
В исходном запросе нет колонки УчебнаяСумма: вычисление относится к схеме списка.
Ожидаемый результат
Наглядная расчётная колонка без изменения структуры базы.
На что обратить внимание
ВыражениеПредставления вычисляемого поля не поддерживается в динамическом списке.
Не складывайте строки количества/цены как числа без определения их типа; здесь типы заданы самим запросом.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.
Выбрать Книгу в таблице по составному ключу
Для двух ключевых полей используем вид КлючСтроки. Клиентская кнопка задаёт ТекущаяСтрока ключом с теми же путями, а не номером позиции на экране.
Где и как запускать
Модуль собственной управляемой формы внешней обработки. Вставляйте готовые процедуры с директивами на уровне модуля; каждый урок — в отдельной копии формы.
Подготовка
В учебной базе 8.5.1.1343 создайте новую внешнюю обработку УчебныйСписок85, пустую управляемую основную форму. Режим совместимости — 8.3.19 или выше. Не переделывайте список рабочей конфигурации.
В реквизитах формы добавьте Список типа ДинамическийСписок. Создайте один элемент ТаблицаФормы с именем ТаблицаТоваров и путём к данным Список. Колонки вручную не добавляйте: их создаёт код. Это не ТаблицаЗначений и не коллекция строк для Добавить().
В событиях формы назначьте ПриСозданииНаСервере одноимённой процедуре из примера. Не используйте одновременно другой обработчик заполнения этого списка.
При открытии код задаёт произвольный запрос из четырёх константных строк. Основная таблица не указана; таблицы базы, файлы и внешние сервисы не используются. Запись данных отсутствует.
Каждый раз открывайте отдельную копию формы. Автоматическое сохранение настроек отключено: старый пользовательский отбор не должен вмешиваться в упражнение.
В Командах формы добавьте ВыбратьКнигу, действие ВыбратьКнигу; перетащите команду на форму кнопкой. Пример уже содержит клиентский обработчик.
&НаСервере
Процедура ПриСозданииНаСервере(Отказ, СтандартнаяОбработка)
Список.ПроизвольныйЗапрос = Истина;
Список.ОсновнаяТаблица = "";
Список.ДинамическоеСчитываниеДанных = Ложь;
Список.АвтоЗаполнениеДоступныхПолей = Истина;
Список.АвтоматическоеСохранениеПользовательскихНастроек = Ложь;
Список.ВидКлюча = ВидКлючаДинамическогоСписка.КлючСтроки;
КлючевыеПоля = Новый Массив;
КлючевыеПоля.Добавить("УчебныйНомер");
КлючевыеПоля.Добавить("Категория");
Список.ПоляКлюча = Новый ФиксированныйМассив(КлючевыеПоля);
Список.ТекстЗапроса = "ВЫБРАТЬ
| 1 КАК УчебныйНомер,
| ""Книга"" КАК Наименование,
| ""Канцелярия"" КАК Категория,
| 3 КАК Количество,
| 250 КАК Цена
|ОБЪЕДИНИТЬ ВСЕ
|ВЫБРАТЬ 2, ""Ручка"", ""Канцелярия"", 1, 30
|ОБЪЕДИНИТЬ ВСЕ
|ВЫБРАТЬ 3, ""Чай"", ""Продукты"", 2, 150
|ОБЪЕДИНИТЬ ВСЕ
|ВЫБРАТЬ 4, ""Вода"", ""Продукты"", 0, 70";
Элементы.ТаблицаТоваров.ТолькоПросмотр = Истина;
Сообщить(Список.ПоляКлюча.Количество() = 2);
Сообщить(Список.ВидКлюча = ВидКлючаДинамическогоСписка.КлючСтроки);
Для Каждого ИмяПоля Из СтрРазделить("УчебныйНомер,Наименование,Категория,Количество,Цена", ",") Цикл
Колонка = Элементы.Добавить("Товары" + ИмяПоля, Тип("ПолеФормы"), Элементы.ТаблицаТоваров);
Колонка.Вид = ВидПоляФормы.ПолеВвода;
Колонка.ПутьКДанным = "Список." + ИмяПоля;
Колонка.Заголовок = ИмяПоля;
КонецЦикла;
КонецПроцедуры
&НаКлиенте
Процедура ВыбратьКнигу(Команда)
КлючКниги = Новый КлючСтрокиДинамическогоСписка(Новый Структура("УчебныйНомер,Категория", 1, "Канцелярия"));
Элементы.ТаблицаТоваров.ТекущаяСтрока = КлючКниги;
Сообщить(КлючКниги.Количество() = 2);
Сообщить(КлючКниги.Получить("УчебныйНомер") = 1);
Сообщить("Проверьте выделенную строку Книга в учебной таблице");
КонецПроцедуры
Разбор по шагам
Основная таблица пустая; собственный запрос создаёт четыре товара. Поля ключа УчебныйНомер и Категория задаются явно.
Вид КлючСтроки подходит составному ключу. ЗначениеПоля в предыдущем уроке использовалось только для одного ключевого поля.
Кнопка строит ключ Книги по двум значениям и присваивает ТекущаяСтрока. Она не меняет запрос и не добавляет товар.
Проверка появления выбранной строки визуальная. Отсутствие строки с таким ключом не превращается автоматически в запись нового товара.
Как проверить результат
При открытии две проверки дают Истина.
Нажмите ВыбратьКнигу: две клиентские проверки дают Истина; в таблице должна быть выбрана Книга с номером 1 и категорией Канцелярия.
Измените сортировку таблицы и повторите выбор: Книга выбирается по ключу, а не по позиции строки.
Ожидаемый результат
Выбор собственной строки по двум ключевым полям без изменения данных.
На что обратить внимание
Нельзя подменять составной ключ числом 1 только потому, что у Книги номер 1.
Указанная основная таблица имеет другие правила ключа: пример специально без неё.
ТекущиеДанные после выбора и взаимодействия с сервером — отдельная операция; урок не выдаёт их до готовности строки.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.