Launch e Param funções

Aplica-se a: Aplicativos de tela

Inicia uma página Web ou uma aplicação de tela e fornece acesso aos parâmetros de iniciação.

Launch

Lança uma página Web ou uma aplicação de tela. A função suporta:

• Address (required), o URL da página da Web do aplicativo de tela.
• Parâmetros (opcional), valores nomeados para passar para a página da Web ou aplicativo de tela. Em um aplicativo de tela, os parâmetros podem ser lidos com a Param função.
• Target (opcional), a guia do navegador na qual iniciar a página da Web ou o aplicativo de tela.

Launch só pode ser usado em fórmulas de comportamento.

Morada

As páginas Web são iniciadas através de um endereço URL. Por exemplo:

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

Pode iniciar aplicações de tela com Ligação Web ou URL da Aplicação (ID de aplicação com prefixo com /providers/Microsoft.PowerApps/apps/). Para localizar estes valores para uma aplicação:

1. Aceder a Power Apps.

2. Selecione Aplicações no painel de navegação esquerdo.

3. Selecione a sua aplicação.

4. Selecione Detalhes no menu superior.
   Também pode selecionar ... (Mais Comandos) e, em seguida, selecionar Detalhes no menu pendente.

   

5. Copiar ligação Web.

   

A Ligação Web pode ser utilizada em qualquer página Web e iniciará a aplicação de tela. Ele também pode ser usado com a Launch função. Por exemplo:

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

As aplicações nativas num dispositivo não podem ser iniciadas diretamente. Poderão estar disponíveis opções indiretas em algumas plataformas, como uma aplicação nativa a instalar um esquema de URL personalizado ou a registar no browser para oferecer uma opção para Web sites específicos.

Parâmetros

Launch pode passar parâmetros para a página da Web ou o aplicativo de tela. Os parâmetros pode ser fornecidos de duas maneiras:

• Uma lista de argumentos de pares nome-valor. Por exemplo:

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

• Um registo de valores de campo. Por exemplo:

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

  Este formulário pode ser mais fácil de trabalhar por fazer a associação entre o nome e o valor mais clara. É o único formulário que suporta o argumento opcional LaunchTarget.

O endereço e os parâmetros são codificados no URL antes de serem transmitidos para substituir determinados caracteres não alfanuméricos com % e um número hexadecimal como se a função EncodeUrl tivesse sido utilizada em cada um.

Quando inicia uma página Web, uma cadeia de consulta de parâmetros pode ser incluída no final do endereço URL. Quaisquer parâmetros adicionais fornecidos serão Launch adicionados ao final da cadeia de caracteres de consulta. As cadeias de consulta não funcionam quando iniciam uma aplicação de tela.

Quando inicia uma aplicação num dispositivo móvel onde essa aplicação já está em execução, os parâmetros não serão atualizados na aplicação em execução. É necessário recarregar a aplicação para que os parâmetros sejam atualizados.

Destino

Utilize o argumento LaunchTarget para especificar a janela de browser de destino onde abrir a página Web ou a aplicação. Utilize um dos seguintes valores de enumeração LaunchTarget ou forneça um nome de janela personalizada.

Novo é o enumeração padrão ao executar em um navegador da Web com Substituir e nomear como opções disponíveis. Num leitor móvel, Novo é a predefinição para páginas Web com nomear como a opção disponível; enquanto a atual aplicação de tela será sempre substituída por outra aplicação de tela.

Param

A Param função recupera um parâmetro passado para o aplicativo quando ele foi iniciado. Se o parâmetro nomeado não foi passado, Param retorna em branco.

• Ao iniciar um aplicativo de tela a partir de outro aplicativo de tela, use os argumentos Parameter para a Launch função. Os nomes e os valores dos parâmetros serão codificados num URL automaticamente.
• Ao iniciar uma aplicação de tela a partir de uma página Web, adicione parâmetros à cadeia de consulta da ligação Web da aplicação de tela. Isto envolve adicionar &parametername=parametervalue, pressupondo que a cadeia de consulta já tenha sido iniciada para o tenantId. Por exemplo, adicionar &First%20Name=Vicki&category=3 transmitiria dois parâmetros: First Name com um valor de "Vicki" e category com um valor de "3" (o tipo de valor é text). O nome e o valor do parâmetro têm de ser codificados por URL se contiverem espaços ou caracteres especiais, semelhante a utilizar a função EncodeURL.
• Param os nomes diferenciam maiúsculas de minúsculas.
• Param nomes e valores serão automaticamente decodificados por URL para uso em seu aplicativo.
• Os valores dos parâmetros não são alterados, a menos que a aplicação seja recarregada. Usar Launch em um dispositivo móvel onde o aplicativo já está em execução não atualiza os parâmetros.
• Mesmo que o parâmetro contenha um número, o tipo retornado por Param será sempre uma cadeia de caracteres de texto. A conversão para outros tipos irá ocorrer automaticamente ou utilizará conversões explícitas, tais como a função Value para converter explicitamente para um número.

Sintaxe

Launch( Endereço [, ParameterName1, ParameterValue1, ... ] )

• Endereço – Obrigatório. O endereço de uma página Web ou o ID de uma aplicação a iniciar.
• ParameterNames – Opcional. Nome do parâmetro.
• ParameterValues – Opcional. Os valores de parâmetros correspondentes a transmitir à aplicação ou à página Web.

