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

Примечание

Эта статья входит в серию руководств по созданию и использованию пользовательских соединителей в 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. чтобы добавить в список еще один столбец, указав для него тип данных Число и имя Оценка.

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

SharePoint Online предоставляет возможность создавать потоки прямо из списка, поэтому мы будем использовать этот подход. Вы можете создать этот же поток из flow.microsoft.com.

  1. В списке SharePoint выберите Поток, затем Создать поток.

    Создание потока

  2. На правой панели выберите Показать больше.

    Показать дополнительные потоки

  3. Выберите шаблон При добавлении нового элемента в SharePoint выполнять настраиваемое действие.

    Настраиваемое действие для SharePoint

    Пользовательское действие в этом случае вызывает API-интерфейс через пользовательский соединитель.

  4. Убедитесь, что вы вошли в SharePoint с правильной учетной записью, затем выберите Продолжить.

    Разрешения соединителя SharePoint

  5. В flow.microsoft.com выберите Изменить. Вы должны видеть сайт SharePoint и список, из которого вы запустили процесс Создать поток.

    Проверка сайта и списка

Добавление настраиваемого соединителя

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

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

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

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

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

  3. Введите значения во все поля.

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

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

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

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

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

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

    Параметр Стоимость
    Адрес сайта Адрес сайта SharePoint Online, из которого вы запустили процесс Создать поток
    Имя списка Список, из которого вы запустили процесс Создать поток
    Id Поле SharePoint Идентификатор
    Звание Поле SharePoint Заголовок
    Просмотр Поле SharePoint Рецензия
    Балл Поле оценка пользовательского соединителя

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

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

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

    Законченный поток анализа тональности

  6. Введите имя последовательности, например Анализ тональности, а затем выберите действие Создать поток и Готово.

Проверка потока

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

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

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

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

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

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

    Выбор нового потока

  4. Откройте ЖУРНАЛ ВЫПОЛНЕНИЯ, где должны отобразиться два запуска последовательности — по одному для каждой новой рецензии.

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

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

    Оценки, добавленные из потока

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

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

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

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

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