КомандыФормы.Количество

Добавить и удалить только собственные временные команду и элементы формы

На сервере своего экземпляра создадим команду, надпись и кнопку перед ней; проверим коллекции и удалим только захваченные собственные объекты.

Подготовка

1. НОВАЯ собственная файловая база 8.5.1.1343, конфигурация УчебнаяНавигация85, совместимость НеИспользовать, управляемое приложение. Без расширений, фоновых прикладных заданий, разделителей и прикладных данных. Не рабочая база или её копия. Здесь стенд, F7 и UI не запускались: runtimeVerifiedScenarios=0.

2. Создайте свои обработки Главная85 и Помощь85. У каждой — управляемая основная форма Пульт без основного реквизита, таблиц данных и обработчиков объекта. Помощь85 может иметь одну статическую надпись Учебная помощь. У Главная85 вставьте полный основной модуль выбранного урока, не внутрь другой процедуры.

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

4. Для урока коллекций назначьте ПриСозданииНаСервере. Добавьте вручную команду ПроверитьКоллекции с действием ПроверитьКоллекции и одну кнопку этой команды. Имена Уч85ВременнаяКоманда, Уч85ВременнаяКнопка, Уч85ВременнаяНадпись заранее НЕ создавайте. Выполняется только временное изменение собственного экземпляра формы.

5. Не смешивайте основные модули двух уроков в одной форме: оба определяют собственное событие создания. Вставляйте по одному. F7 и обновление только своего стенда; открывайте Главная85 из списка собственных обработок в тонком или управляемом толстом клиенте.

6. Для ссылок откройте стандартный диалог Получить ссылку своей формы и выберите Главная или Помощь. Дополнительные данные ссылки в хранилище не записываются: серверный ПолучитьНавигационнуюСсылку получает только метаданные своей обработки. Само создание строки не открывает другую форму и не обращается к внешнему сайту.

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

&НаСервере
Процедура ПриСозданииНаСервере(Отказ, СтандартнаяОбработка)
    ПроверитьСвойКонтекст();
КонецПроцедуры

&НаКлиенте
Процедура ПроверитьКоллекции(Команда)
    Сообщить(ПроверитьКоллекцииНаСервере());
КонецПроцедуры

&НаСервере
Функция ПроверитьКоллекцииНаСервере()
    ПроверитьСвойКонтекст();
    Для Каждого Команда Из ЭтаФорма.Команды Цикл
        Если Команда.Имя = "Уч85ВременнаяКоманда" Тогда
            ВызватьИсключение "Временное имя уже занято; чужую команду не удаляем";
        КонецЕсли;
    КонецЦикла;
    Если ЭтаФорма.Элементы.Найти("Уч85ВременнаяКнопка") <> Неопределено
        Или ЭтаФорма.Элементы.Найти("Уч85ВременнаяНадпись") <> Неопределено Тогда
        ВызватьИсключение "Временные имена уже заняты; чужие элементы не удаляем";
    КонецЕсли;
    КомандДо = ЭтаФорма.Команды.Количество();
    ЭлементовДо = ЭтаФорма.Элементы.Количество();
    СвояКоманда = Неопределено;
    СвояКнопка = Неопределено;
    СвояНадпись = Неопределено;
    Попытка
        СвояКоманда = ЭтаФорма.Команды.Добавить("Уч85ВременнаяКоманда");
        Если ЭтаФорма.Команды.Найти("Уч85ВременнаяКоманда").Имя <> СвояКоманда.Имя
            Или ЭтаФорма.Команды.Количество() <> КомандДо + 1 Тогда
            ВызватьИсключение "Новая собственная команда должна находиться по имени";
        КонецЕсли;
        СвояНадпись = ЭтаФорма.Элементы.Добавить("Уч85ВременнаяНадпись", Тип("ДекорацияФормы"));
        СвояНадпись.Вид = ВидДекорацииФормы.Надпись;
        СвояНадпись.Заголовок = "Временный учебный элемент";
        СвояКнопка = ЭтаФорма.Элементы.Вставить("Уч85ВременнаяКнопка", Тип("КнопкаФормы"), ЭтаФорма, СвояНадпись);
        СвояКнопка.ИмяКоманды = СвояКоманда.Имя;
        Если ЭтаФорма.Элементы.Количество() <> ЭлементовДо + 2
            Или ЭтаФорма.Элементы.Найти("Уч85ВременнаяКнопка") = Неопределено Тогда
            ВызватьИсключение "Коллекция всех элементов должна включать оба временных элемента";
        КонецЕсли;
    Исключение
        УдалитьТолькоСвоиВременные(СвояКнопка, СвояНадпись, СвояКоманда);
        ВызватьИсключение;
    КонецПопытки;
    УдалитьТолькоСвоиВременные(СвояКнопка, СвояНадпись, СвояКоманда);
    Если ЭтаФорма.Команды.Количество() <> КомандДо Или ЭтаФорма.Элементы.Количество() <> ЭлементовДо Тогда
        ВызватьИсключение "Возврат исходного количества собственных объектов формы не подтверждён";
    КонецЕсли;
    Возврат "Свои временные команда, кнопка и надпись проверены и удалены. Исходные элементы не удалялись.";
