КомандыФормы.Найти

Методы · Find

Выполняет поиск команды по имени.

Синтаксис

Найти(<ИмяКоманды>)
Полное описание, параметры и ограничения

КомандыФормы.Найти (FormCommands.Find)

КомандыФормы (FormCommands)

Найти (Find)

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

Синтаксис:
Найти(<ИмяКоманды>)
Параметры:

<ИмяКоманды> (обязательный)
Тип: Строка.
Имя команды, которую нужно найти.
Возвращаемое значение:
Тип: КомандаФормы.

Описание:

Выполняет поиск команды по имени.

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

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

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

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

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

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

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

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

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

Полный модуль собственной управляемой формы Главная85.Пульт. Изменение коллекций только в серверной функции; клиентская команда только выводит её результат.

Подготовка

  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. Равные итоговые количества не доказывают транзакционный откат всех свойств формы. Код удаляет только свои захваченные объекты и не изменяет чужие настройки.

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

Убрать свою старую HTML-пометку и сохранить текст 125

Разбираем собственный HTML в памяти, находим настоящий КомментарийHTML и вызываем пустую ЗаменитьПолныйТекст. Проверяем не только Неопределено, но и новое дерево: два ребёнка превращаются в один, а число 125 и заголовок остаются.

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

Своя новая пустая файловая CF 8.5.1.1343. Настоящая команда управляемой формы на клиенте; разбор и все операции HTML только в её функции &НаСервереБезКонтекста. Через границу передаётся лишь строка.

Подготовка

  1. Это узкий урок сопровождения старого HTML API: КомментарийHTML и ЗаменитьПолныйТекст не рекомендуются с версии 8.2. Он не предлагает строить новый браузерный интерфейс на этом API. Выполнение здесь не проверялось.

  2. Вручную подготовьте НОВУЮ собственную пустую файловую базу в отдельной собственной Windows VM с 1С 8.5.1.1343. Не используйте рабочую базу или её копию. В свойствах конфигурации: Основной режим запуска — Управляемое приложение, Режим совместимости — Не использовать.

  3. Конфигуратор → Общие → Общие формы: создайте управляемую форму УчебнаяПометкаHTML85. Разместите её в рабочей области начальной страницы. Весь код карточки вставьте в модуль именно этой формы, без оборачивания в дополнительную процедуру.

  4. Реквизиты формы: СогласенНаОпыт85 — Булево, исходно Ложь, выведите как ручной флажок; Состояние85 — Строка неограниченной длины, исходно Не запускалось, выведите в поле ТолькоПросмотр=Да. Фаза85 — внутренняя переменная модуля, не реквизит.

  5. В командах формы создайте УбратьПометку85 и назначьте Действие одноимённой клиентской процедуре. Создайте кнопку с ИмяКоманды=УбратьПометку85. Обработчик получает настоящую КомандаФормы; не вызывайте его вручную.

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

  7. HTML уже целиком задан строкой в коде: один DIV, комментарий ARCHIVE:125 и SPAN с числом 125. Не добавляйте пробелы между детьми DIV, URL, скрипты, файлы или внешнюю разметку. Парсер здесь не является браузером; код не открывает страницу и не сохраняет HTML.

&НаКлиенте
Перем Фаза85;

&НаКлиенте
Процедура УбратьПометку85(Команда)
    Попытка
        Если Фаза85 <> Неопределено Тогда
            ВызватьИсключение "Повтор в этом экземпляре запрещен";
        КонецЕсли;
        Если ТипЗнч(СогласенНаОпыт85) <> Тип("Булево")
            Или СогласенНаОпыт85 <> Истина Тогда
            ВызватьИсключение "Сначала подтвердите собственный учебный опыт";
        КонецЕсли;
        СогласенНаОпыт85 = Ложь;
        Фаза85 = "НЕИЗВЕСТНО";
        Состояние85 = "НЕИЗВЕСТНО: результат еще не подтвержден";
        Если ТипЗнч(Команда) <> Тип("КомандаФормы")
            Или Команда <> Команды.Найти("УбратьПометку85") Тогда
            ВызватьИсключение "Нужна настоящая команда своей формы";
        КонецЕсли;
        Протокол85 = УбратьСвоюПометкуНаСервере85();
        Если ТипЗнч(Протокол85) <> Тип("Строка") Или Протокол85 = "" Тогда
            ВызватьИсключение "Не получен серверный протокол";
        КонецЕсли;
        Фаза85 = "ПОДТВЕРЖДЕНО";
        Состояние85 = Протокол85;
    Исключение
        Фаза85 = "STOP";
        СогласенНаОпыт85 = Ложь;
        Состояние85 = "STOP: удаление и сохранность содержимого не подтверждены; повторов нет";
    КонецПопытки;
