Тип: Строка. Содержит системный идентификатор для типов узлов, у которых идентификатор имеет смысл: ОпределениеТипаДокумента, Сущность, Нотация. Для типов узлов, для которых идентификатор не определен, содержит пустую строку.
Полное описание, параметры и ограничения
ЧтениеXML.СистемныйИдентификатор (XMLReader.SystemId)
ЧтениеXML (XMLReader)
СистемныйИдентификатор (SystemId)
Доступен, начиная с версии 8.1.
Использование:
Только чтение.
Описание:
Тип: Строка.
Содержит системный идентификатор для типов узлов, у которых идентификатор имеет смысл: ОпределениеТипаДокумента, Сущность, Нотация.
Для типов узлов, для которых идентификатор не определен, содержит пустую строку.
Доступность:
Тонкий клиент, мобильный клиент, сервер, толстый клиент, внешнее соединение, мобильное приложение (клиент), мобильное приложение (сервер), мобильный автономный сервер.
Использование в версии:
Доступен, начиная с версии 8.1.
Методическая информация
Практические примеры
Обойти объявления собственного внутреннего DTD
В своём DTD объявлены текстовая сущность guide и неразбираемая picture с нотацией png. picture не используется в содержимом; URI — учебные URN, внешний ресурс не читается.
Где и как запускать
Учебная база: создайте серверный общий модуль УчебныеЗадачи (флаг Сервер). Код без директив вставьте в тело процедуры ВыполнитьПример() Экспорт. Вызовите её из серверного обработчика команды учебной обработки. Не запускайте в рабочей базе.
Подготовка
Учебная база 8.5.1.1343, серверный общий модуль УчебныеЗадачи. Фрагмент без директив вставьте в тело ВыполнитьПример() Экспорт и запустите собственной учебной командой.
XML в заданиях приведён полностью или создаётся из собственных чисел/строк. Не подставляйте XML из неизвестных внешних источников, объекты метаданных или реальные ссылки вместо учебных значений.
Ни один фрагмент не пишет товары, документы и настройки конфигурации. Файловое упражнение отдельно предупреждает о создании только собственного временного XSD.
Проверки сообщениями ожидают Истина. XML-текст и объекты можно исследовать в отладчике; это не контракт Avito, SOAP или обмен типовой конфигурации.
XML = "<!DOCTYPE product [<!ELEMENT product (#PCDATA)><!ATTLIST product code CDATA #REQUIRED kind CDATA ""paper""><!ENTITY guide ""Книга""><!NOTATION png SYSTEM ""urn:guide:format:png""><!ENTITY picture SYSTEM ""urn:guide:picture"" NDATA png>]><product code=""A-01"">Книга</product>";
Параметры = Новый ПараметрыЧтенияXML("1.0", "", ПробельныеСимволыXML.ПоУмолчанию, ТипПроверкиXML.НетПроверки, Истина, Ложь);
Чтение = Новый ЧтениеXML;
Попытка
Чтение.УстановитьСтроку(XML, Параметры);
Если Параметры.ИгнорироватьТипДокумента Тогда
ВызватьИсключение "Для этого урока нужно чтение DTD";
КонецЕсли;
НайденDTD = Ложь;
Пока Чтение.Прочитать() Цикл
Если Чтение.ТипУзла = ТипУзлаXML.ОпределениеТипаДокумента Тогда
НайденDTD = Истина;
Прервать;
КонецЕсли;
КонецЦикла;
Если Не НайденDTD Тогда
ВызватьИсключение "Ожидался собственный внутренний DTD";
КонецЕсли;
Сообщить(Чтение.Имя = "product");
Сообщить(Чтение.ПубличныйИдентификатор = "" И Чтение.СистемныйИдентификатор = "");
ЕстьОбъявление = Чтение.ПервоеОбъявление();
ЕстьPicture = Ложь;
ЕстьPNG = Ложь;
Пока ЕстьОбъявление Цикл
Сообщить(СтрШаблон("Объявление: %1; имя: %2; URI: %3",
Чтение.ТипУзла, Чтение.Имя, Чтение.СистемныйИдентификатор));
Если Чтение.ТипУзла = ТипУзлаXML.Сущность И Чтение.СистемныйИдентификатор = "urn:guide:picture" Тогда
ЕстьPicture = Истина;
Сообщить(Чтение.ИмяНотации = "png");
Сообщить(Чтение.СистемныйИдентификатор = "urn:guide:picture");
Сообщить(Чтение.ПубличныйИдентификатор = "");
ИначеЕсли Чтение.ТипУзла = ТипУзлаXML.Нотация И Чтение.СистемныйИдентификатор = "urn:guide:format:png" Тогда
ЕстьPNG = Истина;
Сообщить(Чтение.СистемныйИдентификатор = "urn:guide:format:png");
КонецЕсли;
ЕстьОбъявление = Чтение.СледующееОбъявление();
КонецЦикла;
Сообщить(ЕстьPicture И ЕстьPNG);
Чтение.Закрыть();
Исключение
Чтение.Закрыть();
ВызватьИсключение;
КонецПопытки;Разбор по шагам
Шестым параметром явно включаем чтение DTD; по умолчанию он игнорируется.
Сначала доходим до узла DTD, только затем ПервоеОбъявление начинает обход определений.
Сущность и Нотация — разные типы узла. ИмяНотации имеет смысл у внешней неразбираемой сущности.
Порядок объявлений не фиксируем: независимые флаги определяют внешнюю неразбираемую сущность и нотацию по типу/системному URN. Имя выводим диагностически.
Значение не читаем как заменяющий текст сущности: справка свойства не обещает текстовое значение для узла Сущность.
Как проверить результат
Семь сравнений Истина при обработке собственного DTD. picture и png определены по своим URN.
Нет внешнего DOCTYPE, внешнего параметрического ENTITY, файла, HTTP/HTTPS или включения picture в текст.
Ожидаемый результат
Прочитаны именованные определения и их идентификаторы без загрузки внешних данных.
На что обратить внимание
Не заменяйте строку на XML из интернета: обработка DTD требует отдельного безопасного контракта входов.
NDATA picture не является текстом: ссылку &picture; нельзя использовать как обычную текстовую сущность.
Этот урок о потоковом ЧтениеXML; он не доказывает заполнение Сущности/Нотации у ПостроительDOM.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.