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.

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. Inicie sessão no Power Pages.

2. Escolha 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.

   

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

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. Inicie sessão no Power Pages.

2. Escolha site + Editar.

3. Navegue até à área de trabalho Configurar e, em seguida, selecione Fluxos de nuvem sob 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.

   

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.

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 do pedido deve corresponder ao nome do parâmetro definido no acionador do fluxo de cloud.

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

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.

   

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

Ver também

• Limites dos fluxos automatizados, programados e instantâneos
• Resolução de problemas de erros de fluxo na nuvem
• Referência do código de erro do fluxo da nuvem
• Problemas conhecidos do Power Pages