ДанныеФормыКоллекция.Сдвинуть

Вставить, добавить и переставить строки только своей формы

Создаём Книга/Ручка, временно добавляем Карандаш/Вода и убираем их из памяти. Для Сдвинуть передаём индекс, для Удалить показываем два разных допустимых аргумента.

Подготовка

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

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

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

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

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

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

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

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

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

&НаКлиенте
Процедура УчебноеДействие(Команда)
    СброситьТолькоУчебныеТовары();
    Карандаш = Товары.Вставить(1);
    Карандаш.Код = "C-03";
    Карандаш.Наименование = "Карандаш";
    Карандаш.Количество = 2;
    Вода = Товары.Добавить();
    Вода.Код = "D-04";
    Вода.Наименование = "Вода";
    Вода.Количество = 5;
    Сообщить(Товары.Количество() = 4);
    Сообщить(Товары.Получить(1).Код = "C-03");
    Ручка = Товары.Получить(2);
    Товары.Сдвинуть(Товары.Индекс(Ручка), -2);
    Сообщить(Товары.Получить(0).Код = "B-02");
    Товары.Удалить(Карандаш);
    Товары.Удалить(Товары.Индекс(Вода));
    Сообщить(Товары.Количество() = 2);
    Сообщить(Товары.Получить(0).Код = "B-02");
    Сообщить(Товары.Получить(1).Код = "A-01");
    Сообщить(Товары.Получить(0).Количество = 1);
    Сообщить(Товары.Получить(1).Количество = 3);
КонецПроцедуры

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

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

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

1. Серверный сброс возвращает исходные Книга/3 и Ручка/1. Индексация начинается с 0.

2. Вставить(1) ставит карандаш между ними; Добавить помещает воду в конец.

3. Получить возвращает строку данных формы. Позиция ручки после вставки уже 2, не исходная 1.

4. Сдвинуть принимает ЧИСЛОВОЙ индекс и смещение. Отрицательное -2 переносит ручку в начало.

5. Удаляем карандаш по элементу, воду по актуальному индексу. После сдвига нельзя использовать старую позицию воды.

6. Удаление из данных своей формы не вызывает Удалить у объекта базы и не записывает документ.

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

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

2. В конце таблица показывает Ручка/1, Книга/3; Карандаш/Вода отсутствуют. Повторный запуск даёт тот же результат благодаря собственному сбросу.

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

Разобраны вставка, добавление, доступ по индексу, сдвиг и два способа удаления на конкретных строках.

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

1. Данные формы и ТаблицаФормы — разные объекты. Методы строк вызываются у Товары, не у Элементы.ТаблицаТоваров.

2. Сдвинуть у этого типа принимает индекс, не объект строки.

3. В реальной форме документа изменение табличной части может затем быть записано. Здесь нет команды записи и нет объекта рабочего документа.

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