Выгрузить ручку по массиву строк, а книгу — по отбору

Две перегрузки одного метода принимают разные первые аргументы. Массив содержит сами строки коллекции, а Структура связывает имя колонки с нужным значением.

Подготовка

1. В учебной базе: Файл → Новый → Внешняя обработка. Создайте управляемую форму и назначьте её основной. Дайте обработке имя УчебнаяТаблица.

2. Не добавляйте вручную реквизит Товары и одноимённые элементы: код создаст их при открытии. Модуль формы для этой задачи должен быть пустым.

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

4. Данные Книга/Ручка создаются в памяти формы. Справочники, документы и регистры вашей конфигурации не читаются и не записываются.

5. Каждая команда сначала сбрасывает ТОЛЬКО собственный реквизит Товары к двум учебным строкам. Ручные изменения этой учебной таблицы при запуске задачи будут потеряны; рабочие формы не используйте.

6. ДанныеФормыКоллекция не создаётся через Новый. Она возникает у реквизита формы, описанного как ТаблицаЗначений. Выгрузить/Загрузить выполняются только на сервере.

&НаСервере
Процедура ПриСозданииНаСервере(Отказ, СтандартнаяОбработка)
    НовыеРеквизиты = Новый Массив;
    НовыеРеквизиты.Добавить(Новый РеквизитФормы("Товары", Новый ОписаниеТипов("ТаблицаЗначений")));
    НовыеРеквизиты.Добавить(Новый РеквизитФормы("Код", Новый ОписаниеТипов("Строка"), "Товары", "Код"));
    НовыеРеквизиты.Добавить(Новый РеквизитФормы("Наименование", Новый ОписаниеТипов("Строка"), "Товары", "Название"));
    НовыеРеквизиты.Добавить(Новый РеквизитФормы("Количество", Новый ОписаниеТипов("Число",
        Новый КвалификаторыЧисла(9, 0, ДопустимыйЗнак.Неотрицательный)), "Товары", "Количество"));
    ЭтаФорма.ИзменитьРеквизиты(НовыеРеквизиты);
    Данные = Новый ТаблицаЗначений;
    Данные.Колонки.Добавить("Код", Новый ОписаниеТипов("Строка"));
    Данные.Колонки.Добавить("Наименование", Новый ОписаниеТипов("Строка"));
    Данные.Колонки.Добавить("Количество", Новый ОписаниеТипов("Число",
        Новый КвалификаторыЧисла(9, 0, ДопустимыйЗнак.Неотрицательный)));

    СтрокаТовара = Данные.Добавить();
    СтрокаТовара.Код = "A-01";
    СтрокаТовара.Наименование = "Книга";
    СтрокаТовара.Количество = 3;
    СтрокаТовара = Данные.Добавить();
    СтрокаТовара.Код = "B-02";
    СтрокаТовара.Наименование = "Ручка";
    СтрокаТовара.Количество = 1;

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

&НаКлиенте
Процедура УчебноеДействие(Команда)
    СброситьТолькоУчебныеТовары();
    ПроверитьДваОтбораНаСервере();
КонецПроцедуры

&НаСервереБезКонтекста
Функция СоздатьДваУчебныхТовара()
    Данные = Новый ТаблицаЗначений;
    Данные.Колонки.Добавить("Код", Новый ОписаниеТипов("Строка"));
    Данные.Колонки.Добавить("Наименование", Новый ОписаниеТипов("Строка"));
    Данные.Колонки.Добавить("Количество", Новый ОписаниеТипов("Число",
        Новый КвалификаторыЧисла(9, 0, ДопустимыйЗнак.Неотрицательный)));
    Книга = Данные.Добавить();
    Книга.Код = "A-01";
    Книга.Наименование = "Книга";
    Книга.Количество = 3;
    Ручка = Данные.Добавить();
    Ручка.Код = "B-02";
    Ручка.Наименование = "Ручка";
    Ручка.Количество = 1;
    Возврат Данные;
КонецФункции

&НаСервере
Процедура СброситьТолькоУчебныеТовары()
    Товары.Загрузить(СоздатьДваУчебныхТовара());
КонецПроцедуры

&НаСервере
Процедура ПроверитьДваОтбораНаСервере()
    Выбранные = Новый Массив;
    Выбранные.Добавить(Товары.Получить(1));
    Ручки = Товары.Выгрузить(Выбранные, "Код,Количество");
    Сообщить(Ручки.Количество() = 1);
    Сообщить(Ручки[0].Код = "B-02");
    Сообщить(Ручки[0].Количество = 1);
    Книги = Товары.Выгрузить(Новый Структура("Код", "A-01"), "Код,Количество");
    Сообщить(Книги.Количество() = 1);
    Сообщить(Книги[0].Код = "A-01");
    Книги[0].Количество = 55;
    Сообщить(Товары.Количество() = 2);
    Сообщить(Товары.Получить(0).Количество = 3);
КонецПроцедуры

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

1. Коллекция содержит две собственные строки, исходная ручка имеет индекс 1.

2. В массив помещаем строку, не её индекс и не строковый код.

3. Вторая перегрузка получает Структура("Код", "A-01"); Код — идентификатор колонки.

4. Обе выгрузки ограничивают колонки и выполняются на сервере.

5. Изменяем количество только в копии книги, затем проверяем исходные данные формы.

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

1. Семь логических сообщений дают Истина.

2. Первая копия содержит только B-02/1, вторая — A-01; количество 55 не попадает обратно в форму.

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

На разных товарах показано различие выбора по объектам строк и отбора по значению колонки.

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

1. Не передавайте Массив чисел вместо Массив строк коллекции в эту перегрузку.

2. Массив строк должен относиться к этой коллекции, не к другой форме.

3. Изменение копии не является редактированием исходной строки; для этого нужен отдельный осмысленный шаг.

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