Compartir por

LaunchFuncións Param

Aplícase a: aplicacións Canvas

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

Launch

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

  • Enderezo (obrigatorio), o URL da páxina web da aplicación de lenzo.
  • Parámetros (opcional), valores con nome para pasar á páxina web ou á aplicación de lenzo. Nunha aplicación de lenzo, os parámetros pódense ler coa Param función.
  • Destino (opcional), a pestana do navegador na que iniciar a páxina web ou a aplicación de lenzo.

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

Nota

  • Se a Launch fórmula se usa para abrir Power Apps e a aplicación non é visible para o usuario final, recoméndase comprobar se a aplicación está bloqueada por un bloqueador de ventás emerxentes do navegador ou se o navegador está esperando a resposta do usuario a unha caixa de diálogo que lle pregunta se quere navegar a unha nova pantalla.
  • Só se admiten https: os URI cando se usan Launch no Visual de Power Apps en PowerBI.

Enderezo

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

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

Podes iniciar aplicacións de lenzo con Ligazón web ou URI da aplicación (ID da aplicación co prefixo /providers/Microsoft.PowerApps/apps/). 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. Copiar ligazón web.

    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 Launch función. Por exemplo:

Launch( "https://apps.powerapps.com/e/{environment id}/a/{app id}?tenantId={tenantId}" )

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 Canvas. Os parámetros pódense proporcionar de dúas maneiras:

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

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

  • Un rexistro de valores de campo. Por exemplo:

    Launch( "https://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.

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. Todos os parámetros adicionais proporcionados engadiranse Launch ao final da cadea de consulta. As cadeas de consulta non funcionan cando se lanza unha aplicación de lenzo.

Ao iniciar unha aplicación nun dispositivo móbil no que esa aplicación xa está en execución, os parámetros non se actualizarán na aplicación en execución. É necesaria unha recarga da aplicación para que se actualicen os parámetros.

Destino

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 de LaunchTarget Descripción
Novo A páxina web ou a aplicación ábrese nunha nova xanela ou lapela.
Substitúe A páxina web ou a aplicación substitúe a xanela ou lapela actual.
nome No canto dun valor enum, use a súa propia cadea de texto para nomear a xanela ou a separación. Self é un nome só interno que só é usado pola Launch función. 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. name non pode comezar co carácter de subliñado "_".

Nova é 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.

Param

A Param función recupera un parámetro pasado á aplicación cando se iniciou. 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 Parameter para a Launch función. 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.
  • Param Os nomes son sensibles ás maiúsculas e minúsculas.
  • Param Os nomes e valores serán decodificados automaticamente para o seu uso na aplicación.
  • Os valores dos parámetros non cambian a menos que se recargue a aplicación. O uso Launch nun dispositivo móbil no que a aplicación xa está en execución non actualiza os parámetros.
  • Aínda que o parámetro conteña 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.

Nota

Para páxinas personalizadas, os únicos parámetros que acepta a páxina son: recordId e entityName.

Sintaxe

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

  • Enderezo – Obrigatorio. O enderezo dunha páxina web ou o ID dunha aplicación que se vai lanzar.
  • ParameterNames – Opcional. Nome do parámetro.
  • ParameterValues – Opcional. Valores de parámetros correspondentes para pasar á aplicación ou á páxina web.

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

  • Enderezo – Obrigatorio. O enderezo dunha páxina web ou o ID dunha aplicación que se vai lanzar.
  • ParameterNames – Opcional. Nome do parámetro.
  • ParameterValues – 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 : é necesario. Nome do parámetro pasado á aplicación.

Parámetros reservados

As seguintes palabras clave están reservadas (independentemente do caso) para uso interno, e non deben usarse como parámetro personalizado na Paramfunción ():

  • amp%3Bauthmode
  • amp%3Benableonbehalfof
  • amp%3Bhidenavbar
  • amp%3Blocale
  • appmetadataversion
  • authmode
  • channeltype
  • cordovapath
  • correlationid
  • depurar
  • delegatelaunchurl
  • delegatelaunchurl
  • disablepreviewredirect
  • embedderorigin
  • enableonbehalfof
  • groupid
  • hideappsplash
  • hidenavbar
  • pista
  • hostclienttype
  • hostmode
  • iframecontainerid
  • isfullscreen
  • ispreviewmode
  • loader
  • loaderType
  • configuración rexional
  • localización
  • packagekind
  • packageproperties
  • playerresourcespath
  • playersessionid
  • powerappslanguage
  • screencolor
  • sdkversion
  • sitio
  • skipappmetadata
  • skipiframecreation
  • skiplaunchappcache
  • fonte
  • Hora de orixe
  • standaloneconsent
  • teamid
  • teamtype
  • tenantId
  • tema
  • uselocalpackagehostresources
  • userteamrole

Exemplos

Sinxelo Launch

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 https://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.Replace )		 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 },
"Resultados da busca")		 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/e/YOUR-APP-ENVIRONMENT-ID/a/YOUR-APP-ID?tenantId=YOUR-TENANT-ID&Navigate=Second%20Screen&Record=34"
    >
      Launch canvas app
    </a>
  </body>
</html>

Sinxelo Param

Exemplos de lanzamento sinxelos anteriores para lanzar a aplicación de lenzo desde unha páxina web ou desde outra aplicación de lenzo mostran exemplos sinxelos para Param a función:

Fórmula Descripción Resultado
Param( "Navegar") 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índa que se pasou como un número á Launch función, o resultado será unha cadea de Param texto que pode ser convertida implícita ou explicitamente a outros tipos. "34"
Param( "Usuario") 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.

    Launch exemplo.

  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.

Propina

Para a escalabilidade, pode substituír as palabras clave introducidas manualmente en función por Launchvariables.

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.

    Param exemplo.

  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.

    Param Etiqueta de exemplo.

  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. Selecciona a propiedade StartScreen arriba á esquerda.

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

    Param Exemplo de navegación.

    Se a propiedade function in StartScreen comproba se o parámetro é igual a un valor determinado, neste caso o valor especificacións técnicas. E se coincide, devolve o control de pantalla TechSpecs á propiedade StartScreen .

    Nota

    Substitúe o nome do control TechSpecs na función If polo nome dun control de pantalla na túa propia aplicación se non está a usar o modelo da aplicación Product Showcase .

  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 lánzase directamente con TechSpecs como pantalla de inicio.

Consulte tamén

Referencia da fórmula da aplicación Canvas

  • Last updated on