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
Creazione di un flusso cloud.
Aggiungi il flusso al sito.
Richiama un flusso dal tuo sito web.
Crea un flusso
Accedi a Power Pages.
Seleziona + Modifica.
Passa all'area di lavoro Configura, quindi seleziona Flussi cloud in Integrazioni.
Seleziona + Crea nuovo flusso.
Cerca Power Pages e seleziona il trigger Quando Power Pages chiama un flusso.
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.
Accedi a Power Pages.
Seleziona + Modifica.
Passa all'area di lavoro Configura, quindi seleziona Flussi cloud in Integrazioni.
Seleziona + Aggiungi flusso cloud.
Cerca il flusso creato di recente.
Seziona + Aggiungi ruoli sotto Ruoli.
Scegli i ruoli che devono avere accesso al flusso.
Seleziona Salva.
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
- Se nel trigger non è definito alcun parametro di input, passa un payload vuoto nella richiesta.
- Per informazioni sulle limitazioni del flusso cloud, vedi Limiti dei flussi automatizzati, programmati e istantanei.
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:
Accedi a Power Pages e seleziona il tuo ambiente di destinazione.
Individua il sito e seleziona Modifica.
Vai all'area di lavoro Configura, quindi seleziona Flussi cloud in Integrazioni.
Nell'elenco Flussi cloud in questo sito, cerca il pulsante Registrati.
Per registrare il flusso, seleziona l'icona.