Расширенное имя XML.
Полное описание, параметры и ограничения
РасширенноеИмяXML (XMLExpandedName)
РасширенноеИмяXML (XMLExpandedName)
Доступен, начиная с версии 8.1.
Свойства:
URIПространстваИмен (NamespaceURI)
ЛокальноеИмя (LocalName)
Конструкторы:
По локальному имени и URI пространства имен
Описание:
Расширенное имя XML.
Доступность:
Тонкий клиент, мобильный клиент, сервер, толстый клиент, внешнее соединение, мобильное приложение (клиент), мобильное приложение (сервер), мобильный автономный сервер.
Данный объект может быть сериализован в/из XML. Может использоваться в реквизитах управляемой формы. Данный объект может быть сериализован в/из XDTO. Тип XDTO, соответствующий данному объекту, определяется в пространстве имен {http://www.w3.org/2001/XMLSchema}. Имя типа XDTO: QName.
Использование в версии:
Доступен, начиная с версии 8.1.
Методическая информация
Практические примеры
Проверить возвращаемый тип и обработчик операции FillCatalogs
Операция имеет свой возвращаемый XDTO-тип, параметр пустоты и настройку транзакции. Чтение имени обработчика не выполняет обмен.
Где и как запускать
Учебная база: создайте серверный общий модуль УчебныеЗадачи (флаг Сервер). Код без директив вставьте в тело процедуры ВыполнитьПример() Экспорт. Вызовите её из серверного обработчика команды учебной обработки. Не запускайте в рабочей базе.
Подготовка
Запускайте в учебной копии конфигурации. Примеры читают структуру метаданных, но не создают объекты, не записывают регистры и не проводят документы.
Сверяйте вывод с деревом конфигурации в Конфигураторе. Имена, длины и настройки в УНФ, КА2, БП, УТ 11 и УТ 10.3 могут различаться.
Имена объектов взяты из XML КА2 Progress: C:\claude\KA2\Progress\XML_CF_KA2_PROGRESS. Исходные XML не изменяйте. Выполняйте код только в своей учебной копии соответствующей конфигурации.
В другой конфигурации предварительно найдите аналогичный объект в Конфигураторе и замените только строку имени в поиске. Отсутствие имени обрабатывается до чтения свойств; оно не доказывает отсутствие аналогичной возможности.
Каждый урок запускайте отдельно. Код не вызывает бизнес-функции модулей и обработчики команд, не переключает привилегированный режим и не меняет параметры сеанса.
Сервис = Метаданные.WebСервисы.Найти("CustomerOrdersExchange");
Если Сервис = Неопределено Тогда
ВызватьИсключение "В учебной конфигурации отсутствует WebСервисы.CustomerOrdersExchange";
КонецЕсли;
Операция = Сервис.Операции.Найти("FillCatalogs");
Если Операция = Неопределено Тогда
ВызватьИсключение "В учебной копии нет операции CustomerOrdersExchange.FillCatalogs";
КонецЕсли;
Сообщить(Операция.Имя = "FillCatalogs");
Сообщить("Синоним: " + Операция.Синоним);
Сообщить("Комментарий: " + Операция.Комментарий);
Сообщить(Операция.ПолноеИмя());
Сообщить(Операция.Представление());
Сообщить("Принадлежность: " + Строка(Операция.ПринадлежностьОбъекта));
Сообщить("Идентификатор заимствования: " + Строка(Операция.ОбъектРасширяемойКонфигурации));
Сообщить("Изменён расширениями: " + Строка(Операция.ЕстьИзмененияРасширениямиКонфигурации()));
Сообщить("Расширение-владелец: " + Строка(Операция.РасширениеКонфигурации()));
Родитель = Операция.Родитель();
Если Родитель = Неопределено Тогда
ВызватьИсключение "Не получен родитель своего описания контракта";
КонецЕсли;
Сообщить(Родитель = Сервис);
Сообщить(Операция.ИмяПроцедуры = "FillCatalogs");
Сообщить(НЕ Операция.ВТранзакции);
Сообщить(НЕ Операция.ВозможноПустое);
Сообщить(Операция.РежимУправленияБлокировкойДанных = Метаданные.СвойстваОбъектов.РежимУправленияБлокировкойДанныхПоУмолчанию.Управляемый);
Сообщить(Операция.Параметры.Количество() = 2);
ВозвращаемыйТип = Операция.ТипВозвращаемогоЗначенияXDTO;
Если ТипЗнч(ВозвращаемыйТип) <> Тип("РасширенноеИмяXML") Тогда
ВызватьИсключение "Ожидалось расширенное имя возвращаемого XDTO-типа";
КонецЕсли;
Сообщить(ВозвращаемыйТип.ЛокальноеИмя = "MessageExchange");
Сообщить("URI возвращаемого типа: " + ВозвращаемыйТип.URIПространстваИмен);
Сообщить("Операция не вызвана: исследуется только описание");Разбор по шагам
Операция ищется внутри конкретного найденного сервиса. Отсутствие обрабатывается до её свойств; родитель сравнивается с сервисом.
ИмяПроцедуры — настройка обработчика. ВТранзакции = Ложь означает отсутствие транзакционной обёртки по этой настройке, не гарантию отсутствия транзакций внутри бизнес-кода.
ВозможноПустое относится к возвращаемому значению операции. Параметры имеют свои независимые флаги пустоты.
ТипВозвращаемогоЗначенияXDTO проверяется до чтения ЛокальноеИмя/URI. Префикс d6p1 из XML не используется как идентификатор типа вместо URI.
Количество 2 — число объявленных параметров. Метод не вызывает процедуру FillCatalogs и не блокирует данные.
Как проверить результат
Восемь контрольных Истина и фактический URI возвращаемого типа.
Не создано сообщение обмена, не началась транзакция этой проверкой.
Ожидаемый результат
Возвращаемый контракт, параметры и настройка обработчика разделены.
На что обратить внимание
Имя процедуры не доказывает её корректность: её исходник проверяют отдельно.
Не считать ВТранзакции = Ложь доказательством отсутствия записи данных внутри реальной операции.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.
Определить входной параметр MobileDeviceID до сборки SOAP
MobileDeviceID — входной непустой XDTO-параметр xs:string. Это договор передачи, не значение идентификатора реального мобильного устройства.
Где и как запускать
Учебная база: создайте серверный общий модуль УчебныеЗадачи (флаг Сервер). Код без директив вставьте в тело процедуры ВыполнитьПример() Экспорт. Вызовите её из серверного обработчика команды учебной обработки. Не запускайте в рабочей базе.
Подготовка
Запускайте в учебной копии конфигурации. Примеры читают структуру метаданных, но не создают объекты, не записывают регистры и не проводят документы.
Сверяйте вывод с деревом конфигурации в Конфигураторе. Имена, длины и настройки в УНФ, КА2, БП, УТ 11 и УТ 10.3 могут различаться.
Имена объектов взяты из XML КА2 Progress: C:\claude\KA2\Progress\XML_CF_KA2_PROGRESS. Исходные XML не изменяйте. Выполняйте код только в своей учебной копии соответствующей конфигурации.
В другой конфигурации предварительно найдите аналогичный объект в Конфигураторе и замените только строку имени в поиске. Отсутствие имени обрабатывается до чтения свойств; оно не доказывает отсутствие аналогичной возможности.
Каждый урок запускайте отдельно. Код не вызывает бизнес-функции модулей и обработчики команд, не переключает привилегированный режим и не меняет параметры сеанса.
Сервис = Метаданные.WebСервисы.Найти("CustomerOrdersExchange");
Если Сервис = Неопределено Тогда
ВызватьИсключение "В учебной конфигурации отсутствует WebСервисы.CustomerOrdersExchange";
КонецЕсли;
Операция = Сервис.Операции.Найти("FillCatalogs");
Если Операция = Неопределено Тогда
ВызватьИсключение "В учебной копии нет операции CustomerOrdersExchange.FillCatalogs";
КонецЕсли;
Параметр = Операция.Параметры.Найти("MobileDeviceID");
Если Параметр = Неопределено Тогда
ВызватьИсключение "В собственной проверке нет параметра MobileDeviceID";
КонецЕсли;
Сообщить(Параметр.Имя = "MobileDeviceID");
Сообщить("Синоним: " + Параметр.Синоним);
Сообщить("Комментарий: " + Параметр.Комментарий);
Сообщить(Параметр.ПолноеИмя());
Сообщить(Параметр.Представление());
Сообщить("Принадлежность: " + Строка(Параметр.ПринадлежностьОбъекта));
Сообщить("Идентификатор заимствования: " + Строка(Параметр.ОбъектРасширяемойКонфигурации));
Сообщить("Изменён расширениями: " + Строка(Параметр.ЕстьИзмененияРасширениямиКонфигурации()));
Сообщить("Расширение-владелец: " + Строка(Параметр.РасширениеКонфигурации()));
Родитель = Параметр.Родитель();
Если Родитель = Неопределено Тогда
ВызватьИсключение "Не получен родитель своего описания контракта";
КонецЕсли;
Сообщить(Родитель = Операция);
Варианты = Метаданные.СвойстваОбъектов;
Сообщить(Параметр.НаправлениеПередачи = Варианты.НаправлениеПередачи.Входной);
Сообщить(НЕ Параметр.ВозможноПустое);
ИмяТипа = Параметр.ТипЗначенияXDTO;
Если ТипЗнч(ИмяТипа) <> Тип("РасширенноеИмяXML") Тогда
ВызватьИсключение "Ожидалось расширенное имя типа MobileDeviceID";
КонецЕсли;
Сообщить(ИмяТипа.URIПространстваИмен = "http://www.w3.org/2001/XMLSchema");
Сообщить(ИмяТипа.ЛокальноеИмя = "string");
УчебныйИдентификатор = "guide-device-01";
Сообщить(ТипЗнч(УчебныйИдентификатор) = Тип("Строка"));
Сообщить(НЕ ПустаяСтрока(УчебныйИдентификатор));
Сообщить("Значение только подготовлено в памяти; SOAP не отправлен");Разбор по шагам
Параметр ищется внутри FillCatalogs. Полное имя и родитель подтверждают, что не выбран одноимённый параметр другой операции.
НаправлениеПередачи сравнивается с Входной, не со строкой In из XML. Выходной и ВходнойВыходной потребовали бы другого плана передачи.
ВозможноПустое = Ложь запрещает null в контракте, но само по себе не запрещает пустую строку. Непустота учебной строки проверяется отдельно.
Расширенное имя xs:string раскладывается на URI XML Schema и локальное имя string. Префикс xs не обязан совпадать у другого сериализатора.
guide-device-01 — собственное учебное значение. Никакие реальные идентификаторы, токены или пароли не читаются и не логируются.
Как проверить результат
Восемь контрольных Истина и пояснение, что отправки не было.
Подставьте пустую учебную строку: последняя проверка станет Ложь, хотя запрет null в метаданных не изменился.
Ожидаемый результат
Тип, направление и проверка входного значения отделены от фактического обмена.
На что обратить внимание
Флаг ВозможноПустое не заменяет бизнес-проверку непустой строки.
Подготовленная строка не является доказательством регистрации устройства или принятого SOAP-запроса.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.