Condividi tramite


Configurare flussi cloud Power Automate in Power Pages

Il flusso cloud Power Automate consente agli utenti di creare flussi di lavoro automatizzati tra diverse applicazioni e servizi. Puoi usare un flusso cloud Power Automate per creare la logica che esegue una o più attività quando si verifica un evento. Ad esempio, configura un pulsante in modo che, quando un utente lo seleziona, invii un'e-mail o una richiesta di riunione, aggiorni un record, raccolga dati, sincronizzi file e altre attività.

Ora puoi invocare in modo sicuro i flussi cloud Power Automate da Power Pages per interagire con oltre 1000 origini dati esterne e integrarle nel tuo sito aziendale.

Nota

  • La versione del tuo sito Power Pages deve essere 9.5.4.xx o versioni successive affinché questa funzione possa essere utilizzata.
  • La versione del pacchetto del sito iniziale deve essere 9.3.2304.x o successiva.

Prerequisiti

Per l'integrazione con Power Pages, è necessaria una licenza Power Automate. Si consiglia di utilizzare una licenza Power Automate Process nell'istanza di produzione.

Passaggi per l'integrazione del flusso cloud

  1. Creazione di un flusso cloud.

  2. Aggiungi il flusso al sito.

  3. Richiama un flusso dal tuo sito web.

Crea un flusso

  1. Accedi a Power Pages.

  2. Seleziona + Modifica.

  3. Passa all'area di lavoro Configura, quindi seleziona Flussi cloud in Integrazioni.

  4. Seleziona + Crea nuovo flusso.

  5. Cerca Power Pages e seleziona il trigger Quando Power Pages chiama un flusso.

    Seleziona le opzioni Power Pages in Power Automate.

  6. Definisci le fasi del flusso e i valori di ritorno e seleziona Salva.

Nota

Solo i flussi con riconoscimento della soluzione possono essere collegati al sito Power Pages.

Aggiungere un flusso al sito

Dopo aver creato un flusso cloud istantaneo, deve essere associato al sito Power Pages e protetto con un ruolo web.

  1. Accedi a Power Pages.

  2. Seleziona + Modifica.

  3. Passa all'area di lavoro Configura, quindi seleziona Flussi cloud in Integrazioni.

  4. Seleziona + Aggiungi flusso cloud.

  5. Cerca il flusso creato di recente.

  6. Seziona + Aggiungi ruoli sotto Ruoli.

  7. Scegli i ruoli che devono avere accesso al flusso.

  8. Seleziona Salva.

    Aggiungi un flusso cloud al sito web.

Nota

Quando aggiungi un flusso al tuo sito, viene generato un URL univoco che ti consente di richiamare il cloud dal tuo sito.

Richiamare un flusso dalla pagina web

Utilizza l'API flusso cloud Power Pages per interagire con Power Automate per eseguire l'integrazione di servizi esterni. Le operazioni API flusso cloud sono costituite da richieste e risposte HTTP.

Operation metodo URI
Richiama flusso cloud POST [URI del sito]_/api/cloudflow/v1.0/trigger/<guid>

Esempio:

Richiedi

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

Response

Flusso cloud senza azione di risposta

HTTP/1.1 Accepted
Content-Type: application/json

Flusso cloud con azione di risposta

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

Autenticazione delle richieste dell'API flusso cloud

Non è necessario includere un codice di autenticazione, perché la sessione dell'applicazione gestisce l'autenticazione e l'autorizzazione. Tutte le chiamate API devono includere un token CSRF (Cross-Site Request Forgery, richiesta intersito falsa).

Passaggio del parametro al flusso cloud

In un flusso cloud è possibile definire parametri di input di tipo Testo, Booleano, File e Numero. Il nome del parametro definito nel corpo della richiesta deve corrispondere al nome del parametro definito nel trigger del flusso cloud.

Importante

  • È necessario passare il nome dei parametri della richiesta come definito nel flusso cloud.
  • Il supporto per il passaggio di un parametro a un flusso configurato con input sicuri non è disponibile.

Esempio di JavaScript per chiamare un flusso

Questo esempio mostra come chiamare un flusso utilizzando JavaScript asincrono 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

Application Lifecycle Management (ALM) per flussi cloud

Quando sposti i componenti del sito Power Pages che includono flussi cloud da un ambiente a un altro, i flussi cloud devono essere registrati nell'ambiente di destinazione. Se non registri i flussi cloud, richiamarli dal sito Web genera un errore non consentito.

Per registrare il flusso con l'ambiente di destinazione, segui questi passaggi:

  1. Accedi a Power Pages e seleziona il tuo ambiente di destinazione.

  2. Individua il sito e seleziona Modifica.

  3. Vai all'area di lavoro Configura, quindi seleziona Flussi cloud in Integrazioni.

  4. Nell'elenco Flussi cloud in questo sito, cerca il pulsante Registrati.

    Screenshot del pulsante Registrati nell'elenco Flussi cloud in questo sito.

  5. Per registrare il flusso, seleziona l'icona.