Configurar fluxos de cloud do Power Automate no Power Pages

  • Artigo

O fluxo de cloud do Power Automate permite que os utilizadores criem fluxos de trabalho automatizados entre aplicações e serviços diferentes. Pode utilizar um fluxo de cloud do Power Automate para criar lógica que efetue uma ou mais tarefas quando um evento ocorre. Por exemplo, configure um botão para que, quando um utilizador o selecionar, envia um e-mail ou um pedido de reunião, atualiza um registo, recolhe dados, sincroniza ficheiros e outras tarefas.

Agora, pode invocar em segurança fluxos de cloud do Power Automate a partir do Power Pages para interagir com +1000 origens de dados externas e integrá-las no site de negócio.

Nota

  • A versão do seu site do Power Pages deve ser 9.5.4.xx ou posterior para que esta caraterística funcione.
  • A versão do pacote do site de iniciação tem de ser 9.3.2304.x ou superior.

Pré-requisitos

Para integrar com o Power Pages, é necessária uma licença do Power Automate. É recomendado usar a licença por fluxo do Power Automate na instância de produção.

Passos para integrar o fluxo de cloud

  1. Criar um fluxo de cloud.

  2. Adicionar o fluxo ao seu site.

  3. Invocar um fluxo do seu site.

Criar um fluxo

  1. Iniciar sessão no Power Pages.

  2. Selecione + Editar do site.

  3. Navegue até à área de trabalho Configurar e, em seguida, selecione Fluxos de cloud em Integrações de aplicações.

  4. Selecione + Criar novo fluxo.

  5. Pesquise por Power Pages Selecione o acionador Quando o Power Pages chama um fluxo.

    Selecionar opções do Power Pages no Power Automate.

  6. Defina os passos do fluxo e os valores de devolução e selecione Guardar.

Nota

Só fluxos com suporte para soluções podem ser anexados ao site do Power Pages.

Adicionar um fluxo ao seu Site

Depois de criar um fluxo de cloud instantâneo, este tem de ser associado ao site do Power Pages e protegido com uma função da Web.

  1. Iniciar sessão no Power Pages.

  2. Selecione + Editar do site.

  3. Navegue para a área de trabalho Configurar e, em seguida, selecione Fluxos de cloud (pré-visualização) em Integrações da aplicação.

  4. Selecione + Adicionar fluxo de cloud.

  5. Pesquise pelo fluxo criado recentemente.

  6. Selecione + Adicionar funções em Funções.

  7. Selecione as funções que devem ter acesso ao fluxo.

  8. Selecione Guardar.

    Adicionar fluxo de cloud ao site.

Nota

Quando adiciona um fluxo ao site, é gerado um URL exclusivo que lhe permite invocar a nuvem a partir do site.

Invocar um fluxo a partir da página Web

Utilize a API do fluxo de cloud do Power Pages para interagir com o Power Automate para efetuar a integração de serviços externos. As operações de API do fluxo de cloud consistem em pedidos e respostas HTTP.

Operation Método URI
Invocar fluxo de cloud POST [URI do Site]_/api/cloudflow/v1.0/trigger/<guid>

Exemplo:

Pedir

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

Response

Fluxo de cloud sem ação de resposta

HTTP/1.1 Accepted
Content-Type: application/json

Fluxo de cloud com ação de resposta

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

Autenticar pedidos de API do fluxo de cloud

Não é necessário incluir um código de autenticação, porque a sessão da aplicação gere a autenticação e a autorização. Todas as chamadas à API devem incluir um token de Falsificação de pedido entre sites (CSRF).

Transmitir parâmetro para fluxo de cloud

Num fluxo de cloud, pode definir parâmetros de entrada do tipo Texto, Booleano, Ficheiro e Número. O nome do parâmetro que definir no corpo do pedido deve corresponder ao nome do parâmetro definido no acionador do fluxo de cloud.

Importante

  • Tem de transmitir o nome dos parâmetros do pedido conforme definido no fluxo de cloud.
  • O suporte para transmitir um parâmetro para um fluxo configurado com entradas seguras não está disponível.

Exemplo de JavaScript para chamar um fluxo

Este exemplo demonstra como chamar um fluxo utilizando JavaScript Assíncrono e 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(){
    
    });

Nota