Разобрать контракт опубликованного в конфигурации Web-сервиса

Учебные задачи

Сравниваем определения SOAP-операций и параметров с деревом конфигурации, не вызывая сервис и не скачивая WSDL.

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

Учебная база: создайте серверный общий модуль УчебныеЗадачи (флаг Сервер). Код без директив вставьте в тело процедуры ВыполнитьПример() Экспорт. Вызовите её из серверного обработчика команды учебной обработки. Не запускайте в рабочей базе.

Подготовка

  1. Запускайте в учебной копии конфигурации. Примеры читают структуру метаданных, но не создают объекты, не записывают регистры и не проводят документы.

  2. Сверяйте вывод с деревом конфигурации в Конфигураторе. Имена, длины и настройки в УНФ, КА2, БП, УТ 11 и УТ 10.3 могут различаться.


Для Каждого Сервис Из Метаданные.WebСервисы Цикл
    Сообщить(СтрШаблон("%1 (%2): пространство %3; файл %4",
        Сервис.Имя, Сервис.Синоним, Сервис.ПространствоИмен, Сервис.ИмяФайлаПубликации));
    Сообщить(Сервис.Комментарий);
    Сообщить(СтрШаблон("Пакетов XDTO %1; повторное использование %2; время жизни %3",
        Сервис.ПакетыXDTO.Количество(), Сервис.ПовторноеИспользованиеСеансов, Сервис.ВремяЖизниСеанса));
    Сообщить(Сервис.Модуль = Неопределено);
    Для Каждого Операция Из Сервис.Операции Цикл
        Сообщить(СтрШаблон("Операция %1 (%2) → %3", Операция.Имя, Операция.Синоним, Операция.ИмяПроцедуры));
        Сообщить(Операция.Комментарий);
        Сообщить(СтрШаблон("Результат %1; возможно пустое %2; в транзакции %3; блокировки %4",
            Операция.ТипВозвращаемогоЗначенияXDTO, Операция.ВозможноПустое,
            Операция.ВТранзакции, Операция.РежимУправленияБлокировкойДанных));
        Для Каждого Параметр Из Операция.Параметры Цикл
            Сообщить(СтрШаблон("Параметр %1 (%2): %3; направление %4; возможно пустое %5",
                Параметр.Имя, Параметр.Синоним, Параметр.ТипЗначенияXDTO,
                Параметр.НаправлениеПередачи, Параметр.ВозможноПустое));
            Сообщить(Параметр.Комментарий);
        КонецЦикла;
    КонецЦикла;
КонецЦикла;

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

  1. WebСервисы описывают SOAP-контракт, а HTTPСервисы — маршруты HTTP: коллекции не взаимозаменяемы.

  2. ПространствоИмен и расширенные имена типов XDTO читаем вместе, поскольку одинаковые локальные имена могут принадлежать разным схемам.

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

  4. ВТранзакции — настройка операции. Мы не вызываем операцию, поэтому никакая её бизнес-транзакция не выполняется.

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

  1. Число и имена операций совпадают с деревом выбранного Web-сервиса в Конфигураторе.

  2. Для операции сравните тип результата, ИмяПроцедуры и все направления параметров.

  3. При пустой коллекции WebСервисы цикл завершается без обращения к отсутствующему сервису.

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

Получена схема SOAP-операций и типов их параметров для изучения серверного обработчика.

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

  1. ИмяФайлаПубликации не доказывает наличие текущей веб-публикации или доступность WSDL.

  2. ВозможноПустое не следует приравнивать к произвольному отсутствию поля во внешнем JSON: это другой формат обмена.

  3. Метаданные не проверяют фактическую реализацию метода, права пользователя и корректность полезной нагрузки.

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

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

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

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

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