Funcions de llançament i paràmetre

Article
10/16/2024

S'aplica a: Aplicacions de llenç

Inicia una pàgina web o una aplicació de llenç i proporciona accés als paràmetres d'inici.

Launch

Inicia una pàgina web o una aplicació de llenç. La funció admet:

Address (obligatori), l'adreça URL de la pàgina web de l'aplicació de llenç.
Paràmetres (opcional), valors amb nom que s'han de passar a la pàgina web o a l'aplicació de llenç. En una aplicació de llenç, els paràmetres es poden llegir amb la funció Param.
Destinació (opcional), la pestanya del navegador on s'inicia la pàgina web o l'aplicació de llenç.

Launch només es pot utilitzar en fórmules de comportament.

Nota

Si s'utilitza la fórmula Inicia per obrir Power Apps i l'aplicació no és visible per a l'usuari final, es recomana comprovar si l'aplicació està bloquejada per un bloquejador de finestres emergents del navegador o si el navegador està esperant la resposta de l'usuari a un quadre de diàleg que li pregunta si vol navegar a una pantalla nova.

Adreça

Les pàgines web s'inicien mitjançant una adreça URL. Per exemple:

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

Podeu iniciar aplicacions de llenç amb un enllaç web o un URI de l'aplicació (identificador d'aplicació prefixat amb /providers/Microsoft.PowerApps/apps/). Per cercar aquests valors d'una aplicació:

Aneu al Power Apps.
Seleccioneu Aplicacions a la subfinestra de navegació esquerra.
Seleccioneu l'aplicació.
Seleccioneu Detalls al menú superior.
També podeu seleccionar ... (Més ordres) i, a continuació, Detalls al menú desplegable.
Copia l'enllaç web.

L'Enllaç web es pot utilitzar en qualsevol pàgina web i iniciarà l'aplicació de llenç. També es pot utilitzar amb la funció Launch. Per exemple:

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

Les aplicacions natives d'un dispositiu no es poden iniciar directament. Pot ser que hi hagi opcions indirectes en algunes plataformes, com ara una aplicació nativa que instal·la un esquema d'adreça URL personalitzat o que es registra amb el navegador web per oferir una opció per a determinats llocs web.

Paràmetres

Launch pot passar paràmetres a la pàgina web o a l'aplicació de llenç. Els paràmetres es poden proporcionar de dues maneres:

Llista d'arguments de parells de nom i valor. Per exemple:

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

Registre de valors de camp. Per exemple:
```
Launch( "https://bing.com/search", { q: "Power Apps", count: 1 } )
```
Pot ser més fàcil treballar amb aquest mètode perquè fa que l'associació entre el nom i el valor sigui més clara. És l'únic mètode que admet l'argument LaunchTarget opcional.

L'adreça i els paràmetres estan codificats per URL abans de passar-los per substituir certs caràcters no alfanumèrics amb % i un nombre hexadecimal com si s'hagués utilitzat la funció EncodeUrl en cadascun d'ells.

Quan s'inicia una pàgina web, es pot incloure una cadena de consulta de paràmetres al final de l'adreça URL. Qualsevol paràmetre addicional que es proporciona a Launch s'afegirà al final de la cadena de consulta. Les cadenes de consulta no funcionen en iniciar una aplicació de llenç.

Quan inicieu una aplicació en un dispositiu mòbil on l'aplicació ja s'està executant, els paràmetres no s'actualitzaran a l'aplicació en execució. Cal tornar a carregar l'aplicació per actualitzar els paràmetres.

LaunchTarget enum	Descripció
Nou	La pàgina web o l'aplicació s'obre en una finestra o pestanya nova.
Reemplaçar	La pàgina web o l'aplicació substitueix la finestra o pestanya actual.
nom	En comptes d'un valor enum, utilitzeu la vostra pròpia cadena de text per anomenar la finestra o la pestanya. Propi és un nom només per a ús intern que només utilitza la funció Launch. No té cap impacte en la finestra que veuran els usuaris ni en coincidirà amb el títol. Si ja hi ha una finestra o pestanya amb el nom indicat, el seu contingut se substituirà. Altrament, es crearà una finestra o pestanya nova. El nom no pot començar amb el caràcter de guió baix "_".

Param

La funció Param recupera un paràmetre passat a l'aplicació en iniciar-la. Si el paràmetre anomenat no s'ha passat, Param torna en blanc.