Launch( Endereço, { [ ParameterName1: ParameterValue1, ... ] } [, LaunchTarget ] )

• Endereço – Obrigatório. O endereço de uma página Web ou o ID de uma aplicação a iniciar.
• ParameterNames – Opcional. Nome do parâmetro.
• ParameterValues – Opcional. Os valores de parâmetros correspondentes a transmitir à aplicação ou à página Web.
• LaunchTarget – Opcional. Um valor de enumeração LaunchTarget ou um nome personalizado.

Param( Nome_parâmetro )

• ParameterName - Obrigatório. O nome do parâmetro transmitido à aplicação.

Parâmetros reservados

As seguintes palavras-chave são reservadas (independentemente do caso) para uso interno e não devem ser usadas como um parâmetro personalizado na Paramfunção ():

• amp%3Bauthmode
• amp%3Benableonbehalfof
• amp%3Bhidenavbar
• amp%3Blocale
• appmetadataversion
• authmode
• channeltype
• cordovapath
• correlationid
• depurar
• delegatelaunchurl
• delegatelaunchurl
• disablepreviewredirect
• embedderorigin
• enableonbehalfof
• groupid
• hideappsplash
• hidenavbar
• sugestão
• hostclienttype
• hostmode
• iframecontainerid
• isfullscreen
• ispreviewmode
• loader
• loaderType
• região
• localização
• packagekind
• packageproperties
• playerresourcespath
• playersessionid
• powerappslanguage
• screencolor
• sdkversion
• site
• skipappmetadata
• skipiframecreation
• skiplaunchappcache
• origem
• sourcetime
• standaloneconsent
• teamid
• teamtype
• tenantId
• tema
• uselocalpackagehostresources
• userteamrole

Exemplos

Simples Launch

De uma aplicação de tela para uma página Web:

De uma aplicação de tela para uma aplicação de tela

Atualize o ID da aplicação, o nome do ecrã e o número de registo, conforme adequado.

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

De uma aplicação Web para uma aplicação de tela

Atualize o ID da aplicação, o ID do inquilino, o nome do ecrã e o número de registo, conforme adequado.

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

Simples Param

Exemplos de inicialização simples acima para iniciar o aplicativo de tela a partir da página da Web ou de outro aplicativo de tela mostram exemplos simples de Param função:

Exemplos passo a passo para Launch e Param

O modelo de esquema de tablet Demonstração de Produtos foi utilizado para os exemplos seguintes. Para criar uma aplicação com este modelo, siga os passos de criar uma aplicação e selecione o modelo Demonstração de Produtos. Também pode utilizar a sua própria aplicação.

Exemplo - Launch

1. Aceder a Power Apps.

2. Selecione Aplicações no painel de navegação esquerdo.

3. Selecione a sua aplicação e, em seguida, selecione Editar.

4. Selecione Inserir a partir do menu e selecione Etiqueta.

5. Mova a etiqueta para a parte inferior direita do ecrã.

6. No painel de propriedades no lado direito, selecione Cor como branco e defina a Espessura do limite como 1.

7. Selecione a propriedade Text do lado direito e introduza texto como Tablets Surface nas notícias.

8. Na lista de propriedades na parte superior esquerda, selecione OnSelect.

9. Introduza a fórmula como Launch("https://www.bing.com/news/search","q","Microsoft Surface tablets"). Também pode utilizar qualquer outro URL, parâmetro ou palavras chave que pretender.

   

10. Guarde e publique a aplicação.

11. Executar a aplicação.

12. Selecione a etiqueta Tablets Surface nas notícias para iniciar a pesquisa de notícias com as palavras-chave Tablets Microsoft Surface.

Exemplo - Param

1. Aceder a Power Apps.

2. Selecione Aplicações no painel de navegação esquerdo.

3. Selecione a sua aplicação e, em seguida, selecione Editar.

4. Selecione Inserir a partir do menu e selecione Etiqueta.

5. Mova a etiqueta para a parte inferior direita do ecrã.

6. Selecione a propriedade Text para a etiqueta na parte superior esquerda.

7. Introduza a fórmula como Param("browser"). Também pode utilizar um parâmetro diferente à sua escolha.

   

8. Guarde e publique a aplicação.

9. Copie a ligação Web para a sua aplicação a partir do Power Apps.

10. Abra um novo browser.

11. Cole a ligação Web da aplicação no browser e acrescente &browser=Microsoft%20Edge no final.

    

12. Quando a aplicação é iniciada, a etiqueta mostra o valor do parâmetro transmitido.

    

13. Feche o leitor de aplicações e edite a aplicação.

14. Selecione Aplicação na vista de árvore na navegação esquerda.

15. Selecione a propriedade StartScreen na parte superior esquerda.

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

    

    Se a função na propriedade StartScreen verifica se o parâmetro é igual a um determinado valor, neste caso o valor techspecs. Se corresponder, devolve o controlo de ecrã TechSpecs à propriedade StartScreen.

    Nota

    Substitua o nome do controlo TechSpecs na função If com o nome de um controlo de ecrã na sua própria aplicação se não estiver a utilizar o modelo de aplicação Demonstração de Produtos.

17. Guarde e publique a aplicação.

18. Abra um novo browser.

19. Cole a ligação Web da aplicação no browser e acrescente &screen=techspecs no final.

    

20. A aplicação inicia diretamente com TechSpecs como o ecrã inicial.

Consulte também

Referência de fórmula do aplicativo Canvas