Удаляет символы в указанной строке, не удовлетворяющие рекомендации XML 1.0 или 1.1. Данная функция позволяет решить проблему, например, когда в отображаемых в HTML-документе данных (которые нужно отображать на форме) присутствуют недопустимые символы.
Синтаксис
УдалитьНедопустимыеСимволыXML(<СтрокаСимволов>, <Версия>)Полное описание, параметры и ограничения
Глобальный контекст.УдалитьНедопустимыеСимволыXML (Global context.DeleteDisallowedXMLCharacters)
Глобальный контекст (Global context)
УдалитьНедопустимыеСимволыXML (DeleteDisallowedXMLCharacters)
Доступен, начиная с версии 8.3.20.
Синтаксис:
УдалитьНедопустимыеСимволыXML(<СтрокаСимволов>, <Версия>)
Параметры:
<СтрокаСимволов> (обязательный)
Тип: Строка.
Строка, в которой необходимо проверить символы.
<Версия> (необязательный)
Тип: Строка.
Версия спецификации XML, используемая при проверке допустимости.
Возможные значения параметра: "1.0" или "1.1".
Значение по умолчанию: 1.0.
Возвращаемое значение:
Тип: Строка.
Строка, из которой удалены все символы, не соответствующие стандарту XML 1.0 или 1.1.
Описание:
Удаляет символы в указанной строке, не удовлетворяющие рекомендации XML 1.0 или 1.1.
Данная функция позволяет решить проблему, например, когда в отображаемых в HTML-документе данных (которые нужно отображать на форме) присутствуют недопустимые символы.
Доступность:
Тонкий клиент, мобильный клиент, сервер, толстый клиент, внешнее соединение, мобильное приложение (клиент), мобильное приложение (сервер), мобильный автономный сервер.
См. также:
Использование в версии:
Доступен, начиная с версии 8.3.20.
Методическая информация
Практические примеры
Убрать недопустимые управляющие символы, сохранив табуляцию и перенос
В XML 1.0 нулевой символ и код 1 недопустимы, а табуляция и LF допустимы. Очистка меняет данные: покажем это явно перед сериализацией.
Где и как запускать
Учебная база: создайте серверный общий модуль УчебныеЗадачи (флаг Сервер). Код без директив вставьте в тело процедуры ВыполнитьПример() Экспорт. Вызовите её из серверного обработчика команды учебной обработки. Не запускайте в рабочей базе.
Подготовка
Учебная база 8.5.1.1343, серверный общий модуль УчебныеЗадачи. Фрагмент без директив вставьте в тело ВыполнитьПример() Экспорт и запустите собственной учебной командой.
XML в заданиях приведён полностью или создаётся из собственных чисел/строк. Не подставляйте XML из неизвестных внешних источников, объекты метаданных или реальные ссылки вместо учебных значений.
Ни один фрагмент не пишет товары, документы и настройки конфигурации. Файловое упражнение отдельно предупреждает о создании только собственного временного XSD.
Проверки сообщениями ожидают Истина. XML-текст и объекты можно исследовать в отладчике; это не контракт Avito, SOAP или обмен типовой конфигурации.
Исходная = "Книга" + Символ(0) + Символ(1) + Символ(9) + "3" + Символ(10) + "Вторая строка";
Ожидаемая = "Книга" + Символ(9) + "3" + Символ(10) + "Вторая строка";
Очищенная = УдалитьНедопустимыеСимволыXML(Исходная, "1.0");
Сообщить(Очищенная = Ожидаемая);
Сообщить(СтрДлина(Исходная) - СтрДлина(Очищенная) = 2);
Сообщить(СтрНайти(Очищенная, Символ(9)) > 0);
Сообщить(СтрНайти(Очищенная, Символ(10)) > 0);
Запись = Новый ЗаписьXML;
Запись.УстановитьСтроку();
ЗаписатьXML(Запись, Очищенная);
XML = Запись.Закрыть();
Чтение = Новый ЧтениеXML;
Чтение.УстановитьСтроку(XML);
НайденЭлемент = Ложь;
Пока Чтение.Прочитать() Цикл
Если Чтение.ТипУзла = ТипУзлаXML.НачалоЭлемента Тогда
НайденЭлемент = Истина;
Прервать;
КонецЕсли;
КонецЦикла;
Если Не НайденЭлемент Тогда
Чтение.Закрыть();
ВызватьИсключение "В собственном XML не найден корневой элемент";
КонецЕсли;
Попытка
Восстановленная = ПрочитатьXML(Чтение, Тип("Строка"));
Чтение.Закрыть();
Исключение
Чтение.Закрыть();
ВызватьИсключение;
КонецПопытки;
Сообщить(Восстановленная = Очищенная);
Сообщить(Исходная <> Очищенная);Разбор по шагам
Собственная исходная строка содержит два намеренно недопустимых символа. Не вставляем их вручную в исходник модуля, создаём через Символ.
УдалитьНедопустимыеСимволыXML применяет правила версии 1.0. Полученная копия короче на два символа.
Табуляция и перенос строки остаются. Затем сериализуем и читаем очищенный вариант как строку.
Исходная переменная сохраняется отдельно: после очистки это уже другой текст. Проверки подтверждают и round-trip, и изменение исходных данных.
Как проверить результат
Шесть проверок дают Истина.
Восстановленная содержит Книга, табуляцию, 3, перенос и Вторая строка; управляющих кодов 0/1 в ней нет.
Ожидаемый результат
Контролируемая очистка собственных данных с проверкой сохранённых разделителей.
На что обратить внимание
Очистка не экранирует & или < вручную и не заменяет XML-писатель.
Не применяйте её незаметно к подписанным документам, ключам или строкам, где каждый символ значим.
XML 1.1 имеет другие правила: не меняйте версию без проверки контракта обмена.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.