En iniciar una aplicació de llenç des d'una altra aplicació de llenç, utilitzeu els arguments de Paràmetre a la funció Launch. Els noms i els valors dels paràmetres estaran codificats automàticament en URL.
En iniciar una aplicació de llenç des d'una pàgina web, afegiu paràmetres a la cadena de consulta de l'enllaç web de l'aplicació de llenç. Això implica afegir &parametername=parametervalue, suposant que la cadena de consulta ja s'hagi començat per a tenantId. Per exemple, si s'afegeix &First%20Name=Vicki&category=3, es passen dos paràmetres: First Name amb el valor "Vicki" i category amb el valor "3" (el tipus de valor és text). El nom del paràmetre i el valor han de ser codificats en URL si contenen espais o caràcters especials, similar a l'ús de la funció EncodeURL.
Els noms de Param distingeixen entre majúscules i minúscules.
Els noms i els valors de Param seran automàticament descodificats en URL per a l'ús de l'aplicació.
Els valors dels paràmetres no canvien tret que es torni a carregar l'aplicació. L'ús de Launch en un dispositiu mòbil on l'aplicació ja s'està executant no actualitza els paràmetres.
Fins i tot si el paràmetre conté un nombre, el tipus retornat per Param serà sempre una cadena de text. La conversió a altres tipus es produirà automàticament o utilitzarà conversions explícites, com ara la funció Value, per convertir explícitament en un número.

Nota

Per a les pàgines personalitzades, els únics paràmetres acceptats per la pàgina són: recordId i entityName.

Sintaxi

Llançament( Adreça [, ParameterName1,ParameterValue1 , ... ] )

Adreça : obligatòria. L'adreça d'una pàgina web o l'identificador d'una aplicació per iniciar-la.
ParameterNames – Opcional. Nom del paràmetre.
ParameterValues : opcional. Valors de paràmetres corresponents per passar a l'aplicació o a la pàgina web.

Llançament( Adreça, { [ ParameterName1: ParameterValue1, ... ] } [, LaunchTarget ] )

Adreça : obligatòria. L'adreça d'una pàgina web o l'identificador d'una aplicació per iniciar-la.
ParameterNames – Opcional. Nom del paràmetre.
ParameterValues : opcional. Valors de paràmetres corresponents per passar a l'aplicació o a la pàgina web.
LaunchTarget : opcional. Un valor LaunchTarget enum o un nom personalitzat.

Param( ParameterName )

ParameterName : obligatori. Nom del paràmetre que es passa a l'aplicació.

Paràmetres reservats

Les paraules clau següents estan reservades (independentment de les majúscules o minúscules) per a ús intern i no s'han d'utilitzar com a paràmetre personalitzat a la funció 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
configuració regional
ubicació
packagekind
packageproperties
playerresourcespath
playersessionid
powerappslanguage
screencolor
sdkversion
Lloc del
skipappmetadata
skipiframecreation
skiplaunchappcache
origen
Temps d'origen
standaloneconsent
teamid
teamtype
tenantId
tema
uselocalpackagehostresources
userteamrole

Exemples

Launch senzill

D'una aplicació de llenç a una pàgina web:

Fórmula	Descripció
Llançament( "http://bing.com/search", "q", "Power Apps", "count", 1 )	Obre la pàgina web https://bing.com/search?q=Power%20Apps& recompte = 1. S'obre una finestra o una pestanya nova.
Llançament( "http://bing.com/search", { q: "Power Apps", count: 1 } )	Igual que els exemples anteriors amb la notació de registres equivalent. S'obre una finestra o una pestanya nova.
Llançament( "http://bing.com/search", { q: "Power Apps", count: 1 }, LaunchTarget.Replace )	Igual que els exemples anteriors, se substitueix la finestra o pestanya actual amb el resultat si s'executa en un navegador web.
Llançament( "http://bing.com/search", { q: "Power Apps", count: 1 }, "Resultats de la cerca" )	Igual que l'exemple anterior, es crea o se substitueix el contingut de la finestra o pestanya anomenada Resultats de la cerca.

D'una aplicació de llenç a una aplicació de llenç

Actualitzeu l'identificador de l'aplicació, el nom de la pantalla i el número de registre segons calgui.

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

D'una pàgina web a una aplicació de llenç