КонецПроцедуры

&НаСервереБезКонтекста
Функция УбратьСвоюПометкуНаСервере85()
    ИсходныйHTML85 = "<html><head><title>Урок 125</title></head><body><div id='comment85'><!--ARCHIVE:125--><span id='value85'>125</span></div></body></html>";
    Чтение85 = Новый ЧтениеHTML;
    Попытка
        Чтение85.УстановитьСтроку(ИсходныйHTML85);
        Построитель85 = Новый ПостроительDOM;
        Документ85 = Построитель85.Прочитать(Чтение85);
    Исключение
        Чтение85.Закрыть();
        ВызватьИсключение;
    КонецПопытки;
    Чтение85.Закрыть();
    Если ТипЗнч(Документ85) <> Тип("ДокументHTML") Тогда
        ВызватьИсключение "Разобранный документ не является ДокументHTML";
    КонецЕсли;
    ЗаголовокДо85 = Документ85.Заголовок;
    Если ТипЗнч(ЗаголовокДо85) <> Тип("Строка") Или ЗаголовокДо85 <> "Урок 125" Тогда
        ВызватьИсключение "Не подтвержден собственный заголовок";
    КонецЕсли;
    Контейнер85 = Документ85.ПолучитьЭлементПоИдентификатору("comment85");
    Поле85 = Документ85.ПолучитьЭлементПоИдентификатору("value85");
    Если ТипЗнч(Контейнер85) <> Тип("ЭлементБлокHTML")
        Или ТипЗнч(Поле85) <> Тип("ЭлементHTML") Тогда
        ВызватьИсключение "Не получены ожидаемые собственные DIV и SPAN";
    КонецЕсли;
    ВладелецКонтейнера85 = Контейнер85.ДокументВладелец;
    Если ТипЗнч(ВладелецКонтейнера85) <> Тип("ДокументHTML") Тогда
        ВызватьИсключение "Не получен документ контейнера";
    КонецЕсли;
    КонтейнерСвой85 = ВладелецКонтейнера85.УзелИдентичен(Документ85);
    Если ТипЗнч(КонтейнерСвой85) <> Тип("Булево") Или КонтейнерСвой85 <> Истина Тогда
        ВызватьИсключение "Контейнер не принадлежит своему документу";
    КонецЕсли;
    ДетиДо85 = Контейнер85.ДочерниеУзлы;
    Если ТипЗнч(ДетиДо85) <> Тип("СписокУзловHTML") Тогда
        ВызватьИсключение "Не получен настоящий список детей";
    КонецЕсли;
    КоличествоДо85 = ДетиДо85.Количество();
    Если ТипЗнч(КоличествоДо85) <> Тип("Число") Или КоличествоДо85 <> 2 Тогда
        ВызватьИсключение "Нужны ровно комментарий и SPAN, без других узлов";
    КонецЕсли;
    Пометка85 = ДетиДо85.Элемент(0);
    ВторойУзел85 = ДетиДо85.Элемент(1);
    Если ТипЗнч(Пометка85) <> Тип("КомментарийHTML")
        Или ТипЗнч(ВторойУзел85) <> Тип("ЭлементHTML") Тогда
        ВызватьИсключение "Не подтвержден порядок и тип двух детей";
    КонецЕсли;
    ПолеВКонтейнере85 = ВторойУзел85.УзелИдентичен(Поле85);
    Если ТипЗнч(ПолеВКонтейнере85) <> Тип("Булево") Или ПолеВКонтейнере85 <> Истина Тогда
        ВызватьИсключение "Второй ребенок не является своим полем 125";
    КонецЕсли;
    ВладелецПометки85 = Пометка85.ДокументВладелец;
    Если ТипЗнч(ВладелецПометки85) <> Тип("ДокументHTML") Тогда
        ВызватьИсключение "Не получен документ комментария";
    КонецЕсли;
    ПометкаСвоя85 = ВладелецПометки85.УзелИдентичен(Документ85);
    Если ТипЗнч(ПометкаСвоя85) <> Тип("Булево") Или ПометкаСвоя85 <> Истина Тогда
        ВызватьИсключение "Комментарий не принадлежит своему документу";
    КонецЕсли;
    ДанныеДо85 = Пометка85.Данные;
    ВидимыйТекстДо85 = Контейнер85.ТекстовоеСодержимое;
    ТекстПоляДо85 = Поле85.ТекстовоеСодержимое;
    Если ТипЗнч(ДанныеДо85) <> Тип("Строка") Или ДанныеДо85 <> "ARCHIVE:125"
        Или ТипЗнч(ВидимыйТекстДо85) <> Тип("Строка") Или ВидимыйТекстДо85 <> "125"
        Или ТипЗнч(ТекстПоляДо85) <> Тип("Строка") Или ТекстПоляДо85 <> ВидимыйТекстДо85 Тогда
        ВызватьИсключение "Пометка или контрольный текст отличаются от подготовки";
    КонецЕсли;
    РезультатЗамены85 = Пометка85.ЗаменитьПолныйТекст("");
    Если РезультатЗамены85 <> Неопределено Тогда
        ВызватьИсключение "Пустая замена не вернула документированное Неопределено";
    КонецЕсли;
    КонтейнерПосле85 = Документ85.ПолучитьЭлементПоИдентификатору("comment85");
    Если ТипЗнч(КонтейнерПосле85) <> Тип("ЭлементБлокHTML") Тогда
        ВызватьИсключение "Контейнер после замены отсутствует";
    КонецЕсли;
    ТотЖеКонтейнер85 = КонтейнерПосле85.УзелИдентичен(Контейнер85);
    Если ТипЗнч(ТотЖеКонтейнер85) <> Тип("Булево") Или ТотЖеКонтейнер85 <> Истина Тогда
        ВызватьИсключение "После замены найден другой контейнер";
    КонецЕсли;
    ДетиПосле85 = КонтейнерПосле85.ДочерниеУзлы;
    Если ТипЗнч(ДетиПосле85) <> Тип("СписокУзловHTML") Тогда
        ВызватьИсключение "Не получен свежий список детей";
    КонецЕсли;
    КоличествоПосле85 = ДетиПосле85.Количество();
    Если ТипЗнч(КоличествоПосле85) <> Тип("Число") Или КоличествоПосле85 <> 1 Тогда
        ВызватьИсключение "Удаление комментария не подтверждено составом дерева";
    КонецЕсли;
    ОставшийсяУзел85 = ДетиПосле85.Элемент(0);
    Если ТипЗнч(ОставшийсяУзел85) <> Тип("ЭлементHTML") Тогда
        ВызватьИсключение "Остался не собственный SPAN";
    КонецЕсли;
    ПолеСохранено85 = ОставшийсяУзел85.УзелИдентичен(Поле85);
    Если ТипЗнч(ПолеСохранено85) <> Тип("Булево") Или ПолеСохранено85 <> Истина Тогда
        ВызватьИсключение "Контрольный узел был заменен";
    КонецЕсли;
    ВидимыйТекстПосле85 = КонтейнерПосле85.ТекстовоеСодержимое;
    ТекстПоляПосле85 = ОставшийсяУзел85.ТекстовоеСодержимое;
    ЗаголовокПосле85 = Документ85.Заголовок;
    Если ТипЗнч(ВидимыйТекстПосле85) <> Тип("Строка") Или ВидимыйТекстПосле85 <> ВидимыйТекстДо85
        Или ТипЗнч(ТекстПоляПосле85) <> Тип("Строка") Или ТекстПоляПосле85 <> ТекстПоляДо85
        Или ТипЗнч(ЗаголовокПосле85) <> Тип("Строка") Или ЗаголовокПосле85 <> ЗаголовокДо85 Тогда
        ВызватьИсключение "Содержимое или заголовок изменились";
    КонецЕсли;
    Возврат "Проверено: пометка=" + ДанныеДо85
        + "; детей=" + Строка(КоличествоДо85) + " → " + Строка(КоличествоПосле85)
        + "; текст=" + ВидимыйТекстПосле85 + "; заголовок=" + ЗаголовокПосле85;
