Esegui Power App (anteprima)

L'azione Esegui Power App avvia un'app direttamente da un flusso desktop e stabilisce un canale di comunicazione tra i due. Usando questa integrazione, i flussi desktop possono chiamare in modo nativo esperienze di Power App, passare input e ricevere output. Questo approccio consente un'integrazione nativa avanzata per gli scenari di automazione a cui si è assistito invece di basarsi sull'automazione basata sull'interfaccia utente.

Con questa funzionalità puoi:

  • Richiamare un'app direttamente da un flusso desktop
  • Richiama un'app direttamente da un flusso desktop.
  • Passa gli input dal flusso desktop nell'app.
  • Acquisisci gli output generati dall'app di nuovo nel flusso.
  • Attiva flussi secondari dagli eventi dell'app.

Ciò abilita scenari, ad esempio:

  • Moduli guidati dinamici in più passaggi per l'automazione partecipata
  • Esperienze moderne basate su app che sostituiscono moduli personalizzati obsoleti
  • Automazione gestita dagli eventi, in cui le azioni utente determinano l'esecuzione del flusso
  • Applicazioni cloud moderne che collegano l'automazione desktop legacy

Requisiti e disponibilità

  • Versione minima di Power Automate per desktop: 2.68 o successiva.
  • Disponibilità cloud: Disponibile solo nei cloud pubblici.

Note

Questa funzionalità è in anteprima e può cambiare prima della disponibilità generale.

Prerequisiti

Prima di iniziare, assicurarsi di avere:

  • Power Automate per desktop (PAD) versione 2.68 o versione successiva installata
  • Accesso a Power Apps nello stesso ambiente
  • Flussi secondari desktop che è possibile chiamare dall'app
  • Microsoft Edge WebView2 Runtime installato (necessario per visualizzare Power App durante il runtime)

Importante

  • Creare sottoflow locali e definire le variabili di input/output nell'ambito del sottoflow, se necessario.
  • I nomi dei flussi secondari devono iniziare con una lettera, contenere solo caratteri latini e non avere spazi. I flussi secondari che non seguono queste regole di denominazione non vengono esposti in Power Apps Studio e non sono disponibili per la chiamata.

Passaggio 1: Creare flussi secondari chiamabili nel flusso desktop

  1. Apri il flusso desktop nella finestra di progettazione PAD.
  2. Creare uno o più flussi secondari locali .
  3. (Facoltativo) Per ogni sottoflow, definire:
    • Variabili di input: valori che l'app passa al sottoflusso
    • Variabili di output: i valori restituiti dal sottoflusso all'app

Note

È anche possibile creare flussi secondari che non richiedono input o output. L'app può richiamare questi sottoflow per eseguire la logica senza passare o restituire dati. Mantenere ogni sottoflow incentrato su una singola operazione, ad esempio cercare i dati, convalidare l'input, scrivere in un sistema.

Passaggio 2: Stabilire la connessione di creazione a Power Apps Studio

Per esporre i sottoflussi in Power Apps Studio, in modo che vengano visualizzati come funzioni che puoi richiamare, apri l'app tramite il bridge di creazione di PAD.

  1. Aggiungere l'azione Esegui Power App (anteprima) al flusso desktop.
  2. Nelle proprietà dell'azione, eseguire una delle seguenti operazioni:
    • Selezionare un'app esistente o
    • Creare una nuova app

Note

Se si crea una nuova app:

  • La pagina Power Automate per desktop bridge viene aperta automaticamente nel browser predefinito.
  • Salvare e pubblicare l'app nella finestra di progettazione Power Apps.
  • Tornare all'azione e selezionare Aggiorna.
  • Selezionare l'app dal menu a discesa.

  1. Selezionare Apri app.

    Il browser predefinito apre una pagina Power Automate per desktop che consente di connettersi a Power Apps Studio.

  2. Nella pagina del browser selezionare Apri finestra di progettazione.

    Viene visualizzata una nuova scheda del browser con Power Apps Studio, con l'app selezionata già aperta.

  3. Tieni aperta la pagina del browser di Power Automate per desktop finché non viene visualizzato che è connesso.

    Se si chiude la pagina prima del caricamento dell'app, si impedisce di stabilire una connessione tra il flusso desktop e l'app Power.

Passaggio 3: chiama flussi secondari desktop da Power App

Dopo aver stabilito la connessione alla finestra di progettazione, Power Apps Studio mostra un oggetto host denominato PowerAutomateDesktop. Questo oggetto espone i sottoflussi desktop come funzioni richiamabili.

Modello di chiamata (generale)

Per richiamare un sottoflusso desktop da Power Apps:

  • Utilizzare l'oggetto PowerAutomateDesktop .
  • Chiama il flusso secondario per nome.
  • Passare gli input come parametri di una funzione.
  • Accedere ai valori di output dal risultato restituito.

Sintassi generale:

PowerAutomateDesktop.SubflowName(input1, input2, ...).OutputVariableName;

Esempio

In questo esempio:

  • Il flusso secondario si chiama GetCustomerData.
  • Accetta un singolo parametro di input. Ad esempio: varCustomerId.
  • Restituisce un valore tramite una variabile di output denominata out_customer_data, archiviata nella variabile varResultglobale .

Per chiamare il sottoflow, passare il valore di varCustomerId e archiviare l'output restituito nella variabile globale varResult:

Set(customer_data_result, PowerAutomateDesktop.GetCustomerData(varCustomerId));

Passaggio 4: Restituire valori a Power Apps

  • Power Automate per desktop restituisce tutti i valori come stringhe. In Power Apps eseguire il cast di questi valori al tipo appropriato.
  • Quando si chiama un flusso secondario del flusso desktop, vengono restituite tutte le variabili di output come valore di un singolo record.
  • È possibile accedere alle singole variabili di output come proprietà del record.

Esempio: Ottenere e usare le variabili di output in Power Apps

Set(globalVariable, PowerAutomateDesktop.GetCustomerData(inputVariable))

In questo esempio vengono archiviate tutte le variabili di output del sottoflow in globalVariable.

Per accedere a una variabile di output specifica. Ad esempio, out_var1:

globalVariable.out_var1

Restituisce valori complessi

Se è necessario restituire valori complessi (oggetti o elenchi personalizzati), restituirli come variabili di output e analizzarli in Power Apps.

  1. Nel sottoflusso desktop, crea un oggetto personalizzato.
  2. Restituisce l'oggetto personalizzato come variabile di output.
  3. In Power Apps, usare ParseJSON per analizzare il valore restituito e accedere alle relative proprietà.
Set(parsedValue, ParseJSON(globalVariable.out_customer_data))

Note

Power Automate per desktop restituisce tutti i valori come stringhe. Prima di usare questi valori nell’applicazione, effettuatene il cast al tipo appropriato (ad esempio usando Value o Boolean).

Supporto di IntelliSense

Quando chiami i sottoflussi desktop in Power Apps, Power Apps Studio fornisce IntelliSense per individuare e utilizzare le funzionalità disponibili.

Mentre digiti nella barra della formula:

  • L'oggetto PowerAutomateDesktop mostra i nomi dei flussi secondari disponibili.
  • I parametri di input per il sottoflow selezionato vengono visualizzati nell'ordine corretto.
  • I nomi delle variabili di output vengono suggeriti dopo la chiamata di funzione.

Questo supporto consente di:

  • Trova rapidamente i sottoflussi disponibili.
  • Capire i dati richiesti senza dover tornare al flusso sul desktop.
  • Selezionare variabili di output valide senza memorizzare i nomi.

Dove è possibile chiamare un flusso secondario

Richiama flussi secondari da proprietà abilitate alle azioni, ad esempio:

  • Un pulsante è OnSelect.
  • Proprietà dell'evento di un controllo (ad esempio, OnChange) quando appropriato per la progettazione dell'app.

Comportamento di runtime

Quando il flusso desktop viene eseguito e l'esecuzione arriva a Esegui Power App:

  1. L'app si avvia.
  2. L'app stabilisce automaticamente un canale di comunicazione.

L'azione Run Power App termina quando l'utente chiude la finestra di Power Apps o arresta il flusso manualmente.

Limitazioni e considerazioni

  • Esecuzione sequenziale: Il processo gestisce le chiamate ai flussi secondari una alla volta. Non attivare una nuova chiamata prima del completamento della chiamata precedente.
  • Propagazione della pubblicazione: Dopo aver pubblicato le modifiche a un'app, gli aggiornamenti potrebbero impiegare del tempo prima di essere visualizzati quando si avvia di nuovo l'app da Power Automate per desktop.
  • Richieste di accesso: In alcuni scenari, agli utenti potrebbe essere richiesto di accedere all'avvio dell'app.

Risoluzione dei problemi

Non è possibile visualizzare l'oggetto PowerAutomateDesktop nella finestra di progettazione Power Apps

  • Assicurarsi di usare Apri app nell'azione PAD. Selezionare quindi Apri finestra di progettazione nel browser e attendere che la finestra di progettazione carichi l'app.
  • Mantenere aperta la pagina del browser PAD fino a quando non viene stabilita la connessione.

Non riesco a vedere il mio subflow nuovo o aggiornato in Power Apps Studio

  • Riaprire l'app tramite Eseguire Power Apps > Apri app > Open Designer in modo che lo schema venga aggiornato.

Le modifiche apportate a Power App non vengono riflesse durante l'esecuzione da Power Automate per desktop

  • Assicurati di pubblicare le modifiche più recenti in Power Apps.
  • Dopo la pubblicazione, attendere un breve periodo di tempo prima di eseguire nuovamente l'app, perché gli aggiornamenti potrebbero richiedere del tempo per propagarsi e diventare disponibili quando vengono avviati da Power Automate per desktop. Se non si vuole attendere, è possibile riavviare l'app usando l'azione Esegui Power App per caricare immediatamente la versione più recente.

L'app non viene visualizzata durante il runtime

Power Apps esegue il rendering usando il Microsoft Edge WebView2 Runtime.

  • Assicurarsi che WebView2 Runtime sia installato nel computer. Per verificarlo, è possibile:

    • Controllando l'elenco delle applicazioni installate in Impostazioni di Windows (App > App installate), o
    • Esecuzione del Power Automate per la risoluzione dei problemi del desktop

  • Se non è installato, scaricarlo e installarlo da Microsoft Edge WebView2.

    Nella pagina di download, selezionare Bootstrapper Evergreen ed eseguire il programma di installazione.

  • Last updated on