Funcións de Lanzamento e Param

Artigo
03/22/2024

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.

Iniciar

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

Nota

Se a fórmula de inicio 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á a esperar o resposta do usuario a unha caixa de diálogo que pregunta se quere navegar a unha nova pantalla.

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:

Vaia a Power Apps.
No panel de navegación esquerdo, seleccione Aplicacións.
Seleccione a súa aplicación.
Seleccione Detalles desde o menú superior.
Tamén pode seleccionar ... (Máis comandos) e logo seleccionar Detalles do menú despregable.
Copiar ligazón web.

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

Launchpode 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( "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. 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.

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.

LaunchTarget enum	Descripción
New	A páxina web ou a aplicación ábrese nunha nova xanela ou lapela.
Replace	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 "_".

New é a enumeración predeterminada cando se executa nun navegador web con Replace 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 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.
Os valores dos parámetros non cambian a menos que se recargue a aplicación. O uso de Iniciar nun dispositivo móbil no que xa se está a executar a aplicación non se actualizan os parámetros.
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.

Nota

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

Sintaxe

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

Address – Obrigatorio. 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 – Obrigatorio. 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.

Parámetros reservados

As seguintes palabras clave están reservadas (sen importar o caso) para uso interno e non se deben usar como parámetro personalizado na función Param():

amp%3Bauthmode
amp%3Benableonbehalfof
amp%3Bhidenavbar
amp%3Blocale
appmetadataversion
authmode
channeltype
cordovapath
correlationid
debug
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 de
skipappmetadata
skipiframecreation
skiplaunchappcache
orixe
Hora de orixe
standaloneconsent
teamid
teamtype
tenantId
tema
uselocalpackagehostresources
userteamrole

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 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 }, "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/e/YOUR-APP-ENVIRONMENT-ID/a/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.	blank

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

Vaia a Power Apps.
No panel de navegación esquerdo, seleccione Aplicacións.
Seleccione a aplicación e, a seguir, seleccione Editar.
Seleccione Inserir do menú e logo seleccione Etiqueta.
Mova a etiqueta á parte inferior dereita da pantalla.
No panel de propiedades do lado dereito, seleccione Cor como branco e estableza Espesor de bordo en 1.
Seleccione a propiedade Texto desde o lado dereito e escriba texto como Tabletas Surface nas novas.
Na lista de propiedades na parte superior esquerda, seleccione OnSelect.
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.
Garde e publique a aplicación.
Reproduza a aplicación.
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 na función Launch con variables.

Exemplo: Param

Vaia a Power Apps.
No panel de navegación esquerdo, seleccione Aplicacións.
Seleccione a aplicación e, a seguir, seleccione Editar.
Seleccione Inserir do menú e logo seleccione Etiqueta.
Mova a etiqueta á parte inferior dereita da pantalla.
Seleccione a propiedade Texto para a etiqueta da parte superior esquerda.
Introduza a fórmula como Param("browser"). Tamén pode usar un parámetro diferente da súa elección.
Garde e publique a aplicación.
Copie a ligazón web da súa aplicación desde Power Apps.
Abra nun explorador novo.
Pegue a ligazón web da aplicación no explorador e engada &browser=Microsoft%20Edge ao final.
Cando a aplicación se lanza, a etiqueta mostra o valor do parámetro pasado.
Peche o reprodutor de aplicacións e edite a aplicación.
Seleccione Aplicación desde a vista de árbore na navegación á esquerda.
Selecciona a propiedade StartScreen arriba á esquerda.
Introduza a fórmula como If( Param("screen") = "techspecs", TechSpecs ).

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 de aplicación Product Showcase .
Garde e publique a aplicación.
Abra nun explorador novo.
Pegue a ligazón web da aplicación no explorador e engada &screen=techspecs ao final.
A aplicación lánzase directamente con TechSpecs como pantalla de inicio.