КонецФункции

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

  1. Поставьте флажок и один раз нажмите УбратьПометку85. Согласие расходуется до вызова сервера, а состояние становится НЕИЗВЕСТНО. Повтор в том же экземпляре формы запрещён.

  2. На сервере ЧтениеHTML получает только собственную строку. ПостроительDOM.Прочитать получает настоящий объект чтения; при таком источнике ожидается ДокументHTML. Чтение закрывается и при нормальном разборе, и при исключении.

  3. По двум id находим собственные DIV и SPAN, проверяем реальные типы. SPAN должен быть ЭлементHTML, а не ЭлементРазметкаHTML: последний тип относится к HTMLHtmlElement. Иной фактический тип честно останавливает опыт.

  4. ДокументВладелец контейнера должен быть именно разобранным документом. Количество дочерних узлов должно реально равняться двум; только после этого читаем индексы 0 и 1. Первым нужен настоящий КомментарийHTML, вторым — тот самый собственный SPAN.

  5. Проверяем документ комментария, полную строку ARCHIVE:125 и текст 125. ТекстовоеСодержимое DIV не включает комментарий, поэтому техническая пометка не превращается в видимый текст.

  6. Вызываем ЗаменитьПолныйТекст только у найденного настоящего комментария и только с пустой строкой. Документированное Неопределено — результат именно этой ветки, а не объект для дальнейших вызовов. Иной результат означает STOP.

  7. Не довольствуемся возвращённым значением: снова находим собственный контейнер, проверяем его идентичность и заново читаем ДочерниеУзлы. Должен остаться один узел — прежний SPAN; число 125 и заголовок Урок 125 должны полностью сохраниться.

  8. Только после всех проверок сервер возвращает строковый протокол из фактически прочитанных данных, двух счётчиков, текста и заголовка. В клиент передаётся только эта строка, не HTML/DOM-объекты. При ошибке показывается фиксированное STOP, без исправления дерева или повторной попытки.

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

  1. Без флажка на новом экземпляре: STOP, серверный разбор не начинается, Проверено не появляется. Повторное нажатие в этом экземпляре также не выполняет опыт.

  2. Будущий нормальный запуск должен показать: Проверено: пометка=ARCHIVE:125; детей=2 → 1; текст=125; заголовок=Урок 125. Это ожидаемый контрольный протокол, не сообщение о выполненном сейчас тесте.

  3. В серверном отладчике перед заменой Пометка85 имеет тип КомментарийHTML, КоличествоДо85 — Число 2, ДанныеДо85 — Строка ARCHIVE:125. После замены РезультатЗамены85 реально Неопределено, КоличествоПосле85 — Число 1; оставшийся узел идентичен прежнему Поле85.

  4. В другой новой собственной лаборатории измените только ARCHIVE:125 на ARCHIVE:126 в исходной строке: проверка должна остановить опыт ДО замены. Если добавить третьего ребёнка DIV, состав также отклоняется до замены.

  5. Измените только число SPAN на 126 или только заголовок на другой: STOP до удаления. Не удаляйте проверки ради успеха и не подменяйте результаты счётчиков константами.

  6. Если устаревшая платформа не выполняет описанную пустую замену, возвращает другой тип узла или сохраняет комментарий, это STOP, а не успешный пример. Запуск должен проверить именно вашу платформу; здесь есть только статическая сверка контрактов.

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

Будущий успешный ручной запуск должен подтвердить реальное удаление собственной пометки: детей 2 → 1, прежний SPAN сохранён, текст 125 и заголовок Урок 125 не изменились. В 1С сейчас не запускалось.

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

  1. ЗаменитьПолныйТекст описывает замену логически соседних текстовых узлов. Здесь используется только документированная пустая ветка на изолированной собственной пометке. Непустая ветка с ТекстDOM и РазделитьТекст в урок не входят.

  2. ДокументHTML.СоздатьКомментарий в физической справке объявляет КомментарийDOM, не КомментарийHTML. Поэтому здесь нет конструктора комментария или такой фабрики: нужный HTML-комментарий извлекается из реально разобранного HTML и проверяется по типу.

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

  4. Индексы начинаются с нуля. HTML-парсер может выделять дополнительные текстовые узлы; неожиданный состав не обрезается и не нормализуется ради прохождения проверки.

  5. Все изменения относятся лишь к собственному дереву в памяти серверного вызова. Код не записывает данные базы, не открывает браузер и не читает файлы. Настоящий запуск 1С и проверка поведения устаревшего API ещё не выполнены.

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

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

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

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

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

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