Funcións Launch e Param en Power Apps

Inicia unha páxina web ou unha aplicación de lenzo e proporciona acceso aos parámetros de lanzamento.

Iniciar

Inicia unha páxina web ou unha aplicación de lenzo. A función admite:

  • Enderezo (requirido), o URL da páxina web ou ID de aplicación da aplicación de lenzo.
  • Parámetros (opcional), valores nomeados para pasar á páxina web ou aplicación de lenzo. Nunha aplicación de lenzo, pódense ler parámetros coa función Param.
  • Destino (opcional), a lapela do navegador para iniciar a páxina web ou a aplicación de lenzo.

Launch só se pode usar en fórmulas de comportamento.

Enderezo

As páxinas web iniciadas a través dun enderezo URL. Por exemplo:

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

Pode iniciar aplicacións de lenzo cunha Ligazón web ou un ID da aplicación. Para atopar estes valores para unha aplicación:

  1. Vaia a Power Apps.

  2. No panel de navegación esquerdo, seleccione Aplicacións.

  3. Seleccione a súa aplicación.

  4. Seleccione Detalles desde o menú superior.
    Tamén pode seleccionar ... (Máis comandos) e logo seleccionar Detalles do menú despregable.

    Opción de detalles da aplicación

  5. Copie a Ligazón web ou o ID da aplicación.

    Detalles da aplicación con ligazón web e ID da aplicación

A Ligazón web pode usarse en calquera páxina web e iniciará a aplicación de lenzo. Tamén se pode usar coa función Launch.

O ID da aplicación pode usarse coa función Launch, pero debe ser prefixada con /providers/Microsoft.PowerApps/apps/. Por exemplo:

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

As aplicacións nativas dun dispositivo non se poden iniciar directamente. Pode haber opcións indirectas dispoñibles nalgunhas plataformas, como unha aplicación nativa que instale un esquema de URL personalizado ou o rexistro co navegador web para ofrecer unha opción para sitios web específicos.

Parámetros

Launch pode pasar parámetros á páxina web ou á aplicación de lenzo. Os parámetros pódense proporcionar de dúas maneiras:

  • Lista de argumentos de pares de valores de nomes. Por exemplo:

    Launch( "http://bing.com/search", "q", "Power Apps", "count", 1 )
    
  • Un rexistro de valores de campo. Por exemplo:

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

    Con este formulario pode ser máis sinxelo traballar, xa que fai máis clara a asociación entre o nome e o valor. É o único formulario que admite o argumento opcional LaunchTarget.

Nota

A opción de rexistro dos parámetros está actualmente en Vista previa e será lanzada en todas as rexións en breve. Para obter máis detalles sobre funcións de vista previa, vaia Comprender as funcións experimentais, de vista previa e obsoletas en Power Apps.

O enderezo e os parámetros están codificados no URL antes de ser pasados para substituír certos caracteres non alfanuméricos por % e un número hexadecimal coma se a función EncodeUrl se empregase en cada un.

Ao lanzar unha páxina web, a cadea de consulta dos parámetros pódese incluír ao final do enderezo URL. Calquera parámetro adicional proporcionado a Launch engadirase ao final da cadea de consulta. As cadeas de consulta non funcionan cando se lanza unha aplicación de lenzo.

Destino

Nota

O argumento LaunchTarget está actualmente en Vista previa e será lanzado en todas as rexións en breve. Para obter máis detalles sobre funcións de vista previa, vaia Comprender as funcións experimentais, de vista previa e obsoletas en Power Apps.

Use o argumento LaunchTarget para especificar a xanela do navegador de destino na que abrir a páxina web ou a aplicación. Use un dos seguintes valores da enumeración LaunchTarget ou proporcione un nome de xanela personalizado.

Enumeración LaunchTarget Descripción
Novo A páxina web ou a aplicación ábrese nunha nova xanela ou lapela.
Substituír A páxina web ou a aplicación substitúe a xanela ou lapela actual.
nome En lugar dun valor de enumeración, use a súa propia cadea de texto para o nome da xanela ou lapela. Propio é un nome interno único que só emprega a función Launch. Non ten ningún impacto nin coincidirá co título da xanela que os seus usuarios ven. Se unha xanela ou lapela co nome dado xa existe, o seu contido substituirase. En caso contrario, crearase unha nova xanela ou lapela. O nome non pode comezar co carácter de guión baixo "_".