Actualitzeu l'identificador de l'aplicació, l'identificador de l'inquilí, el nom de la pantalla i el número de registre segons calgui.

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

Els exemples d'inici senzills anteriors per iniciar una aplicació de llenç des d'una pàgina web o des d'una altra aplicació de llenç mostren exemples senzills per a la funció Param:

Fórmula	Descripció	Resultat
Param( "Navegar" )	S'ha proporcionat el paràmetre Navega en iniciar l'aplicació i es torna.	"Segona pantalla"
Param( "Registre" )	S'ha proporcionat el paràmetre Registre en iniciar l'aplicació. Tot i que s'ha passat com a nombre a la funció Launch, el resultat de Param serà una cadena de text que es pot convertir implícitament o explícitament en altres tipus.	"34"
Param( "Usuari" )	No s'ha proporcionat el paràmetre Usuari. Es torna un valor en blanc que es pot provar amb la funció IsBlank.	Buit

Exemples pas a pas per a Launch i Param

La plantilla de disposició de tauleta Aparador de productes s'ha utilitzat per als exemples següents. Per crear una aplicació amb aquesta plantilla, seguiu els passos de l'article Crear una aplicació i seleccioneu la plantilla Aparador de productes. També podeu utilitzar una aplicació pròpia.

Exemple: Launch

Aneu al Power Apps.
Seleccioneu Aplicacions a la subfinestra de navegació esquerra.
Seleccioneu l'aplicació i, a continuació, Edita.
Seleccioneu Insereix al menú i, a continuació, seleccioneu Etiqueta.
Moveu l'etiqueta a la part inferior dreta de la pantalla.
Des de la subfinestra de propietats situada a la dreta, seleccioneu Color com a blanc i definiu el Gruix de la vora en 1.
Seleccioneu la propietat Text al costat dret i introduïu el text Tauletes Surface a les notícies.
A la llista de propietats de la part superior esquerra, seleccioneu OnSelect.
Introduïu la fórmula Launch("https://www.bing.com/news/search","q","Microsoft Surface tablets"). També podeu utilitzar qualsevol altra adreça URL, paràmetre i paraules clau que vulgueu.
Deseu i publiqueu l'aplicació.
Reproduïu l'aplicació.
Seleccioneu l'etiqueta Tauletes Surface a les notícies per iniciar la cerca de notícies amb paraules clau Microsoft Tauletes Surface.

Propina

Per a l'escalabilitat, podeu substituir les paraules clau introduïdes manualment a la funció Launch per variables.

Exemple: Param

Aneu al Power Apps.
Seleccioneu Aplicacions a la subfinestra de navegació esquerra.
Seleccioneu l'aplicació i, a continuació, Edita.
Seleccioneu Insereix al menú i, a continuació, seleccioneu Etiqueta.
Moveu l'etiqueta a la part inferior dreta de la pantalla.
Seleccioneu la propietat Text per a l'etiqueta de la part superior esquerra.
Introduïu la fórmula Param("browser"). També podeu utilitzar un paràmetre diferent que vulgueu.
Deseu i publiqueu l'aplicació.
Copieu l'enllaç web de l'aplicació des del Power Apps.
Obriu un navegador nou.
Enganxeu l'enllaç web de l'aplicació al navegador i afegiu &browser=Microsoft%20Edge al final.
En iniciar l'aplicació, l'etiqueta mostra el valor del paràmetre que s'ha passat.
Tanqueu el reproductor de l'aplicació i editeu-la.
Seleccioneu Aplicació a la Visualització d'arbre de la navegació esquerra.
Seleccioneu la propietat StartScreen a la part superior esquerra.
Introduïu la fórmula com If( Param("screen") = "techspecs", TechSpecs ).

La funció If a la propietat StartScreen comprova si el paràmetre és igual a un valor determinat, en aquest cas el valor techspecs. I si coincideix, retorna el control de pantalla TechSpecs a la propietat StartScreen .

Nota

Substituïu el nom del control TechSpecs a la funció If pel nom d'un control de pantalla de la vostra pròpia aplicació si no utilitzeu la plantilla d'aplicació Product Showcase .
Deseu i publiqueu l'aplicació.
Obriu un navegador nou.
Enganxeu l'enllaç web de l'aplicació al navegador i afegiu &screen=techspecs al final.
L'aplicació s'inicia directament amb TechSpecs com a pantalla d'inici.