Поделиться через


Использование внешних API в рабочих процессах

Важно!

Сейчас эта функция доступна в предварительной версии. Дополнительные условия использования предварительных версий Microsoft Azure включают дополнительные юридические условия, применимые к функциям Azure, которые находятся в бета-версии, в предварительной версии или еще не выпущены в общедоступной версии.

Рабочие процессы можно использовать для автоматизации некоторых бизнес-процессов с помощью Microsoft Purview, а соединитель HTTP и действие анализа JSON позволяют интегрировать рабочие процессы с внешними приложениями.

Соединитель HTTP

Соединители HTTP используют архитектуру REST, которая позволяет рабочим процессам Microsoft Purview взаимодействовать напрямую с приложениями сторонних корпораций с помощью веб-запросов.

Соединитель HTTP доступен во всех шаблонах рабочих процессов.

Примечание.

Чтобы создать или изменить рабочий процесс, требуется роль администратора рабочего процесса в Microsoft Purview. Вы также можете обратиться к администратору рабочего процесса в коллекции или обратиться к администратору коллекции за разрешениями.

  1. Чтобы добавить соединитель HTTP, щелкните + значок в шаблоне, в который нужно добавить, и выберите соединитель HTTP.

    Снимок экрана: добавление соединителя HTTP.

  2. Выбрав соединитель HTTP, заполните следующие параметры:

    1. Узел — URL-адрес запроса, который требуется вызвать при выполнении этого соединителя.
    2. Метод — выберите один из следующих методов. GET, PUT, PATCH, POST и DELETE. Эти методы соответствуют операциям создания, чтения, обновления и удаления.
    3. Путь — при необходимости можно ввести URL-адрес запроса. Для этого параметра можно использовать динамическое содержимое.
    4. Заголовки — при необходимости можно ввести заголовки HTTP. Заголовки HTTP позволяют клиенту и серверу передавать дополнительную информацию с помощью HTTP-запроса или ответа.
    5. Запросы . При необходимости можно передавать запросы.
    6. Текст — при необходимости можно передать текст HTTP при вызове URL-адреса.
    7. Проверка подлинности . Соединитель HTTP интегрирован с учетными данными Microsoft Purview. В зависимости от URL-адреса можно вызвать один из следующих трех типов:
      1. Нет (без проверки подлинности)
      2. Обычная проверка подлинности — используется уже созданные базовые учетные данные проверки подлинности.
      3. Субъект-служба — использование уже созданных учетных данных субъекта-службы и аудитории. Аудитория будет предполагаемым потребителем маркера доступа. Аудитория Microsoft Purview, например: https://purview.azure.net/.default убедитесь, что субъект-служба имеет право вызывать соответствующие службы, например ARM.

    Снимок экрана: добавление свойств соединителя HTTP.

  3. По умолчанию параметры безопасности включены для соединителей HTTP. Чтобы отключить безопасные входные и выходные данные, щелкните значок с многоточием (...), чтобы перейти к параметрам.

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

  4. Теперь вы получите параметры для соединителя HTTP, и вы можете отключить безопасные входы и выходы.

    Снимок экрана: добавление безопасных входных и выходных данных соединителя HTTP.

Синтаксический анализ действия JSON

Действие синтаксического анализа JSON в рабочих процессах позволяет получить входящие данные JSON из HTTP (или любого другого действия или соединителя) и проанализировать JSON для извлечения значений для использования в рабочем процессе.

Действие синтаксического анализа JSON доступно во всех рабочих процессах.

Снимок экрана: действие анализа JSON для рабочих процессов с параметрами, заполненными примерами данных.

Действие синтаксического анализа JSON имеет два параметра:

  • Content — переменная, которая должна содержать json, который требуется проанализировать.
  • Schema — схема входящего JSON, которая позволяет рабочему процессу анализировать входящие сведения. Вы можете указать собственный или использовать кнопку Создать из примера . Если вы создаете на основе примера, вы введете пример полезных данных JSON, и схема будет автоматически создана для вас.

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

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

Дальнейшие действия

Дополнительные сведения о рабочих процессах см. в следующих статьях: