Funzioni Launch e Param

Si applica a: App canvas

Avvia una pagina Web o un'app canvas e fornisce l'accesso per avviare i parametri.

Launch

Avvia una pagina Web o un'app canvas. La funzione supporta:

• Indirizzo (necessario), l'URL della pagina Web o l'URI dell'app (ID app preceduto dal prefisso /providers/Microsoft.PowerApps/apps/) dell'app canvas.
• Parametri (facoltativo), valori denominati da passare alla pagina Web o all'app canvas. In un'app canvas, i parametri possono essere letti con la funzione Param.
• Destinazione (facoltativo), la scheda del browser in cui avviare la pagina Web o l'app canvas.

La funzione Launch può essere usata solo nelle formule di comportamento.

Indirizzo

Le pagine Web vengono avviate tramite un indirizzo URL. Ad esempio:

Launch( "https://bing.com" )

È possibile avviare le app canvas con collegamento Web o URI app (ID app preceduto dal prefisso /providers/Microsoft.PowerApps/apps/). Per trovare questi valori per un'app:

1. Vai a Power Apps.

2. Nel riquadro di spostamento sinistro selezionare App.

3. Selezionare l'app.

4. Selezionare Dettagli nel menu in alto.
   È anche possibile selezionare ... (Altri comandi), quindi selezionare Dettagli nel menu a discesa.

   

5. Copiare Collegamento Web o ID app.

   

Il Collegamento web può essere utilizzato in qualsiasi pagina Web e avvierà l'app canvas. Può anche essere usato con la funzione Launch.

L'ID app può essere usato con la funzione Launch, ma deve essere preceduto da /providers/Microsoft.PowerApps/apps/. Ad esempio:

Launch( "/providers/Microsoft.PowerApps/apps/f342faaf-5f82-4ace-a64b-7c1b01499231" )

Le app native in un dispositivo non possono essere avviate direttamente. Potrebbero essere disponibili opzioni indirette su alcune piattaforme, come un'app nativa che installa uno schema URL personalizzato o viene registrata con il browser Web per offrire un'opzione per siti Web specifici.

Parametri

La funzione Launch può passare parametri alla pagina Web o all'app canvas. I parametri possono essere forniti in due modi:

• Un elenco di argomenti di coppie valore-nome. Ad esempio:

  Launch( "https://bing.com/search", "q", "Power Apps", "count", 1 )
  

• Un record di valori di campo. Ad esempio:

  Launch( "https://bing.com/search", { q: "Power Apps", count: 1 } )
  

  Questo modulo può essere più facile da utilizzare in quanto rende più chiara l'associazione tra nome e valore. È l'unico modulo che supporta l'argomento LaunchTarget facoltativo.

L'indirizzo e i parametri sono codificati nell'URL prima di essere passati per sostituire determinati caratteri non alfanumerici con % e un numero esadecimale come se la funzione EncodeUrl fosse stata utilizzata in ciascuno.

Quando si avvia una pagina Web, una stringa di query dei parametri può essere inclusa alla fine dell'indirizzo URL. Eventuali parametri aggiuntivi forniti per Launch verranno aggiunti alla fine della stringa di query. Le stringhe di query non funzionano quando si avvia un'app canvas.

Quando si avvia un'app su un dispositivo mobile su cui è già in esecuzione, i parametri non verranno aggiornati nell'app in esecuzione. È necessario ricaricare l'app per aggiornare i parametri.

Destinazione

Utilizzare l'argomento LaunchTarget per specificare la finestra del browser di destinazione in cui aprire la pagina Web o l'app. Utilizzare uno dei seguenti valori di enumerazione LaunchTarget o fornire una finestra personalizzata nome.

New è l'enumerazione predefinita durante l'esecuzione in un Web browser con Replace e name come opzioni disponibili. In un lettore per dispositivi mobili, Nuovo è l'impostazione predefinita per le pagine Web con nome come opzione disponibile; mentre l'app canvas corrente verrà sempre sostituita da un'altra app canvas.