КонецФункции

&НаСервере
Процедура УдалитьТолькоСвоиВременные(СвояКнопка, СвояНадпись, СвояКоманда)
    Если СвояКнопка <> Неопределено Тогда
        ЭтаФорма.Элементы.Удалить(СвояКнопка);
    КонецЕсли;
    Если СвояНадпись <> Неопределено Тогда
        ЭтаФорма.Элементы.Удалить(СвояНадпись);
    КонецЕсли;
    Если СвояКоманда <> Неопределено Тогда
        ЭтаФорма.Команды.Удалить(СвояКоманда);
    КонецЕсли;
КонецПроцедуры

&НаСервереБезКонтекста
Процедура ПроверитьСвойКонтекст()
    Если Метаданные.РежимСовместимости <> Метаданные.СвойстваОбъектов.РежимСовместимости.НеИспользовать Тогда
        ВызватьИсключение "Нужен собственный стенд УчебнаяНавигация85 платформы 8.5.1.1343";
    КонецЕсли;
    Если ТранзакцияАктивна() Тогда
        ВызватьИсключение "Учебный вывод не должен выполняться внутри чужой транзакции";
    КонецЕсли;
КонецПроцедуры

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

1. Клиентская команда вызывает серверную функцию формы и получает только строковый результат. Изменение коллекций на клиенте не выполняется.

2. Команды и Элементы — readonly-свойства формы, возвращающие настоящие коллекции. Readonly не запрещает документированные операции с их содержимым на сервере; сами свойства новым объектом не заменяются.

3. До создания проверяем занятость временных имён. Поиск отсутствующего элемента формы документирован как Неопределено; для команд не предполагаем недокументированное поведение Найти при отсутствии, а обходим текущие команды по именам.

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

5. Элементы.Добавить создаёт свою декорацию-надпись на верхнем уровне. Вставить получает имя, Тип("КнопкаФормы"), собственную форму-родителя и конкретную надпись, ПЕРЕД которой нужна кнопка; это не числовой индекс.

6. Кнопка привязана к имени собственной временной команды. Промежуточный UI не должен нажиматься: обе создаются и удаляются в том же серверном вызове, действие временной команды не назначается.

7. ВсеЭлементыФормы.Количество считает элементы вне зависимости от иерархии и не включает корневую форму. После двух добавлений сравниваем с исходным числом плюс два, а не с предположением о пустом дизайнерском интерфейсе.

8. Удаление получает объект, не имя и не индекс. Сначала удаляем временную кнопку, затем надпись, затем команду, чтобы не оставлять кнопку с уже удалённой привязкой. Штатная кнопка ПроверитьКоллекции не удаляется.

9. Очистка вызывается после успеха и при ошибке создания/проверки, использует только захваченные ранее программно добавленные объекты. Сбой самой очистки может заменить исходную ошибку; это не универсальный откат формы.

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

1. Будущий тест: F7, собственная кнопка ПроверитьКоллекции, итоговое число команд и элементов совпадает с исходным. Здесь runtimeVerifiedScenarios=0, реальный UI не изменялся.

2. Повторный успешный вызов снова допустим: временные имена освобождены, исходная кнопка продолжает существовать.

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

4. При успешном серверном вызове промежуточные элементы могут не отображаться клиенту. Проверяется жизненный цикл объектов коллекций, а не анимация появления кнопки.

5. Если удаление завершилось ошибкой, не считайте восстановление подтверждённым: закройте только свою учебную форму и проверьте подготовку перед повтором. Рабочие формы запрещены.

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

Будущий результат — создание, поиск и удаление трёх собственных временных объектов, без удаления исходных элементов формы и без записи прикладных данных.

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

1. Добавить/Вставить/Удалить этих коллекций выполняются на сервере. Доступность чтения количества на клиенте не означает доступность изменения.

2. Удалять разрешено только ранее программно добавленные объекты. Не передавайте в Удалить штатные дизайнерские элементы, найденные случайно по имени.

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

4. Временная команда не имеет прикладного действия и не предназначена для нажатия. Чтобы оставить её в интерфейсе, понадобился бы отдельный полный обработчик; этот урок проверяет только жизненный цикл.

5. Равные итоговые количества не доказывают транзакционный откат всех свойств формы. Код удаляет только свои захваченные объекты и не изменяет чужие настройки.

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