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

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

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

• Подписка Office 365 Business Premium или регистрация для пробной версии free
• Базовый опыт создания потоков. Дополнительные сведения см. в статье Создание потока с нуля.
• Пользовательский соединитель, который вы создали в одной из следующих тем:
  • Создание пользовательского соединителя на основе определения OpenAPI
  • Создание пользовательского соединителя с нуля

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

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

1. На сайте SharePoint Online выберите New затем List.

   

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

   

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

   

3. Выберите , затем Одна строка текста.

   

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

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

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

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

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

   

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

   

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

   действие

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

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

   

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

   

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

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

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

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

   

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

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

   

   Параметр	Значение
   Язык	"en"
   ИДЕНТИФИКАТОР	"1"
   Текст	Поле SharePoint Review (из диалогового окна Dynamic content)

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

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

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

   

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

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

   

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

   

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

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

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

1. В списке SharePoint Online выберите Quick Edit.

   

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

   

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

3. В flow.microsoft.com выберите Мои потоки, затем выберите созданный вами поток.

   

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

   

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

   

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

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

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

• Предоставление общего доступа к соединителю
• Сертификация соединителя

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

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