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

Настройка облачных потоков Power Automate в Power Pages

  • Статья

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

Теперь вы можете безопасно вызывать облачные потоки Power Automate из Power Pages для взаимодействия с более чем 1000 внешними источниками данных и интегрировать их в свой бизнес-сайт.

Заметка

  • Версия сайта Power Pages должна быть 9.5.4.xx или позже для работы этой функции.
  • Версия пакета начального сайта должна быть 9.3.2304.x или выше.

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

Для интеграции с Power Pages требуется лицензия на Power Automate. Рекомендуется использовать лицензию Power Automate Process в производственный экземпляр.

Шаги по интеграции облачного потока

  1. Создание облачного потока.

  2. Добавьте поток на свой сайт.

  3. Вызовите поток с вашего веб-сайта.

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

  1. Выполните вход в Power Pages.

  2. Выберите + Редактировать.

  3. Перейдите в рабочую область Настройка, затем выберите Облачные потоки в разделе Интеграции приложений.

  4. Выберите + Создать новый поток.

  5. Найдите Power Pages и выберите триггер Когда Power Pages вызывает поток.

    Выбор параметров Power Pages в Power Automate.

  6. Определите этапы потока и возвращаемые значения и выберите Сохранить.

Заметка

К сайту Power Pages можно прикрепить только потоки, связанные с решениями.

Добавьте поток на сайт

После создания мгновенного облачного потока его необходимо связать с сайтом Power Pages и защитить с помощью веб-роли.

  1. Выполните вход в Power Pages.

  2. Выберите + Редактировать.

  3. Перейдите в рабочую область Настройка, а затем выберите Облачные потоки (предварительная версия) в разделе Интеграция приложений.

  4. Выберите + Добавить облачный поток.

  5. Найдите недавно созданный поток.

  6. Выберите + Добавить роли в разделе Роли.

  7. Выберите роли, которым предоставляется доступ к потоку.

  8. Выберите Сохранить.

    Добавьте облачный поток на веб-сайт.

Заметка

Когда вы добавляете поток на свой сайт, создается уникальный URL-адрес, который позволяет вам вызывать облако с вашего сайта.

Вызов потока с веб-страницы

Используйте API облачного потока Power Pages для взаимодействия с Power Automate и выполнения интеграции с внешними службами. Операции API облачного потока состоят из HTTP-запросов и ответов.

Работа Способ URI
Вызовите облачный поток POST [Site URI]_/api/cloudflow/v1.0/trigger/<guid>

Пример:

Запросить

POST https://contoso.powerappsportals.com/_api/cloudflow/v1.0/trigger/4d22a1a2-8a67-e681-9985-3f36acfb8ed4
{
    "Location":"Seattle"
}

Отклик

Облачный поток без ответного действия

HTTP/1.1 Accepted
Content-Type: application/json

Облачный поток с ответным действием

HTTP/1.1 200 OK
Content-Type: application/json
Body
{
    "conditions":"Rain",
    "humidity":"93",
    "latitude":"47.60620880126953",
    "longitude":"-122.33206939697266"
}

Аутентификация запросов API облачного потока

Вам не нужно включать код аутентификации, потому что аутентификация и авторизация управляются сеансом приложения. Все вызовы API должны включать токен подделки межсайтовых запросов (CSRF).

Передача параметра в облачный поток

В облачном потоке вы можете определить входные параметры типа Текст, Логический, Файл и Число. Имя параметра, указанное вами в тексте запроса, должно совпадать с именем параметра, определенным в триггере облачного потока.

Внимание

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

Пример JavaScript для вызова потока

Этот пример демонстрирует, как вызвать поток, используя асинхронный JavaScript и XML (AJAX).

    shell.ajaxSafePost({
        type: "POST",
        url: "/_api/cloudflow/v1.0/trigger/44a4b2f2-0d1a-4820-bf93-9376278d49c4",
        data: {"eventData":JSON.stringify({"Email": "abc@contoso.com", "File":{"name":"Report.pdf", "contentBytes":"base 64 encoded string"} })}
    })
    .done(function (response) {
    
    })
    .fail(function(){
    
    });

Заметка