ОбъектМетаданных: HTTPСервис.Синоним

Свойства · Synonym

Тип: Строка. Строка произвольных символов - синоним имени объекта метаданных.

Полное описание, параметры и ограничения

ОбъектМетаданных: HTTPСервис.Синоним (MetadataObject: HTTPService.Synonym)

ОбъектМетаданных: HTTPСервис (MetadataObject: HTTPService)

Синоним (Synonym)

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

Использование:
Только чтение.
Описание:
Тип: Строка.
Строка произвольных символов - синоним имени объекта метаданных.
Доступность:

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

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

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

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

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

Посмотреть маршруты сервиса, не обращаясь к нему

ПередачаДанных имеет корень dt и четыре шаблона. Свойство Модуль всегда Неопределено: оно не возвращает текст обработчиков.

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

Полный серверный модуль учебной копии КА2 Progress 2.5.20.75; без HTTP, публикации и печати.

Подготовка

  1. Изолированная учебная копия КА2 Progress 2.5.20.75 из C:\claude\KA2\Progress\XML_CF_KA2_PROGRESS, платформа 8.5.1.1343. Создайте серверный общий модуль УчебныеМаршрутыИМакеты.

  2. Вставьте полный модуль одного урока и вызовите УчебныеМаршрутыИМакеты.ВыполнитьПример() своей серверной учебной командой.

  3. Источники: HTTPServices\ПередачаДанных.xml и ПередачаДанных\Ext\Module.bsl; Documents\РеализацияТоваровУслуг\Templates\ПФ_MXL_РеализацияТоваров.xml.

  4. Метаданные только читаются. HTTP-запросы, публикация сервиса, загрузка/удаление файлов хранилища и печать документов не выполняются.

  5. Формируемый путь с guide-owned-storage — учебная строка, не действующий адрес публикации. GET/POST обработчики могут выполнять прикладную работу и здесь не вызываются.

  6. Макет печати получается в память без создания документа реализации и без заполнения его данными. Чтение размера макета не доказывает корректность настоящей печатной формы.

Процедура ВыполнитьПример() Экспорт
    Сервис = Метаданные.HTTPСервисы.Найти("ПередачаДанных");
    Если Сервис = Неопределено Тогда
        ВызватьИсключение "Нет подтверждённого HTTP-сервиса ПередачаДанных";
    КонецЕсли;
    Сообщить(Сервис.Имя = "ПередачаДанных");
    Сообщить(Сервис.КорневойURL = "dt");
    Сообщить(Сервис.ПовторноеИспользованиеСеансов = Метаданные.СвойстваОбъектов.РежимПовторногоИспользованияСеансов.Использовать);
    Сообщить(Сервис.ВремяЖизниСеанса = 20);
    Сообщить(Сервис.Модуль = Неопределено);
    Сообщить(Сервис.ШаблоныURL.Количество() = 4);
    Для Каждого Шаблон Из Сервис.ШаблоныURL Цикл
        Сообщить(Шаблон.Имя + " → " + Шаблон.Шаблон);
    КонецЦикла;
    Сообщить(Сервис.Синоним);
    Сообщить(Сервис.Комментарий);
    Сообщить(Сервис.ПолноеИмя());
    Сообщить(Сервис.Представление());
    Сообщить(Сервис.ПринадлежностьОбъекта);
    Сообщить(ТипЗнч(Сервис.ОбъектРасширяемойКонфигурации));
    Сообщить(Сервис.ЕстьИзмененияРасширениямиКонфигурации());
    Сообщить(ТипЗнч(Сервис.РасширениеКонфигурации()));
    Сообщить(Сервис.Родитель() = Метаданные);

КонецПроцедуры

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

  1. Найти описание сервиса в Метаданные.HTTPСервисы.

  2. Проверить корень URL и настройки повторного использования сеансов по исходному XML.

  3. Прочитать Модуль и объяснить Неопределено как контракт, а не ошибку.

  4. Перечислить четыре шаблона и вывести сведения метаданных. Никакой URL не открывается.

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

  1. Семь фиксированных проверок дают Истина, сведения расширений диагностические.

  2. Выводятся четыре имени/шаблона. Это не подтверждение публикации, доступности или авторизации HTTP-сервиса.

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

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

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

  1. ВремяЖизниСеанса — настройка HTTP-сервиса, не время жизни всего клиента 1С.

  2. КорневойURL dt не содержит адрес сервера и имя веб-публикации.

  3. У HTTP-сервиса нет способа исполнить модуль из свойства Модуль. Исходники смотрятся отдельно.

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

Составить карту HTTP-сервиса из метаданных

Для каждого сервиса показываем корневой URL, шаблоны, HTTP-методы и имена обработчиков. Сетевые запросы не отправляем.

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

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

Подготовка

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

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


Для Каждого Сервис Из Метаданные.HTTPСервисы Цикл
    Сообщить(СтрШаблон("Сервис %1 (%2); корень %3", Сервис.Имя, Сервис.Синоним, Сервис.КорневойURL));
    Сообщить(Сервис.Комментарий);
    Сообщить(СтрШаблон("Повторное использование %1; время жизни %2",
        Сервис.ПовторноеИспользованиеСеансов, Сервис.ВремяЖизниСеанса));
    Сообщить(Сервис.Модуль = Неопределено);
    Для Каждого Маршрут Из Сервис.ШаблоныURL Цикл
        Сообщить(СтрШаблон("Шаблон %1 (%2): %3", Маршрут.Имя, Маршрут.Синоним, Маршрут.Шаблон));
        Сообщить(Маршрут.Комментарий);
        Для Каждого Метод Из Маршрут.Методы Цикл
            Сообщить(СтрШаблон("  %1 → %2", Метод.HTTPМетод, Метод.Обработчик));
        КонецЦикла;
    КонецЦикла;
КонецЦикла;

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

  1. КорневойURL относится к пути сервиса внутри публикации. Не добавляем домен, порт и имя публикации наугад.

  2. ШаблонURL сопоставляется с методом запроса. Одинаковый путь с GET и POST может иметь разные обработчики.

  3. Обработчик — строка имени процедуры. Свойство Модуль в доступном API равно Неопределено и не раскрывает исходный текст.

  4. Параметры повторного использования сеанса читаем для последующего исследования, ничего не переключаем.

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

  1. В Конфигураторе HTTP-сервисы → выбранный сервис → Шаблоны URL найдите совпадающие имена, шаблоны и методы.

  2. Если публикации нет, пример всё равно может вывести определения: это не ошибка и не доказательство доступности URL.

  3. В примере нет HTTPСоединения: внешние системы не получают запросов.

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

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

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

  1. Метаданные не показывают настройки веб-сервера, TLS, аутентификацию и фактические коды ответа.

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

  3. Наличие метода DELETE не даёт разрешения проверять удаление на рабочем сервере.

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

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

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

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

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