Param

La funzione Param recupera un parametro passato all'app quando è stata avviata. Se il parametro denominato non è stato passato, Param restituisce blank.

• Quando si avvia un'app canvas da un'altra app canvas, utilizzare gli argomenti Parameter della funzione Launch. I nomi e i valori dei parametri verranno automaticamente codificati nell'URL.
• Quando si avvia un'app canvas da una pagina Web, aggiungere parametri alla stringa di query del collegamento Web dell'app canvas. Ciò comporta l'aggiunta di &parametername=parametervalue supponendo che la stringa di query sia già stata avviata per tenantId. Ad esempio, l'aggiunta di &First%20Name=Vicki&category=3 passerebbe due parametri: First Name con il valore "Vicki" e category con il valore "3" (il tipo di valore è testo). Il nome e il valore del parametro devono essere codificati nell'URL se contengono spazi o caratteri speciali, in modo simile all'utilizzo della funzione EncodeURL.
• Per i nomi dei parametri viene fatta la distinzione tra maiuscole e minuscole.
• I nomi e i valori dei parametri verranno automaticamente decodificati tramite URL per essere utilizzati nell'app.
• I valori dei parametri non cambiano a meno che l'app non venga ricaricata. L'utilizzo di Avvio su un dispositivo mobile su cui l'app è già in esecuzione non aggiorna i parametri.
• Anche se il parametro contiene un numero, il tipo restituito da Paramsarà sempre una stringa di testo. La conversione in altri tipi avverrà automaticamente o utilizzerà conversioni esplicite come la funzione Value per la conversione esplicita in un numero.

Sintassi

Launch( Address [, ParameterName1, ParameterValue1, ... ] )

• Address: obbligatorio. L'indirizzo di una pagina Web o l'ID di un'app da avviare.
• ParameterName: facoltativo. Nome del parametro.
• ParameterValue: facoltativo. Valori di parametro corrispondenti da passare all'app o alla pagina Web.

Launch( Address, { [ ParameterName1: ParameterValue1, ... ] } [, LaunchTarget ] )

• Address: obbligatorio. L'indirizzo di una pagina Web o l'ID di un'app da avviare.
• ParameterName: facoltativo. Nome del parametro.
• ParameterValue: facoltativo. Valori di parametro corrispondenti da passare all'app o alla pagina Web.
• LaunchTarget: facoltativo. Un valore di enumerazione LaunchTarget o un nome personalizzato.

Param( ParameterName )

• ParameterName: obbligatorio. Il nome del parametro passato all'app.

Parametri riservati

Le seguenti parole chiave sono riservate (indipendentemente dal caso) per uso interno e non devono essere utilizzate come parametro personalizzato nella funzione Param():

• amp%3Bauthmode
• amp%3Benableonbehalfof
• amp%3Bhidenavbar
• amp%3Blocale
• appmetadataversion
• authmode
• channeltype
• cordovapath
• correlationid
• debug
• delegatelaunchurl
• delegatelaunchurl
• disablepreviewredirect
• embedderorigin
• enableonbehalfof
• groupid
• hideappsplash
• hidenavbar
• hint
• hostclienttype
• hostmode
• iframecontainerid
• isfullscreen
• ispreviewmode
• loader
• loaderType
• locale
• posizione
• packagekind
• packageproperties
• playerresourcespath
• playersessionid
• powerappslanguage
• screencolor
• sdkversion
• Sito di
• skipappmetadata
• skipiframecreation
• skiplaunchappcache
• source
• sourcetime
• standaloneconsent
• teamid
• teamtype
• tenantId
• tema
• uselocalpackagehostresources
• userteamrole

Esempi

Launch semplice

Da un'app canvas a una pagina Web:

Da un'app canvas a un'app canvas

Aggiornare l'ID app, il nome della schermata e il numero di record come appropriato.