Novo é a enumeración predeterminada cando se executa nun navegador web con Substituír e nome como opcións dispoñibles. Nun reprodutor móbil, Novo é o valor predeterminado para páxinas web con nome como opción dispoñible; mentres que a aplicación actual de lenzo sempre será substituída por outra aplicación de lenzo.

Nota

  • Usando un LaunchTarget con calquera valor que non sexa Novo en escenarios incrustados (por exemplo, Power BI ou SharePoint) non é compatible e pode provocar un comportamento inesperado. No futuro, este comportamento pode cambiar ou pode causar un erro.

Zonas de seguranza

En Internet Explorer e Microsoft Edge clásico, a función Launch abre un sitio web ou aplicación de lenzo só se a súa configuración de seguridade é igual ou superior á da aplicación chamada.

Por exemplo, se engade a función Launch a unha aplicación que se executará na zona de seguridade Sitios de confianza, asegúrese de que o sitio web ou a aplicación coa que desexa que a función se abra está na zona Sitios de confianza ou Intranet local (non en Sitios restrinxidos). Máis información: Cambiar a configuración de seguridade e privacidade de Internet Explorer 11.

Param

A función Param recupera un parámetro pasado á aplicación cando se lanzou. Se non se pasou o parámetro nomeado, Param devolve en branco.

  • Ao iniciar unha aplicación de lenzo desde outra aplicación de lenzo, use os argumentos de Parámetro para a función Launch. Os nomes e valores dos parámetros codificaranse automaticamente no URL.
  • Cando inicie unha aplicación de lenzo desde unha páxina web, engada parámetros á cadea de consulta da ligazón web da aplicación de lenzo. Isto implica engadir &parametername=parametervalue asumindo que a cadea de consulta xa foi iniciada para o tenantId. Por exemplo, ao engadir &First%20Name=Vicki&category=3 pasarían dous parámetros: First Name cun valor de "Vicki" e category cun valor de "3" (o tipo de valor é texto). O nome e valor do parámetro deben estar codificados por URL se conteñen espazos ou caracteres especiais, similares aos que emprega a función EncodeURL.
  • Os nomes dos parámetros diferenzan entre maiúsculas de minúsculas.
  • Os nomes e os valores dos parámetros serán decodificados automaticamente no URL para o seu uso na aplicación.
  • Mesmo se o parámetro contén un número, o tipo devolto por Param sempre será unha cadea de texto. A conversión a outros tipos producirase automaticamente ou empregará conversións explícitas como a función Value para converter explícitamente a un número.

Sintaxe

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

  • Address: requirido. O enderezo dunha páxina web ou o ID dunha aplicación que se vai lanzar.
  • ParameterName(s): Opcional. Nome do parámetro.
  • ParameterValue(s): Opcional. Valores de parámetros correspondentes para pasar á aplicación ou á páxina web.

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

  • Address: requirido. O enderezo dunha páxina web ou o ID dunha aplicación que se vai lanzar.
  • ParameterName(s): Opcional. Nome do parámetro.
  • ParameterValue(s): Opcional. Valores de parámetros correspondentes para pasar á aplicación ou á páxina web.
  • LaunchTarget: Opcional. Un valor da enumeración LaunchTarget ou un nome personalizado.

Param( ParameterName )

  • ParameterName: Obrigatorio. Nome do parámetro pasado á aplicación.

Exemplos

Lanzamento sinxelo

Dunha aplicación de lenzo a unha páxina web:

Fórmula Descripción
Launch( "http://bing.com/search", 
"q", "Power Apps", "count", 1 )
Abre a páxina web http://bing.com/search?q=Power%20Apps&count=1. Ábrese unha nova xanela ou lapela.
Launch( "http://bing.com/search", 
{ q: "Power Apps", count: 1 } )
O mesmo que os exemplos anteriores empregando a notación de rexistro equivalente. Ábrese unha nova xanela ou lapela.
Launch( "http://bing.com/search", 
{ q: "Power Apps", count: 1 }, 
LaunchTarget.Self )
O mesmo que os exemplos anteriores, substituíndo a xanela ou lapela actual polo resultado se se está a executar nun navegador web.
Launch( "http://bing.com/search", 
{ q: "Power Apps", count: 1 }, 
"Search Results" )
O mesmo que o exemplo anterior, crear ou substituír o contido da xanela ou lapela nomeada Resultados da busca.

Dunha aplicación de lenzo a unha aplicación de lenzo

Actualice o ID da aplicación, o nome da pantalla e o número de rexistro segundo corresponda.

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

Dunha páxina web a aplicación de lenzo

