Создание пользовательского соединителя Azure Logic Apps (SOAP) (предварительная версия)

[Данный раздел посвящен предварительному выпуску и может быть изменен.]

Чтобы интегрировать службы SOAP в рабочие процессы Azure Logic Apps, можно создать и зарегистрировать настраиваемый соединитель Простого протокола доступа к объектам (SOAP) с помощью языка описания веб-служб (WSDL), который описывает вашу службу SOAP. Соединители SOAP работают как готовые соединители, поэтому вы можете использовать их так же, как и другие соединители в ваших приложениях Logic Apps. В настоящее время пользовательские соединители SOAP не поддерживают односторонние операции.

Внимание!

  • Это предварительная версия функции.
  • Предварительные версии функций не предназначены для использования в производственной среде, а их функциональность может быть ограничена. Они доступны перед официальным выпуском, чтобы клиенты могли досрочно получить доступ и предоставить отзывы.

Предварительные требования

Для регистрации вашего соединителя SOAP понадобится следующее:

  • Подписка Azure. Если у вас нет подписки, вы можете начать с учетной записи free Azure. В качестве альтернативы вы можете оформить подписку с оплатой по мере использования.

  • Одно из следующего:

    • URL-адрес файла WSDL, который определяет вашу службу SOAP и API-интерфейсы.
    • Файл WSDL, который определяет вашу службу SOAP и API-интерфейсы.

    Для этой процедуры вы можете использовать наш пример, SOAP-службу "Заказы" (http://fazioapisoap.azurewebsites.net/FazioService.svc?singleWsdl).

  • Изображение (необязательно), используемое в качестве значка для пользовательского соединителя.

1. Создайте свой соединитель

  1. На портале Azure в главном меню Azure выберите New.

  2. Введите соединитель Logic Apps в поле поиска, а затем выберите Enter.

    Снимок экрана с поиском по фразе

  3. В списке Результаты выберите Logic Apps Connector (Соединитель Logic Apps)>Создать.

    Скриншот создания соединителя Logic Apps.

  4. Введите сведения для регистрации вашего соединителя, как описано в таблице. Закончив, установите флажок Закрепить на панели управления, а затем выберите Создать.

    Снимок экрана со сведениями о пользовательском соединителе Logic Apps.

    Свойство Предлагаемое значение Описание:
    Имя имя-соединителя-soap Введите имя вашего соединителя.
    Подписка Azure-subscription-name Выберите подписку Azure.
    Группа ресурсов имя-группы-ресурсов-Azure Создайте или выберите группу Azure для организации Azure ресурсов.
    Местонахождение регион развертывания Выберите тот же регион Azure, что и приложение логики.

После развертывания соединителя в Azure должно открыться меню соединителя Logic Apps. Если это не так, выберите соединитель SOAP на панели мониторинга Azure.

2. Определите свой соединитель

Укажите WSDL-файл или URL-адрес для создания соединителя, используемый соединителем метод проверки подлинности, а также предоставляемые соединителем SOAP действия и триггеры.

2a. Укажите файл или URL-адрес файла WSDL для вашего соединителя

  1. В меню соединителя выберите Соединитель Logic Apps, если этот пункт еще не выбран.

  2. На панели инструментов выберите Редактировать.

    Снимок экрана: редактирование пользовательского соединителя

  3. Выберите Общее, чтобы предоставить сведения в этих таблицах о создании, обеспечении безопасности и определении действий и триггеров для вашего соединителя SOAP.

    1. Для пункта Пользовательские соединители выберите SOAP в качестве Конечной точки API, чтобы предоставить файл WSDL, описывающий ваш API.

      Снимок экрана с предоставлением файла WSDL для вашего API

      Вариант Формат. Описание:
      Загрузка WSDL из файла WSDL-файл Откройте местоположение вашего WSDL-файла и выберите этот файл.
      Передача WSDL с URL-адреса http://path-to-wsdl-file Введите URL-адрес для файла WSDL вашей службы.
      Из SOAP в REST Неприменимо Преобразуйте API-интерфейс в службе SOAP в API-интерфейсы REST.

    2. В разделе Общие сведения загрузите значок для вашего соединителя.

      Как правило, поля Описание, Узел и Базовый URL-адрес автоматически заполняются из вашего файла WSDL. Если этого не произошло, добавьте соответствующую информацию, как описано в таблице, и выберите Продолжить.

      Снимок экрана сведений о соединителе

      Параметр или настройка Формат. Описание:
      Загрузить значок файл-png-или-jpg-меньше-1-МБ Значок, представляющий ваш соединитель

      Цвет: предпочтительно белый логотип на цветном фоне.

      Размеры: логотип величиной примерно 160 × 160 пикселей внутри квадрата 230 × 230 пикселей
      Цвет фона значка шестнадцатеричный-код-фирменного-цвета-значка Цвет позади вашего значка, который соответствует цвету фона в вашем файле значка.

      Формат: шестнадцатеричный. Например, #007ee5 представляет синий цвет.
      Описание: описание соединителя Введите краткое описание вашего соединителя.
      Хост хост коннектора Введите хост-домен для вашей службы SOAP.
      Базовый URL-адрес базовый адрес URL коннектора Введите базовый URL-адрес для вашей службы SOAP.

2b. Опишите аутентификацию, которую использует ваш соединитель

  1. Выберите Безопасность, чтобы просмотреть или описать метод аутентификации, используемый вашим соединителем. Аутентификация гарантирует, что идентификационные данные ваших пользователей соответствующим образом передаются между вашим сервисом и любыми клиентами.

    По умолчанию для параметра Тип аутентификации вашего соединителя установлено значение Нет аутентификации.

    Снимок экрана: тип аутентификации.

  2. Чтобы изменить тип аутентификации, выберите Редактировать. Вы можете выбрать значение Базовая аутентификация. Чтобы использовать метки параметров, отличные от значений по умолчанию, обновите их в поле Метка параметра.

    Снимок экрана: базовая аутентификация.

  3. Чтобы сохранить соединитель после ввода сведений о безопасности, в верхней части страницы выберите Обновить соединитель, а затем выберите Продолжить.

Внимание!

  • Если ваш коннектор использует OAuth, регулярно отслеживайте срок действия и своевременно обновляйте учетные данные client ID и client secret с истекающим сроком действия, чтобы клиенты могли продолжать использовать ваш коннектор.
  • При обновлении секрета клиента обновите версию Swagger.
  • Отправьте обновление соединителя через месяц до истечения срока действия идентификатора клиента и секрета клиента.

2c. Просмотрите, обновите или определите действия и триггеры для вашего соединителя

  1. Выберите Определение, чтобы просмотреть и отредактировать имеющиеся или определить новые действия и триггеры, доступные для добавления пользователями в бизнес-процессы.

    Действия и триггеры основаны на операциях, определенных в вашем файле WSDL, из которого автоматически заполняется страница Определение, включая значения запроса и ответа. Если требуемые операции уже указаны здесь, вы можете перейти к следующему шагу процесса регистрации, оставив данную страницу без изменений.

    Снимок экрана с определением соединителя.

  2. (Необязательно) Если вы хотите отредактировать существующие действия и триггеры или добавить новые, перейдите к примеру редактирования определения API.

3. Закончите создание вашего соединителя

Если все готово, выберите Обновить соединитель, чтобы развернуть ваш соединитель.

Поздравляем! Теперь при создании приложения логики вы сможете найти свой соединитель в Logic Apps Designer и добавить его в приложение логики.

Снимок экрана: поиск соединителя в Logic Apps Designer.

Предоставление общего доступа к своему соединителю другим пользователям Logic Apps

Зарегистрированные, но несертифицированные пользовательские соединители работают так же, как готовые соединители, за одним исключением. Они доступны только автору соединителя и пользователям, у которых тот же клиент Microsoft Entra ID и та же подписка Azure для приложений Logic Apps в регионе, где развернуты эти приложения. Хотя предоставлять общий доступ не обязательно, могут возникнуть ситуации, в которых нужно будет поделиться соединителями с другими пользователями.

Внимание!

Если вы совместно используете соединитель, другие могут начать зависеть от этого соединителя. Удаление вашего соединителя удаляет все соединения с этим соединителем.

Чтобы предоставить доступ к вашему соединителю внешним пользователям за пределами этих ограничений — например, всем пользователям Logic Apps — сертифицируйте свой соединитель. Чтобы узнать больше, перейдите к разделу Сертификация соединителя.

Вопросы и ответы

В. Является ли соединитель SOAP общедоступным?
О. Соединитель SOAP доступен в качестве предварительной версии и еще не является общедоступной службой.

В. Есть ли какие-либо ограничения или известные проблемы, связанные с соединителем SOAP?
О. Да. Чтобы узнать больше, перейдите к разделу Ограничения и известные проблемы соединителя SOAP .

В. Есть ли какие-либо ограничения для пользовательских соединителей?
О. Да. Чтобы узнать больше, перейдите к разделу Ограничения пользовательских соединителей.

Получение поддержки

  • Для получения поддержки по разработке и адаптации или для запроса функций, которые недоступны в мастере регистрации, свяжитесь с condevhelp@microsoft.com. Майкрософт отслеживает эту учетную запись, направляя вопросы к разработчикам и описания проблем в соответствующую рабочую группу.

  • Чтобы задать или ответить на вопросы или узнать, что делают другие пользователи Logic Apps, перейдите на форум Azure Logic Apps.

  • Чтобы помочь улучшить Logic Apps, голосуйте или отправляйте ваши идеи на сайт отзывов пользователей Logic Apps.

Сертификация соединителя
Вопросы и ответы о пользовательском соединителе для Azure Logic Apps, Power Automate, Power Apps и Copilot Studio

Предоставление отзыва

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

  • Last updated on