Launch( "/providers/Microsoft.PowerApps/apps/YOUR-APP-ID",
        { Navigate: "Second Screen", Record: 34 }
)

Da una pagina Web a un'app canvas

Aggiornare l'ID app, l'ID tenant, il nome della schermata e il numero di record come appropriato.

<html>
  <body>
    <a
      href="https://apps.powerapps.com/play/e/YOUR-APP-ENVIRONMENT-ID/a/YOUR-APP-ID?tenantId=YOUR-TENANT-ID&Navigate=Second%20Screen&Record=34"
    >
      Launch canvas app
    </a>
  </body>
</html>

Param semplice

Gli esempi di Launch semplice visti sopra per avviare l'app canvas da una pagina web o da un'altra app canvas mostrano esempi semplici per la funzione Param:

Esempi dettagliati per Launch e Param

Il modello di layout per tablet Product Showcase è stato utilizzato per i seguenti esempi. Per creare un'app con questo modello, seguire i passaggi nell'articolo Creare un'app e selezionare il modello Product Showcase. È anche possibile utilizzare la propria app.

Esempio - Launch

1. Vai a Power Apps.

2. Nel riquadro di spostamento sinistro selezionare App.

3. Selezionare l'app e quindi Modifica.

4. Selezionare Inserisci nel menu e quindi selezionare Etichetta.

5. Spostare l'etichetta in basso a destra nella schermata.

6. Nel riquadro delle proprietà sul lato destro, selezionare bianco per Colore e impostare Spessore del bordo su 1.

7. Selezionare la proprietà Text sul lato destro e immettere il testo Tablet Surface nelle notizie.

8. Dall'elenco delle proprietà in alto a sinistra, selezionare OnSelect.

9. Immettere la formula Launch("https://www.bing.com/news/search","q","Microsoft Surface tablets"). È anche possibile utilizzare qualsiasi altro URL, parametro o parole chiave di propria scelta.

   

10. Salvare e pubblicare l'app.

11. Riproduci l'app.

12. Selezionare l'etichetta Tablet Surface nelle notizie per avviare la ricerca notizie con le parole chiave Tablet Microsoft Surface.

Esempio - Param

1. Vai a Power Apps.

2. Nel riquadro di spostamento sinistro selezionare App.

3. Selezionare l'app e quindi Modifica.

4. Selezionare Inserisci nel menu e quindi selezionare Etichetta.

5. Spostare l'etichetta in basso a destra nella schermata.

6. Selezionare la proprietà Text per l'etichetta in alto a sinistra.

7. Immettere la formula Param("browser"). È anche possibile utilizzare un parametro differente di propria scelta.

   

8. Salvare e pubblicare l'app.

9. Copiare il collegamento web per l'app da Power Apps.

10. Aprire un nuovo browser.

11. Incollare il collegamento Web dell'app nel browser e aggiungere &browser=Microsoft%20Edge alla fine.

    

12. All'avvio dell'app, l'etichetta mostra il valore di parametro passato.

    

13. Chiudere il lettore dell'app e modificare l'app.

14. Selezionare App nella vista albero nel riquadro sinistro.

15. Selezionare la proprietà StartScreen in alto a sinistra.

16. Immettere la formula If( Param("screen") = "techspecs", TechSpecs ).

    

    La funzione If nella proprietà StartScreen verifica se il parametro è uguale a un determinato valore, in questo caso il valore techspecs. Se corrisponde, restituisce il controllo dello schermo TechSpecs alla proprietà StartScreen.

    Nota

    Sostituire il controllo TechSpecs nella funzione If con il nome di un controllo della schermata nella propria app se non si utilizza il modello di app Product Showcase.

17. Salvare e pubblicare l'app.

18. Aprire un nuovo browser.

19. Incollare il collegamento Web dell'app nel browser e aggiungere &screen=techspecs alla fine.

    

20. L'app si avvia direttamente con TechSpecs come schermata iniziale.

Vedi anche

Riferimento alle formule di app canvas