Configurar fluxos de cloud do Power Automate no Power Pages

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. Recomenda-se a utilização de uma licença do Power Automate Process na instância de produção.

Passos para integrar o fluxo de nuvem

  1. Criar um fluxo de nuvem.

  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 o site + Editar.

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

  4. Selecione + Criar novo fluxo.

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

    Selecionando 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 nuvem instantâneo, este tem de ser associado ao site do Power Pages e protegido com uma função web.

  1. Iniciar sessão no Power Pages.

  2. Selecione o site + Editar.

  3. Vá para o espaço de trabalho Configurar e depois selecione Fluxos na cloud em Integrações.

  4. Selecione + Adicionar fluxo de nuvem.

  5. Pesquise o 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.

Operação Método URI
Invocar fluxo de nuvem POST [Site URI]_/api/cloudflow/v1.0/trigger/<guid>

Exemplo:

Solicitação

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

Resposta

Fluxo de nuvem sem ação de resposta

HTTP/1.1 Accepted
Content-Type: application/json

Fluxo de nuvem com uma ação de resposta

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

Autenticação de pedidos de API do fluxo de nuvem

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 Solicitação Entre Sites (CSRF).

Transmitir parâmetro para fluxo na nuvem

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 da solicitação deve corresponder ao nome do parâmetro definido no gatilho de fluxo na cloud.

Importante

  • Deve passar o nome dos parâmetros do pedido conforme definido no fluxo na cloud.
  • Não está disponível suporte para transmitir um parâmetro para um fluxo configurado com entradas seguras.

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",
        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(){
    
    });

Nota

Gestão do Ciclo de Vida das Aplicações (ALM) para Fluxos de cloud

Quando move os componentes de site do Power Pages, que incluem fluxos de nuvem, de um ambiente para outro, os fluxos de nuvem têm de ser registados no ambiente de destino. Se não registar os fluxos de cloud, invocá-los a partir do site resulta num erro proibido.

Para registar o fluxo no ambiente de destino, siga estes passos:

  1. Inicie sessão no Power Pages e selecione o ambiente de destino.

  2. Localize o site e selecione Editar.

  3. Aceda à área de trabalho Configurar e, em seguida, selecione Fluxos em nuvem em Integrações.

  4. Dentro da lista Fluxos de nuvem neste site, procure pelo botão Registo.

    Captura de ecrã do botão Registar na lista de fluxos na nuvem neste site.

  5. Para registar o fluxo, selecione o ícone.

Consulte também