Konfigurowanie przepływów w chmurze Power Automate w usłudze Power Pages

  • Artykuł

Przepływ w chmurze Power Automate umożliwia użytkownikom tworzenie zautomatyzowanych przepływów pracy między różnymi aplikacjami i usługami. Przepływu w chmurze Power Automate można użyć do utworzenia logiki, która wykonuje jedno lub więcej zadań po wystąpieniu zdarzenia. Na przykład skonfiguruj przycisk tak, aby po wybraniu go przez użytkownika można było wysłać wiadomość e-mail lub prośbę o spotkanie, zaktualizować rekord, zebrać dane, zsynchronizować pliki i wykonać inne zadania.

Teraz możesz bezpiecznie wywoływać przepływy w chmurze Power Automate z Power Pages, aby wchodzić w interakcje z ponad 1000 zewnętrznymi źródłami danych i integrować je z witryną biznesową.

Uwaga

  • Aby ta funkcja działała, wersja witryny Power Pages musi mieć numer 9.5.4.xx lub nowszy.
  • Wymagana wersja pakietu witryny startowej to 9.3.2304.x lub nowsza.

Wymagania wstępne

Do integracji z Power Pages wymagana jest licencja Power Automate. Zalecane jest używanie licencji Power Automate na przepływ w wystąpieniu produkcyjnym.

Kroki integracji przepływu w chmurze

  1. Utwórz przepływ w chmurze.

  2. Dodaj przepływ do swojej witryny.

  3. Wywołaj przepływ ze swojej strony internetowej.

Utwórz przepływ

  1. Zaloguj się w Power Pages.

  2. Wybierz witrynę + Edytuj.

  3. Przejdź do obszaru roboczego Ustawienia, a następnie wybierz Przepływy w chmurze w Integracje aplikacji.

  4. Wybierz pozycję + Utwórz nowy przepływ.

  5. Wyszukaj Power Pages, wybierz wyzwalacz Gdy Power Pages wywoła przepływ.

    Wybieranie opcji Power Pages w Power Automate.

  6. Zdefiniuj kroki przepływu i wartości zwracane, a następnie wybierz Zapisz.

Uwaga

Do witryny Power Pages można dołączać tylko przepływy świadome chmury.

Dodaj przepływ do swojej witryny

Po utworzeniu natychmiastowego przepływu w chmurze należy go powiązać z witryną Power Pages i zabezpieczyć rolą sieci Web.

  1. Zaloguj się w Power Pages.

  2. Wybierz witrynę + Edytuj.

  3. Przejdź do obszaru roboczego Ustawienia, a następnie wybierz Przepływy w chmurze (wersja zapoznawcza) w sekcji Integracje aplikacji.

  4. Wybierz + Dodaj przepływ w chmurze.

  5. Wyszukaj ostatnio utworzony przepływ.

  6. Wybierz + Dodaj role w sekcji Role.

  7. Wybierz role, które powinny mieć dostęp do przepływu.

  8. Wybierz pozycję Zapisz.

    Dodaj przepływ w chmurze do strony internetowej.

Uwaga

Po dodaniu przepływu do witryny generowany jest unikalny adres URL, który umożliwia wywołanie chmury z witryny.

Wywołanie przepływu ze strony internetowej

Użyj interfejsu API przepływu w chmurze Power Pages do interakcji z Power Automate w celu przeprowadzenia integracji usług zewnętrznych. Operacje Cloud Flow API składają się z żądań i odpowiedzi HTTP.

Działanie Method Identyfikator URI
Wywołanie przepływu w chmurze POST [Site URI]_/api/cloudflow/v1.0/trigger/<guid>

Przykład:

Zażądaj

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

Response

Przepływ w chmurze bez akcji odpowiedzi

HTTP/1.1 Accepted
Content-Type: application/json

Przepływ w chmurze z akcją odpowiedzi

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

Uwierzytelnianie żądań API przepływu w chmurze

Nie ma potrzeby dołączania kodu uwierzytelniającego, ponieważ sesja aplikacji zarządza uwierzytelnianiem i autoryzacją. Wszystkie wywołania API muszą zawierać token CSRF (Cross-Site Request Forgery).

Przekazywanie parametru do przepływu w chmurze

W przepływie chmury można definiować parametry wejściowe typu Tekst, Wartość logiczna, Plik i Liczba. Nazwa parametru zdefiniowana w treści żądania powinna być zgodna z nazwą parametru zdefiniowaną w wyzwalaczu przepływu w chmurze.

Ważne

  • Należy przekazać nazwę parametrów żądania określoną w przepływie w chmurze.
  • Nie jest dostępna obsługa przekazywania parametru do przepływu skonfigurowanego przy użyciu bezpiecznych danych wejściowych.

Przykładowy kod JavaScript w celu wywołania przepływu

W tym przykładzie pokazano, jak wywołać przepływ za pomocą asynchronicznego języka JavaScript i XML (AJAX).

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

Uwaga