Использование пользовательского соединителя из приложения логики

Примечание

Эта статья входит в серию руководств по созданию и использованию пользовательских соединителей в Azure Logic Apps, Power Automate и Power Apps. Обязательно прочитайте Обзор пользовательских соединителей, чтобы понять процесс.

В этом тема вы создаете базовое приложение логики, которое использует пользовательский соединитель, созданный вами в предыдущей теме. Приложение логики запускается, когда элемент добавляется в список SharePoint, затем приложение логики использует пользовательский соединитель для вызова API-интерфейса анализа текста Cognitive Services. Соединитель возвращает оценку тональности (от 0 до 1) для текста в элементе списка, и приложение логики записывает оценку обратно в список. Готовое приложение логики показано на следующем рисунке.

Законченное приложение логики анализа тональности

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

Создание списка SharePoint

Сначала вы создаете простой список из трех столбцов в SharePoint Online; в этом списке хранятся данные обзора фильмов, которые приложение логики анализирует на предмет тональности. Дополнительные сведения о списках SharePoint см. в разделе Введение в списки в документации по SharePoint.

  1. На вашем сайте SharePoint Online выберите Создать, затем Список.

    Создание нового списка SharePoint

  2. Введите имя "Рецензии на фильмы" и щелкните Создать.

    Выбор имени для нового списка

    Список создан со столбцом Заголовок по умолчанию.

    Список "Project Requests"

  3. Выберите Значок создания элемента, затем Одна строка текста.

    Поле однострочного текста

  4. Введите имя "Рецензия" и щелкните Сохранить.

  5. Повторите шаги 3 и 4. чтобы добавить в список еще один столбец, указав для него тип данных Число и имя "Оценка".

Создание приложения логики

Теперь, когда у вас есть список для работы, вы создаете приложение логики на портале Azure.

  1. Войдите на портал Azure с учетными данными учетной записи Azure.

  2. В главном меню Azure выберите Создать > Корпоративная интеграция > Приложение логики.

    Создание приложения логики

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

    Предоставьте сведения о приложении логики

    Параметр значение Описание
    Полное имя SentimentAnalysis Название для вашего приложения логики
    Подписка <название-вашей-подписки-Azure> Название вашей подписки Azure
    Группа ресурсов Моя-первая-LA-RG Название для группы ресурсов Azure, используемой для организации связанных ресурсов
    Местонахождение Восточная часть США 2 Регион, в котором хранится информация о вашем приложении логики

    Примечание. Ваше приложение логики и пользовательский соединитель должны находиться в одном регионе.

    Log Analytics Выключено Оставьте значение Выкл. для настройки диагностического журнала.
  4. После развертывания приложения в Azure откроется конструктор Logic Apps и отобразит страницу с вводным видео и часто используемыми триггерами. В разделе Шаблоны выберите Пустое приложение логики.

    Выберите шаблон пустого приложения логики

Добавьте триггер и пользовательский соединитель

С созданным приложением логики вы добавляете триггер, который срабатывает при добавлении элемента к списку SharePoint. Затем вы добавляете действие, которое нужно выполнить, основываясь на добавленном элементе.

  1. В конструкторе Logic Apps найдите или выберите SharePoint, затем триггер SharePoint — при создании элемента.

    SharePoint создает триггер элемента

  2. По запросу выполните вход с использованием учетных данных SharePoint.

  3. Введите значения для триггера SharePoint.

    SharePoint создает параметры триггера элемента

    Параметр значение
    Адрес сайта <адрес-вашего-сайта-SharePoint>
    Имя списка Обзоры фильмов
    Интервал 10
    Периодичность Второй
  4. Выберите Новый шаг, а затем — Добавить действие.

  5. Найдите пользовательский соединитель SentimentDemo, затем выберите действие, связанное с этим соединителем.

    Выберите действие SentimentDemo

    Название и описание действия происходят из информации, предоставленной вами при создании соединителя.

  6. Введите имя для подключения и ключ API.

    Имя подключения и ключ API

    Параметр значение
    Имя подключения Имя, например SentimentDemoConnection.
    Ключ API Ключ API для API анализа текста. Дополнительные сведения см. в разделе Получение ключа API.
  7. Введите значения во все поля.

    Параметры соединителя

    Параметр значение
    Язык en
    ИД 1
    Текст Поле SharePoint Рецензия (из диалогового окна Динамическое содержимое)

    ID (Идентификатор) — обязательный параметр, так как соединитель может обрабатывать несколько документов. Но в наших примерах отправляется только один документ за раз. В производственном приложении логики значения Язык и Идентификатор могут быть получены из списка или другого источника данных.

  8. Выберите Новый шаг, затем — Добавить действие.

  9. Добавьте действие SharePoint — Обновить элемент и введите значения для всех полей.

    Действие по изменению элемента списка

    Параметр значение
    Адрес сайта <адрес-вашего-сайта-SharePoint>
    Имя списка Обзоры фильмов
    Id Поле SharePoint Идентификатор
    Обращение Поле SharePoint Заголовок
    Отзыв Поле SharePoint Рецензия
    Балл Поле оценка пользовательского соединителя

    Обратите внимание, что при добавлении динамического содержимого в поле оценка Logic Apps добавляет контейнер Для каждого. Служба автоматически определяет, что пользовательский соединитель принимает несколько документов. Ваш соединитель отправляет только по одному за раз, но здорово, что приложение логики соответствует возможностям соединителя.

    Применить к каждому

    Готовое приложение логики должно выглядеть приблизительно так:

    Законченное приложение логики анализа тональности

  10. В верхней части конструктора Logic Apps выберите Запустить.

Тестирование приложения логики

Теперь, когда приложение логики готово к работе, вы можете его проверить, просто добавляя рецензии в список SharePoint и наблюдая результаты выполнения приложения логики.

  1. В вашем списке SharePoint Online выберите Быстрое редактирование.

    Быстрое редактирование списка SharePoint

  2. Добавьте два отзыва в список (один отрицательный и один положительный), затем выберите Готово.

    Быстрое редактирование готово

    Параметр Предлагаемое значение
    Заголовок (положительный) Мой любимый фильм
    Рецензия (положительная) Мне понравился этот новый фильм после долгого дня
    Заголовок (отрицательный) Какой-то другой фильм
    Рецензия (отрицательная) Худшее кино, которое я видел за десятилетия
  3. Вернувшись на портал Azure, выберите Обзор, чтобы посмотреть историю выполнения этого приложения логики. Вы должны увидеть два запуска — по одному для каждой новой рецензии, добавленной в список. Чтобы сохранить ресурсы Azure после завершения работы с этим приложением логики, выберите Отключить.

    Журнал выполнения

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

    Оценки, добавленные из приложения логики

Все готово! Это простое приложение логики, но оно получает мощные возможности благодаря способности вызывать Cognitive Services с помощью пользовательского соединителя.

Следующие шаги

Соединитель можно совместно использовать внутри организации или сертифицировать, чтобы его могли применять пользователи за пределами вашей организации:

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

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