Actualice o ID da aplicación, o arrendatario, o nome da pantalla e o número de rexistro segundo corresponda.

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

Parámetro sinxelo

Os exemplos de lanzamento sinxelo anteriores para iniciar unha aplicación de lenzo dende unha páxina web ou desde outra aplicación de lenzo amosan exemplos sinxelos para a función Param:

Fórmula Descripción Resultado
Param( "Navigate" ) O parámetro Navigate proporcionouse cando a aplicación foi lanzada e devolta. "Segunda pantalla"
Param( "Record" ) O parámetro Record proporcionouse cando a aplicación foi lanzada. A pesar de que foi transmitido como número á función Launch, o resultado de Param será unha cadea de texto que pode converterse implícitamente ou explicitamente a outros tipos. "34"
Param( "User" ) O parámetro User non se forneceu. Un valor en branco devólvese que se pode probar coa función IsBlank. en branco

Exemplos paso a paso para Launch e param

O modelo de deseño para tableta Presentación do produto utilizouse para os exemplos seguintes. Para crear unha aplicación con este modelo, siga os pasos do artigo crear unha aplicación e seleccione o modelo Presentación do produto. Tamén pode usar a súa propia aplicación.

Exemplo: Launch

  1. Vaia a Power Apps.

  2. No panel de navegación esquerdo, seleccione Aplicacións.

  3. Seleccione a aplicación e, a seguir, seleccione Editar.

  4. Seleccione Inserir do menú e logo seleccione Etiqueta.

  5. Mova a etiqueta á parte inferior dereita da pantalla.

  6. No panel de propiedades do lado dereito, seleccione Cor como branco e estableza Espesor de bordo en 1.

  7. Seleccione a propiedade Texto desde o lado dereito e escriba texto como Tabletas Surface nas novas.

  8. Na lista de propiedades na parte superior esquerda, seleccione OnSelect.

  9. Introduza a fórmula como Launch("https://www.bing.com/news/search","q","Microsoft Surface tablets"). Tamén pode usar calquera outro URL, parámetro e palabras clave que desexe.

    Exemplo de Launch

  10. Garde e publique a aplicación.

  11. Reproduza a aplicación.

  12. Seleccione a etiqueta Tabletas Surface nas novas para iniciar a busca de novas coas palabras clave Tabletas Microsoft Surface.

Suxestión

Para a escalabilidade, pode substituír as palabras clave introducidas manualmente na función Launch con variables.

Exemplo: Param

  1. Vaia a Power Apps.

  2. No panel de navegación esquerdo, seleccione Aplicacións.

  3. Seleccione a aplicación e, a seguir, seleccione Editar.

  4. Seleccione Inserir do menú e logo seleccione Etiqueta.

  5. Mova a etiqueta á parte inferior dereita da pantalla.

  6. Seleccione a propiedade Texto para a etiqueta da parte superior esquerda.

  7. Introduza a fórmula como Param("browser"). Tamén pode usar un parámetro diferente da súa elección.

    Exemplo de Param

  8. Garde e publique a aplicación.

  9. Copie a ligazón web da súa aplicación desde Power Apps.

  10. Abra nun explorador novo.

  11. Pegue a ligazón web da aplicación no explorador e engada &browser=Microsoft%20Edge ao final.

    Enderezo web

  12. Cando a aplicación se lanza, a etiqueta mostra o valor do parámetro pasado.

    Etiqueta de exemplo de Param

  13. Peche o reprodutor de aplicacións e edite a aplicación.

  14. Seleccione Aplicación desde a vista de árbore na navegación á esquerda.

  15. Seleccione a propiedade OnStart na parte superior esquerda.

  16. Introduza a fórmula como If(Param("screen")="techspecs",Navigate(TechSpecs,Fade)).

    Exemplo de parámetro para a navegación

    A función If na propiedade OnStart comproba se o parámetro é igual a un certo valor, neste caso o valor techspecs. E se coincide, a aplicación navega ata a pantalla TechSpecs.

    Nota

    Substitúa o nome da pantalla TechSpecs na función Navigate polo nome dunha pantalla da súa propia aplicación se non está a usar o modelo de aplicación Presentación do produto.

  17. Garde e publique a aplicación.

  18. Abra nun explorador novo.

  19. Pegue a ligazón web da aplicación no explorador e engada &screen=techspecs ao final.

    Enderezo web para a pantalla TechSpecs

  20. A aplicación iníciase directamente con TechSpecs ou unha pantalla que ingresou na función Navigate.

Consulte tamén

Referencia da fórmula da aplicación de lenzo